Skip to main content

获取 Artifact

查询单个不可变产物版本的元数据。

接口

GET /agents/sessions/{session_id}/artifacts/{artifact_id} 返回指定 Artifact 的元数据。成功返回 200,不返回文件正文。

路径参数

session_id string (必选)Artifact 所属 Sessionartifact_id string (必选)列表返回的 Artifact 版本 ID,不是 file_id 或快照 ID无请求体。

请求示例

curl -sS "$BASE_URL/agents/sessions/sess_xxx/artifacts/artifact_xxx" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "OpenAI-Beta: agents=v1"

响应字段

id stringArtifact 版本 ID,不是 file_idobject stringArtifact 对象类型,固定为 agent.session.artifactsession_id string所属 Sessionenvironment_id string发布来源环境turn_id string发布来源 Turnpath string产物生成时的沙箱完整路径size_bytes integer文件大小,单位字节created_at integer创建时间,Unix 秒详情不返回底层存储标识、签名下载地址或凭据。

响应示例

{
  "id": "artifact_xxx",
  "object": "agent.session.artifact",
  "session_id": "sess_xxx",
  "environment_id": "ccarenv_xxx",
  "turn_id": "turn_xxx",
  "path": "/workspace/outputs/report.txt",
  "size_bytes": 19,
  "created_at": 1793941200
}

错误码

HTTP 状态码错误类型 / 错误码解决方案
404not_found_error / not_found_error使用当前工作空间中存在且未删除的 Artifact ID
错误正文形如 {"error":{"type","code","message","param"}},网关错误可能使用不同结构。