独自の AI プロバイダー

Archyl にはアーキテクチャディスカバリー、ADR 解析、チャット、インサイト、マネージドエージェントのための AI 機能が含まれています。デフォルトでは、これらすべては Archyl が管理するモデルで実行されます。コンプライアンス、契約、またはデータレジデンシーの理由で既存の AI プロバイダー関係を持つ組織は、独自の認証情報を使用してすべての AI リクエストを独自のプロバイダー経由でルーティングできます。

BYO Provider が有効化されると:

  • すべての AI 機能は構成したプロバイダー経由でルーティングされます
  • Archyl のクォータ強制(チャットクエリ、AI ディスカバリー、エージェント実行)は スキップ されます — プロバイダーがトークン使用量を直接請求します
  • 機能ごとのモデル選択により、モデルの混合が可能です(例:チャットには Claude Sonnet、ディスカバリーには Claude Opus)

これは組織レベルの設定です。組織管理者のみ が構成できます。

サポートされているプロバイダー

プロバイダー 説明 デフォルトモデル
OpenAI api.openai.com での直接 OpenAI API gpt-5.6-luna
Anthropic 直接の Anthropic Messages API (Claude) claude-sonnet-4-6
Google Google Generative Language API (Gemini) gemini-2.0-flash
AWS Bedrock Bedrock Converse API — Anthropic Claude、Mistral、Llama、Titan、Cohere をカバー anthropic.claude-sonnet-4-20250514-v1:0
OpenAI 互換 OpenAI Chat Completions 形式を話す任意のエンドポイント — Azure OpenAI、GitHub Models、OpenRouter、Mistral La Plateforme、Groq、Together AI、Fireworks、DeepInfra、vLLM、llama.cpp など (プロバイダー固有)

OpenAI 互換アダプターは、長いテールのベンダーをカバーする単一の構成です。ベース URL と API キーを提供すると、Archyl は OpenAI であるかのようにエンドポイントと通信します。

構成

ステップ 1 — AI タブを開く

組織設定 → AI に移動します。タブは管理者のみに表示されます。

ステップ 2 — プロバイダーを選択

5 つのプロバイダーカードのいずれかを選択します。各カードには独自の認証情報要件があります:

  • OpenAI / Anthropic / Google — API キーのみ
  • OpenAI 互換 — API キー + ベース URL(例:https://api.openrouter.ai/api/v1、https://api.mistral.ai/v1、https://models.github.ai/inference)
  • AWS Bedrock — <access_key_id>:<secret_access_key> 形式の認証情報(STS 認証情報の場合はオプションの :<session_token> サフィックス付き)、加えて AWS リージョン(例:us-east-1)

ステップ 3 — 機能ごとのモデルを構成(オプション)

各 AI 機能は異なるモデルを使用できます。任意のフィールドを空にすると、プロバイダーのデフォルトにフォールバックします。

機能 説明
チャット ストリーミングチャットアシスタント
ディスカバリー リポジトリ全体の AI ディスカバリー — 信頼できる JSON 出力が必要
構造分析 ディスカバリーフェーズ 1(システム + コンテナ)
関係性の精緻化 ディスカバリーフェーズ 3(コンテナ間リンク)
ADR 解析 ADR の Markdown から構造化フィールドを抽出
ファイル分析 ファイルごとの詳細パス
ドキュメントタイトル生成 ドキュメントのタイトルをバッチ生成
インサイト AI 生成のアーキテクチャインサイト
マネージドエージェント マネージドエージェント実行で使用するモデル(下記の「マネージドエージェント」セクションを参照)

プロバイダーが公開している正確なモデル識別子を使用します(claude-opus-4-5、gpt-4o、mistral-large-latest、anthropic.claude-sonnet-4-20250514-v1:0 など)。Archyl はそのまま渡します。

ステップ 4 — 接続をテスト

接続テスト をクリックします。Archyl は構成されたプロバイダーに対して認証情報で最小限の completion を発行します。緑のチェックマークは認証情報が機能することを確認します。エラーはプロバイダーの応答を表示するので、保存前に構成を修正できます。

ステップ 5 — 有効化して保存

この組織で BYO プロバイダーを有効化 にチェックを入れ、設定を保存 をクリックします。組織の誰からの次の AI リクエスト — チャット、ディスカバリー、エージェント実行、ADR インポート — もプロバイダー経由でルーティングされます。

クォータの動作

BYO Provider が 無効 (デフォルト) の場合、AI 使用量はサブスクリプションの月次クォータに対してカウントされます:

  • AI ディスカバリー操作
  • チャットクエリ
  • マネージドエージェント実行

BYO Provider が 有効 の場合、3 つのすべてのクォータが組織でバイパスされます。使用したトークンに対してプロバイダーに直接支払い、Archyl はこれらの機能をレート制限しなくなります。シートベースのサブスクリプションは、それ以外のすべて(コラボレーション機能、チーム制限など)に引き続き適用されます。

バイパスはトグルを有効にすると即座に有効になり、無効にすると即座に元に戻ります。

セキュリティ

API キーは、プラットフォームの暗号化キーで AES-256-GCM を使用して保存時に暗号化されます。API 応答で返されることはありません — 保存されると、UI は •••••••• と「キー保存済み」インジケーターを表示し、キーは AI リクエストが必要な時にのみインプロセスで復号化されます。

既存のキーを置き換えるには、新しい値を入力して保存します。完全に削除するには、構成を削除 をクリックします。これにより行が削除され、組織はプラットフォーム管理の AI に戻ります。

組織管理者のみがこれらの設定を読み取りまたは変更できます。メンバーは AI 機能が透過的に動作し続けるのを見ます — ルーティングは彼らには見えません。

マネージドエージェント

BYO Provider を有効にすると、マネージドエージェント実行は完全に独自のプロバイダー上で、独自の認証情報を使って実行されます。Archyl 自身のモデルがフォールバックとして使われることはありません。

プロバイダー マネージドエージェント モデル
Anthropic サポート マネージドエージェント のモデル。未設定なら claude-sonnet-4-6
AWS Bedrock サポート(Anthropic Claude モデル) マネージドエージェント のモデル。未設定なら anthropic.claude-sonnet-4-20250514-v1:0。eu.anthropic.claude-sonnet-4-5-20250929-v1:0 のようなクロスリージョン推論プロファイルも使用できます
OpenAI サポート マネージドエージェント のモデル。未設定なら gpt-5.6-luna
OpenAI 互換 エンドポイントが OpenAI Responses API を実装している場合にサポート マネージドエージェント のモデル — 必須。デフォルトはありません
Google 未サポート —

プロバイダーがエージェントを実行できない場合や、OpenAI 互換エンドポイントにモデルが設定されていない場合、実行の開始は明示的なメッセージとともに失敗します。選んでいないモデルで勝手に実行されることはありません。

トラブルシューティング

「接続テスト」が 401 / 403 で失敗する。 キーが周囲に空白なく正しく貼り付けられていることを再確認してください。Bedrock の場合、形式が <access_key_id>:<secret_access_key>(コロン区切り)であり、リージョンが AWS アカウントでモデルが有効化されているリージョンと一致することを確認してください。

「baseUrl is required for openai_compatible provider」。 ベース URL フィールドは OpenAI 互換アダプターに必須です。API のルートを指す必要があります。例:https://api.openrouter.ai/api/v1 — 末尾に /chat/completions を含めません。

ディスカバリーが無効な JSON を返す。 Archyl のプロンプトは OpenAI の厳格な JSON モードに合わせて調整されています。一部のプロバイダー/モデルは markdown コードフェンス内で JSON を返したり、コメントを追加したりします。ディスカバリー、構造分析、関係性の精緻化 機能には特に、JSON モードの信頼性が高いモデル(例:gpt-4o、claude-sonnet-4-6、gemini-2.0-flash)に切り替えてください — チャットと他の機能はより寛容です。

チャットは機能するが、Bedrock でディスカバリーが失敗する。 一部の Bedrock モデル ID には Provisioned Throughput または特定のクロスリージョン推論プロファイルが必要です。Bedrock コンソールでアカウントに対してモデルが有効になっており、選択したリージョンがモデルの可用性と一致することを確認してください。

関連機能