95e0f34d31
Localize the VitePress docs into Simplified Chinese, Spanish, Japanese, French and German (18 pages each), mirroring the existing en/ru structure. - generate the 5 new locales in config.ts from a single strings table (nav, sidebar, search, footer, docFooter, outline, editLink) with locale-prefixed links - rework DocsCardGrid from the binary isRu check to a per-locale map so the home cards render translated copy and prefixed links for every locale
115 lines
8.8 KiB
Markdown
115 lines
8.8 KiB
Markdown
---
|
||
title: プロバイダーとランタイム – Agent Teams ドキュメント
|
||
description: 対応するランタイムパス（Claude Code、Codex、OpenCode）、プロバイダー ID、モデルの命名、マルチプロバイダー戦略、機能チェックについて。
|
||
lang: ja-JP
|
||
---
|
||
|
||
# プロバイダーとランタイム
|
||
|
||
Agent Teams はオーケストレーションとモデルアクセスを分離します。アプリはチーム、タスク、メッセージ、起動状態、レビュー UI を管理し、選択したランタイム／プロバイダーパスが実際のモデル処理を実行します。
|
||
|
||
## アプリが提供するもの
|
||
|
||
Agent Teams が提供するもの:
|
||
|
||
- チームとタスクのオーケストレーション
|
||
- かんばんボード UI
|
||
- チームメイトのメッセージング
|
||
- タスクログ
|
||
- レビュー UI
|
||
- ローカルプロジェクト連携
|
||
- ランタイム検出と機能チェック
|
||
- ローカルログと診断
|
||
|
||
## ランタイムが提供するもの
|
||
|
||
ランタイムが提供するもの:
|
||
|
||
- モデルの実行
|
||
- プロバイダー認証
|
||
- ツール実行の挙動
|
||
- モデル固有のレート制限と機能
|
||
- ランタイム固有のトランスクリプトと配信の証跡
|
||
|
||
## 対応するランタイムパス
|
||
|
||
| ランタイムパス | プロバイダー／モデルのパス | 最適な用途 | 備考 |
|
||
| --- | --- | --- | --- |
|
||
| Claude Code | Anthropic / Claude モデル | Claude Code ユーザーおよび Anthropic を基盤とするワークフロー | Claude チーム向けのデフォルトのローカルファーストパス。ランタイムとアカウントアクセスがローカルで利用可能である必要があります。 |
|
||
| Codex | Codex / OpenAI を基盤とするモデル | Codex ネイティブのワークフロー | Codex ランタイム連携と、利用可能な場合は Codex の認証／アカウント状態を使用します。一部の診断は Claude のトランスクリプトとは異なります。 |
|
||
| OpenCode | OpenCode が管理するモデルルーティング | マルチプロバイダーのチームと広範なモデルカバレッジ | OpenCode は多数のモデルプロバイダーを経由してルーティングできます。Agent Teams は OpenCode のレーンをランタイム固有の証跡として扱い、レーンの識別があいまいな場合は推測を行いません。 |
|
||
|
||
Gemini は、Google ADC（gcloud auth）、Gemini CLI の OAuth、API キー認証を用いた、対応プロバイダーパスとして利用できます。ランタイムが利用可能と報告した場合、チーム作成およびランタイム設定の UI で他のプロバイダーと並んで表示されます。
|
||
|
||
## プロバイダー ID
|
||
|
||
アプリは現在、チーム／ランタイム設定で次のプロバイダー ID を認識します:
|
||
|
||
| プロバイダー ID | 表示の意図 |
|
||
| --- | --- |
|
||
| `anthropic` | Anthropic / Claude Code パス |
|
||
| `codex` | Codex パス |
|
||
| `gemini` | Gemini プロバイダーパス（Google ADC、Gemini CLI、または API キー） |
|
||
| `opencode` | OpenCode パス（OpenCode が管理するプロバイダールーティングを含む） |
|
||
|
||
この表を、すべてのプロバイダーがすべてのマシン上のすべてのモデルについて認証済み・インストール済み・利用可能であることの保証として読まないでください。特定の起動については、ランタイムのステータスと機能チェックが信頼できる情報源です。
|
||
|
||
## モデル ID
|
||
|
||
モデル ID は選択したランタイムに渡されます。Agent Teams はプロバイダーのモデルカタログを汎用的な命名スキームに書き換えることはありません。
|
||
|
||
例:
|
||
|
||
| プロバイダーパス | モデル ID の例 | 備考 |
|
||
| --- | --- | --- |
|
||
| Claude Code | `opus`、`sonnet`、または Claude モデルの完全な ID | 利用可否は Claude Code とアカウントアクセスに依存します |
|
||
| Codex | `gpt-5.4`、`gpt-5.3-codex` | 利用可否は Codex のアカウント／ランタイム状態に由来します |
|
||
| OpenCode | `openrouter/moonshotai/kimi-k2.6` | プレフィックスは OpenCode のプロバイダー設定と一致している必要があります |
|
||
|
||
モデル名が拒否される場合は、まずランタイム／プロバイダーで直接確認してください。チームブリーフを変更しても、利用不可のモデルを起動できるようにはなりません。
|
||
|
||
## マルチプロバイダー戦略
|
||
|
||
Agent Teams はオーケストレーションをプロバイダーを意識したものに保ちますが、プロバイダーに所有されることはありません:
|
||
|
||
- チーム、タスク、受信トレイ、コメント、レビュー状態、起動診断はローカルの Agent Teams ストレージに保持されます
|
||
- 各メンバーはチーム起動メタデータを通じてプロバイダー／モデル設定を保持できます
|
||
- モデルの利用可否、認証、レート制限、ツールの挙動はランタイム／プロバイダーの責務のままです
|
||
- 1 つのチームで複数のプロバイダー／モデルレーンを使用したい場合、OpenCode が最も広範なルーティングパスです
|
||
|
||
コントリビューター向けの境界と正規の実装ガイダンスについては、[コントリビューター向けアーキテクチャ](/ja/reference/contributor-architecture)を参照してください。
|
||
|
||
推奨パターン:
|
||
|
||
| パターン | 役立つ場面 | リスク |
|
||
| --- | --- | --- |
|
||
| すべてのメンバーに 1 つのプロバイダー | 初回の起動、機密性の高いリポジトリ、最もシンプルなデバッグ | 共有のレート制限がチーム全体を停止させる可能性があります |
|
||
| 強力なリード + 安価なビルダー | 実装コストを抑えつつ、計画／レビューの信頼性を維持する | ビルダーの出力にはより厳格なレビューが必要になる場合があります |
|
||
| ビルダーとレビュアーでモデルを分ける | モデル固有の見落としを捕捉する | セットアップと確認すべき帰属がより多くなります |
|
||
|
||
## プロバイダーのコスト
|
||
|
||
Agent Teams は無料でオープンソースです。同梱の無料モデルを使えば、認証なしで始められます。登録も API キーもクレジットカードも不要です。有料またはアカウントを基盤とするプロバイダーの利用は、選択したランタイム／プロバイダーによって管理されます。サブスクリプションの制限、API キー、アカウント認証、レート制限、プロバイダーのポリシーはすべて、アプリの外部に残ります。
|
||
|
||
## 機能チェック
|
||
|
||
セットアップ中、アプリはアクセスおよび機能のチェックを実行する場合があります。これは、チームの起動がプロビジョニングの途中で失敗する前に、不足しているランタイム認証を検出するのに役立ちます。
|
||
|
||
機能チェックは、プロバイダーは存在するが認証されていないこと、モデルリストが利用できないこと、ランタイムパスが見つからないこと、または特定の拡張機能がサポートされていないことを報告できます。それらの結果は、タスクの失敗ではなく、セットアップの診断として扱ってください。
|
||
|
||
一般的なセットアップの修正方法:
|
||
|
||
| チェック結果 | 対処方法 |
|
||
| --- | --- |
|
||
| ランタイムが見つからない | CLI をインストールするか、`PATH` を修正します |
|
||
| プロバイダーが未認証 | プロバイダーのログインフローを実行するか、必要な API キーを追加します |
|
||
| モデルが利用不可 | そのランタイムのモデルリストに表示されているモデルを選択します |
|
||
| 機能がサポートされていない | そのチームメイトには別のランタイムパスを使用します |
|
||
|
||
## 想定すべき制限
|
||
|
||
- ランタイムがサポートされているからといって、Claude Code、Codex、OpenCode の間で同等の機能パリティがあるとは限りません。
|
||
- ログとトランスクリプトのカバレッジはランタイムによって異なります。
|
||
- OpenCode のレーンは、アプリがランタイムログを安全に帰属させられるようになる前に、安定したレーン／セッションの証跡を必要とします。
|
||
- プロバイダーのモデル名と利用可否は、アプリの外部で変わる可能性があります。
|
||
- チームのプロンプトでは、不足している認証、不足している PATH エントリ、プロバイダーの障害、枯渇したレート制限を修正することはできません。
|