OpenAI 获取会话产物元数据
2026-11-18 18:01 更新
get /agents/sessions/{session_id}/artifacts/{artifact_id}
获取某个持久会话产物的不可变元数据。参见会话产物。
路径参数
session_id: string
拥有此产物的会话 ID。
minLength: 0, maxLength: 1048576
artifact_id: string
不可变会话产物的 ID。
minLength: 0, maxLength: 1048576
返回值
SessionArtifact object { id, created_at, environment_id, 5 more }
由托管会话中已完成的轮次发布的不可变文件。
id: string
不可变产物的 ID。
minLength: 0
created_at: integer
产物发布时的 Unix 时间戳,单位为秒。
format: int64
environment_id: string
生成产物的环境 ID。
minLength: 0
object: "agent.session.artifact" (default: "agent.session.artifact")
对象类型,固定为 agent.session.artifact。
"agent.session.artifact"
path: string
文件在执行环境中的原始绝对路径。
minLength: 0
session_id: string
拥有此产物的会话 ID。
minLength: 0
size_bytes: integer
不可变产物的大小,单位为字节。
format: int64, minimum: 0
turn_id: string
发布此产物的已完成轮次 ID。
minLength: 0
示例
## 从环境变量读取 API 密钥。
## 将 SESSION_ID 设置为目标会话的 ID。
## 将 ARTIFACT_ID 设置为目标产物的 ID。
curl https://api.openai.com/v1/agents/sessions/$SESSION_ID/artifacts/$ARTIFACT_ID \
-H 'OpenAI-Beta: agents=v1' \
-H "Authorization: Bearer $OPENAI_API_KEY"
200 响应示例
字段名、类型值和示例标识均按接口定义保留。
{
"id": "id",
"created_at": 0,
"environment_id": "environment_id",
"object": "agent.session.artifact",
"path": "path",
"session_id": "session_id",
"size_bytes": 0,
"turn_id": "turn_id"
}
需要文件本身时,可下载会话产物内容。
以上内容是否对您有帮助:

TRAE-AI编程


更多建议: