助手
扣子 AI 帮助与支持
你好,我是 扣子 文档问答助手 🎉 你在阅读当前文档的过程中,无论对文档概念的解释,还是文档内容方面的疑问,都可以随时向我提问,我会全力为你解答
推荐问题
如何快速了解这个空间的核心内容?
有哪些近期更新的重点文档?
我应该从哪些文档开始阅读?
文档反馈

Agent 管理与设置

更新于: 2026-06-25 17:47:58

你可以在 Agent 设置页面管理 Agent 的身份信息、发布渠道、技能、模型、授权文件夹等配置。

注意

不同类型的 Agent 支持的配置项不同,具体以页面展示为准。

查看 Agent 状态

通过状态提示,你可以查看扣子当前是否仍在处理任务。

  • 在线:随时待命,等你下达指令。
  • 掉线了:云端 Agent、本地 Agent 与云端或本地环境连接中断,暂时无法继续处理任务。
  1. 扣子 对话列表中,单击目标 Agent。
  2. 在 Agent 名称处,查看 Agent 状态。
    Image
  1. 在扣子 App 中,单击目标 Agent。
  2. 单击 Agent 名称。
  3. Agent 详情页,查看 Agent 状态。
    Image

修改 Agent 信息

Agent 信息是其对外的身份名片,你可以修改 Agent 的名称和说明,让它更容易被识别和使用。

  1. 扣子的对话列表中,单击目标 Agent。
  2. 在 Agent 的右上角,单击 Agent 设置图标。
  3. 单击修改 Agent 信息,修改 Agent 名称和说明。
    Image
  1. 在扣子 App 中,单击目标 Agent。
  2. 单击 Agent 名称。
  3. Agent 详情页,修改 Agent 名称和说明。
    Image

配置渠道

你可以将 Agent 发布到飞书、微信等平台,随时随地与 Agent 对话。仅扣子 Agent 支持发布到这些渠道。

  • 飞书:一键配置飞书渠道并完成授权。支持单聊深度对话,也可在群内协同辅助;能自动理解上下文进度,在关键节点为你提供建议与支持。更多信息,请参考在飞书使用扣子
  • 微信:通过扫描二维码完成授权。授权完成后,可在微信中与 Agent 进行对话,例如陪你聊天、解答问题、提醒日程等。

添加渠道

  1. 扣子的对话列表中,单击目标 Agent。
  2. 在 Agent 的右上角,单击 Agent 设置图标。
  3. Agent 设置页面的渠道卡片中,单击添加
  4. 选择目标渠道,完成配置。
    • 飞书:选择飞书,单击去飞书授权。系统自动完成授权并发布 Agent 到飞书。
    • 微信:选择微信,单击去授权。你使用微信扫描系统提供的二维码完成授权后,系统将自动发布 Agent 到微信。
      Image
  1. 在扣子 App 中,单击目标 Agent。
  2. 单击 Agent 名称。
  3. Agent 详情页,单击渠道,然后选择目标渠道,完成配置。
    • 飞书:选择飞书,单击去授权。系统自动完成授权并发布 Agent 到飞书。
    • 微信:选择微信,单击去授权。你使用微信扫描系统提供的二维码完成授权后,系统将自动发布 Agent 到微信。
      Image

关闭渠道

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

查看渠道连接状态

网页端、桌面端

  1. 扣子的对话列表中,单击目标 Agent。
  2. 在 Agent 的右上角,单击 Agent 设置图标。
  3. Agent 设置页面的渠道卡片中,查看各个渠道的连接状态。
    Image
  1. 在扣子 App 中,单击目标 Agent。
  2. 单击 Agent 名称。
  3. Agent 详情页,单击渠道,单击目标渠道对应的连接状态。
    Image

在飞书中使用扣子

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

在飞书中单独对话
在飞书中搜索扣子,开始对话:
Image

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

在微信中使用扣子

你可以直接在微信中与扣子对话,随时获取信息、完成任务。

基础问答
Image

联网搜索
Image

读取微信公众号
Image

技能

通过技能,Agent 能够按需、稳定地执行专业任务,扩展能力边界。你可以将技能看做是新员工的入职材料,将积累的工作经验和最佳实践打包为技能包,让 Agent 成为你专业领域的专家。目前,扣子商店已提供海量优质技能,你可以按需添加使用。更多信息,请参考技能概述

浏览与安装技能

你可以前往技能商店浏览各类实用技能,并将其一键安装到你的 Agent 中。

  1. 扣子的对话列表中,单击目标 Agent。
  2. 在 Agent 的右上角,单击 Agent 设置图标。
  3. Agent 设置页面的技能卡片中,单击 > 图标,然后单击添加
  4. 在技能商店中,搜索目标技能,然后单击添加购买
    付费技能,需要先购买再使用。具体介绍,请参考购买技能
    Image
  1. 在扣子 App 中,单击目标 Agent。
  2. 单击 Agent 名称。
  3. Agent 详情页,单击技能,然后单击添加
  4. 在技能商店中,搜索目标技能,然后单击添加购买
    付费技能,需要先购买再使用。具体介绍,请参考购买技能
    Image

启用与禁用技能

当你需要启用或暂时禁用某个技能在当前 Agent 中使用时,可以通过开关按钮控制其启用状态。

  1. 扣子的对话列表中,单击目标 Agent。
  2. 在 Agent 的右上角,单击 Agent 设置图标。
  3. Agent 设置页面的技能卡片中,单击 > 图标。
  4. 在技能列表中,找到目标技能,开启或关闭技能。
    • 开启:开启后,Agent 在对话中即可调用该技能。
    • 关闭:关闭后,Agent 将不再调用该技能。关闭技能不会卸载该技能。
      Image
  1. 在扣子 App 中,单击目标 Agent。
  2. 单击 Agent 名称。
  3. Agent 详情页,单击技能
  4. 在技能列表中,找到目标技能,开启或关闭技能。
    • 开启:开启后,Agent 在对话中即可调用该技能。
    • 关闭:关闭后,Agent 将不再调用该技能。关闭技能不会卸载该技能。
      Image

授权文件夹

扣子桌面端可以将你的个人电脑连接到扣子,让扣子 Agent 在获得授权后,帮助你处理本地电脑上的文件、文件夹和部分本地 Shell 任务。具体操作,请参考本地设备

查看授权

完成授权后,你可以在Agent 设置页面,查看授权范围。

  1. 扣子的对话列表中,单击目标 Agent。
  2. 在 Agent 的右上角,单击 Agent 设置图标。
  3. 单击已授权文件夹
    Image
  4. 查看已授权可访问的本地电脑文件夹。
    Image
  1. 扣子的对话列表中,单击目标 Agent。
  2. 单击 Agent 名称。
  3. Agent 详情页,单击已授权文件夹
  4. 查看已授权可访问的本地电脑文件夹。
    Image

取消授权

取消授权后,扣子无法操作你的本地电脑。

  1. 扣子的对话列表中,单击目标 Agent。
  2. 在 Agent 的右上角,单击 Agent 设置图标。
  3. 单击已授权文件夹
    Image
  4. 在指定文件下,单击取消授权
    Image
  1. 扣子的对话列表中,单击目标 Agent。
  2. 单击 Agent 名称。
  3. Agent 详情页,单击已授权文件夹
  4. 在指定文件下,单击取消授权
    Image

切换模型

模型就像是扣子的大脑,扣子的回答质量、响应速度、对复杂任务的处理能力很大程度上取决于你为它配置的模型。不同模型单价不同、也各有所长,你可以换几个模型对比一下效果和成本,从而选择最合适的模型。
目前扣子提供以下模型模式供你选择:

  • 自动(默认):后台自动调度,根据任务复杂程度、各个模型负载来灵活匹配合适的模型。
  • 指定模型:目前支持选择 Doubao-2.0-pro、GLM-5.1、Minimax-m2.7 或 Kimi-k2.5,均为业界先进的模型版本。关于模型费用,请参考扣子任务费用

注意

  • 各个模型的 Token 单价不同,单价更高的模型,每次对话消耗的积分越多。你可以在各个模型厂商官网查看模型单价。
  • 扣子会针对部分模型版本推出限时折扣活动,活动期间你可以以较低价格使用这些折扣模型。
  1. 扣子的对话列表中,单击目标 Agent。
  2. 在 Agent 的右上角,单击 Agent 设置图标。
  3. Agent 设置页面的模型设置卡片中,单击模型下拉列表,选择其他模型。
    Image
  1. 在扣子 App 中,单击目标 Agent。
  2. 单击 Agent 名称。
  3. Agent 详情页的模型设置区域,切换模型。
    Image

接入自定义模型

说明

  • 套餐限制:仅个人进阶版及以上版本支持添加自定义模型。
  • Agent 类型:仅 Coze Agent 支持切换为自定义模型,其他类型 Agent 均不支持。
  • 企业用户权限:企业组织成员均可添加自定义模型,默认仅自己可用,也可以在模型管理页面开启成员可用,将模型分享给企业其他成员。
  • 平台限制:仅限网页端和桌面端操作,移动端暂不支持添加和管理自定义模型。

扣子官方提供了 Doubao、GLM、Kimi 等大模型供你选择。除此之外,你也可以添加自定义模型、接入自己的模型 API,例如你自行部署的模型、第三方在线模型等。成功接入后,你的 Coze Agent 就可以使用自己的模型服务,使用自定义模型的 Agent 也不会再收取扣子对话费用,而是消耗你自己的 Token 费用。

接入方式

适用场景

服务商接入

使用扣子已适配的第三方模型服务商。
当前支持以下服务商:

  • 火山引擎方舟
  • Kimi
  • DeepSeek
  • 智谱 GLM
  • MiniMax
  • Kimi Code

自定义接入

使用用户自己的模型服务,或兼容 OpenAI 协议的第三方模型服务。
支持的协议类型:

  • Chat API
  • Responses API

服务商接入步骤:

  1. 模型管理页面右上角单击 + 接入模型
  2. 服务商接入页签中填写以下配置:
    • 服务商:选择需要接入的模型服务商。
    • API Key:调用服务商模型接口所需的鉴权凭证。以火山方舟为例,API Key 获取方式可参考火山方舟官方文档
    • 选择模型:选择需要添加到扣子中的模型。每次只能添加一款模型。
    • 图片理解:开启后,该模型可用于图片理解场景,需模型本身支持该能力。关闭后,图片理解场景将使用自动调用扣子提供的识图工具。
      Image
  3. 单击添加
    成功添加自定义模型后,就可以将 Agent 模型设置为你的自定义模型了。
    Image

自定义接入步骤:

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

常见问题