低代码 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输出
-
执行成功率
-
节点执行总耗时(毫秒)