快速开始
本指南带你从全新安装走到一个会自己组建团队的 lead Agent。主要使用 Web 控制台；最后的 CLI 部分展示在终端中的同样步骤。
开始之前，先安装 agt，用 agt web 启动控制台，并打开它打印的完整链接。
1. 接入模型
在左侧栏打开资源库，点击新建资源。
- 创建一个 Provider：名称、接口的 base URL（例如
https://api.openai.com/v1）和 API Key。 - 在该 Provider 上创建一个 Model。点击获取模型列表从 Provider 提供的模型中选择，或直接填写模型名。选择 Provider 对该模型支持的 API：Chat Completions 或 Responses。保持工具调用开启。
所有选项见接入模型。
2. 选择工具调用的审批方式
默认情况下，Agent 每一次会修改数据或访问 agt 外部的工具调用都要等待审批；读取 agt 自身数据（例如消息记录、任务）不需要审批。打开运行设置 → 工具权限审批，设置 Native 权限审核策略：
| 模式 | 适用场景 |
|---|---|
| 模型审核，异常转人工 | 由审核模型批准常规调用，有疑问的转给你。在审核模型中选择第 1 步创建的模型。 |
| 人工审批 | 每次调用都由你批准。最安全，但 lead 的调用很多。 |
| 自动放行 | 不审批。只适合在可随时丢弃的 home 中做实验。 |
没有配置审核模型时，模型审核会转为人工审批。待审批的请求显示在会话输入框上方，可以在那里批准或拒绝。见权限审批。
3. 创建 lead
打开 Agent 团队，点击创建 Agent：
- 资源名称 / 身份 ID：
lead - 执行方式：AGT 内置，选择第 1 步的模型
- 角色 Prompt：使用已有 Prompt，选择
default/lead - 框架内置工具：勾选资源管理和任务协作
- 响应策略：保持私聊 / 群内被提及
保存后会创建 Agent 定义、聊天身份和启用它的绑定，lead 就可以对话了。
4. 给它一个目标
点击新建会话，选择和 lead 私聊，描述你想要的结果，例如：
为这个仓库组建一个两人代码审查小组：一人关注正确性，一人关注可读性。把他们和我拉进一个群，让他们审查最近的改动。
保持发送后自动回复开启。发送即授权 Agent 运行，会调用你的模型并产生费用。
lead 会先查看已有资源，然后编写角色 Prompt、创建并启用每个队友、建群并向团队布置任务。在它工作时：
- 输入框上方的执行横条显示每个正在运行的 Agent 及其工具调用。
- 如果选择了人工审批，待审批请求也会出现在那里。
- Agent 团队会随着创建列出新的队友。点击某个队友可以查看它的配置、状态和最近执行。
- 打开右上角的调试模式，可以看到执行 ID 和错误码。
5. 让它自己造工具
如果有可用的 Codex Agent，lead 还能自己造工具。让它做一件需要新工具的事，例如为桌游或某个数据源写一个小型 MCP 服务。lead 会把代码交给 Codex Agent 编写，把结果注册为 MCP 服务，测试它能正常启动，再挂载给需要它的 Agent。见让 lead 组建团队。
用 CLI 完成同样的事
控制台的所有操作都经过 agt CLI。下面的例子手动创建一个审查 Agent 并和它对话；lead 通过工具完成的也是这些步骤。
export MODEL_API_KEY=sk-...
agt provider create main --base-url https://api.openai.com/v1 --api-key-env MODEL_API_KEY
agt model create fast --provider main --model gpt-5-mini --api-format responses --tool-call true
agt prompt create reviewer --text '你负责审查代码改动。没有需要补充的内容时，只回复 [[silent]]。'
agt agent create reviewer --model fast --prompt reviewer
# 聊天身份：你自己和 Agent，然后启用 Agent
agt im principal create me --name Me
agt tool call --principal me --manager principal_create --args '{"id":"reviewer","name":"Reviewer","kind":"agent"}'
agt tool call --principal me --manager agent_bind --args '{"principal":"reviewer","agent":"reviewer"}'
# 打开私聊并发送消息
agt tool call --principal me direct_create --args '{"principal":"reviewer"}'
agt tool call --principal me message_send --args '{"conversation":"<会话 ID>","body":"请审查 src/main.rs","request_key":"hello-1"}'
# 授权讨论并运行调度器
agt schedule start <会话 ID>
agt schedule run --watch在另一个终端用 agt tool call --principal me message_history --args '{"conversation":"<会话 ID>"}' 查看回复。所有命令和参数见模块页。