本文介绍如何使用 AgentRun 的快速创建能力，以低代码方式开发 Agent，适合进行快速上手和业务原型验证。
功能简介
快速创建 Agent通过可视化配置界面快速创建 Agent，无需编程经验，可以在较短时间内完成一个可运行的 Agent 配置和验证流程。
主要能力包括：
通过可视化配置界面完成模型选择、提示词编写、工具和沙箱配置等步骤；
支持在页面内对 Agent 的效果进行测试和对比；
支持版本管理与灰度发布，便于在逐步优化的过程中控制上线范围。
该能力更适合快速试验和验证业务思路，如需更复杂的逻辑控制，建议后续转为高代码模式进行二次开发。
核心概念
在快速创建 Agent 前，建议先了解如下核心概念，如已经提前了解，可以直接进入快速创建Agent操作步骤：
核心概念 | 说明 |
模型 | Agent 可以直接使用 AgentRun 中已接入的模型服务，包括：
在配置时，可以从上述模型中选择一个或多个作为 Agent 底层模型。 |
提示词（Prompt） | 提示词用于指导模型如何理解和处理用户请求。
|
工具与沙箱 | Agent 可以通过工具和沙箱扩展能力：
|
模型对比测试 | 在测试界面，支持进行多维度对比测试：
这有助于选择合适的模型和配置方案。 |
版本与灰度 | 快速创建的 Agent 支持版本管理与灰度发布：
|
操作步骤
步骤1：进入创建页面
进入Agent运行时控制台，首次使用需要进行SLR授权，在弹出的提示框中点击确认即可；
在Agent 运行时页面单击创建Agent；
选择快速创建，即可进入可视化配置界面。
步骤2：选择模型
为 Agent 指定一个名称并选择一个底层的语言模型
输入自定义的Agent名称；
选择模型：在 选择模型 区域，从 大语言模型 下拉列表中选择一个模型。
模型参数配置：调整模型的推理行为，配置推理模式、温度、Token限制等参数；
说明决策建议：温度越低，模型回答越稳定、确定；温度越高，回答越具创造性和多样性。对于需要精确回答的场景，建议调低温度（如 0.1-0.3）；对于创意性任务，可适当调高（如 0.7-0.9）。
在快速创建模式下，为简化配置，部分高级参数（如
top_k、seed等）不可用。如需精细调参，将 Agent 转为代码方式创建Agent进行配置。
步骤3：编写和优化提示词
提示词（Prompt）是您给 Agent 下达的指令，用于指导其如何行动、扮演什么角色以及遵循哪些规则。
系统提示词编写：定义 Agent 的核心职责和工作流程，可以直接使用系统预设的提示词/Prompt，也可以在界面中自定义编写；
提示词优化（可选）：在编写提示词后，建议使用AI Prompt助手，对提示词的表达或结构进行调整，使其更清晰、更有效；
配置提示词变量：通过设置变量，使 Agent 能够处理动态信息。在提示词中使用
{变量名}的格式来定义变量，例如{user_name}。示例提示词：
## 工作流程 1. 理解客户问题。 2. 根据客户 `{user_name}` 查询其订单信息。 3. 提供准确和有帮助的回复。
步骤4：为Agent配置工具或沙箱
工具和沙箱可以扩展 Agent 的能力，使其能够与外部世界交互或执行代码，如：
通过配置网页抓取工具，可以让Agent能够从网页中搜索和处理内容，并将HTML转换为Markdown格式，以便于使用；
通过配置BrowserTool浏览器沙箱，可以让Agent进行自动化测试和调试的浏览器实例；
通过配置Sandbox 沙箱—Code Interpreter沙箱，可以让Agent在安全的沙箱环境中执行Python代码、管理文件系统、处理数据文件等；
操作：
创建工具和沙箱：如果当前没有可用的工具，可以在资源配置>工具市场，搜索需要的工具，点击安装按照控制台指引进行创建，也可以参考工具管理、Sandbox沙箱服务文档进行工具和沙箱创建；
选择工具或沙箱
步骤5：配置访问凭证
为 Agent 配置访问入口的凭证（例如 API Key 等），用于保护您的 Agent，防止未经授权的调用。凭证由 AgentRun 的凭证管理统一管理和注入。
在访问凭证模块，点击入站：访问凭证
选择凭证模式：
不使用凭证（不推荐）：Agent 的调用地址可被公网匿名访问，存在安全风险。此模式仅适用于功能测试，严禁用于生产环境。
使用已有凭证（推荐）：为了保障 Agent 安全，建议选择此项。如果您还没有凭证，可以选择已有的凭证，可以点击
参考凭证管理进行创建。
步骤6：完成配置并测试
完成上述步骤后，单击右上角创建Agent，保存配置并创建Agent；
待创建完成后，可以在测试区域输入测试信息，与Agent进行交互，测试Agent功能；
步骤7：发布版本并进行灰度
AgentRun 支持版本管理与灰度发布。在对 Agent 的提示词、工具或模型进行变更后，建议先 发布版本，然后通过 创建Endpoint 并 启用次要版本（灰度发布），将一小部分 流量分配 给新版本。在监控确认新版本稳定可靠后，再逐步增加流量比例，最终完成全量上线。
在左侧目录中选择版本与灰度；
发布当前版本：点击发布版本，并输入版本描述，描述此版本主要变更和功能后，点击发布版本；
创建Endpoint：
输入Endpoint名称，主要版本下拉框中选择上一步中发布的当前版本号；
启用次要版本（灰度发布）：勾选启用次要版本（灰度发布），选择次要版本，并为主要版本和次要版本配置流量分配百分比；
后续步骤
对比测试
可以使用对比测试功能对比不同模型、不同版本在同一输入下的表现，测试结果将并排显示，方便直观对比并根据此调整模型、提示词或工具配置。
在左侧目录选择配置与调试；
点击模型对比测试区域的对比测试按钮；
选择测试类型和对比对象：
模型测试：选择不同的模型进行对比测试，查看不同模型的回答效果和性能差异；
Endpoint测试：选择不同的Endpoint进行对比测试，查看不同提示词、配置和工具的回答效果。
选择完成后，输入同一问题将并排显示测试结果，如：
转换为代码模式
当业务复杂度提升，需要更精细的逻辑时，可以将快速创建的Agent一键转换为代码模式，转换后的代码结构清晰，可在此基础上进行二次开发，无需从零构建：
代码编辑能力：可以直接编辑Agent的代码实现，拥有更高的灵活性和控制力；
版本控制：支持代码版本管理，可以追踪每次修改的历史记录。
操作：
在Agent的配置与调试页面右上角，点击转换为代码模式；
仔细阅读提示信息后，点击转换为代码创建，如果您只是想查看该Agent的代码详情，可以点击代码预览，将代码下载到本地后，进行查看预览。
重要一旦转换就不能再转换回来，将失去可视化配置界面，需要参考代码创建Agent通过代码进行配置。
等待转换完成后，快速创建的Agent将由低代码可视化界面配置转换为高代码模式。
在应用中集成Agent
在左侧集成与发布模块参考Agent集成与发布文档，将开发的 agent 快速集成到您的前端网页、后端应用等，支持UI集成、代码集成、生态集成三种方式。
快速创建Agent默认配置说明
以下为快速创建Agent默认的配置说明，在快速创建模式下，无法修改。如需修改，需要转换为代码创建模式，具体操作详见本文的转换为代码模式步骤。
运行时配置
运行时 | python3.12 |
启动命令 | python3 main.py |
启动端口 | 9000 |
资源配置
CPU（核） | 0.5核 |
内存 | 512MB |
单实例并发会话数上限 | 100 |
会话空闲超时时间（秒） | 1800 |
网络配置
网络模式：PUBLIC，允许默认网卡访问公网。
常见问题（Q&A）
Q1：快速创建的 Agent 是否可以直接用于生产环境？
A：
可以，但仅建议用于逻辑简单、流量可控的场景。对于需要处理复杂业务流程或对高可用性有严格要求的生产环境，我们强烈建议您在完成原型验证后，转为高代码模式以获得更强的控制力、稳定性和可维护性。
Q2：快速创建的 Agent 的运行环境是什么？如何扩缩容？请求性能如何？
A：
Agent 运行在基于函数计算（FC）的实例环境中。该环境会根据会话和请求量进行全自动的弹性扩缩容，您无需手动配置实例数量。冷启动时间通常在毫秒级到秒级不等，具体性能受模型响应速度、工具调用耗时等多种因素影响。您可以在 Agent 的可观测性页面查看详细的性能指标。