飞书集成：在聊天中调用你的 Agent
你可以在 Pipora 的网页界面里和 Agent 对话，也可以创建工作流来自动化任务。如果团队日常协作主要发生在飞书里，就可以把 Agent 接入飞书，让查询、审批和工作流通知直接进入聊天场景。
Pipora 支持把 Agent 接入飞书（Lark），让它以机器人形式在私聊或群聊中提供服务。
飞书集成是什么
飞书集成是一条消息通道，它把你的 Pipora Agent 和飞书机器人连接起来。
配置好后，你在飞书里发送消息，机器人会把消息转给 Agent；Agent 完成理解、调用工具或运行工作流后，再把结果返回飞书。
整个过程不需要你打开 Pipora 的网页界面——在熟悉的飞书聊天窗口里就能完成。
能做什么
私聊机器人，一对一对话
你可以直接给机器人发私信：
- 问它问题，它会基于你的 Agent 能力来回答
- 让它执行某个工具操作，比如查询数据、整理文件
- 多轮追问，它能记得你们之前聊过什么，不会每次从零开始
群里@机器人，团队协作
在群聊里，只要@机器人并带上你想说的话，它就能响应：
- 群成员都能看见问题和回答，信息透明
- 适合团队共享的查询场景，比如「@机器人 查一下本周的数据汇总」
- 机器人只响应@它的消息，不会打扰正常群聊
多轮对话，上下文自然延续
不管是私聊还是群聊，机器人都记得同一段对话的上下文：
- 你问「明天北京天气怎么样」，它回答了
- 接着问「那上海呢」，它知道你还在说天气，不需要重复说「北京」
- 同一个人在同一段对话里的连续提问，Agent 都能连贯理解
工具审批卡片
当 Agent 想执行某个敏感操作时（比如删除文件、调用外部接口），它不会擅自行动，而是会发一张交互卡片到飞书：
- 卡片上写明「我想执行某某操作，参数是什么」
- 你点击「同意」或「拒绝」
- 同意后 Agent 才继续执行，拒绝则取消
这让 Agent 可以执行更完整的任务，同时关键操作仍由你确认。
工作流暂停卡片
如果你的工作流里设计了「人工审批节点」，当流程跑到这里暂停时，飞书里会收到一张卡片：
- 卡片提示「某某工作流暂停了，需要你确认是否继续」
- 你点击「继续」或「终止」
- 选择后工作流自动恢复运行或结束
这样你不需要一直打开 Pipora 网页，也能在飞书中及时处理暂停节点。
为什么要接入飞书
减少切换成本
团队成员已经在飞书里沟通、协作、接收通知。把 Agent 能力接进来，意味着：
- 不需要额外打开一个网页或应用
- 查询和操作就在日常聊天窗口里完成
- 新成员可以在熟悉的协作工具中开始使用
审批流程更及时
工具审批、工作流暂停这类需要人工介入的环节，通过飞书卡片推送：
- 审批请求像普通消息一样出现在聊天列表里
- 手机上也能处理卡片并完成确认
- 不会因为没看网页而耽误流程
团队共享 Agent 能力
在群里@机器人，相当于把 Agent 的能力开放给整个团队：
- 一个人配置好的 Agent，全团队都能用
- 常见问题的答案、常用操作的执行，大家都能复用
- Agent 的回复所有人可见，减少重复询问
如何配置
第一步：在飞书开放平台创建机器人应用
你需要有一个飞书企业账号，并在飞书开放平台创建一个自建应用：
- 进入飞书开放平台，创建一个新的企业自建应用
- 给应用开通「机器人」能力
- 获取应用的 App ID 和 App Secret
- 找到机器人的 Open ID（可选，但建议填写，用于精准识别群聊中的@消息）
- 确保应用有接收消息和发送卡片的权限
第二步：在 Pipora 中填写配置
打开 Pipora 的 Web 界面，进入「设置」→「飞书配置」：
- 启用飞书集成：勾选开关，开启集成
- App ID：填写从飞书开放平台获取的 App ID
- App Secret：填写对应的 App Secret
- Bot Open ID：填写机器人的 Open ID，帮助准确过滤群聊中的@消息
填写完成后保存。你也可以通过环境变量的方式配置这几项信息，效果是一样的。
第三步：重启服务生效
保存配置后，需要重启一次本地服务，飞书集成才会真正启动。
第四步：把机器人拉进群（如果需要群聊功能）
如果希望团队成员能在群里@机器人，需要手动把机器人拉进对应的飞书群聊。
怎么使用
私聊机器人
在飞书里找到机器人，直接发消息：
帮我总结一下本周的会议纪要
机器人会把消息转给默认的 Agent（通常是通用助手），然后把回答发回来。
群里@机器人
在群聊里：
@机器人 帮我查一下上个月的销售数据
机器人会检测到@了自己，提取你的问题，交给 Agent 处理，然后把结果发到群里。
@指定 Agent
如果你配置过多个 Agent，还可以在消息开头指定用哪个 Agent：
@机器人 @数据分析员 帮我生成一份周报
这样消息会路由给「数据分析员」这个 Agent 来处理，而不是默认的通用助手。
处理审批卡片
当 Agent 需要执行敏感操作时，你会在聊天里收到一张卡片：
- 卡片上写清楚了「要做什么」和「涉及哪些参数」
- 点击「同意」，Agent 继续执行，执行结果稍后发给你
- 点击「拒绝」，Agent 取消这次操作
处理工作流暂停卡片
当工作流跑到人工审批节点暂停时：
- 你会收到一张卡片，提示「某某工作流需要你确认」
- 点击「继续」，工作流恢复执行
- 点击「终止」，工作流结束
一句话总结
飞书集成 = 把 Pipora Agent 接入飞书协作场景。配置好后，你可以在私聊或群聊中直接与 Agent 对话，接收工具审批和工作流暂停的交互卡片，减少在多个应用之间切换。