概念
本页定义了贯穿 Agent Teams 的核心术语。请将其作为应用、任务看板、消息与审查流程的共享词汇表。
团队
团队是附属于某一项目路径的一组具名智能体。它包含一个 lead、可选的 teammate、运行时/提供方设置、prompt、收件箱、任务以及本地启动状态。
Lead
lead 是团队的协调者。它将用户目标转化为任务,分配或重新调度 teammate,跟踪阻塞项,请求审查,并推动工作在看板上不断流转。
lead 消息使用与 teammate 消息不同的投递路径:应用会将 lead 收件箱中的条目转发到 lead 运行时,而 teammate 则在两轮之间读取它们各自的收件箱文件。
Teammate
teammate 是团队中的非 lead 智能体。teammate 通常承担聚焦的角色,例如构建者、审查者、研究者或测试者。teammate 可以接收直接消息、任务分配、任务评论和审查请求。
任务
任务是持久的工作单元。它具有 id、状态、负责人、描述、评论、日志、附件、任务引用以及可审查的变更。
常见的任务状态有 todo、in_progress、done、review 和 approved。在内部,任务文件存储工作状态,而审查与审批的位置也可以使用看板叠加状态。
看板
看板是团队工作的看板视图。它让你能够按状态浏览任务、打开任务详情、检查日志、审查 diff、审批已完成的工作,或请求更改。
收件箱
收件箱是团队参与者的本地消息文件。Agent Teams 将收件箱用于用户消息、lead 消息、teammate 消息、运行时投递元数据、跨团队消息以及部分系统通知。
消息是持久的本地记录。投递仍然取决于所选运行时处于活动状态并能够处理其下一轮。
Agent Block
agent block 是用 <info_for_agent>...</info_for_agent> 包裹的隐藏的、仅供智能体使用的指令文本。UI 会在面向人类的常规显示中剥离这些块,但智能体与运行时投递可以将它们用于协调细节。
当前的规范标记是 info_for_agent。较旧的文档可能使用带有 info_for_agent 标记的围栏代码块,或 XML 风格的 <agent_block> 标签——这些都是遗留模式,遇到时应迁移为 info_for_agent。(原始标签名为 agent-block;下划线形式 <agent_block> 在 VitePress 源文件中使用,以避免 HTML 解析。)
上下文阶段
上下文阶段是会话上下文时间线中的一个片段。压缩会开启一个新阶段,因此可以分析重置前后的 token 与上下文用量。
上下文跟踪会区分不同类别,例如项目指令、提及的文件、工具输出、思考文本、团队协调与用户消息。这些数字是诊断信息,而非提供方的计费账单。
运行时
运行时是运行某一智能体轮次的本地执行路径。受支持的运行时路径包括 Claude Code、Codex 和 OpenCode。
运行时掌控模型执行行为、认证细节、工具执行语义、速率限制、模型可用性,以及部分转录/日志格式。
提供方
提供方是运行时背后的模型访问路径。当前的提供方 id 包括 Anthropic、Codex、Gemini 和 OpenCode。OpenCode 可以通过其自身配置路由到许多模型提供方。
Agent Teams 编排任务与消息,但它不会取代提供方的认证或提供方的策略。
Solo 模式
Solo 模式运行一个单成员团队。它适用于快速工作、降低协调开销,以及在扩展为完整团队之前验证某个 prompt。
跨团队通信
智能体可以在团队内部以及跨团队发送消息。当不同团队负责相关工作并需要在不把所有内容合并成一个庞大团队的前提下进行协调时,可以使用这一功能。
自主级别
自主级别控制智能体在询问之前能够做多少事情。更高的自主级别更快;更低的自主级别对于敏感的代码路径、持久化、提供方认证、Git 操作与发布更为安全。
审查
审查是以任务为范围的验收流程。任务可以进入 review,接收评论或请求的更改,然后在结果被接受时进入 approved。
审查与本地 diff 及任务历史绑定,因此当任务保持聚焦、且智能体提及它们正在处理的任务时,效果最佳。
