OpenAI 写入智能体环境文件

2026-11-18 17:53 更新

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
}
以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号