用Dify搭建飞书AI助手：企业自建应用 + 知识库检索 + 结构化答案

文章简介本文手把手教你搭建一个飞书AI助手实现飞书应用机器人触发、基于知识库的智能问答、结构化答案输出。适合需要企业知识库问答场景的开发者。标签Dify、飞书、知识库、企业自建应用、AI助手前言在前两篇文章中我们分别搭建了多分支AI客服和工单审批流实现了意图识别和条件分支处理。这次我们来解决一个更实用的场景飞书AI助手。这篇文章能解决什么问题企业里经常有这样的需求员工在飞书问怎么申请VPN销售问产品A的最新报价是多少客服问这个故障怎么处理传统方式问题1重复回答效率低问题2答案不统一容易出错问题3资深员工被频繁打扰通过本文你将学会如何用Dify 飞书搭建AI助手如何基于知识库检索回答如何输出结构化的专业答案读完这篇你能得到什么一个完整可运行的飞书AI助手Demo理解知识库检索的使用场景掌握Dify与飞书企业自建应用集成的方法前置知识需要了解Dify的基本使用有飞书管理员权限更佳。一、项目需求飞书问答的痛点重复性问题多80%的问题都是常见问题答案不统一不同人回答可能不一致响应不及时依赖人工回复无法7×24小时知识分散产品文档、FAQ分散在各处需要实现的功能本文要搭建一个飞书AI助手实现以下功能应用机器人触发在飞书给应用机器人发消息即可提问知识库检索基于企业知识库回答结构化输出返回格式化的专业答案预期效果用户在飞书给应用机器人发送消息 → Dify接收消息 → 知识库检索 → LLM生成答案 → 返回结构化回复二、核心概念知识库检索什么是知识库检索知识库检索是Dify的一个重要功能它允许你上传企业文档PDF、Word、Markdown等自动分段和建立索引根据用户问题检索相关内容将检索结果提供给LLM生成答案什么场景下需要知识库检索企业FAQ产品手册、常见问题技术文档API文档、开发指南规章制度员工手册、流程规范培训资料产品培训、销售话术本文的知识库设计我们用知识库来存储企业产品文档用户提问 → 知识库检索 → 返回相关段落 → LLM基于内容生成答案设计思路检索阶段找出与用户问题最相关的文档片段生成阶段LLM基于检索内容组织语言不编造答案输出阶段返回结构化的Markdown格式答案三、环境准备Dify版本1.11.x飞书企业版需要管理员权限知识库提前准备好产品文档LLM模型DeepSeek内网穿透Cloudflare Tunnel如Dify部署在内网四、开始搭建4.1 创建飞书企业自建应用打开 飞书开放平台点击「创建企业自建应用」输入应用名称Dify AI助手点击「创建」4.2 获取应用凭证进入应用详情页点击「凭证与基础信息」复制以下信息App IDApp Secret保存好这两个凭证后续需要用到4.3 添加应用能力机器人在飞书开放平台应用详情页点击左侧菜单「应用能力」点击「添加应用能力」选择「机器人」能力点击「添加」说明机器人能力是飞书AI助手的基础必须添加添加后用户可以在飞书客户端搜索并与机器人对话4.4 配置权限点击「权限管理」添加以下权限权限名称权限标识说明获取与发送单聊消息im:message:send_as_bot发送消息给用户接收消息im:message接收用户消息提交审核如是企业内部应用可直接启用4.5 创建Dify工作流打开Dify → 创建应用 → 选择「工作流」输入应用名称飞书AI助手点击「创建」进入工作流画布整体结构收到消息 → 知识检索 → LLM处理 → 发送LARK应用消息4.6 配置Dify接收飞书消息关键安装Lark触发器插件后使用「收到消息」节点在Dify工作流画布中点击「开始」节点选择「收到消息」节点配置订阅要记录好回调URL选择订阅4.7 配置内网穿透Dify部署在内网时需要如果 Dify 部署在内网环境需要配置内网穿透使飞书服务器能够访问到 Dify 的回调地址。使用 Cloudflare Tunnel 配置内网穿透下载 cloudflaredcurl-Lhttps://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-amd64-ocloudflared添加执行权限chmodx cloudflared启动内网穿透假设 Dify 运行在本地 80 端口./cloudflared tunnel--urlhttp://localhost:80启动成功后终端会显示一个公网 URL如https://xxxxx.trycloudflare.com请保存这个地址说明内网穿透工具会生成一个临时的公网 URL用于飞书回调每次重启 cloudflared 后 URL 可能会变化需要更新飞书中的配置生产环境建议使用固定的域名和稳定的内网穿透方案4.8 配置飞书事件与回调回到飞书开放平台点击「事件与回调」选择「事件配置」标签页配置订阅方式在「请求地址」填入 Dify 生成的回调URL如果使用内网穿透则使用 cloudflared 生成的公网地址替换http://localhosthttps://xxxxx.trycloudflare.com/triggers/plugin/xxxxx添加事件im.message.receive_v14.9 发布应用点击「版本管理与发布」创建新版本提交发布在「应用发布」→「待发布」中确认注意企业自建应用需要管理员审核或在后台直接启用。4.10 添加「知识检索」节点在「收到消息」节点后直接查询知识库获取相关内容添加「知识检索」节点配置知识库选择已创建的知识库如产品文档、FAQ等查询内容使用「收到消息」节点的消息内容变量知识库准备提前在 Dify 中创建知识库上传产品文档、常见问题等资料配置好分段和索引策略4.11 添加「LLM」节点在「知识检索」节点后添加「LLM」节点模型选择DeepSeek系统提示词你是一个飞书群助手。请根据用户的问题和知识库检索结果给出专业、准确的回答。 回答要求 1. 基于知识库内容回答如果知识库中没有相关信息说明根据现有资料我暂时无法回答这个问题 2. 简洁明了直接回答问题 3. 使用 Markdown 格式输出支持标题、列表、代码块等 4. 如果涉及步骤说明使用有序列表 5. 如果不知道答案诚实地说明不要编造用户提示词用户问题{{#1775661379508.content#}} 知识库检索结果 {{#context#}} 请基于以上知识库内容给出结构化的回答。如果知识库中没有相关信息请说明。4.12 添加「发送LARK应用消息」节点将 LLM 的结构化回答发送回飞书关键安装Lark消息和群组插件后使用「发送LARK应用消息」节点拖入「发送LARK应用消息」节点配置接收人和消息内容五、完整工作流结构┌─────────────────────────────────────────────────────────────┐ │ Demo3 完整工作流 │ └─────────────────────────────────────────────────────────────┘ 开始收到消息 │ ▼ 知识检索根据用户消息查询相关内容 │ ▼ LLM基于知识库生成结构化答案 │ ▼ 发送LARK应用消息将结构化答案发回飞书 │ ▼ 结束六、测试验证测试用例场景测试问题预期结果产品咨询“有什么产品”基于知识库返回所有产品列表无答案“公司明年战略是什么”说明无法回答实际测试在飞书搜索「Dify AI助手」输入测试问题查看返回的结构化答案七、常见问题Q: 企业自建应用需要审核吗A如果是企业管理员创建的应用可以直接启用如果是普通员工创建需要管理员审核Q: 收不到飞书消息A: 检查应用是否已发布/启用事件订阅是否正确配置Dify 回调URL 是否可访问权限是否正确配置八、与Demo1/Demo2的区别项目Demo1Demo2Demo3核心功能意图识别 分支紧急程度判断知识库检索 飞书应用应用场景智能客服工单审批企业知识问答外部集成HTTP请求HTTP请求飞书 知识库消息来源用户输入用户输入飞书应用消息新特性-代码执行知识库检索 内网穿透九、总结通过本文你学到了什么飞书企业自建应用创建应用、添加机器人能力、配置权限内网穿透配置使用Cloudflare Tunnel实现内网Dify的公网访问知识库检索文档上传、分段、检索策略结构化输出Markdown格式、专业答案知识库检索的使用技巧文档质量上传结构清晰的文档分段策略合理设置分段长度和重叠检索调优调整相似度阈值平衡召回和精确提示词工程指导LLM基于检索内容回答参考资料Dify官方文档飞书开放平台Dify GitHubCloudflare Tunnel文档