> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coze.cn/llms.txt
> Use this file to discover all available pages before exploring further.

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

## 简介 {#46288884}

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

典型场景包括：

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

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

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

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


## 场景二：**飞书 AI 机器人智能对话** {#c3b1b56a}

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

### 场景描述 {#50e13752}

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

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

### 操作步骤 {#f3a74784}

#### **步骤1 搭建智能体** {#8e8ba3ab}

在扣子编程侧搭建低代码智能体，具体步骤请参见[搭建一个 AI 助手智能体](/guides/quickstart)。

#### **步骤2 发布到飞书** {#371caf42}

1. 在智能体编排页面右上角单击**发布**，选择**飞书**发布渠道，单击**授权**。
   首次发布时需要进行授权，根据引导完成授权。
   ![Image=600x176](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/35bde59532f2451eb095151a9a25defd~tplv-goo7wpa0wc-image.image)
2. 单击**发布**。

#### **步骤3 在飞书中使用 AI 机器人** {#73b8880d}


* **与 AI 机器人私聊**
   在飞书的搜索框中，输入你的智能体名称，打开对应的 AI 机器人，即可与智能体进行对话。
   ![Image=500x549](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/02cb0d655e114245a71065225cd38bd6~tplv-goo7wpa0wc-image.image)
* **在飞书群中与 AI 机器人对话**
   1. 将机器人加入飞书群：
      在飞书群右上角单击 … > **选择**设置，在**群机器人**区域搜索并添加对应的 AI 机器人。
      ![Image=300x355](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/6a8ce29ee9a6416e84441689c55d4edb~tplv-goo7wpa0wc-image.image)
   2. 通过 **@机器人名称** ，与智能体进行对话。

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

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

### 场景描述 {#7657dea1}

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

### 操作步骤 {#124c33a8}

#### 步骤1 搭建智能助手 {#29058e2c}

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

![Image=500x430](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/885b2b4ee6ea416e958633ad37f776bc~tplv-goo7wpa0wc-image.image)

本场景中的提示词如下：

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

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

1. 在智能体编排页面右上角单击**发布**，选择**飞书多维表格**发布渠道，单击**授权**。
   ![Image=546x137](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/bcc0a0f87e7647b3ad8831e1b28da371~tplv-goo7wpa0wc-image.image)
2. 授权成功后，单击**配置**，并填写配置。
   配置部分决定了智能体回复内容在表格中的呈现效果。
   ::::cols
   @col 50
   ![Image=400x74](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/3353a1d223004188916e02c6cfb86760~tplv-goo7wpa0wc-image.image)
   
   @col 50
   ![Image=400x486](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/6a4e166b3a3b4ec4b470a4e37d353a0c~tplv-goo7wpa0wc-image.image)
   ::::
   <!-- @cols-width: 198,138,505 -->
   |**分类** |**参数** |**说明** |
   |---|---|---|
   |配置多维表格捷径基础信息 |捷径输出数据类型 |智能体回复所在的列的单元格格式。本场景中智能体输出内容为分类标签，因此输出数据类型设置为单选。 |
   |配置多维表格输入表单 |\- |表单默认存在一个字段 user_query，即用户和智能体对话时用户输入的内容。 |\
   | | | |\
   | | |在本场景中，用户输入的内容为专利摘要，为文本信息，所以控件为文本输入框。 |
   |完善捷径上架信息 |捷径名称 |设置字段捷径的名称。本场景中设置为**专利分类**。 |
   |^^| | | \
   | |捷径描述 |设置字段捷径的描述。 |
   |^^| | | \
   | |捷径使用说明 |设置字段捷径的使用说明。 |
   |^^| | | \
   | |扣子发布范围 |本场景中选择**仅自己可用。​**该发布范围无需飞书审核，方便快速测试和调整。 |\
   | | | |\
   | | |智能体正式上线后，你也可以根据需要设置为**所属公司内可用**，该发布范围的审核时间通常在**一周以上**。 |
3. 单击**确认**，并在页面右上角单击**发布**。
   关于发布多维表格字段捷径的详细操作说明请参见[发布到飞书多维表格](/guides/shortcut)。   


#### 步骤3 在飞书多维表格使用字段捷径 {#142b8fd9}


1. 在飞书多维表格中新建一列，双击列名，在**字段类型** > **探索字段捷径**中搜索字段捷径的名称，本场景中对应的字段捷径为**专利分类**。
   :::tip 说明
   若直接搜索捷径名称无结果，可尝试通过**智能体名称**搜索。
   :::
2. 在字段捷径的配置区域，选择作为用户 Query 的列，智能体将对这一列进行批量处理。本场景中作为智能体用户 Query 的列为专利摘要列。生成范围选择**整列**，单击**确定**。
   ::::cols
   @col 50
   ![Image=899x925](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/a8fa623ab64544c39c2a2f3220d84f00~tplv-goo7wpa0wc-image.image)
   
   @col 50
   ![Image=400x531](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/ab00501315224e03a40418adb5fcf5d8~tplv-goo7wpa0wc-image.image)
   ::::   


## 场景四：扣子编程自动写入飞书多维表格 {#1d4e7453}

你可以在工作流中添加[飞书多维表格](https://www.coze.cn/store/plugin/7395043460165779483?from=plugin_card)插件，该插件支持创建多维表格、对多维表格中的数据进行增删改查等丰富的功能。本文以 **add_records** 工具为例，介绍如何让工作流自动向飞书多维表格写入数据。

如果你需要将数据写入飞书云文档或飞书电子表格，也可以使用[飞书云文档](https://www.coze.cn/store/plugin/7395041536909574154?from=plugin_card)或[飞书电子表格](https://www.coze.cn/store/plugin/7395040352337559578?from=plugin_card)插件，它们支持创建文档、写入内容、获取文档信息等操作，满足不同类型飞书文档的数据管理需求。

### 场景描述 {#bc0062a0}

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

### 操作步骤 {#ae738be3}

#### 步骤1 创建并配置飞书多维表格 {#5b89516c}

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

![Image=500x141](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/4728839436034e92a010aa7d5d4ddd7b~tplv-goo7wpa0wc-image.image)

#### 步骤2 搭建工作流 {#e27eedee}

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

![Image=1873x253](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/a41011cb2c0f48d1b71030d0a1780711~tplv-goo7wpa0wc-image.image)

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

<!-- @cols-width: 100,548,433 -->
|**节点** |**说明** |**示例** |
|---|---|---|
|大模型节点 |1. 通过[链接读取](https://www.coze.cn/store/plugin/7329410795979161663?from=plugin_card)插件，自动解析并提取文章链接中的内容。 |\
| |2. 使用大模型总结文章内容，可参考以下系统提示词： |\
| | |\
| |```Markdown |\
| |# 角色 |\
| |你是一位专业的阅读笔记助手，擅长总结文章内容、提炼主旨以及抓取重点信息，帮助用户在短时间内快速掌握文章核心要点。 |\
| | |\
| |## 技能 |\
| |### 技能 1: 总结文章内容 |\
| |1. 当用户提供一篇文章时，仔细阅读文章内容。 |\
| |2. 分析文章的段落结构和逻辑关系。 |\
| |3. 用简洁明了的语言总结文章的主要内容，确保涵盖关键信息。 |\
| |===回复示例=== |\
| |文章主要围绕[核心主题]展开，讲述了[主要事件或观点 1]，接着提到了[主要事件或观点 2]……整体呈现了[简要概括整体情况]。 |\
| |===示例结束=== |\
| | |\
| |### 技能 2: 提炼文章主旨 |\
| |1. 在总结文章内容的基础上，深入挖掘作者的写作意图。 |\
| |2. 分析文章所传达的核心思想、情感或价值观。 |\
| |3. 用精炼的语句概括出文章的主旨。 |\
| |===回复示例=== |\
| |文章主旨是[主旨内容]，通过[具体方式或事例]表达了作者[情感或观点]。 |\
| |===示例结束=== |\
| | |\
| |### 技能 3: 提取重点信息 |\
| |1. 依据文章内容，识别重要的事实、数据、观点等。 |\
| |2. 对重点信息进行整理和归纳。 |\
| |3. 以清晰的方式呈现给用户。 |\
| |===回复示例=== |\
| |重点信息如下： |\
| |- [重点信息 1] |\
| |- [重点信息 2] |\
| |…… |\
| |===示例结束=== |\
| | |\
| |## 限制: |\
| |- 只围绕用户提供的文章进行分析总结，拒绝回答与文章分析无关的话题。 |\
| |- 所输出的内容必须逻辑清晰，符合正常语言表达习惯。 |\
| |- 总结部分和主旨提炼部分都要简洁，避免冗长表述。 |\
| |- 回答需基于对文章本身的理解和分析，不借助外部知识库。 |\
| |``` |![Image=200x615](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/f27b061ee7944eba8b22b750fcb4bfd4~tplv-goo7wpa0wc-image.image) |
|add_records 节点 |添加[飞书多维表格](https://www.coze.cn/store/plugin/7395043460165779483?from=plugin_card)插件中的 **add_records** 工具，将大模型节点返回的数据自动插入飞书多维表格，参数配置如下： |\
| | |\
| |* **app_token**：输入步骤 1 中已创建的飞书多维表格的 URL。 |\
| |* **records**：引用大模型节点中输出的需要录入飞书多维表格的数据。 |\
| |* **授权方式**：选择**单独授权**。详细说明，请参考[如何设置 OAuth 插件的授权模式？](/guides/plugin_node#79ba9ce6)。 |![Image=200x135](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/643d2cae24d546e98b16864f91573fa7~tplv-goo7wpa0wc-image.image) |

## 场景五：将飞书文档作为知识库 {#a298c219}

### **场景描述** {#f98e3544}

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

### 操作步骤 {#808cf2db}

#### 步骤1 创建飞书文档知识库 {#aaa96769}

1. 在扣子编程页面顶部选择目标工作空间，然后在左侧导航栏中单击**资源库**。
2. 在页面右上角，选择 **+资源** > **知识库**。知识库创建方式选择**创建扣子知识库**。
3. 知识库类型选择**文本格式**，导入类型选择**飞书**。单击**创建并导入**。
   如果是首次导入某个飞书账号的文档时，需要先根据页面提示完成授权和安装。支持绑定多个飞书账号。具体操作，请参考[管理数据源权限](/guides/manage_data_source_permissions)。
   ::::cols
   @col 50
   ![Image=300x541](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/db7acc5d2c444387949e78df3ada744f~tplv-goo7wpa0wc-image.image)
   
   @col 50
   ![Image=400x208](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/7c9cfb5d4b084fc9be58cb0439243871~tplv-goo7wpa0wc-image.image)
   ::::
4. 在**选择文件**页面导入**我的空间**下所有者为本人的云文档或**知识库Wiki** 中的文档。并在右上角设置自动更新的频率。
   暂不支持导入共享空间下的云文档。
5. 在**创建设置**页面，配置分段策略和存储。详细的参数说明请参考[飞书文档](/guides/create_knowledge#d270b740)。单击**下一步**。
   ![Image=500x279](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/173654823d1f4bf7bc27514c05913e7f~tplv-goo7wpa0wc-image.image)
6. 等数据处理完毕后，单击**确认**。

#### 步骤2 在智能体或工作流中使用知识库 {#7ce66733}

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

::::cols
@col 50
智能体

![Image=400x350](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/b5652599677c4e89b926d73b18145fd4~tplv-goo7wpa0wc-image.image)

@col 50
工作流

1. 在工作流中添加**知识库检索节点**。
2. 知识库来源选择扣子知识库，目标知识库选择步骤1 中创建的飞书文档知识库。
   ![Image=300x398](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/0b8a02b8be9a47b4b4a2691d740e83f0~tplv-goo7wpa0wc-image.image)
::::