如需查看完整的文档索引,请参阅 llms.txt。在文档页面的 URL 末尾加上 .md 即可查看该页面的 Markdown 版本。
主导航
主题

Daytona

在 Daytona 沙盒中运行 Agents API 会话。

请参阅 OpenAI Cookbook 中的应用管理和 webhook 管理示例。

有关执行器设置和连接要求,请参阅自托管沙盒。

选择沙盒预配模式:

  • 应用管理: 按照本指南从您的应用中启动和停止沙盒。
  • Webhook 管理: 部署一个处理程序,在收到 OpenAI webhook 时启动或重新连接沙盒。

有关这两种模式的比较,请参阅沙盒生命周期。

Webhook 管理

使用控制器验证 OpenAI 发来的 webhook 请求,并将沙盒预配任务加入队列。将控制器与运行各个会话执行器的工作沙盒分开部署。按照部署并连接处理程序中的步骤注册端点和签名密钥。

收到 environment_connection 请求时,启动或重新连接工作沙盒。如果会话失败,请释放该沙盒。请分别为工作沙盒和控制器显式设置超时时间。如果需要在空闲时停止计算资源,请制定策略,协调资源停用与新到任务的处理。请参阅生命周期行为。

应用管理

准备工作

您需要 OpenAI 项目 API 密钥、Daytona API 密钥和 Codex CLI 软件包。

设置 DAYTONA_API_KEY,并使用 OPENAI_API_KEY 发送应用请求。将 OPENAI_EXECUTOR_API_KEY 设置为环境密钥。向沙盒传入密钥时,仅传入此环境密钥,并将其用作 CODEX_API_KEY。

1. 设置 Daytona 环境

创建自托管会话并保存其环境 ID。使用 Daytona SDK 或 API 创建一个隔离沙盒,并为其指定已配置的工作目录。在沙盒中安装 Codex CLI,然后使用该环境 ID 和环境密钥启动沙盒中的执行器。

执行器会主动向 OpenAI 建立长连接,但 Daytona 的空闲检测机制无法感知此连接。设置 auto_stop_interval=0,防止沙盒在智能体工作时自动停止。同时设置沙盒的最长存活时间,避免任务中断后计算资源一直运行。

如果您经常使用沙盒,请将 Codex 和 ripgrep 加入 Daytona 快照,以便沙盒更快建立连接。

2. 运行会话

Daytona 执行器连接后,按照运行和继续会话中的 HTTP 示例发送输入,并以流式方式接收结果。完成后,请删除会话,并单独停止 Daytona 沙盒。

请先启动沙盒,再提交输入。当前轮次会等待环境建立连接。连接成功后,会话会在事件流中发出 agent.session.environment.connected 事件。

使用 agent.session.turn.completed 判断当前轮次是否成功完成。轮次失败或取消后也可能出现 agent.session.idle,因此不能仅凭会话处于空闲状态就判定该轮次成功。如果在事件发生后立即查询会话,短时间内仍可能得到先前的状态。

参考资料