工具、工作流与数据表

这些是LoopAgent的「行动能力」——配置之后，模型可以在对话中自主调用它们去完成目标任务。

工具与 MCP

• 给 LoopAgent 绑定插件 / MCP 后，模型即可按需调用对应的工具。
  -凭证安全**：URL、API Key、鉴权头等敏感信息全部保存在平台侧，执行也在平台侧完成，模型从不接触你的密钥。名字类似 key / token / secret 的参数会对模型隐藏，执行时由平台注入。 **
• 工具数量不多时，模型直接就能看到并调用；数量很多（超过 30 个）时，改为「延迟加载」模式以节省 Tokens控制成本。

使用要点

• 工具报错不会中断本轮：某个工具调用失败时，工具卡里会显示错误信息，模型会转述或重试，继续服务。
• 看不到工具调用过程：由 LoopAgent - 输出的「调用过程可见」开关控制（插件级和智能体级都要打开）。

工具调不到的排查

1. 智能体的工具总开关是否打开；
2. 插件是否已绑定到该智能体并启用；
3. 该操作（action）是否在插件级或智能体级被禁用；
4. MCP 检查白名单是否把该工具排除在外。

工作流

一个已发布的工作流可以变成一个工具，模型能像调工具一样触发它，工作流 START 节点的入参就是这个工具的入参。

要让工作流变成可调用的工具，需要同时满足三个条件（缺一则工具不出现，且不会报错）：

1. 智能体的工作流总开关打开；
2. 该工作流已关联到这个智能体；
3. 该工作流已发布（只存草稿的工作流会被跳过）。

• 改了工作流草稿不发布，LoopAgent 跑的仍是旧的已发布版本。
• 工作流的「简介」要写清用途，否则模型检索不到、不会调用。
• 工作流执行的积分记在工作流所属组织账上。

数据表与图表

给 LoopAgent 绑定数据表后，模型会自动获得两个能力：用自然语言查表，以及把查询结果画成图表。模型全程不写 SQL。

• 自然语言查表：模型用一句自然语言描述要查什么，平台负责转成查询并返回结果。
• 生成图表：把本轮最近一次查询的结果渲染成柱状 / 折线 / 饼图等图表，直接展示给用户。
• 必须先查再画：生成图表前，同一轮必须先成功查过一次表。用户新开一轮直接说「画个图」而没先查，会被提示先查一次——这是设计，不是故障。

表来源：LoopAgent 的数据表在它自己的数据节点里选择。请在 LoopAgent 的数据节点里选表，去改智能体其它位置的数据表设置对 LoopAgent 无效。