Agent Skills
返回列表
飞书配对审批

飞书配对审批

AI Agent 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3fb2cd03/huangzixuan-feishu-pairing。

技能介绍

要解决的问题

当飞书 IM 通道配置了 pairing 访问策略时,新群聊或用户首次尝试与机器人对话,会收到类似「您暂时还无法与我对话,需要机器人主人的允许。您的请求已发送,获得允许后即可正常使用。」的提示。此时会话处于待审批状态,必须由机器人管理员找到对应请求并逐一处理,否则用户始终无法对话。本技能负责自动化这一段人工查找与处理流程。

核心能力与工作步骤

  • 查询待审批列表:通过 qw_query 工具查询飞书通道的配对信息,返回 pending(待审批)和 approved(已通过)两个列表,pending 中每条包含 conversationId、senderId、conversationName、conversationType 和触发消息内容。
  • 展示并确认:以清晰格式展示待审批请求的会话名称、类型(群聊/私聊)、发送者 ID 和触发消息。若只有一条记录且用户意图明确,可跳过确认直接执行。
  • 执行审批:通过 qw_action 工具批准或拒绝指定请求,执行成功后告知用户,并提示对方重新尝试对话。
  • 结果验证:再次调用 qw_query 确认请求已从 pending 移入 approved,并建议在对应群聊中重新 @机器人 验证回复。

适用边界与注意点

  • senderId 是必传参数,最常见的错误是只传 conversationId,会报 Missing params.senderId 类错误。
  • conversationId 和 senderId 必须来自同一条 pending 记录,不能混用不同记录的 ID。
  • 飞书频道未连接时查询可能返回空结果或错误,需先在 QoderWork 中连接频道。
  • 审批操作不可撤销,误批准需在频道管理界面手动移除配对。
  • 若用户从 IM 通道发起此请求,应直接在文本中询问,而非调用 AskUserQuestion 工具。

使用场景

  • 飞书群开启 pairing 策略后,新成员 @机器人 被拒,需要管理员查看待审批列表并批准,让对方能正常对话
  • 用户私信机器人收到「需要主人允许」提示,管理员要查询 pending 列表并批准该私聊配对请求
  • 多条群聊配对请求积压,管理员逐条核对会话名称与触发消息,选择批准或拒绝指定请求
  • 审批执行后,管理员再次查询配对状态确认请求已通过,并在群内 @机器人 验证能否正常回复

适合人员

  • 飞书机器人管理员:开启 pairing 策略后,需要及时处理新群聊和用户的配对审批,避免成员一直无法与机器人对话
  • 使用 QoderWork 接入飞书的开发者:调试机器人首次回复被拦截的问题时,需要查询 pending 配对列表并执行批准或拒绝
  • 机器人运维人员:收到用户反馈「暂时无法与机器人对话」时,需要定位配对请求状态并完成审批操作