Super Agent 使用边界
一、模型选择注意事项
支持的模型类型
- Super Agent 目前支持不输出"思考过程"的模型
- 如果需要 分析图片，需要选择支持多模态的模型
特殊模型配置
使用以下模型时，需要在模型管理中进行特殊设置：
- Qwen 系列模型：需要关闭思考模式
- DeepSeek V4 系列：需要禁用思考功能
提示：如果不确定如何配置，请联系技术支持团队
二、使用限制说明
任务执行限制
| 限制说明 | 具体数值 | 影响 |
|---|---|---|
| 单次任务最多执行步骤 | 25 步 | 特别复杂的多步骤任务可能无法完成，会被中断 |
| 单轮对话工具调用次数 | 建议不超过 10 次 | 超过后 AI 会被提示停止，但不是强制中断 |
| 同时执行的搜索/分析 | 最多 3 个 | 如果 AI 计划同时做 5 件事，只会执行前 3 个 |
| 同时调用的子Agent | 最多 3 个 | 多个任务并行处理时的上限 |
| 历史对话加载轮数 | 最近 10 轮 | 更早的对话通过摘要方式记忆 |
| 代码执行超时 | 5 分钟 | 单次代码或技能工具的最长运行时间 |
重要提示：
- 工具调用次数限制是"建议性"的，AI 可能继续调用
- 步骤限制是强制性的，触发时当前任务可能部分完成
三、两种工作模式
自动模式（Auto Mode）- 默认模式
特点：
- AI 自主决定使用哪些工具和方法
- 最多尝试 3 轮搜索优化
- 可能会跳过知识库检索（如果 AI 判断不需要）
适用场景：
- 开放性问题
- 需要 AI 灵活处理的任务
- 不确定具体需要什么工具时
注意事项：
- ⚠️ 绑定的技能、工具和子Agent 总数建议不超过 20 个，否则可能导致 AI "注意力分散"，回答准确性下降
专注模式（Focused Mode）- 手动选择工具
特点：
- 用户从界面明确选择要使用的工具或 Agent
- 如果选择的工具不可用，会直接报错（不会尝试其他方式）
适用场景：
- 明确知道要用什么工 具
- 需要保证使用特定功能时
- 关键任务不希望 AI 自主判断时
四、记忆与历史功能
对话记忆
- 会话内记忆：保留最近 10 轮完整对话，更早的内容会被压缩成摘要
- 记忆更新时机：在您看到回复后的后台异步更新
- 触发条件：对话内容较多时（超过一定长度）才会启动摘要
个人偏好记忆（跨会话）
- 自动提取并记录：个人偏好、角色身份、专业领域
- 提取频率：每 3 轮对话提取一次
- 最多记录：100 条个人信息
- 生效时间：新提取的偏好不会立即影响当前会话，下次会话生效
清除历史的影响
- 使用"清除上下文"功能后：
- 之前的对话历史不会被加载
- 记忆摘要也会清空
- 相当于重新开始对话
五、后台执行功能
如何使用
- 提问后可以切换到其他页面
- 任务会在后台继续执行
- 完成后会收到通知
取消任务的说明
- 取消是"协商式"的，不是立即终止
- 正在执行的工具不会立刻停止
- 建议：避免频繁点击取消和重试，可能导致意外行为
六、子Agent（Sub-agent）配置指南
当前版本限制
- 只有开启了 MCP Server 的 Agent 才能作为子Agent 使用
- 只能传递文本，暂不支持传递图片、文件等
配置要点（重要）
为了让 Super Agent 准确调用子Agent，配置时需要注意：
-
服务名称：简短直白，表述子Agent 的用途
- ✅ 好的例子："IT资产申请助手"
- ❌ 不好的例子："通用查询工具"
-
服务描述：明确说明使用场景，推荐使用以下格式：
- ✅ 推荐："当用户询问IT资产申请流程、IT设备申请相关问题时，停止思考并使用此工具"
- ❌ 避免："这是一个查询知识库的工具"（过于宽泛）
-
关键原则：
- 描述要足够具体，让 AI 能明确判断何时使用
- 避免过于通用的描述（如"查知识库"），会导致路由失败
- 用户问题和子Agent 描述要有明确关联性
配置示例
服务名称：IT资产申请助手
服务描述：当用户询问"如何申请IT资产"、"IT设备申请流程"、"办公电脑申请"等相关问题时，立即使用此工具查询相关知识库并回答。
为什么这样配置：
- "IT资产怎么申请"这个用户问题，和"IT资产申请助手"有明确的关联性
- AI 能清楚判断什么时候该用这个子Agent
七、文件制品生成说明
什么是文件制品
AI 生成的文档、报告、代码等可下载文件
可能遇到的问题
- 文件"消失"：生成了但界面上看不到
- 重复文件：同一个文件被多次推送
- 找不到文件：提示文件不存在
原因说明
文件生成涉及多个环节的协同，任何一 个环节出问题都可能导致上述情况
遇到问题怎么办
- 刷新页面重试
- 如果问题持续，联系技术支持
八、内容安全机制
输入过滤
- 个人敏感信息（如身份证号、手机号）会被自动检测和脱敏
- 命中规则的内容会被过滤
输出过滤
- AI 回复会自动检测敏感词
- 检测到敏感内容会替换为安全提示
- 注意：替换后的内容会被保存，原始内容不会保留
九、最佳实践建议
任务描述
- ✅ 清晰具体："帮我整理本季度销售数据，生成Excel报表"
- ❌ 模糊笼统："帮我看看数据"
工具选择
- 简单任务：使用自动模式，让 AI 灵活处理
- 关键任务：使用专注模式，手动选择工具确保准确性
子Agent 使用
- 配置时一定要描述清楚使用场景
- 总数控制在 20 个以内
- 避免功能重叠的子Agent
历史管理
- 定期清理无关会话历史
- 重要对话可以手动保存关键信息
十、常见问题
Q：为什么 AI 没有使用我配置的知识库？
A：自动模式下，AI 会自主判断是否需要检索知识库。如需强制使用，可以明确提问"从知识库中查询..."
Q：任务执行到一半被中断了？
A：可能触发了 25 步执行上限。建议将复杂任务拆分成多个小任务分步执行。
Q：配置了很多子Agent，但感觉回答质量下降？
A：工具和子Agent 总数超过 20 个会影响准确性。建议精简到最常用的功能。
Q：取消任务后为什么还在执行？
A：取消是协商式的，正在运行的操作不会立即停止。等待几秒钟后再重新发起请求。
Q：如何确保子Agent 被正确调用？
A：在配置描述中明确写清楚"当用户询问XX问题时使用"，并确保用户问题和描述有明确关联。