运行时工具发现

运行时工具发现用于确认某个客户端、API key、租户、模块和已配置 Agent 在当前时刻可以看到哪些工具。它是构建可靠 Agent 工作流的基础，因为当 scope、模块启用状态、租户设置或 Agent 绑定变化时，可见工具集也会变化。

当工作流需要确认可用工具、排查空工具列表，或为新的 Agent 工作流准备访问包时，请使用本页。

发现流程

工具列表按租户确定。只有访问路径和已配置工作流都支持时，工具才会出现。

因素	控制内容	复核问题
Endpoint	客户端进入哪个产品或模块能力面。	客户端是否使用了该工作流预期的 endpoint？
API key	客户端代表哪个租户和访问包。	这个 key 是否为当前租户、工作流和环境签发？
Scope	哪些工具家族可以被看到或调用。	key 是否包含完成任务所需的最小批准 scope？
模块启用状态	产品模块是否在租户中可用。	模块是否已在客户环境中启用并准备好？
Agent 绑定	哪些工具属于当前已配置 Agent。	工具是否分配给用户从 Agent Hub 进入的 Agent？
风险与复核边界	工具用于只读、分析、草稿还是动作能力。	工作流是否具备该工具类型所需的复核路径？
数据就绪度	工具是否能返回有用结果。	必需记录、文档、信号或场景是否足够可用？

测试发现结果前，请先使用访问与 Scope 规划准备访问包。

运营模块可以声明对租户开放的 Agent 工具。工具声明应在工作流依赖它之前，把运行时边界讲清楚。

这种区分让部署可以广泛开放只读工具，同时把工单创建、派工、关闭或外部系统交接保留给具备复核路径的 Agent。

在围绕某个工具构建提示词、自动化或工作流逻辑前，请确认：

对已接受的运行，请在工作流运行记录中保存可见工具集。

模式	通常含义	下一步
工具列表为空	Endpoint 可访问，但 key 没有匹配的工具可见性。	检查 endpoint、租户、scope、模块启用状态和 Agent 绑定。
只读工具可见，动作工具不可见	访问包支持调查，但不支持草稿或动作工作流。	保持只读工作流，或申请经复核的写入访问。
模块工具缺失	该租户可能未启用模块，或 endpoint 不正确。	确认模块启用状态和 endpoint 选择。
工具可见但调用被阻止	发现成功，但 scope、输入、风险节点或复核策略阻止执行。	使用工具执行治理复核调用路径。
某个用户可见，另一个用户不可见	key、scope、租户上下文或 Agent 绑定不同。	对比访问包和 Agent Hub 入口。
工具输出较弱	工具访问正常，但来源数据不完整或过期。	扩大使用前先运行数据就绪度检查。

MCP 工具参考说明可用工具家族、预期参数和 scope 规划。运行时发现确认当前客户端在当前租户中实际能使用什么。

两类视角都需要使用：

需求	使用
规划候选工具和 scope	工具参考和 scope 参考。
验证当前访问包	运行时发现。
排查缺失工具	运行时发现，加上 endpoint、scope、模块和 Agent 检查。
保存运行证据	运行记录中的运行时可见工具列表。

Agent Hub 是用户可见入口。运行时发现用于技术确认：已配置 Agent 是否具备预期工具。

Hub 入口被视为就绪前，请确认：

现象	检查项
客户端无法连接	Host、endpoint path、尾部斜杠和 API key header。
工具列表为空	租户、key、scope、endpoint、模块启用状态和 Agent 绑定。
工具名调用失败	用运行时发现替代硬编码工具假设。
预期模块工具缺失	确认模块 endpoint 和客户启用状态。
输出缺少证据	检查来源就绪度和证据要求。
动作工具被阻止	复核 scope、风险节点、确认、人工审批和审计要求。

详细失败排查见 MCP 错误与审计。