Dify搭建智慧航道助手 + EdgeOne Pages一键部署上线全攻略

友友们，早上好呀，众所周知，本博主是做航道领域系统开发的。我们在航运物流、港口调度、航道规划行业中，一般需要快速查询航道通航状态、潮汐水位、船舶航线规划、航道法规、气象预警等信息。今天就分享一下我借助Dify快速编排工作流，新建智慧航道知识库，搭建专属智慧航道助手 AI 应用；再通过腾讯云 EdgeOne Pages官方全场景应用模板，零运维一键部署、全球边缘加速分发，从 AI 应用搭建到公网可访问的全流程。内容包括Dify 工作流编排、模型配置、API 密钥获取，以及EdgeOne Pages 模板部署、环境变量配置、部署上线等等，好了，下面我们直接开始。

一、整体方案架构

我们先来看一下整体的架构设计

1. 方案架构

Dify 端：选择模板 → 创建智慧航道助手工作流 → 配置大模型、提示词、用户输入节点 → 调试应用并生成 API 访问凭证 EdgeOne Pages 端：选用官方全场景应用模板 → 绑定gitee仓库 → 配置Dify接口环境变量 → 自动构建部署

注：EdgeOne Pages 这里的仓库，选择很多，大家自己选择合适自己的就好，另外dify访问好像大陆有点问题，建议用香港或者新加坡的服务器，我自己是用的香港节点的云服务器来进行开发的

2. 能力说明

1. Dify 产品能力落地：完整运用工作流编排、LLM 模型配置、变量引用、应用 API 开放能力；
2. EdgeOne 技术优势：依托全球 CDN 边缘网络，实现跨地域低延迟访问，无需服务器运维、自动 SSL 证书配置；

二、前期准备工作

1.注册登录Dify 官网，可以提前下载配置好 GPT-4o、Claude 等大模型供应商；

2.注册登录腾讯云 EdgeOne 控制台，开通 EdgeOne Pages 服务；

3.准备 gitee、GitHub 或者其他仓库的账号，用于 EdgeOne Pages 模板仓库授权部署，我这里就用gitee仓库了；

4.功能梳理，大家按照自己的ai应用梳理自己的功能需求，像我要设计的智慧航道助手核心需求：支持航道状态查询、潮汐时间推算、船舶航线建议、航运法规解读、恶劣天气通航预警五大核心能力。

三、第一步：Dify 搭建智慧航道助手 AI 应用

3.1 创建空白工作流应用

1. 进入 Dify 工作台，点击创建应用，选择工作流（Workflow） 类型，应用名称填写智慧航道助手，描述备注Dify x EdgeOne航运航道通航、潮汐、航线智能问答助手；
2. 进入工作流画布，开始拖拽节点编排完整业务流程。

3.2 工作流节点完整编排

1. 开始节点配置

选中画布开始节点，右侧添加用户输入字段：

• 字段标识：user_query
• 字段名称：用户咨询问题
• 字段类型：单行文本
• 是否必填：开启
• 功能：接收用户输入的航道相关咨询，如「长江南京段今日通航状态」「明日潮汐时间表」等。

2. LLM 大模型节点配置

拖拽LLM 节点至开始节点下游并连线，关键配置如下：

模型选择：选用 GPT-4o/Claude Sonnet 4（长文本理解、专业领域问答能力更强）；

可以设置系统提示词：

你是专业的智慧航道运维咨询专家，精通国内内河航道、沿海港口通航规则、潮汐气象、船舶航线规划、航运安全法规。
严格遵循以下规则回复用户问题：
1. 仅解答航道通航、潮汐水位、航线规划、航运法规、恶劣天气通航预警相关问题；
2. 回答结构清晰，分点说明，数据表述严谨，无明确数据时如实告知；
3. 拒绝无关娱乐、生活类问题咨询，礼貌引导聚焦航道相关业务；
4. 结合常规航运常识给出合理化建议，语言通俗易懂，适合港口从业者使用。
用户当前咨询问题：{{user_query}}

1. 模型参数：温度设置0.6（专业问答需低随机性），最大回复长度 2000 字符；
2. 保存节点配置。

3. 结束节点配置

拖拽结束节点连线至 LLM 节点下游，右侧设置输出内容为LLM 节点的回复结果，完成基础工作流闭环。

4. 拓展可选节点（进阶增强）

可按需添加HTTP 请求节点对接公开航道气象 API、条件判断节点区分咨询类型，实现精准应答，进一步强化应用实用性。

5.知识库创建添加

另外大家也可以添加自己的行业知识库

然后在节点中，调用自己的知识库，进行更加精准的搜索和回答。

3.3 应用调试与发布

1. 点击画布右上角运行调试，输入测试问题：长江航道枯水期通航注意事项，验证 AI 回复逻辑、内容准确性；
2. 调试无误后，点击右上角发布，发布版本选择正式版，对外开放 API 访问能力。

3.4 获取 Dify API 核心凭证

1. 回到智慧航道助手应用首页，点击左上角应用名称，进入访问 API页面；
2. 复制两个关键信息（后续 EdgeOne 配置必填）：
   • API 服务器地址：云端版固定为 https://api.dify.ai/v1
   • API 密钥：新建密钥并复制，格式为 app-xxxxxxxxxxxxxxxxxxxx

大家自己妥善保存密钥，不要泄露了。

3.5 提交 Dify 模板

大家也可以提交自己的模板

1. 将当前智慧航道助手导出为 DSL 文件；
2. 提交至 Dify Marketplace

四、第二步：EdgeOne Pages 部署智慧航道助手前端

4.1 进入 EdgeOne 官方 Dify 全场景模板

1. 登录腾讯云 EdgeOne 控制台，进入EdgeOne Pages产品页面；
2. 访问官方模板地址：https://pages.edgeone.ai/templates/dify-frontend ；
3. 模板亮点适配：支持 Chat 对话模式、流式输出、对话历史留存、适配 Dify 所有应用类型，完美匹配智慧航道助手对话场景。

4.2 授权 Gitee并创建项目

1. 点击模板页面Deploy按钮，跳转至 EdgeOne 配置页面；
2. 首次使用需点击立即开通EdgeOne Pages，绑定并授权Gitee账号；
3. 授权选择仓库范围：建议选择所有仓库，简化部署流程；
4. 项目基础配置：
   • 项目名称：xxx(写自己的)
   • 仓库名称：与项目名称保持一致
   • 加速区域：选择全球（适配跨地域用户低延迟访问）
   • 仓库类型：私有 / 公有均可

4.3 配置关键环境变量（核心步骤）

在项目环境变量配置区，新增 3 个必填变量，精准填入 Dify 获取的凭证：

表格

技术说明：环境变量为模板连接 Dify 后端的核心配置，填写错误会导致前端无法调用 AI 接口，务必准确复制无多余空格。

4.4 自动构建与全球部署

1. 配置完成后点击开始部署，EdgeOne Pages 将自动拉取模板代码、关联 GitHub 仓库、执行构建；
2. 等待 1-3 分钟，控制台显示部署成功，自动生成官方公网访问域名；
3. 域名格式示例：smart-waterway-ai-assistant.edgeone.app，该域名已自动配置 SSL 证书，支持 HTTPS 安全访问。

4.5 功能验证与效果测试

1. 复制部署生成的公网链接，浏览器打开；
2. 输入航道相关咨询问题，测试对话响应速度、回复准确性、流式输出效果；
3. 验证功能：对话历史保存、多轮上下文连贯、移动端自适应展示均正常生效。

五、总结

最后简单总结一下吧，今天和大家完整分享了：基于 Dify 原生工作流、模型编排和 API 对接能力，再搭配 EdgeOne Pages 全场景模板，从零手把手完成了智慧航道行业 AI 助手的搭建，并且一键部署到全球公网，全程跑通了从 0 到落地的完整流程。

整个体验下来特别省心： Dify 不用自己写复杂代码，可视化拖拽就能搭业务工作流、配大模型、接业务接口，垂直行业 AI 应用门槛直接拉低，运维、航道问答、巡检报表这类场景都能快速自定义； 而 EdgeOne Pages 自带现成模板、开箱即用，不用手写一行前端，就能直接把做好的 AI 应用公网发布、全球访问，部署简单又稳定。

依托这两个产品的原生能力互补，普通人也能快速落地智慧航道这类垂直行业 AI 应用，不用投入大量开发成本。希望今天的分享，能给大家做行业 AI 搭建和部署带来一点参考和帮助。