用途:Tool 是 Celigo 的一等可复用构建块,把查询、导入、转换、分支等逻辑封装在明确的输入/输出契约后。一次定义、多处调用,可从 Flow、API、AI Agent、MCP Server 及其他 Tool 使用,避免在多个消费方重复搭建相同的查询-转换-导入模式。
主要能力:输入为 JSON Schema,定义调用方传入的数据;routers[] 组成处理管线,内含 branches[],分支下为 pageProcessors[](export 查询、import 导入);输出由 schema、映射、查找表、钩子定义。可用 nextRouterId 串联多个 router 做顺序处理,特殊值 "outputRouter" 退出工具并返回结果。路由支持无路由、基于表达式过滤(input_filters)和脚本路由(script)。输出映射支持 mappings[]、静态 lookups[] 以及 preMap/postMap 钩子。工具不固定连接,由消费方在绑定时提供连接,同一工具可用不同连接(如测试与生产)。
使用方式:遵循 Connection → Export + Import → Tool 的自底向上构建顺序。最小必填字段为 name、_integrationId 和 input.schema,其中 input.schema 根须为 type: "object"(MCP 兼容需要)。CLI 提供 celigo tools list/get/create/update/set/delete,以及 add-processor、remove-processor、test-run、debug-requests 等命令。可将现有 Flow/API/Tool 中一段步骤重构为新工具,但仅由用户主动触发,且不可程序化撤销。
适用场景:MCP 服务器暴露的每段逻辑、被 2 个以上消费方复用的逻辑、需要调用方切换连接、需要工具嵌套编排时。不适合仅用于单个 Flow/API 的一次性逻辑,或多租户模板场景(应使用抽象 Flow)。
限制:工具自身不会启动,无调度、无监听器、无 Flow 运行时控制,也没有抽象/实例层。查询需区分分支内运行时 export 查询与输出阶段静态查找表。重构生成的工具处理器复用原 export/import ID,若这些资源被修改会波及所有消费方。PUT 会清除省略字段,应先 GET 再改再 PUT。