OpenAI 写入智能体环境文件
post /agents/environments/{environment_id}/files
将内联字节或 Files API 文件复制到已连接的执行环境中。同一路径已有普通文件时会替换该文件。请在两轮之间上传,等待写入成功后再开始下一轮。参见环境文件。
路径参数
environment_id: string
环境 ID。
minLength: 0, maxLength: 1048576
请求体参数
内容类型为 application/json。
hosted_environment_file_param: HostedEnvironmentFileParam
写入 OpenAI 托管执行环境的文件。
FileID object { file_id, path, type }
此前通过 OpenAI Files API 上传的文件。
file_id: string
已上传文件的 ID。
minLength: 1, maxLength: 256
path: string
/workspace 内的目标绝对路径。
minLength: 1, maxLength: 4096
type: "file_id" (default: "file_id")
对象类型,固定为 file_id。
"file_id"
Inline object { data, path, type }
直接以标准 Base64 数据提供的文件。
data: string
采用标准 Base64 编码的文件内容。
minLength: 0, maxLength: 6990508
path: string
/workspace 内的目标绝对路径。
minLength: 1, maxLength: 4096
type: "inline" (default: "inline")
对象类型,固定为 inline。
"inline"
返回值
EnvironmentFile object { environment_id, object, path, size_bytes }
执行环境中当前存在的文件。
environment_id: string
存放此文件的环境 ID。
minLength: 0
object: "agent.environment.file" (default: "agent.environment.file")
对象类型,固定为 agent.environment.file。
"agent.environment.file"
path: string
环境工作区内文件的绝对路径。
minLength: 0
size_bytes: integer
文件大小,单位为字节。
format: int64, minimum: 0
示例
## 从环境变量读取 API 密钥。
## 将 ENVIRONMENT_ID 设置为目标环境的 ID。
## 此官方示例仅展示请求地址和请求头。发送前请按上方参数补充 JSON 请求体及 Content-Type 请求头。
curl https://api.openai.com/v1/agents/environments/$ENVIRONMENT_ID/files \
-X POST \
-H 'OpenAI-Beta: agents=v1' \
-H "Authorization: Bearer $OPENAI_API_KEY"
201 响应示例
字段名、类型值和示例标识均按接口定义保留。
{
"environment_id": "environment_id",
"object": "agent.environment.file",
"path": "path",
"size_bytes": 0
}
TRAE-AI编程


更多建议: