智能体工具与 MCP
工具让 Agent 模式能够检索实时信息或执行授权操作。MCP 是连接外部工具服务的一种方式；GeniSpace 还提供平台工具、内置工具、自定义 Operator 和本地应用工具。
工具来源
| 来源 | 示例 |
|---|---|
| 平台工具 | Dataset 搜索、Datasource 操作、任务、存储、应用 |
| Assistant 工具 | 创建或管理支持的 GeniSpace 资源 |
| 自定义 Operator | 团队定义的 OpenAPI 或 Operator 实现 |
| MCP 服务 | 通过 Model Context Protocol 暴露的外部工具 |
| 本地应用工具 | Workbench 草稿编辑及其他宿主应用操作 |
为智能体配置工具
- 打开 控制台 → 智能体，编辑一个对话型智能体。
- 打开工具或 MCP 配置。
- 只启用需要的工具来源。
- 界面提供范围选择时，指定 Operator、任务、Datasource、Dataset 或服务。
- 可配置时分别设置读取、创建、更新和删除权限。
- 保存，并在 Chat 的 Agent 模式下测试。
最终可用工具是智能体配置、当前用户权限、空间访问和运行策略的交集。
添加外部 MCP 服务
- 打开智能体或空间的 MCP 服务配置。
- 输入服务名称和 URL。
- 通过受支持的安全凭据字段添加认证。
- 测试工具发现。
- 启用前核对发现的工具名称与描述。
不要将凭据写入提示词、描述、URL 或截图。生产环境必须使用 HTTPS。
Chat 中的工具调用
执行时间轴会显示所选工具、状态、耗时和结果摘要。选择事件可在活动面板中查看结构化结果。应用插件还可以将结果渲染为预览、表格、表单或确认界面，而不是原始 JSON。
工具返回空记录时，最终回答必须如实报告。除非界面明确显示仍有后台任务运行，否则最终回答完成后不会继续调用工具。
用户确认
缺少信息或需要明确选择时，交互型智能体可以暂停执行。确认卡片支持：
- 单选
- 带数量限制的多选
- 自定义文本答案
提交后会恢复已保存的同一轮执行。删除数据或产生外部影响的操作，在继续前应核对目标和范围。
Dataset 工具选择
| 请求 | 优先工具 |
|---|---|
| 精确 ID、状态、日期或已知字段值 | 结构化查询 |
| 字面关键词或标识符 | 全文搜索 |
| 相似经历、能力、语义或跨语言概念 | 向量搜索 |
只请求 Dataset Schema 中真实存在的输出字段。向量 Top-K 是相似候选，不是满足硬性条件的证明。
故障排除
| 问题 | 检查项 |
|---|---|
| 没有选择工具 | 使用 Agent 模式，并明确说明需要执行的操作 |
| 找不到工具 | 检查智能体配置、用户权限、空间访问和服务发现 |
| 字段或过滤条件无效 | 查看 Dataset 或工具 Schema，使用已声明字段与合法表达式 |
| 重复执行同一调用 | 先检查首次结果，调整请求，不要重复不变的只读调用 |
| 只看到结果描述 | 在活动面板中打开事件，或检查对应 Chat 插件是否启用 |