# 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智能体。

# 知识库参数

目前七巧支持将附件同步到dify。需要获取dify的知识库相关参数。
1、知识库API密钥获取：
在dify知识库内，点击左上角【API】，点击右上角【API密钥】，即可找到密钥。

2、知识库id获取：
知识库id可在浏览器地址获取。

3、七巧AI技能-同步知识库，参数填写
为了让大模型更高效地处理、存储和检索文本，提升知识库回答的准确性与效率。知识库会将上传的文档（如 PDF、Word、文本等）拆分成若干个较小的“内容片段”。
分段标识符：分段标识符是用于手动拆分文档的 “标记符号”，用户可通过指定这些符号，让系统在对应位置分割文本。一般采用多个特殊符号组成，如“###”。注意：不要与自身业务数据重复。
分段最大长度：分段最大长度是指每个拆分后的 “内容片段” 允许的最大字符数，超过这个长度时，系统会自动截断或拆分。