创建和配置智能体
只有两个必填项——名称和运行方式——其他可选项都值得了解。
创建一个智能体只需要两件事:一个名称和一款 AI 编程工具。其余的——系统指令、模型、环境变量、可见性、并发——全部可选,且随时可改。先跑起来,再慢慢调。
选择 AI 编程工具
每个智能体使用一个已连接 runtime 提供的 AI 编程工具。对于 local runtime,工具安装在目标机器上;remote 和 cloud 则由对应的运行节点提供。最常见的选择:
| 工具 | 适合 |
|---|---|
| Claude Code | Anthropic 官方工具,功能最完整;首选 |
| Codex | OpenAI 出品,主流备选 |
| Cursor | Cursor 编辑器生态用户 |
| Copilot | 想用上 GitHub 账号额度的团队 |
| CodeBuddy | 使用腾讯 Claude Code 兼容 CLI 的团队 |
另外还支持多款 provider。实际可选择的工具由你已连接的 runtime 返回,创建页面会展示当前可用的选项;不要把某一份固定列表当成产品契约。
写系统指令
系统指令会附加到每个任务前面——告诉智能体它扮演什么角色、遵守什么规则:
你是一个前端代码评审智能体。收到 issue 后先读 diff,只关注:
- 样式问题(tailwind 类名、盒模型)
- 无障碍(a11y)
不要改代码——把建议留在评论里。留空则智能体使用底层工具的原生行为,不加额外约束。
模型与运行方式设置
- 模型——多数工具支持选模型(比如 Claude Code 可以在 Sonnet 和 Opus 之间选)。留空用工具默认值。改模型只影响新任务;已派发的任务按派发时锁定的模型跑完。
- 并发上限——这个智能体同时能跑多少个任务(默认 6)。到上限的新任务排队等待而不是被拒绝。修改它不会打断正在运行的任务。
自定义环境变量
自定义环境变量在任务执行时注入——典型用途是 API Key 或切换上游端点:
ANTHROPIC_API_KEY = sk-...
ANTHROPIC_BASE_URL = https://my-proxy.example.com系统关键变量(PATH、HOME、USER、SHELL,以及所有 WUJIE_ 开头的)不能覆盖。
环境变量的键可以随智能体配置展示,但值只有这个智能体的 owner 能读取。admin 不会自动获得绕过 owner 限制的权限。即便如此,也不要放高价值机密:给智能体用专用的、最小权限的凭证,并定期轮换。
可见性
- workspace——工作区成员可以在工作流中使用它
- private(默认)——只有这个智能体的 owner 可以触发它
智能体配置对所有工作区成员仍然可见——名字、描述和可见性不会因为 private 而从列表里消失。private 限制的是触发执行,不是发现它的能力。
智能体的编辑、归档和恢复由 owner 负责;workspace admin 不会绕过这个 owner 限制。任何成员都可以复制一个可复制的智能体,复制后的智能体归复制者所有。
Skills
智能体可以挂 Skills——知识包(SKILL.md 加配套文件),在任务执行时投递给 AI 编程工具。可以挂任意多个;编辑内容只对新建任务生效。
归档与恢复
不再使用的智能体可以归档——从日常视图消失,历史数据完整保留,随时可恢复。
归档会立刻取消这个智能体所有未完成的任务——运行中、已派发、排队中的一律取消。有重要任务在跑就先等它跑完。
下一步
- Skills——挂上知识包
- 分配 issue 给智能体——让新智能体上岗