yun
-
Agent Runtime 故障排查
先确定失败发生在哪一步:访问集群、提交声明、调度、拉取镜像、创建运行环境、挂载文件、执行任务,还是清理资源。保留第一次失败的信息,再进行配置修改。
-
Agent Runtime 沙箱启动失败排查
调用 StartSandboxInstance 或执行 agr instance create 后,接口直接返回错误,或者实例状态持续停留在 STARTING、转为 STARTING_FAILED,或在启动后进入 FAILED,均表示本次启动没有稳定完成。
-
Agent Runtime agr CLI 安装与配置
agr 是 Agent Runtime 的命令行工具。这里说明 agr CLI 的安装、凭据写入与配置验证方法。
-
Agent Runtime 沙箱工具类型说明
沙箱工具的类型决定沙箱实例的运行环境形态和默认能力。选择正确的类型后,基于该沙箱工具启动的沙箱实例会继承对应的环境配置、预置能力和适用边界。
-
Agent Runtime 创建沙箱工具(通过 CLI)
创建一个可复用的 Sandbox Tool,定义类型、网络模式、超时和标签,以及自定义镜像、端口、资源规格和探针配置。后续基于该 Tool 启动的 Instance 会继承这些设置。
-
Agent Runtime 实例无法访问外部网络或外部无法访问实例端口
Agent Runtime 网络问题通常表现为三类:Instance 无法访问目标地址、外部请求无法到达 Instance 业务端口,或创建、更新 Tool 时被网络参数校验拒绝。排查时先区分问题发生在 Tool 默认配置、运行中的 Instance,还是 NetworkPolicy、DNSConfig 与端口声明等附加限制。
-
Agent Runtime 5 分钟创建第一个沙箱
如何通过 agr CLI 在 5 分钟内创建并运行第一个沙箱:准备一个 code-interpreter 沙箱工具,基于该沙箱工具启动沙箱实例,执行一段 Python 代码并验证执行结果,最后清理试用资源。完成后,你将掌握使用 agr CLI 创建、运行和删除沙箱的基本流程。
-
Agent Runtime 用 MCP 连接 Claude/Cursor
AGS 提供托管的远程 HTTP MCP 服务,对于支持远程 HTTP MCP 且兼容 AGS 鉴权方式的客户端,可以以将 Agent Sandbox Code MCP 添加到 Cursor 或 Claude Desktop,让模型调用代码执行、命令执行和文件读写能力。使用该托管服务无需获取源码或自行部署 MCP Server,但需要提前准备 AGS API Key、沙箱工具、可用地域,并完成客户端配置。
-
Agent Runtime 用 E2B SDK 跑代码
python3 -m pip install e2b-code-interpreter。
-
Agent Runtime 暂停与恢复 Sandbox Instance
Sandbox Instance 需要临时中断、稍后继续使用时,可以将实例从 RUNNING 暂停到 PAUSED,再恢复到 RUNNING。