[ PROMPT_NODE_23866 ]
managed-agents-onboarding
[ SKILL_DOCUMENTATION ]
# 智能体 — 入门流程
> **通过 `/claude-api managed-agents-onboard` 调用?** 您找对地方了。运行下面的访谈——不要向用户总结,直接提问。
当用户想要从零开始设置一个智能体时使用此流程。三个步骤:**分支选择(已知 vs 探索)→ 配置模板 → 设置会话**。最后输出可运行的代码。
> 同时阅读 `shared/managed-agents-core.md` — 它包含了每个配置项的详细信息。本文档是访谈脚本,而非参考手册。
---
Claude 智能体是一个托管智能体:Anthropic 在其编排层运行智能体循环,并为每个会话提供一个沙盒容器,智能体的工具就在其中执行。您提供智能体配置和环境配置;框架——事件流、沙盒编排、提示词缓存、上下文压缩和扩展思考——都由系统为您处理。
**您需要提供:**
- **智能体配置** — 工具、技能、模型、系统提示词。可重用且有版本控制。
- **环境配置** — 智能体工具执行的沙盒(网络、包)。可在不同智能体间重用。
智能体的每次运行都是一个**会话**。
---
## 1. 已知还是探索?
询问用户:
> 您是否已经知道想要构建什么样的智能体,还是希望先探索一些常见的模式?
### 探索路径 — 展示模式
四种形态,相同的运行时代码路径 (`sessions.create()` → `sessions.events.send()` → 流式传输)。只有触发器和接收端不同。
| 模式 | 触发器 | 示例 |
|---|---|---|
| 事件触发 | Webhook | GitHub PR 推送 → CMA (GitHub 工具) → Slack | # <------ MC 是否删除?
| 定时任务 | Cron | 每日简报:浏览器 + GitHub + Jira → CMA → Slack | # <------ MC 是否删除?
| 即发即弃 PR | 人工 | Slack 斜杠命令 → CMA (GitHub 工具) → PR 通过 CI |
| 研究 + 仪表盘 | 人工 | 主题 → CMA (网页搜索 + `frontend-design` 技能) → HTML 仪表盘 |
询问哪种形态适合,然后使用它作为参考继续“已知路径”。
### 已知路径 — 配置模板
三轮。每轮批量提问;不要一次只问一个。
**A 轮 — 工具。** 从这里开始;这是最具体的部分。三种类型;询问用户想要哪种(任意组合):
| 类型 | 说明 | 如何引导 |
|---|---|---|
| **预构建 Claude 智能体工具** (`agent_toolset_20260401`) | 开箱即用:`bash`, `read`, `write`, `edit`, `glob`, `grep`, `web_fetch`, `web_search`。一次性启用全部,或通过以下方式单独启用