插件常见问题

插件已发布，为什么工具仍显示“待调试”？

发布状态和工具调试状态是两个维度。进入工具执行试运行，确认真实请求成功并保存结果后再交给调用方使用。

服务显示“上线”，为什么仍然调用失败？

“上线”不代表 URL、网络、服务鉴权、用户授权和参数都正确。按连接、鉴权、输入参数、上游响应、输出解析的顺序定位真实错误。

为什么 MCP 工具不能直接编辑或启停？

MCP 工具契约来自 MCP Server，部分字段和开关由同步状态管理。先修改服务端定义，再回到插件执行同步、试运行和发布。

为什么导入插件的“下一步”不可点击？

检查是否已选择有效文件或输入可解析的原始内容；如果仍禁用，说明当前版本或空间尚未开放该导入路径。没有明确成功反馈和资源列表新增时，不算导入成功。

为什么代码注册关闭后没有新增插件？

代码注册入口需要同时提供合法的 ai_plugin JSON 和 OpenAPI YAML，并由当前版本完成持久化。只有列表新增或页面明确提示成功才算注册完成；否则改用已开放的表单创建方式。

如何配置默认值？

默认值必须与参数类型一致，并考虑模型未传值时的真实服务行为。包含凭据或固定业务标识的值不要作为公开默认值，应放入受控鉴权或服务端配置。

修改参数后为什么调用方异常？

工具参数是调用契约。删除字段、改名、改类型和收紧枚举都会影响智能体、工作流和卡片映射。优先新增兼容字段或新工具，迁移调用方后再停用旧契约。

为什么复制到其他工作空间后不能调用？

复制主要迁移资源定义，不会自动迁移目标空间无权访问的密钥、OAuth 授权、私网连接、卡片、MCP 可访问性和端侧部署。进入目标空间重新配置并完成最小试运行。

如何安全下线工具？

先查看引用数，新增替代工具并迁移调用方；随后停用旧工具并观察运行记录，最后再删除。直接删除可能使已发布智能体和工作流运行失败。

调试时应提供哪些信息？

保留发生时间、插件与工具名称、运行记录或请求 ID、输入结构、响应状态和可脱敏的错误信息。不要在截图、日志或工单中发送 Token、Cookie、密码和完整业务数据。