文档中心

Appearance

控制台

构建共享制度知识的飞书员工服务助手 ​

连接 AI 助手

本实战把一项统一维护的制度知识服务接入飞书。两位员工首次发送 /init 时会分别获得智能体实例，随后都能通过各自实例查询同一套制度资料。你将在智能体开发服务平台（AgentWorks）中使用用户绑定和 Trace 验证实例按用户创建、知识由两个实例共享。

本页只使用专用测试应用、测试用户和虚构制度资料。

本实战将帮助你理解 ​

  • 如何把已经验证的知识库组实例与飞书模板绑定组合成一项员工服务，而不为每位员工重复维护制度资料。
  • 为什么员工的智能体实例和用户绑定需要分别创建，而制度资料可以由多个实例共同使用、统一维护。
  • 如何用用户绑定证明消息进入了对应员工实例，再用 Trace 证明两个实例都检索了目标知识，而不是只判断最终回答是否合理。

注意

按用户开通并统一维护知识

如果你的目标是构建一项由多位员工分别使用、但制度资料统一维护的服务，请继续完成本实战。如果你只想先验证 /init、用户绑定和按用户配置实例，不需要接入共享知识，请从更聚焦的构建按用户开通的飞书个人工作助手开始。

准备条件和样例 ​

开始前需要：

  • 一个已经通过实际回复验证的模型凭证和模型。尚未验证时，先完成创建第一个智能体并完成基础验证。
  • 一个已经通过固定问题验证的知识库组实例。本实战沿用构建可追溯的企业知识助手中的虚构制度资料；也可以使用能够回答同样固定问题的现有测试知识库组实例。
  • 创建智能体模板和飞书渠道账号的权限。
  • 一个专用于本实战的飞书企业自建应用。该应用已启用机器人能力，使用长连接订阅 im.message.receive_v1，具有接收单聊和以机器人身份回复所需的权限，并已发布给两位测试用户。
  • 同一测试企业中的两位测试用户，以及这两位用户在当前飞书应用中的发送者 ID。

本文使用 recipe-feishu-employee-service-v1 作为资源名称。如果环境中已有同名资源，请统一追加简短后缀，不要修改或复用来源不明的资源。

完整的飞书应用准备方法参见接入飞书机器人。

注意

使用专用应用并保护凭证

一个飞书应用只能连接一个启用的 AgentWorks 渠道账号。不要复用已经连接其他环境或渠道账号的应用。App Secret 只填写到 AgentWorks 渠道账号中，不要放入提示词、聊天消息、截图或测试记录。

理解按需开通和共享知识 ​

下面的关系图展示本实战有意采用的资源范围：员工实例分别创建，知识库组实例由两个员工实例共同使用。

图表预览

员工获得不同的智能体实例和用户绑定，因此可以分别管理实例状态和生命周期。两个实例连接同一个知识库组实例，因此制度资料和检索配置由一处维护。不同实例 ID 本身不表示知识、记忆、凭证或业务权限已经隔离。

只需分开对话而不需要分别管理实例时，绑定一个已经创建的共享智能体实例更简单。选择方法参见通过渠道提供智能体。

以下入口仅在租户已启用知识库和飞书渠道能力时可用。按钮会在新标签页打开控制台。若先进入登录页，控制台目前不会在登录后自动返回目标页面；请登录后返回本文，再次选择按钮。

创建员工服务智能体模板 ​

本阶段由 AgentWorks 配置者完成。

  1. 打开创建智能体模板页面。

    创建智能体模板

  2. 将 模板名称 设为 recipe-feishu-employee-service-v1，选择已经验证的模型凭证和模型。

  3. 在 系统提示词 中输入：

    language-text
    你是面向员工的内部服务助手。
回答支持制度和事件升级问题前，必须先检索已连接的知识库。
只根据检索到的资料回答，不要补充资料中没有的政策、时限、金额、工单状态或负责人。
如果资料没有答案，明确说明资料未提供该信息，并建议联系对应制度负责人。
使用简洁中文回答。

  4. 在 插件配置 中添加 知识库 RAG - 实例，再选择准备好的知识库组实例。

    注意

    为什么选择现有知识库组实例？

    这样，每位员工通过 /init 创建的智能体实例都会连接同一个已经验证的知识服务。更新这项知识服务后，不需要为每位员工重新导入资料。需要让不同实例使用不同知识资源时，应改为分别准备相应资源。参见知识库 RAG 模板和实例有什么区别？。

  5. 关闭默认开启的 启用文件系统，不添加其他能力。本实战只验证知识检索和飞书交付。

  6. 选择 创建智能体模板，再在模板的 插件 中确认目标知识库组实例已经关联。

创建模板绑定的飞书渠道账号 ​

新建飞书渠道账号时选择需要用户执行 /init 的模板绑定

  1. 打开 渠道账号。

    打开渠道账号

  2. 选择 新建账号，在 渠道类型 中选择 飞书。

  3. 将 账号名称 设为 recipe-feishu-employee-service-v1，填写专用应用的 应用 ID（凭证）和应用密钥。

  4. 在 绑定模式 中选择 模板绑定（agent_id 指向 Agent 模板，用户需 /init），再选择刚创建的智能体模板。

  5. 在 单聊允许的发送者 ID 中填写两位测试用户在当前应用中的 ID，并选择 禁用群聊。

    注意

    发送者 ID 属于当前飞书应用

    同一位飞书用户在不同应用中的发送者 ID 可能不同。不要直接复用其他应用记录的 ID，也不要在已经分发的应用中通过留空允许名单来试探用户 ID。

  6. 选择 创建并启用渠道账号，等待状态变为 在线。

  7. 打开渠道账号的 用户绑定，确认两位用户尚未产生绑定记录。

让两位员工按需开通 ​

下面先由两位飞书测试用户分别完成首次使用，再由 AgentWorks 配置者检查路由和知识检索。

开通第一位员工 ​

第一位测试用户执行以下操作：

  1. 在飞书中发送：

    language-text
    /init

  2. 收到初始化成功提示后发送：

    language-text
    P1 事件的首次响应目标是多少？请只依据资料回答。

  3. 确认回答包含 15 分钟。

开通第二位员工 ​

第二位测试用户执行以下操作：

  1. 在飞书中发送：

    language-text
    /init

  2. 收到初始化成功提示后发送：

    language-text
    确认 P1 后 30 分钟仍没有技术负责人时，应执行什么升级动作？请只依据资料回答。

  3. 确认回答包含值班热线，以及事件编号、影响范围、已完成操作和当前阻塞项。

核对两位员工的用户绑定 ​

AgentWorks 配置者执行以下操作：

  1. 打开渠道账号的 用户绑定，记录两位用户对应的智能体实例 ID。
  2. 确认两个实例 ID 不同，并且都能在 智能体实例 中找到。
两个飞书测试用户分别绑定到不同的智能体实例

检查 Trace 和资料边界 ​

  1. 分别打开两位用户对应的智能体实例，在 Trace 中找到刚才的制度问题。
  2. 确认两次调用都执行了知识检索，collection_name 指向同一个 Collection 资源 ID，并且检索结果包含最终回答使用的制度内容。 用户绑定证明消息进入哪个智能体实例；Trace 证明两个实例实际检索了同一项知识资源。回答相似本身不能代替这两项检查。

完成结果：两位员工分别获得自己的智能体实例，并能通过飞书从同一套制度资料得到有依据的回答；用户绑定和 Trace 分别证明了消息路由与知识检索。

可选：验证资料不足时不编造 ​

由第一位测试用户在飞书中发送：

language-text
P1 事件可以获得多少合同赔付？请只依据资料回答。

确认回答说明资料没有提供赔付金额，没有编造金额。再打开对应智能体实例的 Trace，确认智能体检索了同一个 Collection，且检索结果没有提供赔付金额。

可选：验证重复初始化和重新开通 ​

这是可选的生命周期练习，不影响前面的完成结果。删除绑定会改变消息路由，只能对本实战的非生产用户执行。

第一位员工检查重复初始化 ​

第一位测试用户再次发送 /init。确认机器人提示已经初始化，用户绑定不变，也没有创建另一个实例。

配置者删除第二位员工的绑定 ​

  1. 记录第二位用户的原实例 ID。
  2. 在 用户绑定 中选择 删除绑定并确认删除。
  3. 确认绑定列表中不再显示该用户，而原智能体实例仍然存在。

第二位员工重新开通 ​

  1. 发送一条普通消息，确认机器人要求先发送 /init。
  2. 再次发送 /init，等待平台创建新实例。
  3. 发送前面的固定制度问题，确认仍能得到有依据的回答。

配置者核对新实例 ​

  1. 确认新绑定指向不同的新实例，原实例仍然保留。
  2. 在新实例的 Trace 中确认知识检索仍指向同一个 Collection。
删除用户绑定后重新初始化并再次取得资料答案

删除绑定只会移除用户与原实例的路由关系。原实例及其能力资源仍需由运营人员单独处理。参见管理用户绑定。

如果验证没有通过 ​

  • 渠道账号无法保持在线：检查 App ID、App Secret、应用版本、机器人能力和长连接事件订阅，并确认同一飞书应用没有连接另一个启用的渠道账号。
  • 某位员工没有收到回复：检查该用户在当前应用中的发送者 ID、单聊允许名单和机器人可见范围。
  • 回答没有使用制度资料：检查智能体模板是否关联正确的知识库组实例，再在对应 Trace 中确认是否执行知识检索；不要通过改写答案来掩盖检索失败。
  • 两个 Trace 指向不同 Collection：停止验收，重新核对模板关联的知识库组实例和各实例配置。

调整为自己的员工服务 ​

  • 所有员工只需不同对话时，考虑使用实例绑定，减少实例和清理工作。
  • 每位员工需要独立实例参数或执行资源时，保留模板绑定，只开放确实需要在 /init 中填写的参数。
  • 资料由一处维护时，复用经过验证的知识库组实例，并指定内容负责人。
  • 需要按员工隔离私有资料时，不要只依赖不同实例；为知识、记忆、凭证和外部系统建立相应的身份与权限边界。

准备上线和清理 ​

上线前确定飞书应用负责人、App Secret 轮换、允许名单、知识内容负责人、实例容量、用户绑定清理、离职用户处理、Trace 检查和原实例保留策略。参见管理渠道账号与用户绑定和将智能体投入生产。

清理本实战时，先停用飞书渠道账号，再删除测试用户绑定并分别处理对应智能体实例；随后删除渠道账号和智能体模板。只有在没有其他智能体引用时，才能清理知识资源。最后在飞书开放平台停用测试应用并撤销 App Secret。