---
sidebar_position: 1
---

# 智能体设置

本指南介绍如何通过 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：进入设置页面

1. 登录 Wegent Web 界面
2. 点击左侧边栏的 **设置**
3. 选择 **智能体** 标签页

### 步骤 2：创建新智能体

1. 点击 **创建智能体** 按钮
2. 填写基本信息：

| 字段 | 必填 | 说明 |
|------|------|------|
| **名称** | 是 | 智能体的唯一标识符 |
| **显示名称** | 否 | 用户友好的显示名称 |
| **描述** | 否 | 智能体的功能描述 |
| **绑定模式** | 否 | 可用于哪些任务类型（Chat/Code/Knowledge） |

### 步骤 3：添加机器人成员

1. 在 **成员** 部分，点击 **添加成员**
2. 选择一个已配置的机器人
3. 为该成员设置：
   - **成员名称**：在团队中的标识
   - **角色**：Leader（领导者）或 Member（成员）
   - **成员提示词**：该成员在团队中的具体职责

### 步骤 4：选择协作模式

从以下模式中选择：

| 模式 | 说明 | 适用场景 |
|------|------|----------|
| **Solo** | 单个机器人独立工作 | 简单任务、问答 |
| **Pipeline** | 顺序执行，前一个的输出是后一个的输入 | 开发流程、内容生产 |
| **Route** | 领导者根据内容路由到合适的专家 | 客服、技术支持 |
| **Coordinate** | 领导者协调并行执行，汇总结果 | 市场调研、代码审查 |
| **Collaborate** | 所有成员自由讨论，共享上下文 | 头脑风暴、复杂问题 |

### 步骤 5：保存智能体

点击 **保存** 完成创建。智能体将出现在列表中，可以在聊天中使用。

---

## 🔧 配置机器人

### 步骤 1：进入机器人设置

1. 在设置页面，选择 **机器人** 标签页
2. 点击 **创建机器人** 或编辑现有机器人

### 步骤 2：基本配置

| 字段 | 必填 | 说明 |
|------|------|------|
| **名称** | 是 | 机器人的唯一标识符 |
| **显示名称** | 否 | 用户友好的显示名称 |
| **描述** | 否 | 机器人的功能描述 |

### 步骤 3：选择执行器

选择机器人的运行环境：

| 执行器 | 说明 | 适用场景 |
|--------|------|----------|
| **ClaudeCode** | Claude Code SDK，支持代码执行和文件操作 | 代码开发、文件处理 |
| **Agno** | Agno 框架，支持多种协作模式 | 对话、多智能体协作 |
| **Dify** | 外部 Dify API 代理 | Dify 工作流集成 |
| **Chat** | 直接 LLM API（无 Docker） | 轻量级对话 |

### 步骤 4：绑定模型

**方式一：从下拉列表选择（推荐）**
1. 保持 **高级模式** 关闭
2. 从下拉列表中选择已配置的模型

**方式二：高级模式（自定义配置）**
1. 开启 **高级模式**
2. 选择模型协议（OpenAI/Claude/Gemini）
3. 输入 JSON 配置

### 步骤 5：配置提示词

在 **系统提示词** 字段中输入机器人的角色定义：

```
你是一位专业的软件开发工程师，擅长使用 TypeScript 和 React 开发前端应用。

你的职责包括：
1. 编写高质量、可维护的代码
2. 遵循最佳实践和设计模式
3. 提供清晰的代码注释和文档
```

### 步骤 6：配置 MCP 工具（可选）

添加 MCP（Model Context Protocol）服务器以扩展机器人能力：

1. 点击 **添加 MCP 服务器**
2. 配置服务器信息：
   - **名称**：服务器标识
   - **命令**：启动命令（如 `docker`）
   - **参数**：命令参数
   - **环境变量**：所需的环境变量

### 步骤 7：添加 Skills（可选）

为机器人添加技能扩展：

1. 在 **Skills** 部分，点击下拉选择
2. 选择要添加的技能
3. 技能将在任务执行时按需加载

### 步骤 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：为什么我的智能体没有出现在聊天选择器中？

**答**：检查以下几点：
1. 智能体状态是否为"可用"
2. 绑定模式是否包含当前任务类型
3. 智能体是否至少有一个机器人成员

### Q4：如何让机器人使用特定工具？

**答**：
1. 在机器人配置中添加 MCP 服务器
2. 或者添加包含工具的 Skills
3. 在提示词中说明何时使用这些工具

### Q5：协作模式可以在任务执行中切换吗？

**答**：不可以。协作模式在智能体创建时确定，任务执行期间保持不变。如需不同模式，请创建新的智能体。

---

## 🔗 相关资源

### 前置步骤
- [配置模型](./configuring-models.md) - 设置 AI 模型
- [配置执行器](./configuring-shells.md) - 配置运行环境

### 下一步
- [管理任务](../chat/managing-tasks.md) - 创建和执行任务
- [管理 Skills](./managing-skills.md) - 上传和使用技能

### 参考文档
- [核心概念](../../concepts/core-concepts.md) - 理解 Wegent 架构
- [协作模式详解](../../concepts/collaboration-models.md) - 四种协作模式详解
- [YAML 规范](../../reference/yaml-specification.md) - 完整配置格式

---

## 💬 获取帮助

需要帮助？

- 📖 查看 [常见问题](../../faq.md)
- 🐛 提交 [GitHub Issue](https://github.com/AntGroup/Wegent/issues)
- 💬 加入社区讨论

---

<p align="center">配置您的智能体，开启 AI 协作之旅！🚀</p>
