如何在飞书使用扣子

本文介绍扣子编程在飞书侧的一些典型使用场景，包括单点登录、智能对话、多维表格字段捷径、数据与知识管理。

简介

扣子编程与飞书深度集成，你可以通过扣子编程搭建的智能体，在飞书平台内快速落地 AI 应用，提升协作效率、降低人工成本、实现知识与数据的自动化流转。

典型场景包括：

• 通过 SSO 实现飞书账号直接登录扣子编程：支持通过飞书账号 SSO 单点登录扣子编程，实现企业身份体系统一管理，员工无需重复认证即可使用扣子编程服务。
• 飞书 AI 机器人智能对话：将扣子编程侧搭建的智能体发布为飞书 AI 机器人，用户可在飞书聊天窗口直接调用智能体，与智能体进行业务咨询、任务协助等对话交互，实时获取 AI 支持。
• 通过飞书多维表格字段捷径自动处理数据：通过飞书多维表格字段捷径，将智能体能力嵌入表格，实现批量翻译、文本提取、标签分类等重复性数据处理任务，提升数据处理效率。
• 扣子编程自动写入飞书多维表格：支持通过扣子编程官方提供的飞书多维表格插件、飞书云文档插件、飞书电子表格插件，实现工作流自动化将扣子编程的业务数据，如智能体交互记录、任务结果等写入飞书文档，实现数据实时同步与集中管理。
• 飞书文档作为知识库：支持将飞书文档（云文档、Wiki）作为扣子知识库，实现知识内容自动同步与智能检索。

场景一：通过 SSO 实现飞书账号直接登录扣子编程

对于已对接 SAML 2.0 协议或 OAuth 2.0 协议 IdP（Identity Provider，身份提供商）的企业，通过配置 SSO 登录，可实现企业员工直接使用飞书账号免密登录扣子编程，实现身份互通。

1. 配置 SSO 单点登录。
   企业管理员在企业 IdP 后台和扣子编程分别配置单点登录相关参数，配置示例请参见通过飞书进行 SAML SSO 登录。
2. 配置 SSO 登录后跳转的扣子编程页面。
   单点登录默认跳转至火山引擎云身份中心的登录门户，你需要手工配置 SSO 登录后跳转的扣子编程页面，具体配置方法请参见配置 SSO 登录后跳转至扣子编程指定页面。

场景二：飞书 AI 机器人智能对话

将低代码智能体发布至飞书渠道后，扣子编程会自动在飞书开放平台创建对应的应用和机器人，用户可直接在飞书聊天窗口中直接调用 AI 机器人与智能体进行对话，无需切换平台即可获取强大的 AI 能力。

场景描述

飞书 AI 机器人的使用场景举例如下：

• 智能问答机器人：基于企业内部知识库，为员工提供智能问答服务，加速知识流转。例如，您可以搭建一个 HR 助手，员工在飞书私聊机器人即可咨询社保办理、假期申请等规则，机器人会自动匹配员工手册内容并解答。
• 新闻热点追踪机器人：配置机器人查询当日的热点新闻，以便及时获取最新资讯。

操作步骤

步骤1 搭建智能体

在扣子编程侧搭建低代码智能体，具体步骤请参见搭建一个 AI 助手智能体。

步骤2 发布到飞书

1. 在智能体编排页面右上角单击发布，选择飞书发布渠道，单击授权。
   首次发布时需要进行授权，根据引导完成授权。
   
2. 单击发布。

步骤3 在飞书中使用 AI 机器人

• 与 AI 机器人私聊
  在飞书的搜索框中，输入你的智能体名称，打开对应的 AI 机器人，即可与智能体进行对话。
  
• 在飞书群中与 AI 机器人对话
  1. 将机器人加入飞书群：
     在飞书群右上角单击 … > 选择设置，在群机器人区域搜索并添加对应的 AI 机器人。
     
  2. 通过 @机器人名称 ，与智能体进行对话。

场景三：通过飞书多维表格字段捷径自动处理数据

飞书多维表格字段捷径适用于批量处理数据，可帮助你通过智能体快速完成批量翻译、提取图片关键字、自动打标签等重复性任务，提升数据处理效率。

场景描述

本文以专利分类助手智能体为例，智能体通过提取专利摘要中的核心内容，对专利进行标签分类。你可以将专利分类助手智能体发布为飞书多维表格字段捷径，通过字段捷径快速完成标签分类。

操作步骤

步骤1 搭建智能助手

搭建专利分类智能助手，提示词类似如下，详细操作步骤请参见搭建一个 AI 助手智能体。

本场景中的提示词如下：

请你基于专利内容的摘要信息，对该专利进行单一类别划分（类别无先后优先级，核心判断依据为摘要内容与哪类描述的匹配度最高），具体任务要求如下：
一、任务目标
根据专利摘要的核心技术内容，从下方给定的 7 个分类中，选择 1 个最符合的类别作为该专利的最终分类。
二、分类体系及优先级规则
1. 分类详细描述
交互控制：内容涉及虚拟对象 / 虚拟角色的控制、虚拟道具的控制、游戏玩法机制、游戏社交、界面操作、技能释放和玩法等，与 “玩家如何控制游戏中内容” 直接相关的技术。
界面显示：核心内容是 “游戏内容、信息如何在界面上显示”，且摘要中通常会明确提及 “显示方法”；（优先级规则：若核心内容同时涉及 “交互控制”，则优先分类为 “交互控制”）。
客户端：核心内容是 “在客户端处理且用户不可见的技术”，包括渲染、下载与更新、客户端之间的通信及其他客户端专属技术；（优先级规则：若内容同时涉及 “交互控制、界面显示、直播 & 回放”，则优先划分到前述三类，不归类为 “客户端”）。
直播 & 回放：内容涉及游戏直播、游戏高光剪辑、游戏录屏、游戏回放相关的技术。
音频：内容涉及游戏音频（如音频生成、音频适配、音频交互等）相关的技术。
服务端：内容涉及 AI、机器学习、服务器部署、服务端通信、战队匹配、角色寻路、帧同步等服务端专属技术。
其他：内容属于游戏领域，但无法匹配上述 6 个分类的技术，包括但不限于游戏安全、游戏测试、游戏数据统计（非服务端核心功能）等。
2. 关键优先级总结
当 “界面显示” 与 “交互控制” 重叠时，归为交互控制；
当 “客户端” 与 “交互控制 / 界面显示 / 直播 & 回放” 重叠时，归为前述三类，不归为客户端；
所有分类优先以 “摘要核心内容” 为判断基准，不纠结次要提及的技术点。
三、操作流程
完整阅读目标专利的摘要信息，提取其中核心技术主题（即专利最想保护的技术方向）；
将核心技术主题与上述 7 个分类的描述逐一比对，初步筛选可能匹配的类别；
若存在多类别重叠，严格按照 “优先级规则” 排除低优先级类别；
最终确定 1 个最符合的分类。
四、输入输出示例
输入（专利摘要片段）：“本发明公开了一种虚拟角色技能释放的控制方法，玩家可通过滑动界面按钮触发技能，并根据滑动轨迹调整技能释放范围，同时在界面上显示技能冷却时间。”
输出示例： “交互控制”

步骤2 发布为飞书多维表格字段捷径

1. 在智能体编排页面右上角单击发布，选择飞书多维表格发布渠道，单击授权。
   
2. 授权成功后，单击配置，并填写配置。
   配置部分决定了智能体回复内容在表格中的呈现效果。

   

   

   分类	参数	说明
   配置多维表格捷径基础信息	捷径输出数据类型	智能体回复所在的列的单元格格式。本场景中智能体输出内容为分类标签，因此输出数据类型设置为单选。
   配置多维表格输入表单	-	表单默认存在一个字段 user_query，即用户和智能体对话时用户输入的内容。 在本场景中，用户输入的内容为专利摘要，为文本信息，所以控件为文本输入框。
   完善捷径上架信息	捷径名称	设置字段捷径的名称。本场景中设置为专利分类。
   	捷径描述	设置字段捷径的描述。
   	捷径使用说明	设置字段捷径的使用说明。
   	扣子发布范围	本场景中选择仅自己可用。​该发布范围无需飞书审核，方便快速测试和调整。 智能体正式上线后，你也可以根据需要设置为所属公司内可用，该发布范围的审核时间通常在一周以上。

3. 单击确认，并在页面右上角单击发布。
   关于发布多维表格字段捷径的详细操作说明请参见发布到飞书多维表格。

步骤3 在飞书多维表格使用字段捷径

1. 在飞书多维表格中新建一列，双击列名，在字段类型 > 探索字段捷径中搜索字段捷径的名称，本场景中对应的字段捷径为专利分类。

   说明

   若直接搜索捷径名称无结果，可尝试通过智能体名称搜索。

2. 在字段捷径的配置区域，选择作为用户 Query 的列，智能体将对这一列进行批量处理。本场景中作为智能体用户 Query 的列为专利摘要列。生成范围选择整列，单击确定。

   

   

场景四：扣子编程自动写入飞书多维表格

你可以在工作流中添加飞书多维表格插件，该插件支持创建多维表格、对多维表格中的数据进行增删改查等丰富的功能。本文以 add_records 工具为例，介绍如何让工作流自动向飞书多维表格写入数据。

如果你需要将数据写入飞书云文档或飞书电子表格，也可以使用飞书云文档或飞书电子表格插件，它们支持创建文档、写入内容、获取文档信息等操作，满足不同类型飞书文档的数据管理需求。

场景描述

例如，你搭建了一个内容收藏与摘要工作流，当你在浏览网页、社交媒体时遇到感兴趣但无暇即时阅读的文章，只需将文章链接发送给工作流，工作流自动将文章链接、内容摘要等信息写入指定的飞书多维表格，形成结构化的待读清单，方便后续集中查阅。

操作步骤

步骤1 创建并配置飞书多维表格

创建一个飞书多维表格，用于记录文章链接和内容摘要，表格设计类似如下：

步骤2 搭建工作流

内容收藏与摘要工作流的整体设计类似如下：

工作流中的关键节点说明如下：

# 角色
你是一位专业的阅读笔记助手，擅长总结文章内容、提炼主旨以及抓取重点信息，帮助用户在短时间内快速掌握文章核心要点。

## 技能
### 技能 1: 总结文章内容
1. 当用户提供一篇文章时，仔细阅读文章内容。
2. 分析文章的段落结构和逻辑关系。
3. 用简洁明了的语言总结文章的主要内容，确保涵盖关键信息。
===回复示例===
文章主要围绕[核心主题]展开，讲述了[主要事件或观点 1]，接着提到了[主要事件或观点 2]……整体呈现了[简要概括整体情况]。
===示例结束===

### 技能 2: 提炼文章主旨
1. 在总结文章内容的基础上，深入挖掘作者的写作意图。
2. 分析文章所传达的核心思想、情感或价值观。
3. 用精炼的语句概括出文章的主旨。
===回复示例===
文章主旨是[主旨内容]，通过[具体方式或事例]表达了作者[情感或观点]。
===示例结束===

### 技能 3: 提取重点信息
1. 依据文章内容，识别重要的事实、数据、观点等。
2. 对重点信息进行整理和归纳。
3. 以清晰的方式呈现给用户。
===回复示例===
重点信息如下：
- [重点信息 1]
- [重点信息 2]
……
===示例结束===

## 限制:
- 只围绕用户提供的文章进行分析总结，拒绝回答与文章分析无关的话题。
- 所输出的内容必须逻辑清晰，符合正常语言表达习惯。
- 总结部分和主旨提炼部分都要简洁，避免冗长表述。
- 回答需基于对文章本身的理解和分析，不借助外部知识库。

场景五：将飞书文档作为知识库

场景描述

对于企业而言，大量的流程规范、产品介绍、FAQ 都沉淀在飞书文档和 Wiki 中。将这些动态更新的文档直接作为扣子智能体的知识库，可以让你的 AI 客服、内部问答助手等应用，实时基于企业最新、最准确的知识进行回答。避免人工手动上传知识库的繁琐操作，同时确保回答内容与飞书文档实时一致。

操作步骤

步骤1 创建飞书文档知识库

1. 在扣子编程页面顶部选择目标工作空间，然后在左侧导航栏中单击资源库。
2. 在页面右上角，选择 +资源 > 知识库。知识库创建方式选择创建扣子知识库。
3. 知识库类型选择文本格式，导入类型选择飞书。单击创建并导入。
   如果是首次导入某个飞书账号的文档时，需要先根据页面提示完成授权和安装。支持绑定多个飞书账号。具体操作，请参考管理数据源权限。

   

   

4. 在选择文件页面导入我的空间下所有者为本人的云文档或知识库Wiki 中的文档。并在右上角设置自动更新的频率。
   暂不支持导入共享空间下的云文档。
5. 在创建设置页面，配置分段策略和存储。详细的参数说明请参考飞书文档。单击下一步。
   
6. 等数据处理完毕后，单击确认。

步骤2 在智能体或工作流中使用知识库

在智能体或工作流中添加步骤1 中创建的飞书文档知识库。