> ## 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.

扣子编程全新推出 AI 生成式工作流功能，核心是将复杂工作流搭建流程转化为**自然语言描述驱动**的高效模式。你无需编写代码，只需用文字清晰描述业务需求，扣子 AI 即能自动生成对应的工作流完整代码，并完成代码测试、需求迭代等全流程操作。
扣子编程改变了传统工作流搭建逻辑，帮助开发者从「如何分步实现」转向「需要实现什么目标」，大幅降低工作流搭建门槛，提升开发效率。
## 费用说明 {#3127155c}
开发、测试、线上使用工作流时，以下操作将消耗你的扣子积分。

* [编程任务](https://docs.coze.cn/coze_pro/task_fee)：与扣子 AI 的每轮对话。
* [内置集成](https://docs.coze.cn/coze_pro/internal_integrations_fee)：调用大语言模型、联网搜索、图像生成等内置集成服务。

## 配额与限制 {#f31b5948}
开发工作流时，存在可创建的项目数量、可回滚版本数、可部署次数等配额限制，详细说明，请参考[配额与限制](/guides/vibe_coding_limit)。
## 开发工作流 {#09c96324}
参考以下流程，通过 AI 编程开发全代码工作流。
### 步骤一：输入开发提示词 {#a954a0b1}

1. 在[扣子编程](https://code.coze.cn/home)首页，单击**工作流**选项卡。
2. 在文本框输入你的提示词。
   你需要尽可能清晰且详细地描述工作流的功能、业务逻辑、交互等方面的要求。例如，你可以输入以下提示：
   ```Plain Text
   搭建一个发票读取工作流，支持上传并解析发票类 PDF 文件，自动提取 PDF 中的关键信息，提取完成后，生成结构化输出结果（支持 JSON 格式或表格格式），确保字段清晰、数据准确。若涉及多页 PDF 发票，需支持批量解析与信息汇总。
   ```

   ![Image=489x248](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/dc6030481c3642af89e3d980718a0210~tplv-goo7wpa0wc-image.image)
3. （可选）进阶配置：通过上传附件、选择协作模式、添加技能、选择编程模型，让扣子 AI 生成的结果更精准、更符合你的预期。
   ![Image=410x164](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/26d2a994fcba4a89aac7b586ef34c094~tplv-goo7wpa0wc-image.image)
   
   :::: tabs
   @tab ① 上传附件
   酌情上传一些图片或文件，作为附加信息提供给扣子 AI，以便扣子 AI 能更理解你的需求。例如上传你想参考的实现方案等。
   
   @tab ② 选择协作模式
   默认情况下为 **Agent 模式**，如果你对需求不确定，可以先切换到**问答模式**讨论方案，在方案确认后，再切换到**Agent 模式**，由扣子 AI 根据此前的讨论结论执行开发任务。更多信息，请参考[如何选择协作模式？](/guides/vibe_coding_faq#3069a332)。
   
   @tab ③ 调用技能
   扣子 AI 现已支持添加编程技能（Skill），在执行编程任务时，扣子 AI 可以按需加载技能，从而具备相应的专业领域知识和能力。例如，前端设计技能可以有效指导模型如何排版、设计配色和动画效果、处理背景等等，能显著提升模型的 UI 生成能力，减少产物视觉效果的“AI 味”。
   AI 编程项目中，扣子 AI 可用的编程技能如下：
   
   * **官方技能**：扣子编程官方提供的集成服务，可一键集成各种常见能力，例如图片生成、视频生成等。
   * **我的技能**：开发者自行上传的编程技能。你可以上传扣子编程或扣子制作的技能包，也可以上传外部开源技能包。制作及上传技能的方式可参考[开发技能](/guides/vibe_coding_skill)、[使用技能](/guides/using_skill)。
   
   ![Image=352x276](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/7bbe576712744d228956c6f79c7033bc~tplv-goo7wpa0wc-image.image)
   
   @tab ④ 选择编程模型
   扣子编程已集成 GLM 4.7、GLM 5、Kimi K2.5 等主流的编程模型，用于开发应用。为了达到较好的开发效果，系统会自动为你选择适合当前场景的模型，你也可以根据模型的官方介绍自行选择。
   
   ::::

4. 单击**运行**图标，开始开发你的工作流。

### 步骤二：AI 编程开发工作流 {#0684c38a}
在工作流开发过程中，扣子 AI 会根据你输入的提示词，自动判断需要加载的技能，并生成符合你功能、交互等要求的工作流代码。
扣子 AI 判断你的工作流需要数据库、存储、AI 等能力时，会自动加载官方技能来接入对应的集成服务，并遵循技能使用指南完成开发。如果扣子 AI 未自动集成这些能力，你也可以通过自然语言要求扣子 AI 添加相关能力，例如，你可以说：
```Plain Text
为我的工作流添加数据库功能，用于存储用户提交的表单数据
```

关于技能与集成能力的详细说明，请参考[集成能力](/guides/ai_powered_workflow_development#53373f47)。
### 步骤三：预览工作流 {#f553b335}
初步生成代码后，扣子 AI 会自动生成测试用例并完成自动化测试。测试通过后，扣子 AI 将在画布中呈现完整的工作流，你可直观查看工作流的整体架构、各节点的关联逻辑。
扣子编程工作流采用语义层、 参数层和代码层三层协同驱动架构，基于语义驱动，无需预先定义抽象化节点模板，可高效生成覆盖全流程的节点。所有工作流均以开始节点为起点，以结束节点为终点。开始节点用于设定启动工作流需要的输入信息，结束节点用于返回工作流运行后的结果。任务执行节点是工作流的核心功能单元，既可能是单个独立功能组件，也可能是多个关联功能的组合组件。它能覆盖图像生成、数据库读写、第三方工具调用等多种业务场景。
你可以单击画布中的任意节点，可以查看该节点的详细信息，包括输入、输出参数及对应的配置等。如果你对工作流节点存在疑问，可以框选一个或多个目标节点，单击**解释**，扣子 AI 会解读该节点，提供详细的节点介绍、关键执行逻辑以及异常与降级策略。

::::cols
@col 50
![Image=1258x1180](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/27adb014b1ed42f0a85f5f783f146c3c~tplv-goo7wpa0wc-image.image)


@col 50
![Image=215x496](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/60786182fc50496eb2dac34ee3f3b2c7~tplv-goo7wpa0wc-image.image)

::::

### 步骤四：试运行工作流 {#427fa9df}
确认工作流的结构与节点配置初步满足需求后，你可以试运行工作流，对工作流进行全链路验证。

* 验证工作流整体运行状态是否正常，无执行报错、流程中断等异常情况。
* 验证各节点间的数据传递链路是否畅通、逻辑交互是否匹配预期，确保上游节点的输出数据格式与下游节点的输入要求完全兼容，且节点的执行顺序、分支逻辑、条件判断等均符合需求。

你可以在画布上，单击**试运行，​**然后根据页面提示配置合适的参数值，最后单击**试运行**。在试运行过程中，画布会实时展示运行进度，包括执行状态、单节点消耗时间等信息。试运行完成后，界面上将展示工作流的返回结果。你还可以单击画布中的任意节点，查看该节点在此次试运行中的详细输入与输出信息。
![Image=533x497](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/5b13dd1052d34c0a901bb70596250413~tplv-goo7wpa0wc-image.image)
如果出现故障，扣子 AI 通常会自动识别并提示你修复故障，你可以根据页面提示，单击**一键修复**或**自动修复**，允许扣子 AI 尝试修复这些问题。如果在调试工作流过程中出现报错，你可以复制报错信息到对话中，要求扣子 AI 进行修复。
## 迭代工作流 {#d03a4688}
测试并修复问题之后，如果已生成的工作流仍有可改进之处，你可以通过自然语言或编写代码的方式，和扣子 AI 一起迭代你的工作流。
### 调整需求 {#2629c725}
如果历史对话中存在不准确的描述，导致生成的工作流无法满足需求，你可以修改历史对话，让扣子 AI 根据新的描述对工作流进行调整和优化，无需回滚版本。同时扣子 AI 的版本记录里也会另起一个分支来记录本次及后续的变更。
![Image=347x165](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/2bec5b571df6492488c02392a1b8ce09~tplv-goo7wpa0wc-image.image)
### 编辑工作流 {#09b79de9}
当扣子 AI 生成初步的工作流后，你可以继续通过多种方式与其协作，对工作流进行修改和优化，直至达到预期效果。
**方式一：通过自然语言调整**
这是最直接、简便的方式。你只需在对话框中用自然语言提出修改建议，扣子 AI 就会理解你的意图并对整个工作流进行调整。例如：
```Plain Text
增加一个配置参数，用于选择飞书消息类型。
```

**方式二：引用特定节点进行精确修改**
如果你想针对画布中的某些节点进行精准修改，引用功能是最高效的方式。

1. 在画布中，框选目标一个或多个工作流节点，单击**引用**。
2. 系统将在**对话框**中引用该节点，然后你可以输入修改指令。
   ![Image=471x247](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/bfaa343e2121471b9483c4c623ee7135~tplv-goo7wpa0wc-image.image)

**方式三：通过画布进行可视化编排**
当你想在工作流的特定位置进行节点的增加、修改、删除操作时，可以直接在画布上手动编排与设计。手动编排工作流并不会直接更新代码，需要单击**发送并执行变更**，让扣子 AI 完成实际的修改工作。
此处以增加节点的操作为例。

1. 在画布中选择目标节点，单击➕ 。
   ![Image=521x274](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/33faf10e64df43a5ae5654879e056d19~tplv-goo7wpa0wc-image.image)
2. 在**新建节点**对话框中，选择节点类型及对应配置。
   <!-- @cols-width: 102,510,177 -->
   | | | | \
   |**节点类型** |**说明** |**图示** |
   |---|---|---|
   | | | | \
   |动作 |执行具体任务的节点，例如发送飞书消息、生成图片、生成视频、调用大模型等。 |\
   | |选择类型为**动作**后，需要在**描述节点功能**文本框中，清晰说明该节点要完成的具体操作。例如： |\
   | |```Plain Text |\
   | |增加一个发送消息到飞书的节点，将提取到的发票信息自动发送到飞书群组。 |\
   | |``` |\
   | | |![Image=555x783](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/c47517126c9a4af3a419988fd318956e~tplv-goo7wpa0wc-image.image) |
   | | | | \
   |条件 |逻辑判断与分支流转的节点，可根据不同的条件，决定工作流的走向。 |\
   | |选择类型为**条件**后，你可以按需设置条件分支数量，并在条件节点中，设置对应的条件及执行动作。例如： |\
   | | |\
   | |* **条件1**：`发票金额大于5000`、`执行动作增加标签字段 tag，值为“大额待审批“`。 |\
   | |* **条件2**：`否则，默认执行此分支`、`增加标签字段 tag，值为“小额免审批“`。 |![Image=1183x805](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/38f2e0b0d2b049879ae31e0e3083ccba~tplv-goo7wpa0wc-image.image) |
   | | | | \
   |并发 |当多个操作之间无先后依赖关系时，可通过并发节点并行处理，减少整体耗时。 |\
   | |选择类型为**并发**后，你可以按需设置并发分支数量，并在并发节点中，设置对应的执行动作。 |\
   | |例如同时执行**发送飞书通知**和**写入飞书多维表格**两个动作。 |![Image=1091x520](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/30746c8c799e425dae916c4791f466aa~tplv-goo7wpa0wc-image.image) |

3. 在画布右上角，单击**发送并执行变更**。
   扣子 AI 将接管任务，然后理解你在画布中的配置，完成工作流编排。

### 调试代码 {#5607ce2d}
扣子编程提供了一个基于 Web 的 AI 编程环境，你可以在代码编辑器中修改代码文件、在终端中执行命令调试代码，和扣子 AI 一起开始开发你的工作流。关于 AI 编程开发环境的使用技巧，可参考[AI 编程环境](/guides/vibe_coding_environment)。
常见操作如下：
<!-- @cols-width: 197,423,239 -->
| | | | \
|**操作** |**说明** |**示例** |
|---|---|---|
| | | | \
|通过扣子 AI 修改代码 |在页面右上角单击**文件树**图标进入代码编辑器，找到你想修改的代码文件或片段，并单击**引用到对话**，然后通过自然语言描述你的修改需求。 |![Image=1936x1025](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/e979a7408c2641358135a6601af4422b~tplv-goo7wpa0wc-image.image) |
| | | | \
|手动修改代码 |在页面右上角单击**文件树**图标进入代码编辑器，你可以在其中查看扣子 AI 生成的所有代码文件，并直接修改代码。 |\
| |修改代码之后随时切回**预览**页面，刷新画布，即可体验最新的工作流效果。 |![Image=1800x1028](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/c663ef57504242238cfcacf24000d550~tplv-goo7wpa0wc-image.image) |
| | | | \
|终端运行代码 |代码编辑器下方是 Web 终端，你可以通过**终端**执行常见的命令来调试并迭代你的工作流，例如执行`npm install`安装项目依赖等，与本地终端操作逻辑一致。 |![Image=1796x1100](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/67d86b7b778c4d03b991ac95fc2b4828~tplv-goo7wpa0wc-image.image) |

### 回滚版本 {#d4248d7f}
扣子 AI 使用当前先进模型来完成任务，但由于模型生成代码的随机性，有时可能无法完全满足你的需求，生成了不符合预期的代码，或者出现了反复修复失败的故障，此时你可以使用回滚版本功能，将工作流恢复到之前正常的版本状态。
![Image=445x309](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/532e81d98f304c8089e7fa6f8684e854~tplv-goo7wpa0wc-image.image)
## 集成能力 {#53373f47}
扣子编程通过**技能**方式封装了一批常见的集成能力接口，方便你快速为工作流添加各种功能，例如数据库、存储、AI 能力等，使工作流更好地满足多样化的业务需求。
在和扣子 AI 对话，添加集成能力之前，你需要先在扣子 AI 对话区域单击**技能**，确认扣子 AI 已添加了你想要的技能。
![Image=351x346](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/ec6ae53bdce1483ca7de5a41f1bf2fb7~tplv-goo7wpa0wc-image.image)
### AI 能力 {#3e0e1eec}
为工作流添加 AI 能力时，通常需要开通模型服务并获取 API 密钥、并自行完成模型调用的配置与开发。扣子编程托管了业界先进的各种模型服务，无需任何配置，扣子 AI 会自动为你的工作流添加 AI 能力，帮助你开发更为智能的工作流。例如开发一个阅读笔记总结工作流，通过大模型可以将获取到的文章内容进行总结、提炼，并输出总结笔记。
默认情况下，工作流已开通了大模型集成的权限，扣子 AI 会在收到指令后，自动为工作流添加 AI 功能。你也可以在对话区发送自然语言指令，让扣子 AI 集成大模型能力。例如：
```Plain Text
使用大模型总结检索到的文章，并整理阅读笔记
```

更多信息，请参考[内置集成](/guides/internal_integrations)。
### 存储与数据库 {#bda4f2a6}
扣子编程提供了结构化、非结构化数据托管方案，对于需要集成数据库和存储能力的工作流，扣子 AI 会根据任务要求自动集成并设置数据库能力和存储能力。
例如运行提取发票信息的工作流时，将发票提取记录写入到数据库中。

::::cols
@col 50
![Image=2127x1116](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/ee56965a5ae04d9180b42d341f8869e8~tplv-goo7wpa0wc-image.image)


@col 50
![Image=2056x385](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/591ae6dc942c49cbb1daf22ddeeb84de~tplv-goo7wpa0wc-image.image)


::::

更多信息，请参考[集成数据库能力](/guides/integrate_database)、[集成对象存储能力](/guides/integrate_storage)。
### 飞书消息等外部集成 {#08ab4c3a}
除了扣子编程内置的存储、数据库等能力之外，你还可以为你的工作流集成外部功能和服务，例如飞书消息、飞书多维表格等。只需要简单的配置，即可在你的项目中使用这些外部集成能力，详细配置说明可参考[管理外部集成服务](/guides/manage_external_integrations)。
例如集成飞书多维表格服务，在运行提取发票信息的工作流时，将发票提取结果写入到飞书多维表格中。

::::cols
@col 50
![Image=1486x959](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/e837ce88fa2d4593b03ecb61cc2ddc53~tplv-goo7wpa0wc-image.image)


@col 50
![Image=752x116](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/099a0a89924a4121a9bba2ab4ecd0351~tplv-goo7wpa0wc-image.image)


::::

更多信息，请参考[支持的集成服务](/guides/integrations_overview#2903324c)。
## 后续操作 {#380980e9}
### 部署项目 {#349b8574}
完成工作流的开发与测试之后，你可以在页面右上角单击**部署**，将扣子编程开发的工作流部署成为一个可调用的 API 服务，以便后续通过 OpenAPI 方式将工作流的 AI 功能集成到你的应用中。具体操作，请参考[部署工作流](/guides/deploy_vibe_workflow)。
![Image=586x337](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/50c19ab62bfd4e11948d2e40cb8128cd~tplv-goo7wpa0wc-image.image)
### 分享项目 {#480db417}
在项目开发页面右上角单击**分享**按钮，可以将部署成功的项目分享给他人。
![Image=556x321](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/474209881a6e4e1490fc8da1a041f038~tplv-goo7wpa0wc-image.image)
### 查看线上日志 {#f3d86c2f}
查看已发布的应用、智能体和工作流的后端运行日志，以便在出现问题时进行故障排查和分析。详细说明可参考[查看日志和 Trace](/guides/view_running_log)。
![Image=546x365](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/64dbf3ed89d74e3583ae1b8302d2f713~tplv-goo7wpa0wc-image.image)
## 常见问题 {#b05fee7d}

* [工作空间中的成员为什么无法编辑项目？](/guides/vibe_coding_faq#86d58612)
* [如何查看内置集成消耗的积分？](/guides/vibe_coding_faq#eed61c76)