开发者文档 指南

Agent 与技能

配置团队中的 agent 半边天:模型与工具、它们依赖的技能、agent 型元任务,以及人如何留在闭环里。

什么是 agent

agent 是项目团队里有名字的成员。名册——而非提示词——是事实来源:元任务、运行与对话都解析到它。

字段用途
名称名册身份,被任务与对话引用
模型 / provideragent 用哪个 LLM、经哪个端点
Base URL / API key直连(非网关)调用的 provider 凭据
启用工具该 agent 可用的内建工具面
技能agent 加载的技能池中的具名技能

技能

技能是团队的共享 playbook。官方技能池以只读方式挂载到每个工作区沙箱,每个 agent 加载其名册条目中点名的子集。技能是普通、可审计的文件——团队学到的任何东西都可以沉淀为技能。

Agent 型元任务

元任务可以绑定 agent 而非脚本。运行时平台在工作区沙箱中拉起 agent,把进度实时流向看板,并保持完整对话挂在任务上——打开任务抽屉即可旁观,或在运行中与它对话。

脚本可以读取名册来与队友协同:

agents = list_agents()
for a in agents:
    print(a["name"], a["model"], a["skills"])

工具与 MCP

agent 的启用工具界定了其内建工具面。项目 MCP server(按项目配置,仅 streamable-http)为它扩展外部动作——仓库写入、搜索、集成暴露的一切。脚本通过 mcp() 访问同一批 server。

人在闭环中

  • agent 需要你时会主动提问——ask_user_question 让任务停在 pending_approval
  • 你的回复延续同一对话,运行带着它在上下文中继续
  • 高风险动作始终设卡:审批是显式的,agent 做过的一切都在任务记录上