智能体设置
本指南介绍如何通过 Web 界面配置智能体(Agent)、机器人(Bot)、提示词和协作模式。
📋 目录
🎯 概念概述
核心关系
智能体 (Agent/Team) = 机器人(Bot) + 协作模式
机器人 (Bot) = 执行器 (Shell) + 模型 (Model) + 提示词 (Prompt) + MCP 工具 + Skills
术语对照
| 代码/CRD 层 | 前端界面(中文) | 前端界面(英文) | 说明 |
|---|---|---|---|
| Team | 智能体 | Agent | 用户直接交互的 AI 助手 |
| Bot | 机器人 | Bot | 组成智能体的构建块 |
架构图
┌─────────────────────────────────────────────────────────┐
│ 智能体 (Agent/Team) │
│ ┌─────────────────────────────────────────────────┐ │
│ │ 协作模式 │ │
│ │ (Solo / Pipeline / Route / Coordinate / Collaborate) │
│ └─────────────────────────────────────────────────┘ │
│ │ │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ 机器人 1 │ │ 机器人 2 │ │ 机器人 N │ │
│ │ (Bot) │ │ (Bot) │ │ (Bot) │ │
│ └──────────┘ └──────────┘ └──────────┘ │
└─────────────────────────────────────────────────────────┘
🚀 创建智能体
步骤 1:进入设置页面
- 登录 Wegent Web 界面
- 点击左侧边栏的 设置
- 选择 智能体 标签页
步骤 2:创建新智能体
- 点击 创建智能体 按钮
- 填写基本信息:
| 字段 | 必填 | 说明 |
|---|---|---|
| 名称 | 是 | 智能体的唯一标识符 |
| 显示名称 | 否 | 用户友好的显示名称 |
| 描述 | 否 | 智能体的功能描述 |
| 绑定模式 | 否 | 可用于哪些任务类型(Chat/Code/Knowledge) |
步骤 3:添加机器人成员
- 在 成员 部分,点击 添加成员
- 选择一个已配置的机器人
- 为该成员设置:
- 成员名称:在团队中的标识
- 角色:Leader(领导者)或 Member(成员)
- 成员提示词:该成员在团队中的具体职责
步骤 4:选择协作模式
从以下模式中选择:
| 模式 | 说明 | 适用场景 |
|---|---|---|
| Solo | 单个机器人独立工作 | 简单任务、问答 |
| Pipeline | 顺序执行,前一个的输出是后一个的输入 | 开发流程、内容生产 |
| Route | 领导者根据内容路由到合适的专家 | 客服、技术支持 |
| Coordinate | 领导者协调并行执行,汇总结果 | 市场调研、代码审查 |
| Collaborate | 所有成员自由讨论,共享上下文 | 头脑风暴、复杂问题 |
步骤 5:保存智能体
点击 保存 完成创建。智能体将出现在列表中,可以在聊天中使用。
🔧 配置机器人
步骤 1:进入机器人设置
- 在设置页面,选择 机器人 标签页
- 点击 创建机器人 或编辑现有机器人
步骤 2:基本配置
| 字段 | 必填 | 说明 |
|---|---|---|
| 名称 | 是 | 机器人的唯一标识符 |
| 显示名称 | 否 | 用户友好的显示名称 |
| 描述 | 否 | 机器人的功能描述 |
步骤 3:选择执行器
选择机器人的运行环境:
| 执行器 | 说明 | 适用场景 |
|---|---|---|
| ClaudeCode | Claude Code SDK,支持代码执行和文件操作 | 代码开发、文件处理 |
| Agno | Agno 框架,支持多种协作模式 | 对话、多智能体协作 |
| Dify | 外部 Dify API 代理 | Dify 工作流集成 |
| Chat | 直接 LLM API(无 Docker) | 轻量级对话 |
步骤 4:绑定模型
方式一:从下拉列表选择(推荐)
- 保持 高级模式 关闭
- 从下拉列表中选择已配置的模型
方式二:高级模式(自定义配置)
- 开启 高级模式
- 选择模型协议(OpenAI/Claude/Gemini)
- 输入 JSON 配置
步骤 5:配置提示词
在 系统提示词 字段中输入机器人的角色定义:
你是一位专业的软件开发工程师,擅长使用 TypeScript 和 React 开发前端应用。
你的职责包括:
1. 编写高质量、可维护的代码
2. 遵循最佳实践和设计模式
3. 提供清晰的代码注释和文档
步骤 6:配置 MCP 工具(可选)
添加 MCP(Model Context Protocol)服务器以扩展机器人能力:
- 点击 添加 MCP 服务器
- 配置服务器信息:
- 名称:服务器标识
- 命令:启动命令(如
docker) - 参数:命令参数
- 环境变量:所需的环境变量
步骤 7:添加 Skills(可选)
为机器人添加技能扩展:
- 在 Skills 部分,点击下拉选择
- 选择要添加的技能
- 技能将在任务执行时按需加载
步骤 8:保存机器人
点击 保存 完成配置。
🤝 协作模式
Solo 模式
最简单的模式,单个机器人独立处理任务。
用户请求 → 机器人 → 响应
适用场景:
- 简单问答
- 单一任务处理
- 快速原型
Pipeline 模式
机器人按顺序执行,形成处理流水线。
用户请求 → 机器人1 → 机器人2 → 机器人3 → 响应
适用场景:
- 代码开发流程(开发 → 审查 → 测试)
- 内容生产(写作 → 编辑 → 发布)
- 数据处理管道
Route 模式
领导者分析请求并路由到合适的专家。
用户请求 → 领导者 → {专家A | 专家B | 专家C} → 响应
适用场景:
- 技术支持(前端/后端/数据库专家)
- 客户服务(销售/售后/投诉)
- 多语言编程问答
Coordinate 模式
领导者分解任务,并行分配给多个专家,然后汇总结果。
用户请求 → 领导者(分解) → [专家A, 专家B, 专家C] → 领导者(汇总) → 响应
适用场景:
- 市场调研(竞品分析 + 用户研究 + 趋势分析)
- 代码审查(安全 + 性能 + 质量)
- 综合报告生成
Collaborate 模式
所有机器人共享上下文,自由讨论。
用户请求 → [机器人A ↔ 机器人B ↔ 机器人C] → 共识响应
适用场景:
- 头脑风暴
- 复杂问题诊断
- 创新产品设计
✨ 最佳实践
1. 提示词设计
好的提示词结构:
1. 角色定义:你是一位 [角色]...
2. 职责说明:你的职责包括...
3. 输入描述:你将收到...
4. 输出要求:请以 [格式] 输出...
5. 质量标准:确保 [质量要求]...
2. 机器人专业化
- 每个机器人专注于单一领域
- 避免创建"万能"机器人
- 通过团队协作组合能力
3. 协作模式选择
| 任务特点 | 推荐模式 |
|---|---|
| 简单、单一 | Solo |
| 有固定流程 | Pipeline |
| 需要专业分工 | Route |
| 需要多角度分析 | Coordinate |
| 需要创意讨论 | Collaborate |
4. 团队规模
- Solo:1 个机器人
- Pipeline:3-6 个机器人
- Route:1 个领导者 + 3-8 个专家
- Coordinate:1 个领导者 + 3-5 个专家
- Collaborate:3-8 个机器人
⚠️ 常见问题
Q1:智能体和机器人有什么区别?
答:
- 机器人(Bot):单个 AI 工作单元,包含执行器、模型和提示词
- 智能体(Agent/Team):由一个或多个机器人组成的"工作团队",是用户直接交互的对象
Q2:如何选择执行器?
答:
- ClaudeCode:需要代码执行、文件操作、Git 集成时使用
- Agno:需要多智能体协作、对话交互时使用
- Dify:需要与 Dify 平台集成时使用
- Chat:只需要简单对话,不需要工具调用时使用
Q3:为什么我的智能体没有出现在聊天选择器中?
答:检查以下几点:
- 智能体状态是否为"可用"
- 绑定模式是否包含当前任务类型
- 智能体是否至少有一个机器人成员
Q4:如何让机器人使用特定工具?
答:
- 在机器人配置中添加 MCP 服务器
- 或者添加包含工具的 Skills
- 在提示词中说明何时使用这些工具
Q5:协作模式可以在任务执行中切换吗?
答:不可以。协作模式在智能体创建时确定,任务执行期间保持不变。如需不同模式,请创建新的智能体。
🔗 相关资源
前置步骤
下一步
参考文档
💬 获取帮助
需要帮助?
- 📖 查看 常见问题
- 🐛 提交 GitHub Issue
- 💬 加入社区讨论
配置您的智能体,开启 AI 协作之旅!🚀