分页列出 Session 已发布的不可变产物版本。
接口
GET /agents/sessions/{session_id}/artifacts
分页列出指定 Session 已发布的 Artifact。成功返回 200 和列表信封。
Artifact 需要目标工作空间已开通产物能力,并在 Turn 成功完成后才会产生。托管环境完成 Turn 后,如果工作空间未开通产物能力,列表返回空数组。本轮没有新增产物时,列表仍可能包含此前 Turn 的产物;可读取返回项的
turn_id 筛选本轮结果。使用
environment.type=none 的 Session 没有关联环境,产物列表可能返回 404。需要托管环境完成 Turn 后再查询。查询参数environment_idstring (可选)环境 ID,可选,按环境过滤limit integer (可选)每页数量,默认 20,范围 1–100order string (可选)排序方向,asc 或 desc,默认 descafter string (可选)上一页的 last_idbefore string (可选)反向分页游标,可选;与 after 不能同时使用当前不提供按 turn_id 或 path 的服务端过滤。分页后由调用方自行筛选。 | 请求示例 |
响应字段objectstring列表对象类型,固定为 listdata array当前页的 Artifact 列表,可为空first_id string / null当前页首项 ID。空页为 nulllast_id string / null当前页末项 ID。空页为 nullhas_more boolean当前方向是否还有下一页data 项字段:列表不返回底层存储标识、签名下载地址或凭据。
data 项 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 秒 | 响应示例 |
错误码
| HTTP 状态码 | 错误类型 / 错误码 | 解决方案 |
|---|---|---|
400 | invalid_request_error / invalid_request_error | 按查询参数说明修正 limit、order,并避免同时传冲突参数 |
404 | not_found_error / not_found_error | 使用当前工作空间中存在且可见的 Session ID |
404 | not_found_error / not_found_error | 使用当前集合上一页返回的 last_id 作为游标 |
{"error":{"type","code","message","param"}},网关错误可能使用不同结构。排查时保留 Session ID、Turn ID、环境 ID 和 x-request-id。