导入 Dify 应用 — Dify 安装中的聊天助手
一个以 Dify DSL 导出的 Dify 聊天应用,由 aggrega import 导入为一个 Aggregate、一个 Release 和一个 Manifest,它们按原样为 Kubernetes 构建承载该应用的标准库 Dify 安装。
导入 Dify 应用 逐步讲解了这一过程:命令、它写入的文件、构建,以及对构建结果的一次运行。此文件夹保存了该演练的每个阶段:
| 文件夹 | 内容 |
|---|---|
source/ | 应用 support-assistant.yml;使该文件夹成为工作区的 .aggrega-config.yaml;以及 import-answers.yaml,即对任何应用都无法包含的内容的回答:保存该安装的应用密钥和所有者密码的 Kubernetes Secret 的名称,以及所有者账户的电子邮件 |
draft/ | aggrega import support-assistant.yml --target helm 写入的文件(未经修改),以及它打印的内容:stdout.txt 为标准输出,import.txt 为标准错误 |
source/support-assistant.yml 是为本示例编写的,采用 Dify 在 DSL 版本 0.7.0 下导出应用的格式。
在文档仓库的检出副本中,check.sh 会重新运行导入,将其写入和打印的内容与 draft/ 比较,将演练引用的代码块与这些文件比较,并验证和构建导入所写入的内容。它需要将标准库目录(获取途径)检出在此仓库旁边,或在 AGGREGA_CATALOG_DIRS 中指定其目录。
生成示例
你可以使用下面的命令运行本示例的导入,或者让你的 AI 助手替你运行。
将示例写入一个以其命名的新文件夹:
aggrega scaffold --example import-dify然后它会打印接下来要运行的命令。第一条命令进入新文件夹:
cd import-dify构建
导入会在项目旁边的 source/ 中起草 Aggrega 文件,从 import-answers.yaml 中获取任何应用都无法包含的内容,并拉取构建所需的内容。它将项目与标准库目录进行比对,该目录由工作区的默认注册表以签名快照的形式发布:首次导入会获取它、验证它、将其保存在工作区的内容缓存中,并在写在草稿旁边的记录里以其摘要(digest)标识它。若工作区指定了自己的目录文件夹 — 在 AGGREGA_CATALOG_DIRS 中,或在 workspace.catalog_dirs 下 — 则改为针对这些文件夹进行导入:
cd sourceaggrega import support-assistant.yml --target helmaggrega validate --release release.yamlaggrega build --release release.yaml如何创建构建产出的清单所读取的 Secret 以及如何运行这些清单,见上面链接的分步讲解。
借助 AI 助手
已配置 Aggrega 工具的 AI 助手也能完成同样的操作:把下面这条提示粘贴给它。
只使用 Aggrega 工具,不要自己创建任何文件夹。如果工作区文件夹中还没有 `import-dify` 文件夹,调用一次 `scaffold` 工具,将 `example` 设为 `import-dify`,不设 `dir`:它会把示例写入一个新的 `import-dify` 文件夹,其中的 `source` 文件夹包含本示例要导入的内容。然后调用 `import` 工具,将 `workspace_root` 设为 `import-dify/source`,`source` 设为 `support-assistant.yml`,`target` 设为 `helm`:它从 `support-assistant.yml` 旁边的 `import-answers.yaml` 读取所需的答案,将草稿写入 `import-dify/source`,并拉取草稿所需的内容。然后调用 `validate` 工具,将 `workspace_root` 设为 `import-dify/source`,`release` 设为 `release.yaml`;再调用 `build` 工具,将 `workspace_root` 设为 `import-dify/source`,`release` 设为 `release.yaml`,`write` 设为 true。告诉我构建写入了哪些文件;它们位于 `import-dify/source/dist/` 下。测试
使用 --target compose 导入,并按照分步指南中 在 Docker Compose 上 所示启动后,该安装会在本机上响应:API 位于 http://127.0.0.1:5001,控制台位于 http://127.0.0.1:3001/signin。应用会响应使用其自身密钥发送的消息,该密钥由 分步指南 在登录、从 Dify 的插件市场安装 OpenAI 提供方(草拟的 Release 中的 marketplace_enabled 让该安装能够访问这个市场)并设置该提供方的密钥之后创建:
curl -sS http://127.0.0.1:5001/v1/chat-messages \ -H 'Authorization: Bearer <app key>' -H 'Content-Type: application/json' \ -d '{"inputs": {}, "query": "In one short sentence: what does a support plan cover?", "response_mode": "blocking", "user": "test-it"}'本次运行的提供方密钥是一个占位符,设置时 Dify 以 OpenAI 的 Incorrect API key provided 拒绝了它,因此该消息得到的是:
{"code":"provider_not_initialize","message":"Model gpt-4o-mini credentials is not initialized.","status":400}如上所述为 Kubernetes 构建,并按照分步指南中 运行它 的方式应用后,只要将一个本地端口转发到其 Service,API 就会在同一地址响应相同的请求;本次运行在那里得到了相同的回复:
kubectl port-forward -n <namespace> svc/dify-zdapi-default 5001:5001