#4. 插件配置

---

插件（Plugin）是 Coze 平台的扩展能力模块，能够为代理或工作流赋予调用外部服务的能力。例如搜索网络、查询天气、操作数据库、生成图片、发送邮件等。Coze 支持三种插件类型：云插件（Cloud Plugin）、本地插件（Local Plugin）和 MCP 插件。插件可以被代理直接调用，也可以作为工作流中的一个节点使用。

#在应用中添加插件

在应用编辑器的左侧「资源」面板中，找到「插件」区域，点击旁边的「+」按钮，可以看到两个选项：「New Plugin（新建插件）」和「Import from Resource Library（从资源库导入）」。

• New Plugin：从头创建一个新的自定义插件，适合接入自有 API 或定制功能。
• Import from Resource Library：从已有的团队资源库导入现有插件，无需重复创建，可直接复用。

#插件添加

点击「新插件（New Plugin）」后，系统会弹出「创建插件」对话框，需要填写以下信息：

填写基础信息

创建插件需要填写三个核心字段：

• 插件名称（必填）：为插件输入一个清晰且合规的名称，名称应简洁明了，能直接反映插件的功能。例如「天气查询」「PDF 解析器」「航班查询」等。
• 简要介绍（必填，最多 50 字）：用简洁的语言描述插件的核心职能，并且必须包含核心关键词。例如「自动读取 PDF 和 Word 文件并生成内容摘要」。这段介绍会帮助大语言模型判断何时调用该插件。
• 插件图标（必填，最多 600 字）：详细描述插件的主要功能和使用场景，帮助用户和大型语言模型更好地理解它。内容须符合平台内容规范，不得含有违规信息。

选择插件类型

填写完成后继续向下滚动，选择插件图标样式，并进一步配置插件类型和创建方式。

• 云插件（Cloud Plugin）：插件逻辑运行在 Coze 云端。适合大多数通过 HTTP API 对接的场景。云插件有两种创建方式：
  • 云插件 - 基于现有服务创建：你已有一个对外暴露 API 的服务（例如你公司的内部查询接口），直接填写该 API 的 URL、请求方法和参数定义即可快速接入。
  • 云插件 - 在 Coze IDE 中创建：在 Coze 内置的在线代码编辑器中直接编写云函数（支持 Python），无需部署服务器，Coze 会自动托管运行环境。适合轻量级逻辑处理、数据格式转换、简单 API 封装等场景。

• 本地插件（Local Plugin）：与云插件不同，选择本地插件类型后无需选择创建方法，直接点击「确认」即可。创建完成后需要手动点击「创建工具」添加工具函数，每个工具需填写工具名称、描述、功能说明，以及配置输入和输出参数。支持切换到代码模式，通过编辑 JSON 配置。

• MCP 插件：基于 MCP（Model Context Protocol）协议接入的插件，需要填写插件网址（URL 或资源 URL）、配置请求头（Headers）和授权方式（如无需授权、Bearer Token、API Key 等）。MCP 是目前主流 AI 工具生态的标准协议，可以快速接入支持 MCP 的第三方服务（如 Brave Search、Notion、Linear 等）。