插件生态与调试

插件通过 API 将外部服务接入 Coze，使智能体具备搜索、资讯、企业内部数据等扩展能力。合理配置参数与提示词，可以让模型在合适的时机触发插件并利用返回结果。

---

插件类型与选择

• 官方插件：由 Coze 官方维护，覆盖搜索、资讯、内容生成、音视频、图像处理等能力。
• 创作者插件：由社区或团队自建，适用于垂直业务场景。
• 私有插件 / OAuth 插件：需要授权访问企业内部系统或第三方账号时使用。

选择插件时，请确认目标模型支持 Function Call，否则无法触发调用。

---

添加插件的流程

1. 在智能体编排页的「技能」区域点击 + 插件。
2. 搜索并添加目标插件，可先在商店页面体验其功能。
3. 回到提示词中明确插件的调用条件，例如：

当遇到行业最新资讯相关问题时，调用 {头条搜索} 获取实时信息。

4. 在「预览与调试」对话中验证插件是否按预期触发。

---

参数配置与最佳实践

为插件设置默认值与可见性，可减少调用失败并提升效率。

• 避免缺参报错：给必填项设置默认值，用户未提供时也能执行。例如天气查询未指定城市时，默认定位到"杭州"并返回结果。

• 稳定参数隐藏：对固定值（如返回条数）设置默认值并关闭「对模型可见」，避免模型重复判断。

• 编辑方法：点击插件右侧的 编辑参数 图标，配置默认值、可见性、描述等。

---

绑定卡片展示

部分插件返回结构化数据，可在「消息卡片」中定义展示样式：

1. 在卡片编辑器添加所需组件。
2. 打开插件的「绑定卡片数据」，选择卡片并映射字段。

3. 调试对话，确认卡片能正确渲染插件返回的数据。

---

删除或替换插件

• 点击插件右上角 … → 移除。

• 若仅需暂停使用，可在提示词中移除调用指令或关闭相关快捷指令。

---

常见问题

• 调用失败怎么办？
  逐项确认模型支持 Function Call、提示词是否明确、必填参数是否有值。

• 豆包·角色扮演·Pro 无法调用插件？
  该模型不支持 Function Call，需更换为「豆包·工具调用」等模型。

• 插件显示"未授权"？ OAuth 插件需要先在编排页完成授权。工作流中可开启共享授权，让终端用户无需重复授权。

---