智能体管理
智能体(Agent)是 Snail AI 平台的核心模块,用于创建、配置和管理 AI 助手。每个智能体可以绑定不同的模型、知识库、MCP 工具、Skill 技能、记忆体系等能力,形成面向具体业务场景的对话服务单元。
核心概念
智能体并非一个简单的"聊天机器人",而是一个可编排、可观测、可分发的 AI 服务实体。它具有以下特征:
- 独立身份:每个智能体拥有唯一 ID、名称、头像和描述,便于在组织内识别和管理。
- 能力可组合:通过绑定 RAG 知识库、MCP 服务、Skill 技能等模块,按需组合不同能力。
- 分布式执行:智能体的实际推理可路由到不同的执行应用(Agent Client),通过 gRPC 双向流实现 Server-Agent 分离部署。
- 全链路可观测:每次对话均产生 Trace,支持 Langfuse 风格的瀑布图分析和评分。
智能体生命周期
一个智能体从创建到持续运营,经历以下阶段:
创建 → 配置 → 发布 → 对话 → 监控 → 迭代| 阶段 | 说明 | 对应文档 |
|---|---|---|
| 创建 | 通过 AI 辅助流式创建、手动表单填写或模板快速创建智能体 | 创建智能体 |
| 配置 | 设定系统提示词、绑定知识库、MCP、Skill、选择模型、配置记忆等 | 配置智能体 |
| 发布 | 保存配置后即可使用;可设为精选推荐或发布到智能体市场 | 智能体市场 |
| 对话 | 通过内置对话界面与智能体交互,支持流式输出和思维链展示 | 对话交互 |
| 监控 | 查看活跃用户数、对话量、消息趋势、工具调用次数等分析数据 | — |
| 迭代 | 根据监控数据和实际反馈持续优化提示词、知识库和工具配置 | — |
能力矩阵
下表列出了智能体可绑定和启用的全部能力模块:
| 能力模块 | 说明 | 是否可多选 | 备注 |
|---|---|---|---|
| 对话模型 | 选择 CHAT 类型的大语言模型作为推理引擎 | 单选 | 支持 OpenAI、Claude、Ollama、Gemini、火山引擎等 |
| RAG 知识库 | 绑定一个 RAG 知识库,使智能体具备基于文档的问答能力 | 单选 | 支持向量 + BM25 混合检索 |
| MCP 服务 | 绑定一个或多个 MCP 工具服务器,赋予智能体外部工具调用能力 | 多选 | 支持 SSE/Streamable HTTP/Stdio 三种协议 |
| Skill 技能 | 绑定预定义的技能脚本,扩展智能体的结构化处理能力 | 多选 | 技能由管理员预先配置和维护 |
| 记忆 | 启用短期记忆(滑动窗口)和长期记忆(向量召回),使对话具有上下文延续性 | — | 可配置滑动窗口大小(默认 20 条) |
| 联网搜索 | 启用 Web Search,允许智能体实时检索互联网信息 | — | 开关式启用 |
| 执行应用 | 指定智能体的实际执行 Agent Client 应用 | 单选 | 用于分布式路由场景 |
| 精选推荐 | 将智能体标记为企业精选,在列表页优先展示 | — | 开关式启用 |
列表页功能
智能体列表页是管理智能体的入口,提供以下功能:
- 企业精选区域:展示标记为精选的智能体,突出显示重点推荐的 Agent。
- 全部智能体区域:以卡片网格形式展示所有智能体,每张卡片包含头像、名称、描述、ID 和访问量。
- 搜索:按名称或描述关键词搜索智能体。
- 排序:支持按"最新"或"最热门"排序。
- 新建入口:点击"新建智能体"按钮打开创建向导。
- 快捷操作:每张卡片右上角提供删除等快捷菜单。
点击任意智能体卡片即可进入该智能体的详情页,包含 编辑配置、数据分析 和 可观测性 三个标签页。