在项目中使用插件

插件为 AI 编程项目提供外部 API、内容处理和其他工具能力。当前项目选择面板按 已添加、企业插件、平台插件 组织，不再把“官方、三方、云端、端、MCP”作为一级来源页签。

添加插件

1. 进入 AI 编程项目。
2. 单击左侧输入框下方的 插件。
3. 在 企业插件 或 平台插件 中搜索目标插件。
4. 阅读名称、说明、来源和工具类型，单击 添加。
5. 回到 已添加，确认项目只保留当前任务真正需要的插件。

企业插件 是当前企业已经上架、允许成员使用的插件；平台插件 由平台市场提供，可按模型工具、数据连接、开发工具、图像等分类浏览。插件卡片上仍可能显示“官方、三方、云插件、MCP 插件”等属性，这些是插件来源或形态标识，不是项目选择页的一级分类。

在需求中说明调用规则

添加插件后，仍要告诉 AI 何时使用、传入哪些参数以及如何处理失败。例如：

使用 OCR 插件识别用户上传的发票图片。只有图片类型为 JPG 或 PNG 且小于 10 MB 时调用；识别后返回发票号、日期和金额；字段缺失时标记“待确认”，不要补造内容；插件超时或失败时提示用户重新上传。

权限与验证

• “添加到项目”不等于获得外部服务授权，仍需按插件页面完成授权或配置。
• 外部凭证使用环境变量或插件授权页面保存，不放入对话。
• 使用最小测试参数验证一次真实调用，再扩展业务流程。
• 对超时、限流、空结果、参数错误和无权限分别提供可见提示。
• 插件升级或替换后，使用相同测试用例回归验证。