在我们精心编写好人设与回复逻辑后，发现智能体无法按照我们编写的内容来执行。举例一种错误的写法：在了解这个问题发生的原因之前，我们先了解下，智能体插件调用场景的执行逻辑是怎样的step1: 大模型识别到用户问题，调用头条新闻插件step2:插件执行并返回执行结果step3:根据插件的执行结果返回本次调用的总结回复可以看到，在调用插件场景下智能体本身有一个执行逻辑，因此无法完全遵循我们所写的人设与回复

工作流使用限制相关文档：https://www.coze.cn/open/docs/guides/workflow_limits如您在调用工作流过程中出现运行中止或其他异常问题，可能的原因是工作流运行超时导致，您可以前往火焰图查看具体耗时异步执行工作流的详细介绍可参考官网文档：https://www.coze.cn/open/docs/guides/use_workflow#00d7b009大模型

如您在使用智能体过程中， 出现工作流中某个节点可以试运行成功，但整个工作流试运行，会在该节点进行报错的问题，可参考此文章前置节点的原始输出与最终输出格式不一致，导致当前节点的输入为空 未正确引用有最终输出的参数，表现为在该节点的输入框内容为空 确认输入参数中引用的参数有最终输出值确认引用参数的原始输出和最终输出格式一致，方法如下：原始输出通常为该节点本身返回的内容，例如插件、大模型节点、知识库节点

如您在使用智能体过程中， 出现工作流能够试运行成功，但添加至智能体后调用报错或不符合预期，可参考此文章开始节点设置的输入参数如下：确认智能体中调用工作流输入的值与试运行一致这里参数字段的提取逻辑主要根据您对该参数的描述来进行语义识别如果工作流中的结束节点选择了返回变量，则会调用大模型节点对工作流进行总结，总结内容为最终智能体回复

多Agent模式，适用于把任务分给不同的Agent执行。因此，准确的跳转是多Agent智能体的核心内容配置解释：判断时机为-模型回复后，则在该模型生成了回复后，结合下方的跳转prompt，对该回复内容进行跳转判断如跳转效果不理想，则重点调整分类agent的输出内容和跳转prompt效果展示如需更详细的了解跳转的判断逻辑链路，可参考调试详情中的内置提示词

本文档主要涵盖常见的性能调优方法如您在使用智能体的过程中，出现响应慢，等待回复时间长等问题，可参考此文档通过调试详情中的火焰图，可以看到整体链路下，每个节点的具体耗时判断耗时较长的节点是否符合预期插件节点多次调用插件，确认插件节点的平均耗时是否符合插件介绍中的平均耗时大模型节点大模型节点接入了方舟平台，扣子默认使用公共资源池创建的接入点，会随着整体请求量的变化产生部分波动，其中：输入tokens

扣子中有部分节点支持批处理功能，具体是否支持可以通过节点配置界面查看这里以大模型节点举例批处理需要传入一个数组，循环次数为该数组的最大值这里传入了一个整数型数组：[1,2,3,4,5]配置输入参数，选择批处理变量：item1，并在提示词中进行引用批处理节点会返回一个 Array 数据

选择markdown 组件，该组件支持markdown格式输出该组件的内容中包含以下格式内容时可展示出url中的图片

因API接口调用并无用户登陆态信息，可参考使用：https://www.coze.cn/docs/developer_guides/chat_v3 user_id字段实现用户区分扣子支持对用户做区分，在开启变量节点的用户信息变量后，可以在工作流中获取该变量来进行用户区分。该变量在不同的发布渠道展示的结果不同，会根据不同的用户登陆信息来生成不同的sys_uuid例如：发布在扣子商店后，不同的用户登陆

扣子产品拥有高度的可操作性，从零基础到玩转扣子需要经历一个必要的学习过程在这个学习过程中，我们会在不同的使用阶段产生不同的问题基于这些问题，我们提取出一条扣子使用路径在这条路径上的每一步所产生的问题，我们均记录在社区专栏中从了解扣子，到使用扣子，我们会经过哪些环节？在用户使用路径中，产生的大部分问题都可以在官网文档或交互界面的提示中寻得答案针对给用户带来较多疑问的环节，我们编写了对应的文档，给大家

在扣子使用中，无论是我们上传文件，或者是生成的非文本内容，都是存放在扣子服务器端以url形式进行访问，这个url并非是永久保存的，这里举例两种常见url有效期的查看方法使用文生图节点，会生成以下url（仅示例，实际不可访问）将此url粘贴至浏览器中进行访问，会跳转到图片链接其中x-expires 字段为有效截止日期，这里x-expires=1765876786，为时间戳格式，需进行转换此方法也同样

Step 1进入方舟控制台的在线推理模块Step 2选择vision系列的模型并创建接入点Step 3在扣子智能体编排界面中选择创建的接入点（按接入点名称展示）Step 4上传图片并给出指令

Step 1：在工作流中设置File-Default类型变量Step 2：选择{{ FileUpload1.value[0] }}变量Step 3：最终该变量会自动转换成url传入工作流中

基于js语法的条件判断语句用一个表单进行举例1、添加表单2、设置内容输入框的可见性：{{ InputNumber2.value >3}}3、操作数字输入框的值>3

这里我们以模版库中的一个案例来进行介绍：https://www.coze.cn/template/project/7442139374751629323?业务逻辑-工作流介绍开始节点中传入了两个变量变量名：Image 类型：image变量名：style 类型：string如何在用户界面传入这两个值？点击开始生成按钮点击事件：可以看到这里点击开始生成按钮后，会控制Form1组件，调用该组件的“提交”

在扣子的使用中，前端渲染图片的格式如下![图片名称](图片地址）如果知识库中本身已经有图片存在，图片会以url形式存在，参考以下格式<img src =https://lf3-appstore-sign.oceancloudapi.com/ocean-cloud-tos/BYTE_RAG_UPLOAD_BIZ_TYPE/*********希望大模型输出的内容中包含图片，可在大模型的系统提示词中按照

检查文件是否符合知识库的使用限制，可参考：https://www.coze.cn/docs/guides/knowledge文件需要在当前格式下被正确打开才可成功上传，如果是直接更改的格式后缀可能会导致上传失败。