# 智能体平台集成

# 概述

七巧支持集成不同的智能体平台。集成后，七巧就能调用该智能体平台的智能体。

# 功能说明

# 前提条件

需要具备AI功能。如果您使用AI功能时，系统提示您当前版本不包含AI功能或功能过期时，请联系道一商务。也可以点击右下角的【在线咨询】咨询客服。

# 编辑

1、点击顶部的“AI中心”，然后进入“智能体平台集成”。

2、点击某个平台的卡片，填入相应参数，保存后就完成七巧与该平台的集成。不同平台的平台参数获取，请详见下面相应平台的集成说明。

# 移除

如果同一个平台需要更换或某平台不再使用，可以使用移除功能。例如，企业的腾讯知识引擎平台过期后不再使用，可以移除腾讯知识引擎参数，取消集成。

点击卡片，打开平台详情弹窗，点击左下角的【移除】按钮，可以移除该平台所有参数。移除后，平台状态会变为“未设置”，恢复为未集成状态。移除后，七巧的已配置AI技能将无法正常使用。

# Dify集成

七巧支持集成Dify平台。Dify是国内著名的开源智能体平台，功能强大、生态丰富。（Dify读音为：di fai） Dify支持知识库管理，能基于向量模型对文档进行切片，基于重排名模型对片段召回和排序。也支持图文片段。 Dify支持工作流，支持大模型、知识检索、参数提取器、http节点等节点，支持调用插件和工具。 Dify具体使用方法，请参考Dify官方帮助文档：https://docs.dify.ai/zh-hans/introduction

如需本地部署dify，且与七巧集成。请联系道一商务，可点击右下角的【在线咨询】。

# 平台集成参数

Dify与七巧集成需要以下参数： 平台地址：http://ip:端口/v1。如果是SaaS七巧，必须填入公网ip地址，并在公网ip里将七巧加入白名单。如果是私有化七巧，ip可以是本地ip。 secretKey：该key用于dify文件服务相关功能，例如图文回复。secretKey请从.env文件里获取，每个dify部署完，都会有唯一的secretKey。

备注：
1、必须允许公网访问dify。可以找云厂商购买公网ip并绑定到本地dify。
2、（可选）如果贵司对公网访问有防火墙设置，那需要将七巧ip加入访问白名单，允许七巧访问该公网ip。七巧ip请联系道一商务/技术支持人员获取。

# 技能参数

1、创建chatflow类型的智能体 登录dify，进入dify的工作室

创建“chatflow”应用。目前七巧集成dify，只支持这种格式。

2、配置智能体，并发布 进入chatflow，编排智能体工作流。然后点击右上角的【发布】。 具体各节点介绍、编排方法，可以参考dify官方帮助文档。

3、创建API访问密钥 进入“访问API”，点击右上角的【API密钥】。创建该智能体的API密钥。

4、配置七巧AI技能参数 将API密钥配置到AI技能，实现技能与智能体的绑定。确定后，后续通过AI助手调用技能时，实际上就是调用该技能绑定的dify智能体。

# 腾讯知识引擎集成

腾讯知识引擎是腾讯推出的面向B端的智能体平台，在知识库切片和检索具备很大优势。 可以进入腾讯云官网开通免费体验：https://lke.cloud.tencent.com/lke

腾讯知识引擎支持个人注册，免费体验。且它的工作流支持导出导入。

# 平台集成参数

1、腾讯知识引擎的平台参数使用“腾讯云”公共的API访问密钥。点击链接进入腾讯云控制台：https://console.cloud.tencent.com/cam/capi 在此页面，获取secretId、secretKey

备注：secretKey只有新建API密钥时可见，请做好备份保存！

2、在七巧填入平台集成参数 将在腾讯云API访问密钥获取的secretId、secretKey填入“智能体平台集成”的“腾讯知识引擎”，确定保存即可。 （腾讯云里，如果访问密钥有多个，任意一个即可）

# 技能参数

1、在腾讯知识引擎，新建知识引擎应用，一个应用相当于一个智能体。

2、在腾讯知识引擎，编排工作流，并完成调试 新建工作流

编排工作流，并完成调试。必须经过调试，工作流才能被智能体引用。调试后，工作流的状态会变为“待发布”。

3、在腾讯知识引擎，将应用切换成“单工作流模式” 点击左上角应用图标，将应用切换成“单工作流模式”，确保智能体每次启动都会触发工作流。

4、在腾讯知识引擎，发布应用 点击右上角【发布】，发布智能体应用

5、在腾讯知识引擎，获取应用id、appKey 在“发布管理-调用信息”获取该应用的appKey。在浏览器URL上，可以获取应用id

6、在七巧，在AI技能弹窗里，填入应用id、appKey

# 扣子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-授权-个人访问令牌” 可点击链接进入：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应用技能，查阅技能的具体用法。