主题
计算机使用
从附加到你的 Fleet agent 的持久虚拟计算机运行代码、管理文件并调用经过身份验证的 API。
计算机使用让你的 Fleet agent 可以访问一台隔离的虚拟计算机。agent 可以编写和执行代码、管理文件、安装包，并调用经过身份验证的外部 API，而无需将凭据暴露给语言模型。
NOTE
计算机使用在 Plus 和 Enterprise 计划中可用。
计算机模式
选择虚拟计算机如何在 agent 的对话线程之间共享：
| 模式 | 描述 |
|---|---|
| 共享计算机 | 所有线程共享一台计算机。文件系统、已安装的包和正在运行的进程在线程之间持久保留。当你希望文件、依赖项或环境设置在对话之间累积时，请选择此模式。共享计算机不会自动删除。 |
| 每线程计算机 | 每个线程都有自己独立的计算机，它会全新启动，并在空闲时归档。请为软件工程 agent 和其他运行大量并行、写入密集型任务的工作负载选择此模式，或用于线程不应看到彼此状态的任何情况。 |
配置计算机使用
WARNING
计算机模式在创建 agent 时设置，之后无法更改。要切换模式，请创建新的 agent。
Open the Create agent dialog
在 Fleet 左侧导航中，在 My Agents 下，点击
并选择 Create with AI 或 Blank agent。为你的 agent 输入名称。
Enable computer use
在 Should your agent use a computer? 下，选择 Yes，然后选择 Shared computer 或 Computer per thread。如果你选择 No（默认值），则创建的 agent 没有计算机访问权限。
Set the base snapshot (optional)
展开 Advanced 以选择新计算机的 Snapshot。
Create the agent
点击 Create Agent。
访问配置文件
使用访问配置文件让你的 agent 调用经过身份验证的外部 API，而无需将凭据放入提示或将其暴露给语言模型。发往匹配主机的出站 HTTP 请求会通过一个代理路由，该代理会在转发前注入配置的标头。
一个配置文件包含一个或多个 Custom rules。每个规则指定：
- Match Hosts：规则适用的目标主机名。使用
*作为通配符（例如，*.example.com匹配api.example.com）。 - Source Type and Provider：凭据来源。选择 Connection 用于用户委托的 OAuth，或选择 Workspace Secret 用于静态 API 密钥。
- Inject Headers：代理添加到匹配请求中的 HTTP 标头。使用
{access_token}等模板值来引用凭据（例如，Authorization: Bearer {access_token}）。
配置文件还具有一个 Network scope，用于控制 agent 计算机的出站流量。默认值为 None (all traffic allowed)。
添加访问配置文件
Create the access profile
前往 Fleet Integrations 选项卡，导航到 Computer 部分。点击 + Create profile 并按照提示配置主机模式和凭据。
Attach the profile to an agent
在 agent 编辑器中，点击 Computer 节点。点击 Access profiles 旁的 + Add，然后选择你创建的配置文件。
Save changes
点击 Save changes。
计算机生命周期
每个 agent 有两个生命周期设置，用于控制计算机保持活动的时间以及停止后保留的时间。在设置弹出框中配置这两项。
- Idle timeout：当计算机在此时间段内未收到任何命令时，它会暂停并归档磁盘。agent 稍后可以恢复同一台计算机而不丢失数据。默认值：15 分钟。
- Stopped computer cleanup：计算机停止此时间段后，将连同所有磁盘数据一起永久删除。默认值：14 天。
NOTE
Stopped computer cleanup 仅适用于 Computer per thread 模式。共享计算机不会自动删除。
基础快照
快照是用于启动计算机的磁盘映像。默认情况下，所有 Fleet agent 都使用工作区默认快照。要构建、捕获或配置自定义快照，请参阅沙箱快照。在设置弹出框中更改 agent 的快照。
NOTE
快照更改仅适用于 agent 的新计算机。Shared computer 模式下的单台共享计算机会在其生命周期内保留其原始快照。
配置生命周期和快照
agent 的快照、空闲超时和已停止计算机清理均在设置弹出框的 Computer lifecycle 部分中设置。
Open the settings popover
在 Fleet 中，打开 agent 并点击
agent 编辑器中的设置图标。
Set the lifecycle fields
滚动到 Computer lifecycle 部分。设置 Snapshot、Idle timeout，以及针对 Computer per thread 模式的 Stopped computer cleanup。
Save changes
点击 Save changes。