以编程方式使用文档

计算机使用功能让您的 Fleet 代理可以访问隔离的虚拟计算机。代理可以编写和执行代码、管理文件、安装软件包,以及调用已认证的外部 API,而不会向语言模型暴露凭据。

计算机模式

选择虚拟计算机如何在代理的对话线程之间共享:

模式描述
**共享计算机**所有线程共享一台计算机。文件系统、已安装的软件包和正在运行的进程在各线程之间保持持久化。当您希望文件、依赖项或环境设置在对话中累积时,请选择此模式。共享计算机不会自动删除。
**每线程一台计算机**每个线程获得一台独立的隔离计算机,该计算机在启动时是全新的状态,空闲时会被归档。对于软件工程代理和运行大量并行、写密集型任务的工作负载,或需要线程之间保持独立状态的情况,请选择此模式。

配置计算机使用

Open the Create agent dialog

Fleet 左侧导航栏中的 **我的代理**区域 ,点击 **使用 AI 创建** or **空白代理**并输入您的代理名称。

Enable computer use

在 **您的代理是否应该使用计算机?**下,选择 **是**,然后选择 **共享计算机** or **每线程一台计算机**。如果选择 **No** (默认设置),则代理创建时将不具有计算机访问权限。

Set the base snapshot (optional)

展开 **高级设置** 来选择 **快照** 用于新计算机。

Create the agent

点击 **创建代理**.

访问配置文件

使用访问配置文件可以让代理调用已认证的外部 API,而无需将凭据放在提示中或向语言模型暴露。发往匹配主机的出站 HTTP 请求会通过代理路由,该代理在转发前会注入配置的标头。

一个配置文件包含一个或多个 **自定义规则**。每条规则指定:

  • 匹配主机:规则适用的目标主机名。使用 * 作为通配符(例如, *.example.com 匹配 api.example.com).
  • 来源类型和提供者:凭据来源。选择 **连接** 用于用户委托 OAuth,或 **工作区密钥** 用于静态 API 密钥。
  • 注入请求头:代理向匹配请求添加的 HTTP 请求头。可使用模板值,例如 {access_token} 来引用凭据(例如, Authorization: Bearer {access_token}).

配置文件还具有 **网络范围** ,用于控制代理计算机的出站流量。默认值为 **无(允许所有流量)**.

添加访问配置文件

Create the access profile

前往 Fleet 集成选项卡 ,然后导航到 **计算机** 部分。点击 **+ 创建配置文件** ,然后按照提示配置主机模式和凭据。

Attach the profile to an agent

在代理编辑器中,点击 **计算机** 节点。点击 **+ 添加** 旁边的 **访问配置文件** ,然后选择你创建的配置文件。

Save changes

点击 **保存更改**.

计算机生命周期

每个代理都有两个生命周期设置,用于控制计算机保持活跃的时长以及停止后保留的时长。 在设置弹出窗口中配置这两项.

  • 空闲超时:当计算机在此时间段内未收到任何命令时,它会暂停,磁盘会被存档。代理稍后可以恢复同一台计算机而不会丢失数据。默认值: **15 分钟**.
  • 已停止计算机清理:当计算机停止运行超过此时间段后,它会连同所有磁盘数据一起被永久删除。默认值: **14 天**.

基础快照

快照是用于启动计算机的磁盘镜像。默认情况下,所有 Fleet 代理都使用工作区默认快照。若要构建、捕获或配置自定义快照,请参阅 沙盒快照. 更改代理的快照 ,位于设置弹出窗口中。

配置生命周期和快照

代理的快照、空闲超时和已停止计算机清理都在以下位置设置 **计算机生命周期** 设置弹出窗口的部分中。

Open the settings popover

In Fleet,打开代理,然后点击 代理编辑器中的设置图标。

Set the lifecycle fields

滚动到 **计算机生命周期** 部分。设置 **快照**, **空闲超时**,对于 **每个线程的计算机** 模式, **已停止计算机清理**.

Save changes

点击 **保存更改**.