# 扣子Coze集成
扣子（coze）是目前国内最热门最强大的智能体平台之一，是字节跳动的产品。 扣子支持免费注册、免费体验。每天都有免费使用额度，能满足尝鲜和日常轻量使用。
为什么选择扣子？
1、灵活的工作流设计
扣子的工作流功能可以用来处理逻辑复杂，且有较高稳定性要求的任务流。扣子提供了大量灵活可组合的节点包括大语言模型 LLM、自定义代码、判断逻辑等，无论你是否有编程基础，都可以通过拖拉拽的方式快速搭建一个工作流。例如创建一个撰写行业研究报告的工作流，让智能体写一份 20 页的报告。
2、无限拓展的能力集
扣子集成了丰富的插件工具，极大地拓展智能体的能力边界。扣子官方发布了多款能力丰富的插件，你可以直接将这些插件添加到智能体中。例如使用新闻插件，打造一个可以播报最新时事新闻的 AI 新闻播音员。扣子平台也支持创建自定义插件。 你可以将已有的 API 能力通过参数配置的方式快速创建一个插件让智能体调用。自定义插件也可以发布到商店，供其他用户使用。
3、丰富的数据源
扣子提供了简单易用的知识库功能来管理和存储数据，支持智能体与你自己的数据进行交互。无论是内容量巨大的本地文件还是某个网站的实时信息，都可以上传到知识库中。这样，智能体就可以使用知识库中的内容回答问题了。
4、持久化的记忆能力
扣子提供了方便 AI 交互的数据库记忆能力，可持久记住用户对话的重要参数或内容。创建一个数据库来记录阅读笔记，包括书名、阅读进度和个人注释。有了数据库，智能体就可以通过查询数据库中的数据来提供更准确的答案。
具体可到扣子官网了解：https://www.coze.cn/open/docs/guides/welcome (opens new window)
七巧支持集成扣子的智能体，能在七巧AI功能里与扣子智能体对话，解决业务问题。
# 平台集成参数
前提条件：
1、请先到扣子官网注册扣子。
2、请先确认您在七巧开发平台是否有“智能体平台集成”的权限
目前，七巧集成扣子采用扣子的个人访问令牌方案。
1、进入“扣子API-授权-服务身份及凭证”。或“个人访问令牌”
服务身份及凭证，又称为服务令牌。相比个人访问令牌，它支持更长的有效时间，其他和个人令牌一致。
服务令牌有“永久”期限，而个人访问令牌最长30天。
可点击链接进入：https://www.coze.cn/open/oauth/pats (opens new window)
服务令牌：
个人令牌：
2、添加新令牌，保存令牌
点击右上角的【添加新令牌】，配置个人令牌的权限，然后点击确定。请保存好个人令牌，个人令牌只在创建时展示一次，后续将不再展示。
① 对于有效时间：如果不希望频繁变更，建议选择长一点的时间。
② 对于权限，请至少提供以下图片圈中的权限。
③ 对于授权的工作空间：即控制个人访问令牌能访问哪个工作空间的智能体。（一个账号可以有多个空间，每个空间可以有多个智能体。）
3、填写扣子平台参数
进入“七巧开发平台-AI中心-智能体平台集成”，点击扣子卡片，在弹窗里，填写平台地址、上面获取到的个人令牌。保存即可。
平台地址：固定是：https://api.coze.cn/ (opens new window)
# 技能参数
前提条件：请先完善平台集成参数。
在七巧的技能管理里（平台技能/应用技能），扣子的技能参数只有一个：扣子智能体id。
1、创建扣子智能体
进入工作空间，创建扣子智能体。
具体智能体搭建玩法，请参考扣子官方文档：
https://www.coze.cn/open/docs/guides/agent_overview (opens new window)
2、发布智能体
搭建完成后，点击智能体右上角的【发布】，进入发布页面。
发布时，注意勾选发布渠道。
对于七巧集成扣子，请勾选发布API。
其他渠道可不勾选，如果不希望智能体在coze市场、豆包等地方露出，请勿勾选发布到相应渠道。
3、复制智能体id
在浏览器的地址栏，最后那串数字就是扣子智能体的id。复制。
4、填写技能参数
在七巧开发平台，可以进入“AI中心-平台技能管理”，添加技能，技能类型选择调用智能体。
智能体平台选择扣子coze，然后将上面获取的智能体id填入。
或进入“七巧开发平台-我的应用-具体某个应用-技能管理”，维护应用技能的扣子参数。
然后，请查阅AI应用技能，查阅技能的具体用法。
# 知识库参数
目前七巧的附件同步、入口同步功能支持上传同步到Coze，需要获取Coze的知识库相关参数。
1、Coze知识库id获取：
2、七巧AI技能-同步知识库，参数填写：
为了让大模型更高效地处理、存储和检索文本，提升知识库回答的准确性与效率。知识库会将上传的文档（如 PDF、Word、文本等）拆分成若干个较小的“内容片段”。
分段标识符：分段标识符是用于手动拆分文档的 “标记符号”，用户可通过指定这些符号，让系统在对应位置分割文本。一般采用多个特殊符号组成，如“###”。注意：不要与自身业务数据重复。
分段最大长度：分段最大长度是指每个拆分后的 “内容片段” 允许的最大字符数，超过这个长度时，系统会自动截断或拆分。
