Appearance
配置工具并试运行
工具是智能体和工作流真正调用的最小单元。插件发布成功，不代表插件中的每个工具都已经调试通过。
工具列表
插件详情页集中展示工具名称、输入参数、服务状态、调试状态、智能体引用数、创建时间、启用状态和操作入口。
图 1：先检查服务状态和调试状态，再执行编辑、试运行、卡片绑定、代码片段、模拟集或删除等操作。
工具契约
基本信息
- 工具名称：保持稳定、可搜索，准确表达动作。
- 工具说明：说明何时调用、完成什么工作、返回什么结果和主要限制。
- HTTP 工具还需要配置请求方法与相对路径。
输入参数
当前工具详情支持配置名称、描述、类型、参数位置、必填和启用状态，并支持对象子参数。HTTP 输入位置包括 Body、Path、Query 和 Header。
- 参数描述写清格式、单位、枚举和边界。
- Path 占位符必须存在同名 Path 参数。
- 关闭参数后，模型和调用方不能继续依赖该字段。
- 默认值不得包含密钥或真实用户数据。
输出参数
输出参数决定工作流变量选择、智能体结构化消费和卡片映射。按真实响应维护字段类型与嵌套关系，自动解析或自动优化结果仍需人工审核。
不同工具的维护方式
- HTTP API 工具：可编辑基本信息、路径、方法、输入输出，并进行试运行。
- MCP 工具：以服务端工具清单为准；本地编辑和启用开关可能被锁定。
- Cloud IDE 工具：在 IDE 中维护代码、依赖、元数据和测试。
- 端插件工具：除参数外还要验证客户端版本、设备权限和在线状态。
试运行流程
- 从工具列表或工具详情点击“试运行”。
- 按输入参数填写最小合法数据。
- 运行并查看 Request、Response 和连接器校验结果。
- 检查状态码、返回内容、字段类型和错误信息。
- 结果适合作为模型示例时，先脱敏再保存为工具使用示例。
- 返回工具详情确认调试状态变为“通过”。
至少覆盖：
- 最小合法输入。
- 缺少必填参数、非法枚举、空字符串和超长输入。
- 鉴权失败、上游限流、超时和服务异常。
- 空结果、分页末尾和部分字段缺失。
- 输出参数与真实响应不一致。
卡片、代码片段与模拟集
- 绑定卡片数据：选择已发布卡片，把工具输出映射到卡片变量；无卡片时保持“不使用卡片回复”。
- Code Snippet：当前可查看 cURL、Wget、Node.js、Python 和 Golang 示例，用于开发者核对调用方式。
- 管理模拟集：为稳定的测试输入输出建立可复用测试数据；模拟结果不能替代真实服务验证。
工具试运行或参数变更会使插件回到未发布状态时，应完成发布与版本检查。
故障定位顺序
按网络连通、服务鉴权、用户授权、输入映射、服务响应、输出解析、调用方消费的顺序排查。保留请求 ID、运行时间和脱敏错误信息，不通过吞异常或固定返回值让页面“看起来通过”。