发布到飞书多维表格

扣子编程支持将低代码智能体发布到飞书多维表格中，智能体会作为一个独立的字段捷径，向多维表格的用户提供智能服务。

功能说明

多维表格字段捷径是某些高频的业务场景下预置的字段，添加了字段捷径的列，单元格内容均可选择由字段捷径自动生成。你在扣子编程中搭建的智能体可以发布为一个字段捷径，用户可以在自己的多维表格中为某一列设置这个字段捷径，并指定用户 Query，智能体会批量生成内容，并填充到这一列中。
扣子编程字段捷径通常用于批量数据处理的场景，例如批量翻译表格中的某一列、批量提取图片中的关键字等。在游戏设计场景中，你的智能体技能是生成游戏场景图片，你可以将智能体发布为字段捷径，指定游戏场景描述列为用户 Query，指定场景配图列使用字段捷径，配置完成后，智能体会自动为每个场景描述生成对应的场景示意图。

你也可以在飞书多维表格中配置多个字段捷径列，对一列原始输入进行多样化处理，例如从用户反馈原文中提取多个字段、对反馈打标、总结、生成自动回复；也可以分批处理一个字段，例如先通过扣子编程字段捷径扩写文档、再通过扣子编程字段捷径将文档保存为 PDF。

使用限制

字段捷径的数据类型必须和智能体的输出格式严格匹配。具体限制如下：

发布智能体到飞书多维表格

1. 登录扣子编程。

2. 在页面顶部空间列表中选择目标工作空间。

3. 在项目开发页面，选择低代码智能体。在页面右上角，单击发布。

4. 在发布页面，找到飞书多维表格发布渠道，单击授权。
   

5. 根据页面提示，完成飞书多维表格授权。
   授权并成功发布到飞书多维表格之后，扣子编程将以你的身份将智能体发布至飞书多维表格字段捷径中。你可以在个人管理页面随时取消授权。

6. 单击配置，并填写配置。
   配置部分决定了智能体回复内容在表格中的呈现效果。你需要通过捷径输出数据类型和多维表格输入表单来设计呈现效果。

   

   

   分类	参数	说明
   配置多维表格捷径基础信息	捷径输出数据类型	智能体回复所在的列的单元格格式。
   配置多维表格输入表单	-	用户 Query 的传入方式，如果希望用户选择某一列作为 Query，则配置为字段选择器，并选择 Query 列的数据类型。例如智能体技能是从图片中提取金额，捷径输出数据类型应配置为数字，多维表格输入表单控件指定为字段选择器，并选择附件类型。 各字段详细的参数说明请参见下文多维表格输入表单部分。如果需要添加多个输入参数，可参考下文添加输入参数部分。
   完善捷径上架信息	捷径名称	设置字段捷径的名称。建议设置一个易于识别的捷径名称，以便在飞书多维表格中搜索对应的字段捷径。
   	捷径描述	设置字段捷径的描述。
   	捷径使用说明	设置字段捷径的使用说明。
   	扣子发布范围	支持两种发布范围： 仅自己可用：在体验或调试字段捷径时，你可以选择该发布范围。该发布范围无需飞书审核，方便快速测试和调整。 所属公司内可用：调试完成、准备正式上线时，你可以选择该发布范围。该发布范围的审核时间通常在一周以上。

7. 单击确认，并在页面右上角单击发布。
   你可以在智能体的发布历史中查看审核结果，飞书和扣子编程均审核通过后，审核状态才会显示为通过。审核通过后，可以从智能体编排页面进入多维表格字段捷径，查看你的字段捷径。

   查看发布结果
   

   进入飞书多维表格
   

发布配置说明

捷径输出数据类型

此字段用于指定多维表格中使用字段捷径的列的字段类型。例如智能体的核心技能为图片理解，发布为多维表格字段捷径之后，用于对表格中的图片列生成文本总结，那么捷径输出数据类型可以指定为文本。如果智能体技能为智能分类与打标，可以将捷径输出数据类型指定为多选，由智能体生成各个选项。
支持设置的字段类型包括文本、数字、单选、多选、日期、附件和对象。每种格式对智能体的输出有不同的限制，例如数字类型的字段捷径要求智能体输出中包含数字，输出格式如果不符合要求，则会生成失败、报错、或单元格显示为空。

多维表格输入表单

用户在编辑多维表格时，如果设置某列由字段捷径生成内容，则需要填写字段捷径的配置。此处定义字段捷径配置的格式。

表单默认存在一个字段 user_query，即用户和智能体对话时用户输入的内容。你也可以添加输入参数，例如翻译场景下增加一个文本参数，用于在多维表格中自定义翻译风格，详细信息可参考下文添加输入参数部分。

支持的控件类型如下：

添加输入参数

如果你需要增加字段，可以在智能体的人设与回复逻辑中添加 {{var}} 来新增输入参数。在多维表格使用该智能体时，这些传入的值将被插入到智能体提示词当中。
例如使用技术翻译小助手翻译技术词汇，在人设与回复逻辑中使用变量{{添加语言}}、{{目标语言}}，并在发布配置里分别将这两个变量设置为单选控件，添加两个选项中文和英文，发布到字段捷径后，就可以批量将某一列文本进行英译中或中译英。

发布配置参考

文本格式

适用于智能体生成回复为纯文本的场景。通常情况下，智能体回复只要是文本，都可以将输出数据类型配置为文本格式。如果智能体的回复中包含图片、文件等多模态内容，只保留其中的文本部分，不展示图片或文件。
典型场景如下：

• 内容提取：从聊天记录中提取用户 ID、用户名称等内容。
• 内容总结：将智益故事总结为一段故事梗概、总结用户反馈中的核心意图。
• 文本处理：文本翻译、裁剪等其他文本处理。

数字

如果智能体自动生成的列，后续计划进行数学统计或分析，可以将输出数据类型配置为数字。生成数字后，可以在其他列中使用数学公式去统计、筛选、分析数据。
典型场景如下：

• 针对客服对话记录，统计客服和用户的对话轮次，统计问题处理效率
• 针对发票图片，提取金额部分，用于记录开销、统计金额
• 针对图书笔记，提取页码部分，记录阅读进度
• 从聊天记录中提取用户 ID、电话号码、身份证号、满意度评分等数字格式的内容。

数字格式的扣子编程字段捷径中，智能体生成的回复中必须包含数字，否则字段生成时会报错。

单选

单选适用于智能分类或智能打标的场景。
典型场景如下：

• 智能评价：在商户评价表单中，总结用户评价，并判断是好评或差评
• 问题分类：在 Oncall 分析表单中，对用户问题分类，明确是咨询类问题或故障排查问题

智能体通常需要具备良好的意图识别能力，能从复杂的文本中提取出关键信息，根据人设和提示词的要求进行分类或打标。单选的选项由智能体的回复自动生成，通常适用于多选一的场景，例如优先级、评价等级、肯定或否定、状态等。

多选

多选和单选类似，都适用于智能分类或智能打标的场景。
典型场景如下：

• 在商户评价表单中，总结用户评价，例如餐厅环境、服务态度等。
• 在反馈分析表单中，对反馈内容打标，明确反馈内容涉及的功能模块

智能体通常需要具备良好的意图识别能力，能从复杂的文本中提取出关键信息，根据人设和提示词的要求进行分类或打标。多选的选项同样由智能体的回复自动生成，通常适用于多选多的场景，例如分类、标签、关键词等。
日期格式的扣子编程字段捷径中，智能体生成的回复必须严格是 String 数组格式，即 [“”,“”,“”]，例如 [“日志采集”,“日志检索”,“日志分析”]。

日期

适用于展示日期的场景。日期格式的列可以用于看板展示、按日期筛选顺序、按日期排序等等，如果要在单元格中展示日期，建议设置输出数据类型为日期，便于后续的数据管理。
日期格式的扣子编程字段捷径中，智能体生成的回复中必须包含日期，且日期格式为 13 位的 Unixtime 时间戳，单位为毫秒。智能体回复的日期格式是固定的，但是你可以自定义设置多维表格中展示的日期格式，例如 2024年8月1日、1970/01/19 等。
请勿选择新纪录自动填写创建时间，否则字段会生成失败并报错。

附件

适用于多模态内容生成的场景，例如生成 PDF、图片、TXT 等文件。生成的文件会作为附件上传到单元格中，如果文件是图片格式，则默认呈现预览图。
典型场景如下：

• 文字生成图片：游戏场景的表单中，对各类场景的文字描述生成一系列配图。
• 图片处理：在相册表单中，对照片批量添加美颜效果或滤镜；在用户反馈表单中，对反馈截图中暴露的用户 ID、电话号码等敏感信息进行智能脱敏处理。
• 文件生成：将文本内容转成 PDF、将文本内容记录在 TXT 中。

选择附件格式之前，建议确认智能体具备图文生成或处理的能力，可以配置文生图或图片处理的工作流、插件、图像流，成功调试智能体后再发布到多维表格。

• 附件格式的扣子编程字段捷径中，智能体生成的回复中应包含 Markdown 格式的文件链接，例如 [file](https://example.com/file.png),否则生成的单元格内容为空。
• 如果智能体绑定的工作流、图像流开启了异步处理，飞书多维表格生成内容时会报错。

对象

对象格式的列，在飞书多维表格中以一个主列+多个子列的方式呈现，主列中包含各个子列的完整内容。在对象格式的字段捷径中，智能体输出的内容必须是一个格式合法的 JSON 对象，扣子编程会根据发布配置中的字段配置，将 JSON 的各个字段解析名作为独立的字段的子字段对应各个子列。用户可以按需选择展示哪些子列。
通常用于批量信息提取与总结，典型场景如下：

• 从客户案例文档中提取出客户名称、方案架构、客户原声、场景等内容
• 从客服的对话信息中提取出用户意图、反馈类型、用户 ID等信息
• 从发票照片中提取出商户名称、发票号码、具体金额等信息。

如果 JSON 格式不合符，多维表格可能无法正常解析智能体输出结果。
配置方式如下：

展示效果：

在多维表格中使用智能体

成功将智能体发布到多维表格并审核通过后，智能体会作为多维表格的一个字段捷径公开展示在字段捷径中心。飞书用户可以在多维表格中使用这个字段捷径批量生成内容。
使用方式如下：
在飞书多维表格中新建一列，双击列名，并在字段类型 > 探索字段捷径中选择字段捷径的名称。

填写字段捷径的配置，即指定用户 Query。此处以字段选择器为例。在字段捷径的配置区域，选择作为用户 Query 的列，智能体将对这一列进行批量处理。

相关操作

下架智能体

如果不再需要在该渠道中使用智能体，您可以选择将其下架。下架的操作步骤请参见下架智能体。
下架智能体后，飞书多维表格中依赖该智能体的字段捷径将无法继续生成内容。

常见问题

为什么批量生成后单元格仍是空的？

通常原因是智能体没有生成符合字段要求的回复。例如：

• 智能体人设与回复逻辑中定义了智能体的技能是提取 ID，ID 格式 为 7 位数字，如果用户 Query 中不存在 7 位的数字，智能体无法成功提取 ID，则单元格为空。
• 文生图场景中，如果智能体处理超时，返回“抱歉无法生成图片”，则单元格为空。

你可以修改用户的 Query 后重试，或者修改智能体的人设与回复逻辑，提高智能体正确回复的概率。

发布到多维表格需要审核多久？

发布到飞书多维表格的智能体会经由飞书审核，也有一定几率触发扣子编程的人工审核。发布申请的表单中需要填写发布范围，其中：

• 仅自己可用的审核时间为 1 小时~3 个工作日。
• 全量发布、仅公司可见的审核时间通常在一周以上。全量发布的审核流程长、审核标准高，审核过程中无法修改范围重新发布，请谨慎选择。

建议在体验或调试字段捷径时先选择仅自己可用，调试完成、准备正式上线时再选择特定公司可用。

更新智能体后需要重新发布到多维表格吗？

需要。
如果修改了智能体的编排、多维表格发布配置，或重新填写发布申请表单（修改可见范围等），应重新发布智能体到多维表格，刷新多维表格字段捷径的配置。重新发布到多维表格时依然需要根据申请表单中填写的发布范围进行审核。

处理包含超链接或附件的单元格时报错 Execute Fail

当多维表格中的原始输入字段中包含超链接或附件，或文本内容中包含超链接，这些内容在作为智能体输入时会被转换成 Markdown 格式。具体来说，图片和文件将以![文件标题](URL地址)的格式呈现，而链接则以[链接标题](URL地址)的形式表示。如果智能体的工作流中存在某些节点，比如输入参数为链接的链接读取插件节点，它们无法识别 Markdown 格式的链接，从而导致“Execute Fail”错误。为解决这一问题，建议在工作流中添加一个代码节点，用于从 Markdown 中提取链接内容，以便后续节点能够顺利处理。
提取链接的代码示例如下：

async function main({ params }: Args): Promise<Output> {
 const markdownLink = params.input; // 输入的Markdown格式链接

 // 使用正则表达式匹配Markdown链接的URL部分
 const urlRegex = /\[.*?\]\((.*?)\)/;
 const match = markdownLink.match(urlRegex);

 let extractedUrl = '';
 if (match && match[1]) {
 extractedUrl = match[1]; // 提取匹配结果中的URL
 }

 const ret = {
 "original": markdownLink,
 "extractedUrl": extractedUrl // 添加提取出的URL到返回结果中
 };

 return ret;
}

为什么搜索不到字段捷径？

在多维表格中搜索不到目标字段捷径时，可按以下步骤排查：

• 尝试多维度搜索
  若直接搜索捷径名称无结果，可尝试通过智能体名称搜索。
• 检查发布范围与用户一致
  若发布范围为仅自己可用：需确保飞书多维表格的登录用户，与智能体发布时授权的用户账号一致。
• 确认智能体发布状态
  确认智能体已成功发布至飞书多维表格。
  

常见错误信息