根据环境 ID 查询准备状态和已安装资产的安全元数据。
接口
GET /agents/environments/{environment_id}
返回指定环境的当前状态和安全元数据。成功返回 200。
路径参数environment_idstring (必选)创建回执中的环境 ID,不是 Session ID、模板 ID 或 sandbox ID无请求体。 | 请求示例 |
响应字段idstring环境 IDobject stringEnvironment 对象类型,固定为 agent.environmenttype string环境类型,固定为 openai_hostedstatus string环境状态:pending、ready、connected、disconnected、suspended、expired、failedfiles array已安装文件的安全元数据,不返回文件内容。
属性 id string环境文件 IDtype string文件引用类型,固定为 file_idpath string环境内文件路径size_bytes integer文件字节数file_id string原始源文件 IDarray已安装 Skill 的安全元数据,不返回 Skill 包内容。
属性 type stringSkill 引用类型,固定为 skill_referencename string技能名称description string技能说明skill_id string技能资源 IDversion string已冻结的具体版本array插件列表,当前托管环境返回 [];历史记录中的插件字段不代表可以创建ready 表示环境准备完成,可以创建引用该环境的 Session。connected 表示实例已经连接,不保证后续每条命令都成功。 | 响应示例 |
错误码
| HTTP 状态码 | 错误类型 / 错误码 | 解决方案 |
|---|---|---|
404 | not_found_error / not_found_error | 使用当前工作空间中存在且可见的环境 ID |
503 | server_error / environment_unavailable | 稍后重试;持续失败时提交工单并提供 x-request-id |
{"error":{"type","code","message","param"}},网关错误可能使用不同结构。排查时保留 HTTP 状态、x-request-id 和环境 ID。