news 2026/2/10 9:01:54

Coze智能体开发:Coze Studio插件配置

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
Coze智能体开发:Coze Studio插件配置

插件工具可以扩展 LLM 的能力,比如联网搜索、科学计算或绘制图片,赋予并增强了 LLM 连接外部世界的能力。部署 Coze Studio 开源版之后,你可以参考本文档配置插件工具,否则这些插件工具可能无法正常运行。

插件接入方式

Coze Studio 提供了三种插件工具类型,即官方内置插件、自定义插件、商业版插件。

插件类型说明接入方式
官方内置插件由后台统一配置,支持 Coze Studio 开源版中所有用户使用。参考接入官方插件。
自定义插件由开发者自行创建与配置,使用范围为当前工作空间。参考商业版文档创建插件。
商业版插件扣子商业版(coze.cn)中的收费插件,须手动接入后才能使用。参考接入Coze商业版插件。

接入Coze商业版插件

为了丰富插件生态, Coze Studio 开源版现已支持接入 Coze 商业版的收费插件,包括扣子官方和第三方提供的收费插件,例如语音合成、天眼查等插件工具。 在开源版中使用商业版插件时,平台将使用开发者预先配置的商业版访问令牌进行鉴权。当前部署的开源版本中所有用户账号均使用此用户身份和权限调用这些商业版插件,产生的费用均由访问令牌的所属账号承担

使用这些商业版插件前,应参考以下步骤开通插件:

  1. 获取商业版账号的访问令牌。 在你的扣子商业版账号中申请访问令牌,并选择插件管理(callToo、getPlugin)和权益(getBenefit)权限点。 支持个人访问令牌、服务访问令牌或 Oauth 访问令牌,获取方式可参考鉴权方式。
  2. 在开源版中配置令牌,并启用 Coze SaaS 插件。
    1. 登录 Coze Studio 开源版,进入 Admin 管理后台。
    2. 进入配置管理>基础配置页面。
    3. 在 Coze API Token 一项中填写访问令牌,并启用 Coze Saas 插件。
    4. 点击保存。

  3. 成功配置后,在开源版的探索 > 插件 Coze 插件页面可以看到目前可用的所有商业版插件。

  4. 使用商业版插件。 常见场景的操作如下:
    相关操作说明
    为 Agent 添加插件为 Agent 添加插件时,可以在Coze.cn 插件页面选择商业版的插件。

    为工作流插件节点选择插件在工作流插件节点选择插件时,Coze.cn 插件页面可选择商业版的插件。

接入官方插件

官方插件工具列表

登录 Coze Studio 开源版之后,你可以在左侧导航栏单击探索,并在插件页面查看所有官方插件工具。这些插件可通过 API 的方式调用第三方服务。 插件页面中,如果插件带有未授权的标签,表示此插件需要授权,且尚未配置授权信息。配置方式可参考配置官方插件工具。没有此标签的插件可以直接使用。

Coze Studio 开源版提供的官方插件工具列表如下:

插件名称插件描述
Wolfram Alpha强大的数学工具,可计算各种数学表达式。
搜狐热闻帮助用户获取搜狐网上的每日热闻。
什么值得买帮助用户查询商品优惠信息,提供价格、购买渠道和性价比推荐。
板栗看板任务拆解工具,根据用户提问拆解任务,生成任务看板。
文库搜索根据文库文档标题关键字,搜索豆柴文库内容和网页URL。
高德地图路线规划、位置查询、地理信息转换等功能
飞书电子表格对飞书电子表格进行创建、编辑和查询等操作。
博查搜索从全网搜索任何网页信息和网页链接,结果准确、摘要完整,更适合AI使用。
图片压缩上传图片链接,返回压缩后的base64格式图片。
飞书认证及授权提供飞书应用的认证及授权功能。
飞书多维表格支持创建和管理飞书多维表格,进行数据操作和搜索。
飞书日历在飞书日历上创建、更新、删除、查询日程信息。
飞书云文档支持创建文档、添加内容、获取文档信息和搜索文档。
飞书消息支持发送飞书消息和获取消息历史记录。
飞书任务调用飞书开放平台任务相关API,创建、更新、删除和查询任务。
飞书知识库搜索飞书知识库Wiki、获取Wiki全部子节点列表。
天眼查利用天眼查API检索企业信息,查询企业基本信息、新闻舆情等。

配置官方插件工具

如果你需要直接使用 Coze Studio 提供的官方内置插件工具,在使用前,应参考以下步骤配置相应插件的授权凭证。 此处以“飞书云文档”插件为例,其他官方插件请参考对应第三方服务的 API 文档获取授权凭证。

  1. 进入目录backend/conf/plugin/pluginproduct
  2. 打开plugin_meta.yaml文件。
  3. 找到你想要使用的内置工具,例如搜索插件名称”飞书云文档“。
    1. 该插件的授权方式为 OAuth2.0 授权码模式,需要配置公网 host。修改coze-studio/docker/.env中的SERVER_HOST为公网 host。
    2. 找到对应插件的payload字段。
    3. 进入飞书开放平台开发者后台 > 应用详情页 > 凭证与基础信息 >应用凭证,获取应用凭证 App ID 和 App Secret ,修改payload中的client_idclient_secret字段。
    4. 进入飞书开放平台开发者后台 > 应用详情页 >安全设置,配置重定向 URL 为https://{SERVER_HOST}/api/oauth/authorization_code
    5. 进入飞书开放平台开发者后台 > 应用详情页 >权限管理,申请payload中要求的scope权限。 关于插件的其他参数配置说明,可参考插件配置 schema;payload 的其他字段说明,可参考授权配置 Payload。

    6. 保存文件。
  4. 执行以下命令重新启动服务。
    # 重启服务 docker compose --profile '*' up -d --force-recreate --no-deps coze-server

服务启动之后,在智能体编辑页面,选择飞书云文档插件,就可以正常使用了。

插件配置 schema

以飞书云文档插件为例,其配置 schema 详细字段说明如下。你可以根据业务需求修改各个可选参数配置。关于 payload 部分的详细字段说明,可参考授权配置 Payload。

- plugin_id: 19 #必填,类型int。插件唯一标识ID。 product_id: 7395041536909574154 #必填,预留字段,保持当前值。 deprecated: false #可选,类型bool。插件是否已废弃,当官方插件需要从商店下架时,设置为true。 version: v1.0.0 #必填,类型string。插件版本,格式必须为vX.X.X,每一次插件升级都应该升级版本号。 openapi_doc_file: lark_docx.yaml #必填,类型string。描述插件工具API的OpenAPI3文档。 plugin_type: 1 #必填,类型int。目前固定为1,表示插件类型为HTTP。 manifest: #必填,类型object。插件配置元信息。 schema_version: v1 #必填,类型string。插件配置元信息的版本号,目前固定为v1。 name_for_model: 飞书云文档 #必填,类型string,暂时无用。插件名称,提供给大模型理解。 name_for_human: 飞书云文档 #必填,类型string。插件公开展示的名称。 description_for_model: 这是一个飞书云文档 #必填,类型string,暂时无用。插件描述,提供给大模型理解。 description_for_human: 这是一个飞书云文档 #必填,类型string。插件公开展示的描述。 auth: #必填,类型object。插件鉴权配置。 type: oauth #必填,类型string。插件鉴权类型,可选none(无鉴权);oauth(标准oauth2.0);service_http(简单鉴权)。 sub_type: authorization_code #可选,类型string。插件鉴权子类型。鉴权类型为none时无效;鉴权类型为oauth时,仅支持authorization_code(授权码模式);授权类型为service_http时,仅支持token/api_key(APIToken或者APIKey等单字段鉴权信息); payload: '{"client_id":"","client_secret":"","client_url":"https://accounts.feishu.cn/open-apis/authen/v1/authorize","scope":"drive:drive","authorization_url":"https://open.larkoffice.com/open-apis/authen/v2/oauth/token","authorization_content_type":"application/json"}' #可选,类型string。鉴权的具体配置,json格式,具体字段根据鉴权类型和子类型而定。 logo_url: official_plugin_icon/plugin_lark_docx.png #必填,类型string。插件图标URI,需要提前在./docker/volumes/minio/official_plugin_icon配置。 api: #必填,类型object。插件额外描述信息。 type: openapi #必填,类型string。插件类型,目前固定为openapi,表示插件类型为HTTP,与plugin_type含义相同。 common_params: #必填,类型object。工具HTTP请求的通用参数。 header: #可选,类型array。工具HTTP请求的通用头参数。User-Agent 固定为 Coze/1.0。 - name: User-Agent value: Coze/1.0 path: [ ] #可选,类型array。工具HTTP请求的通用路径参数。 query: [ ] #可选,类型array。工具HTTP请求的通用查询参数。 body: [ ] #可选,类型array。工具HTTP请求的通用body参数。 tools: #必填,类型array。插件工具列表。 - tool_id: 190001 #必填,类型int。工具唯一标识ID。 deprecated: false #可选,类型bool。工具是否已废弃,当需要从商店下架工具时,设置为true。 method: post #必填,类型string。工具HTTP请求方法。 sub_url: /document/create_document #必填,类型string。工具HTTP请求子路径。 - tool_id: 190002 deprecated: false method: get sub_url: /document/get_document_content

授权配置 Payload

以飞书云文档插件为例,其授权配置 payload 详细字段说明如下。你可以根据业务需求修改各个可选参数配置。

type AuthOfAPIToken struct { // Location is the location of the parameter. // It can be "header" or "query". Location HTTPParamLocation `json:"location"` // Key is the name of the parameter. Key string `json:"key"` // ServiceToken is the simple authorization information for the service. ServiceToken string `json:"service_token"` } type OAuthAuthorizationCodeConfig struct { ClientID string `json:"client_id"` ClientSecret string `json:"client_secret"` // ClientURL is the URL of authorization endpoint. ClientURL string `json:"client_url"` // Scope is the scope of the authorization request. // If multiple scopes are requested, they must be separated by a space. Scope string `json:"scope,omitempty"` // AuthorizationURL is the URL of token exchange endpoint. AuthorizationURL string `json:"authorization_url"` // AuthorizationContentType is the content type of the authorization request, and it must be "application/json". AuthorizationContentType string `json:"authorization_content_type"` }

《DeepSeek高效数据分析:从数据清洗到行业案例》聚焦DeepSeek在数据分析领域的高效应用,是系统讲解其从数据处理到可视化全流程的实用指南。作者结合多年职场实战经验,不仅深入拆解DeepSeek数据分析的核心功能——涵盖数据采集、清洗、预处理、探索分析、建模(回归、聚类、时间序列等)及模型评估,更通过金融量化数据分析、电商平台数据分析等真实行业案例,搭配报告撰写技巧,提供独到见解与落地建议。助力职场人在激烈竞争中凭借先进技能突破瓶颈,实现职业进阶,开启发展新篇。

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/2/3 13:09:23

Coze智能体开发:Coze Studio快速开始

环境要求 在参考本文安装 Coze Studio 之前,确保您的软硬件环境满足以下要求: 项目说明CPU2 CoreRAM4 GiBDocker提前安装 Docker、Docker Compose,并启动 Docker 服务,详细操作请参考 Docker 文档: * macOS&#xff…

作者头像 李华
网站建设 2026/1/29 15:14:34

DataCap开源数据集成平台快速部署完整指南

DataCap开源数据集成平台快速部署完整指南 【免费下载链接】datacap DataCap 是数据转换、集成和可视化的集成软件。支持多种数据源,文件类型,大数据相关数据库,关系型数据库,NoSQL 数据库等。通过软件可以实现管理多种数据源&…

作者头像 李华
网站建设 2026/2/7 16:38:46

智能动画库架构演进:2025年性能突破与生态重构

智能动画库架构演进:2025年性能突破与生态重构 【免费下载链接】react-move 项目地址: https://gitcode.com/gh_mirrors/rea/react-move React-Move作为数据驱动动画领域的技术演进典范,在生态整合与性能突破方面展现出独特价值。该库通过精巧的…

作者头像 李华
网站建设 2026/2/6 2:17:55

5个LÖVE游戏交互优化技巧:打造沉浸式玩家体验

5个LVE游戏交互优化技巧:打造沉浸式玩家体验 【免费下载链接】love LVE is an awesome 2D game framework for Lua. 项目地址: https://gitcode.com/gh_mirrors/lo/love LVE作为一款轻量级2D游戏框架,为开发者提供了丰富的Lua接口来构建出色的游戏…

作者头像 李华
网站建设 2026/2/8 6:58:02

如何打造永不充电的智能日历?ESP32墨水屏项目全解析

如何打造永不充电的智能日历?ESP32墨水屏项目全解析 【免费下载链接】portal_calendar A Portal themed e-ink calendar based on the ESP32 platform 项目地址: https://gitcode.com/gh_mirrors/po/portal_calendar 你是否曾经梦想过拥有一款永远不需要充电…

作者头像 李华
网站建设 2026/2/9 21:17:36

FaceFusion能否用于法庭证据重建?司法领域可行性讨论

FaceFusion能否用于法庭证据重建?司法领域可行性讨论 在一场深夜抢劫案的监控录像中,嫌疑人戴着口罩、帽子,面部仅露出一小部分轮廓。画面模糊,分辨率低得连眼睛形状都难以辨认。警方想通过人脸识别锁定身份,但算法返回…

作者头像 李华