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
5.7 KiB
Markdown
115 lines
5.7 KiB
Markdown
---
|
||
title: 提供方与运行时 – Agent Teams 文档
|
||
description: 受支持的运行时路径（Claude Code、Codex、OpenCode）、提供方 ID、模型命名、多提供方策略以及能力检查。
|
||
lang: zh-Hans
|
||
---
|
||
|
||
# 提供方与运行时
|
||
|
||
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 存储中
|
||
- 每位成员都可以通过团队启动元数据携带提供方/模型设置
|
||
- 模型可用性、身份验证、速率限制和工具行为仍由运行时/提供方负责
|
||
- 当你希望让一个团队使用多条提供方/模型通道时，OpenCode 是覆盖面最广的路由路径
|
||
|
||
关于面向贡献者的边界以及规范的实现指南，请参阅[贡献者架构](/zh/reference/contributor-architecture)。
|
||
|
||
推荐模式：
|
||
|
||
| 模式 | 何时有帮助 | 风险 |
|
||
| --- | --- | --- |
|
||
| 所有成员使用同一个提供方 | 首次启动、敏感仓库、最简单的调试 | 共享的速率限制可能让整个团队停摆 |
|
||
| 强 lead + 更廉价的 builder | 在降低实现成本的同时保持规划/审查的可靠性 | builder 的产出可能需要更严格的审查 |
|
||
| 分别使用 builder 和 reviewer 模型 | 捕捉特定于模型的盲点 | 需要更多设置，并需检查更多归属信息 |
|
||
|
||
## 提供方成本
|
||
|
||
Agent Teams 免费且开源。你可以从内置的免费模型开始，无需身份验证——无需注册、API 密钥或信用卡。付费或基于账户的提供方使用由你所选择的运行时/提供方管理：订阅额度、API 密钥、账户认证、速率限制和提供方政策都仍然外置于应用之外。
|
||
|
||
## 能力检查
|
||
|
||
在设置过程中，应用可能会执行访问与能力检查。这有助于在团队启动于预配中途失败之前，检测出缺失的运行时认证。
|
||
|
||
能力检查可能会报告：某个提供方存在但未认证、模型列表不可用、缺少某条运行时路径，或某项特定的扩展能力不受支持。请将这些结果视为设置诊断，而非任务失败。
|
||
|
||
典型的设置修复：
|
||
|
||
| 检查结果 | 应采取的措施 |
|
||
| --- | --- |
|
||
| 缺少运行时 | 安装 CLI 或修复 `PATH` |
|
||
| 提供方未认证 | 运行提供方登录流程或添加所需的 API 密钥 |
|
||
| 模型不可用 | 选择该运行时模型列表中可见的模型 |
|
||
| 能力不受支持 | 为该队友改用另一条运行时路径 |
|
||
|
||
## 应预期的限制
|
||
|
||
- 受支持运行时并不意味着 Claude Code、Codex 和 OpenCode 之间具有同等的功能对等性。
|
||
- 日志和转录的覆盖范围因运行时而异。
|
||
- 在应用能够安全归属运行时日志之前，OpenCode 通道需要稳定的通道/会话凭证。
|
||
- 提供方的模型名称与可用性可能在应用之外发生变化。
|
||
- 团队提示词无法修复缺失的认证、缺失的 PATH 条目、提供方中断或耗尽的速率限制。
|