低代码 Agent 创建功能提供所见即所得的流程画布,通过拖拽节点、连接流程即可完成 Agent 配置,大幅降低开发门槛。
工作原理
低代码 Agent 创建基于流程画布(Flow)模式,采用可视化编排方式构建 Agent 工作流。流程画布支持多种节点类型,包括开始节点、LLM 节点、MCP服务节点、代码执行节点等。通过连接节点构建完整的工作流,系统会自动将画布配置转换为可执行的流程定义。流程支持对话模式和工作流模式两种执行方式。
主要能力包括:
模型编排:支持通义系列及 OpenAI 兼容模型
工具支持:支持编排基于 OpenAPI 规范和 MCP 协议的工具
Agent 编排:支持编排 agentrun agent 及内置的 function calling agent
知识库集成:支持对接百炼知识库
自定义代码执行:内置代码执行节点,同时支持编排函数计算节点
完备的流程控制结构:分支、循环、迭代、并行
多客户端协议集成:OpenAI、dify workflow、dify chatflow
版本管理与灰度发布:便于在逐步优化的过程中控制上线范围
核心概念
在使用Flow创建 Agent 前,建议先了解如下核心概念,如已经提前了解,可以直接进入Agent创建:
核心概念 | 说明 |
模型 | Agent 可以直接使用在 AgentRun 平台配置的通义及 OpenAI 协议兼容的模型,包括:
|
Agent | 使用Flow创建的 Agent 支持在流程 Agent 节点中添加在AgentRun平台通过其他方式创建的Agent: |
对话模式/工作流模式 |
|
环境变量 | 使用环境变量来存储您的应用特定的敏感信息,如 API 密钥、数据库密钥等。支持在流程维度配置环境变量,流程中的节点可以访问流程的环境变量。 |
版本与灰度 | 快速创建的 Agent 支持版本管理与灰度发布:
|
适用范围
使用低代码 Agent 创建功能需要具备以下权限:
权限策略 | 说明 |
AliyunFCInvocationAccess | 流程中调用函数节点需要此权限 |
AliyunDevsReadOnlyAccess | 流程中调用 MCP、工具需要此权限 |
AliyunBailianDataFullAccess | 流程中调用百炼知识检索需要此权限 |
AliyunAgentRunReadOnlyAccess | 流程中调用 agentrun agent 需要此权限 |
AliyunEventBridgePutEventsPolicy | 流程中调用 EventBridge 需要此权限(功能目前不支持,未来可能开放) |
AliyunFnFFullAccess | 流程中调用其他流程需要此权限(功能目前不支持,未来可能开放) |
前置条件:
确保已配置模型。在模型管理页面配置通义或 OpenAI 兼容模型。当前支持通义和 OpenAI 模型。
通过Flow创建Agent
通过流程画布创建 Agent,配置模型、工具等节点,完成一个可运行的 Agent。
操作步骤
登录AgentRun 控制台,在Agent 运行时页面点击创建Agent。
选择通过Flow创建,进入 Flow Agent 创建页面。
配置基本信息:
Flow名称:输入有意义的名称,便于后续管理和识别(如:
agent-flow-0RUvK)功能描述(可选):详细描述 Flow 的功能、用途和特点
配置执行角色:
从下拉列表中选择执行角色(如:
AliyunFnFExecutionRole)如果角色缺少权限策略,点击一键授权完成授权
执行角色用于授予工作流服务访问其他阿里云服务的权限,需要以下权限:AliyunFCInvocationAccess、AliyunDevsReadOnlyAccess、AliyunFnFFullAccess、AliyunAgentRunReadOnlyAccess、AliyunEventBridgePutEventsPolicy、AliyunBailianDataFullAccess
配置访问凭证:
入站:访问凭证:选择匿名访问或添加凭证(推荐使用凭证以保障安全)
点击下一步,进入流程画布页面。
在流程画布中配置流程:
画布默认包含开始节点和结束节点
在开始节点和结束节点之间添加节点(如 LLM 节点、流式回复节点等),一个基础的流程示例如下:

点击开始节点,在右侧配置面板的下一步区域添加节点
或直接在画布上右键点击,选择 添加节点,然后选择节点类型
配置节点:
点击节点打开配置面板
对于 LLM 节点:
选择模型:点击模型选择区域,从下拉列表中选择已配置的模型(如:
qwen3-model的qwen3-max),并配置模型其他参数(如温度、最大标记等,可选)配置提示词:在 SYSTEM 消息中编写提示词,在USER中配置参数(必填)

对于流式回复节点:配置流式回复相关参数

连接节点:确保开始节点连接到中间节点,中间节点连接到结束节点
点击创建Agent,等待创建完成。
创建成功后,页面显示Flow 创建成功提示,并跳转到 Agent 详情页。
测试运行
在 Agent 详情页,使用测试运行功能验证 Agent 是否正常工作。
在画布工具栏点击测试运行按钮。
在测试运行面板中:
选择执行模式:工作流模式或对话模式
填写输入参数:
sys.query(选填):输入测试问题,如"你好,请介绍一下你自己"
sys.conversation_id(选填):会话 ID,用于会话变量共享
sys.user_id(选填):用户 ID
点击开始运行,等待运行完成。
查看运行结果:

发布版本
为 Agent 发布版本,用于版本管理和灰度发布。
只有流程有新的变更的情况下才能发布新的版本。
操作步骤
在 Agent 详情页,点击左侧导航栏的版本与灰度。
在版本管理区域,点击发布版本。
填写版本描述(可选),如"初始版本,包含基本的 LLM 对话流程"。
点击发布版本,等待发布完成。
发布成功后,版本列表中显示新发布的版本,包含版本号、描述和发布时间。
通过 API 调用
使用 curl 命令调用 API,您可以在Agent详情页里的页面查看相关调用示例:

发布为聊天框
将 Agent 发布为聊天框,提供 Web 界面供用户交互。
操作步骤
在 Agent 详情页,点击左侧导航栏的集成与发布。
在集成模板区域,选择集成方式和风格模板:
集成方式:全屏嵌入、浮窗聊天、侧边栏、自定义
风格模板:简约风格、商务风格、科技风格、温馨风格
点击开始集成,打开 API 绑定配置对话框。
配置 API 绑定:
选择执行角色(如:
AliyunAgentRunDefaultRole)选择 Endpoint(如:
Default (ACTIVE))点击下一步
等待集成资源部署完成。
部署完成后,页面显示部署完成! 提示。可以在已部署的集成资源 区域查看聊天框 URL。
查看流程 trace
查看 Agent 流程执行的 trace 信息,用于调试和监控。
操作步骤
在 Agent 详情页,点击左侧导航栏的可观测性。
查看流程执行记录和 trace 信息:
基础监控:查看执行次数、执行耗时、执行错误次数、LLM 调用次数、Token 使用情况、执行成功率等统计信息
LLM 监控:查看 LLM 调用相关的监控信息
链路追踪:查看详细的执行链路信息(需要先开启链路追踪功能)
基础监控页面显示的信息包括:
执行次数
执行耗时平均值(毫秒)
执行耗时最大值(毫秒)
执行错误次数
LLM 调用次数
Token 输入
Token输出
执行成功率
节点执行总耗时(毫秒)