Agent/定制 Agent/Agent 管理与设置
更新于: 2026-06-25 17:47:58
你可以在 Agent 设置页面管理 Agent 的身份信息、发布渠道、技能、模型、授权文件夹等配置。
注意
不同类型的 Agent 支持的配置项不同,具体以页面展示为准。
查看 Agent 状态
通过状态提示,你可以查看扣子当前是否仍在处理任务。
- 在线:随时待命,等你下达指令。
- 掉线了:云端 Agent、本地 Agent 与云端或本地环境连接中断,暂时无法继续处理任务。
- 在扣子 对话列表中,单击目标 Agent。
- 在 Agent 名称处,查看 Agent 状态。

- 在扣子 App 中,单击目标 Agent。
- 单击 Agent 名称。
- 在 Agent 详情页,查看 Agent 状态。

修改 Agent 信息
Agent 信息是其对外的身份名片,你可以修改 Agent 的名称和说明,让它更容易被识别和使用。
- 在扣子的对话列表中,单击目标 Agent。
- 在 Agent 的右上角,单击 Agent 设置图标。
- 单击修改 Agent 信息,修改 Agent 名称和说明。

- 在扣子 App 中,单击目标 Agent。
- 单击 Agent 名称。
- 在 Agent 详情页,修改 Agent 名称和说明。

配置渠道
你可以将 Agent 发布到飞书、微信等平台,随时随地与 Agent 对话。仅扣子 Agent 支持发布到这些渠道。
- 飞书:一键配置飞书渠道并完成授权。支持单聊深度对话,也可在群内协同辅助;能自动理解上下文进度,在关键节点为你提供建议与支持。更多信息,请参考在飞书使用扣子。
- 微信:通过扫描二维码完成授权。授权完成后,可在微信中与 Agent 进行对话,例如陪你聊天、解答问题、提醒日程等。
添加渠道
- 在扣子的对话列表中,单击目标 Agent。
- 在 Agent 的右上角,单击 Agent 设置图标。
- 在 Agent 设置页面的渠道卡片中,单击添加。
- 选择目标渠道,完成配置。
- 飞书:选择飞书,单击去飞书授权。系统自动完成授权并发布 Agent 到飞书。
- 微信:选择微信,单击去授权。你使用微信扫描系统提供的二维码完成授权后,系统将自动发布 Agent 到微信。

- 在扣子 App 中,单击目标 Agent。
- 单击 Agent 名称。
- 在 Agent 详情页,单击渠道,然后选择目标渠道,完成配置。
- 飞书:选择飞书,单击去授权。系统自动完成授权并发布 Agent 到飞书。
- 微信:选择微信,单击去授权。你使用微信扫描系统提供的二维码完成授权后,系统将自动发布 Agent 到微信。

关闭渠道
- 在扣子的对话列表中,单击目标 Agent。
- 在 Agent 的右上角,单击 Agent 设置图标。
- 在 Agent 设置页面的渠道卡片中,单击目标渠道对应的关闭渠道,根据界面提示,完成操作。
关闭后,Agent 将从该平台下线,但扣子内的对话记录和配置不受影响,可随时重新添加。

- 在扣子 App 中,单击目标 Agent。
- 单击 Agent 名称。
- 在 Agent 详情页,单击渠道,单击目标渠道对应的取消授权,根据界面提示,完成操作。
关闭后,Agent 将从该平台下线,但扣子内的对话记录和配置不受影响,可随时重新添加。

查看渠道连接状态
网页端、桌面端
- 在扣子的对话列表中,单击目标 Agent。
- 在 Agent 的右上角,单击 Agent 设置图标。
- 在 Agent 设置页面的渠道卡片中,查看各个渠道的连接状态。

- 在扣子 App 中,单击目标 Agent。
- 单击 Agent 名称。
- 在 Agent 详情页,单击渠道,单击目标渠道对应的连接状态。

在飞书中使用扣子
直接在飞书中和扣子对话,扣子就能在飞书内帮你把活干了。更多信息,请参考在飞书使用扣子。
在飞书中单独对话
在飞书中搜索扣子,开始对话:

在飞书群中对话
将扣子拉入你的飞书群,和其他群成员一起使用扣子。

在微信中使用扣子
你可以直接在微信中与扣子对话,随时获取信息、完成任务。
技能
通过技能,Agent 能够按需、稳定地执行专业任务,扩展能力边界。你可以将技能看做是新员工的入职材料,将积累的工作经验和最佳实践打包为技能包,让 Agent 成为你专业领域的专家。目前,扣子商店已提供海量优质技能,你可以按需添加使用。更多信息,请参考技能概述。
浏览与安装技能
你可以前往技能商店浏览各类实用技能,并将其一键安装到你的 Agent 中。
- 在扣子的对话列表中,单击目标 Agent。
- 在 Agent 的右上角,单击 Agent 设置图标。
- 在 Agent 设置页面的技能卡片中,单击 > 图标,然后单击添加。
- 在技能商店中,搜索目标技能,然后单击添加或购买。
付费技能,需要先购买再使用。具体介绍,请参考购买技能。

- 在扣子 App 中,单击目标 Agent。
- 单击 Agent 名称。
- 在 Agent 详情页,单击技能,然后单击添加。
- 在技能商店中,搜索目标技能,然后单击添加或购买。
付费技能,需要先购买再使用。具体介绍,请参考购买技能。

启用与禁用技能
当你需要启用或暂时禁用某个技能在当前 Agent 中使用时,可以通过开关按钮控制其启用状态。
- 在扣子的对话列表中,单击目标 Agent。
- 在 Agent 的右上角,单击 Agent 设置图标。
- 在 Agent 设置页面的技能卡片中,单击 > 图标。
- 在技能列表中,找到目标技能,开启或关闭技能。
- 开启:开启后,Agent 在对话中即可调用该技能。
- 关闭:关闭后,Agent 将不再调用该技能。关闭技能不会卸载该技能。

- 在扣子 App 中,单击目标 Agent。
- 单击 Agent 名称。
- 在 Agent 详情页,单击技能。
- 在技能列表中,找到目标技能,开启或关闭技能。
- 开启:开启后,Agent 在对话中即可调用该技能。
- 关闭:关闭后,Agent 将不再调用该技能。关闭技能不会卸载该技能。

授权文件夹
扣子桌面端可以将你的个人电脑连接到扣子,让扣子 Agent 在获得授权后,帮助你处理本地电脑上的文件、文件夹和部分本地 Shell 任务。具体操作,请参考本地设备。
查看授权
完成授权后,你可以在Agent 设置页面,查看授权范围。
- 在扣子的对话列表中,单击目标 Agent。
- 在 Agent 的右上角,单击 Agent 设置图标。
- 单击已授权文件夹。

- 查看已授权可访问的本地电脑文件夹。

- 在扣子的对话列表中,单击目标 Agent。
- 单击 Agent 名称。
- 在 Agent 详情页,单击已授权文件夹。
- 查看已授权可访问的本地电脑文件夹。

取消授权
取消授权后,扣子无法操作你的本地电脑。
- 在扣子的对话列表中,单击目标 Agent。
- 在 Agent 的右上角,单击 Agent 设置图标。
- 单击已授权文件夹。

- 在指定文件下,单击取消授权。

- 在扣子的对话列表中,单击目标 Agent。
- 单击 Agent 名称。
- 在 Agent 详情页,单击已授权文件夹。
- 在指定文件下,单击取消授权。

切换模型
模型就像是扣子的大脑,扣子的回答质量、响应速度、对复杂任务的处理能力很大程度上取决于你为它配置的模型。不同模型单价不同、也各有所长,你可以换几个模型对比一下效果和成本,从而选择最合适的模型。
目前扣子提供以下模型模式供你选择:
- 自动(默认):后台自动调度,根据任务复杂程度、各个模型负载来灵活匹配合适的模型。
- 指定模型:目前支持选择 Doubao-2.0-pro、GLM-5.1、Minimax-m2.7 或 Kimi-k2.5,均为业界先进的模型版本。关于模型费用,请参考扣子任务费用。
注意
- 各个模型的 Token 单价不同,单价更高的模型,每次对话消耗的积分越多。你可以在各个模型厂商官网查看模型单价。
- 扣子会针对部分模型版本推出限时折扣活动,活动期间你可以以较低价格使用这些折扣模型。
- 在扣子的对话列表中,单击目标 Agent。
- 在 Agent 的右上角,单击 Agent 设置图标。
- 在 Agent 设置页面的模型设置卡片中,单击模型下拉列表,选择其他模型。

- 在扣子 App 中,单击目标 Agent。
- 单击 Agent 名称。
- 在 Agent 详情页的模型设置区域,切换模型。

接入自定义模型
说明
- 套餐限制:仅个人进阶版及以上版本支持添加自定义模型。
- Agent 类型:仅 Coze Agent 支持切换为自定义模型,其他类型 Agent 均不支持。
- 企业用户权限:企业组织成员均可添加自定义模型,默认仅自己可用,也可以在模型管理页面开启成员可用,将模型分享给企业其他成员。
- 平台限制:仅限网页端和桌面端操作,移动端暂不支持添加和管理自定义模型。
扣子官方提供了 Doubao、GLM、Kimi 等大模型供你选择。除此之外,你也可以添加自定义模型、接入自己的模型 API,例如你自行部署的模型、第三方在线模型等。成功接入后,你的 Coze Agent 就可以使用自己的模型服务,使用自定义模型的 Agent 也不会再收取扣子对话费用,而是消耗你自己的 Token 费用。
|
接入方式
|
适用场景
|
|
服务商接入
|
使用扣子已适配的第三方模型服务商。
当前支持以下服务商:
- 火山引擎方舟
- Kimi
- DeepSeek
- 智谱 GLM
- MiniMax
- Kimi Code
|
|
自定义接入
|
使用用户自己的模型服务,或兼容 OpenAI 协议的第三方模型服务。
支持的协议类型:
|
服务商接入步骤:
- 在模型管理页面右上角单击 + 接入模型。
- 在服务商接入页签中填写以下配置:
- 服务商:选择需要接入的模型服务商。
- API Key:调用服务商模型接口所需的鉴权凭证。以火山方舟为例,API Key 获取方式可参考火山方舟官方文档。
- 选择模型:选择需要添加到扣子中的模型。每次只能添加一款模型。
- 图片理解:开启后,该模型可用于图片理解场景,需模型本身支持该能力。关闭后,图片理解场景将使用自动调用扣子提供的识图工具。

- 单击添加。
成功添加自定义模型后,就可以将 Agent 模型设置为你的自定义模型了。

自定义接入步骤:
- 进入添加自定义模型页面。
找到要切换模型的扣子 Agent 或云端 Agent,在对话框右下角展开模型列表,并选择 + 添加自定义模型。
- 在自定义接入页签中填写以下配置:
- 模型展示名称:模型在扣子内展示的名称,便于用户识别和选择。
- 模型 ID:模型唯一标识,例如
doubao-seed-2-0-lite-260428,调用接口时会作为模型标识传入。
- 模型协议:选择模型服务兼容的 OpenAI 协议类型,支持 Chat API 和 Responses API。
- API URL:填写模型服务的 Base URL。选择不同协议后,系统会自动拼接对应接口路径。
- API Key:调用模型服务所需的鉴权凭证。
- 图片理解:开启后,该模型可用于图片输入场景,需模型本身支持图片理解。
- 最大回复长度:模型单次回复支持的最大输出 token 数,可手动填写,也可选择 16K、32K、64K、128K。

- 单击添加。
成功添加自定义模型后,就可以将 Agent 模型设置为你的自定义模型了。

常见问题