河蟹 AI 文档
Agent 管理
创建自定义 AI 角色、配置系统提示词和工具，启用多 Agent 会议。
什么是 Agent
Agent 是河蟹 AI 中的 AI 角色。每个 Agent 拥有独立的：
- 系统提示词（System Prompt）— 定义角色的行为和专业能力
- 模型选择 — 可以指定使用哪个 AI 模型
- 温度参数 — 控制创造力 vs 确定性
- 工具集 — 分配 MCP 工具给特定 Agent
- 技能集 — 启用已安装的技能
创建 Agent
- 进入 Agent 管理 页面
- 点击 "创建 Agent"
- 填写名称、描述、系统提示词
- （可选）选择绑定模型、设置温度、分配工具和技能
- 保存
示例：创建一个 "前端专家" Agent，System Prompt 设为 "你是一位资深前端工程师，精通 Vue 3、TypeScript、TailwindCSS..."，温度设为 0.3。
Agent 属性
| 属性 | 说明 |
|---|---|
| name | 英文标识符，唯一 |
| display_name | 显示名称 |
| description | 简短描述 |
| system_prompt | 系统提示词，定义角色行为 |
| model | 绑定的模型（留空则使用默认模型） |
| temperature | 生成温度 0~2（默认 0.7） |
| tools[] | 可用的 MCP 工具列表 |
| skills[] | 启用的技能列表 |
| status | active / inactive |
使用 Agent 聊天
在对话页面，点击输入框上方的 Agent 选择器切换角色。选中的 Agent 的系统提示词会自动注入到对话中。
多 Agent 会议
河蟹 AI 支持 多 Agent 协作讨论 模式：
- 在 Agent 管理页面点击 "Agent 会议"
- 选择参与讨论的多个 Agent
- 输入议题，多个 Agent 会轮流发言、讨论、总结
适用场景：技术方案评审、多角度分析问题、头脑风暴。
角色详情
在角色列表中点击任意角色卡片，可展开查看完整信息：
- 背景设定 — Agent 的角色背景和专长描述
- 工具列表 — 该角色可调用的工具/技能
- 约束条件 — Agent 执行任务时需遵守的限制
快速开始对话
在角色卡片上点击"聊天"按钮：
- 自动新建一个以角色名命名的会话（如"数据分析师"）
- 聊天模式自动切换为 Agent
- 后续再次点击同一角色，会定位到已有的会话而非重复新建
Agent 路由管理
在 Agent 路由 标签页管理 Agent 的模型绑定：
- 注册 — 指定 Agent 使用的 Provider 和模型
- 编辑 — 点击 ✏️ 修改已注册 Agent 的显示名、Provider、模型
- 注销 — 移除 Agent 路由绑定
提示：注册和编辑时，名称、Provider、模型三个字段都不能为空。
角色定义参考
Agent 角色在后端 hexclaw.yaml 中定义，也可通过 API 动态注册：
roles:
- name: researcher
title: 研究助手
goal: 深度调研指定主题并生成结构化报告
backstory: 你是一位资深研究员，擅长信息检索和分析
tools:
- web_search
- file_write
- summary
constraints:
- 引用来源必须标注
- 报告字数不少于 1000 字