通过代码创建Agent（高代码）

步骤1：进入代码创建Agent页面

1. 进入AgentRun运行时与沙箱页面。

2. 单击创建Agent，在弹出的窗口中选择通过代码创建。

3. 输入Agent名称和功能描述，建议使用有意义的名称，便于后续管理和识别。

步骤2：代码配置

1. 选择代码来源

   上传代码包

   1. 单击上传文件，选择本地 zip 文件。

   2. 确保包内结构符合运行时规范（入口文件位置、依赖目录等）。

   3. 如基于官方示例，可先下载模板，填入必要配置（如 system_prompt），再打包上传。

      说明

      示例代码中的 MODEL_NAME 和 SANDBOX_NAME 会从运行时环境变量中读取，此处无需修改。

   从OSS获取代码包

   1. 在代码来源中选择OSS 对象存储。

   2. 选择代码包所在的Bucket名称和OSS目录。

   3. 确保执行角色具备读取该 OSS 对象的权限。

   使用容器镜像部署

   1. 在代码来源中选择容器镜像。

   2. 选择镜像实例与镜像仓库。

      说明

      • 支持自定义镜像、阿里云容器镜像服务（个人版/企业版）。

      • 选择自定义镜像时，可直接配置自定义镜像地址。

   3. 选择镜像版本。

   在线编写和调试代码

   选择在线编码方式，系统将在在线代码编辑器中自动加载官方示例代码，可直接进行代码业务逻辑实现和修改。

2. 启动配置

   上传代码包/OSS对象存储/在线编辑模式

   • 启动命令，例如：

     • python3 main.py

     • node app.js

     • java -jar app.jar

   • 启动端口，如 9000，需与代码中服务监听端口一致。

   说明

   使用官方模板（如上述 Python 示例）时，一般保持默认配置即可。

   容器镜像模式

   • 启动命令通常由镜像内 Dockerfile 的 CMD/ENTRYPOINT 决定。

   • 需要指定启动端口，与容器内应用监听端口一致。

步骤3：资源配置、环境变量与高级配置

在资源配置和高级配置中设置运行参数。

1. 计算资源

   • CPU（核）与内存：为每个 Agent 实例分配的计算资源。资源越多，处理复杂任务的速度越快，但成本也相应增加。

   • 单实例并发会话数上限：单个 Agent 实例能同时处理的会话数量上限。提高此值可减少所需实例数，从而节约成本，但需确保代码线程安全且单个实例的 CPU 和内存资源充足。

   • 会话空闲超时时间（秒）：实例上最后一个会话结束后，空闲超过该时间即自动释放实例。

2. 环境变量

   为 Agent 配置运行时环境变量，用于向代码传递参数。使用官方示例时，需配置以下环境变量：

   • MODEL_NAME：必选，填写模型管理中已创建的模型名称。

   • SANDBOX_NAME：可选，填写已创建的 Sandbox 名称。

3. 网络配置

   • 允许访问VPC：Agent 需要访问 VPC 内的云资源（如 RDS、OSS 等）时开启。

   • 允许默认网卡访问公网。

4. 日志配置

   开启日志功能，可将 Agent 的运行日志保存在日志服务中。可指定日志项目（Project）与日志库（Logstore），也可选择自动配置或自定义配置中的一键配置功能使用默认值。

5. 健康检查配置

   启用健康检查后，可配置检查路径（如 /health）、检查间隔（秒）、超时时间（秒）和失败阈值。系统将定期向指定路径发送 HTTP 请求检查服务状态，连续失败达到阈值时自动重启服务实例，有助于提高服务可用性和自动故障恢复能力。

步骤4：按需配置执行角色

执行角色用于授予 Agent 代码访问其他云资源（如模型服务、OSS）的权限。AgentRun 通过执行角色（RAM 角色）管理权限，代码在运行时将扮演此角色以获得相应的操作权限。

授权主体：函数计算服务（fc.aliyuncs.com）

所需权限：根据实际使用的服务添加相应策略

在执行角色ARN中选择已有角色。如果没有符合要求的角色，可参考以下步骤创建。

1. 单击执行角色ARN下拉框右侧的添加按钮，进入RAM访问控制 > 角色列表。

2. 单击创建角色。

3. 在创建角色页面，信任主体类型选择云服务。

4. 信任主体名称选择函数计算/FC。

5. 单击确定，输入角色名称，再次单击确定，并按照提示完成安全验证。

6. 创建成功后进入角色详情页，单击新增授权。

7. 根据实际使用的服务添加相应策略，常用策略示例：

   • AliyunOSSFullAccess：Agent 需要使用 OSS 中的资源时，需配置对象存储服务（OSS）管理权限。

   • AliyunAgentRunFullAccess：使用官方示例创建时必须配置 AgentRun 服务管理权限。

   • AliyunDevsFullAccess：Serverless 开发平台（Devs）管理权限。

步骤5：配置访问凭证

为 Agent 配置访问凭证（如 API Key 等），用于保护 Agent 防止未经授权的调用。凭证由 AgentRun 的凭证管理统一管理和注入。

1. 在访问凭证模块，单击入站：访问凭证。

2. 选择凭证模式：

   • 不使用凭证（不推荐）：Agent 的调用地址可被公网匿名访问，存在安全风险。此模式仅适用于功能测试，严禁用于生产环境。

   • 使用已有凭证（推荐）：为保障 Agent 安全，建议选择此项。如果尚未创建凭证，可单击参考凭证管理进行创建。

步骤6：完成配置并测试

完成上述配置后，单击右上角开始部署完成创建。系统将自动跳转至 Agent 详情页，选择代码与调试，在调试工具中进行测试。

步骤7：发布版本并进行灰度

AgentRun 支持版本管理与灰度发布。对 Agent 的提示词、工具或模型进行变更后，建议先发布版本，再通过创建 Endpoint 并启用次要版本（灰度发布），将少量流量分配给新版本。确认新版本稳定后，逐步增加流量比例，最终完成全量上线。

1. 在左侧目录中选择版本与灰度。

2. 发布当前版本：单击发布版本，输入版本描述说明主要变更和功能后，再次单击发布版本。

3. 创建Endpoint：

   1. 输入Endpoint名称，在主要版本下拉框中选择上一步发布的当前版本号。

   2. 启用次要版本（灰度发布）：勾选启用次要版本（灰度发布），选择次要版本，并为主要版本和次要版本配置流量分配百分比。