快速入门

前提条件

已启用 Outposts 的组织
一个具有相应 Outposts 作用域的 v3 API 令牌：
- account.outposts.orchestrator：用于管理 outpost 的 orchestrator (隐含 machine 作用域)
- account.outposts.machine：用于读取队列并认领/释放会话的工作器
一台满足以下条件的机器 (VM 或容器) ：
- 已安装 Devin CLI
- 已具备机器依赖
- 已克隆你的代码仓库，并已配置远程仓库
- 能够访问你的会话所需的构建工具、包注册表、secrets 和内部服务

你的机器
Docker

会话会直接在拥有你账号权限的机器上执行。我们建议在一个你愿意让 Agent 自由操作的专用目录下运行工作器——更理想的是，在一台专门用于长时间运行 Agent 任务的机器上运行，比如你桌上的一台 Mac Mini。

安装 Devin CLI

下载并安装 Devin CLI：

curl -fsSL https://cli.devin.ai/install.sh | bash

创建 outpost

在 Devin Cloud 中，前往 Settings → Environment → Outposts，然后点击 “Create Outpost” 按钮。

为你的 Outpost 命名，并选择它要服务的机器类型 (例如 Linux、Windows 或 Mac) 。然后点击 “Create” 按钮。

创建 Outpost 后，你会获得一个 Outpost 令牌，分配给它的工作器将使用该令牌向 Devin 进行身份验证。复制该令牌并将其保存在安全的地方，以备后续使用。该令牌只会在创建 Outpost 时显示一次。

运行你的 Outpost 工作器

进入你希望工作器运行的目录：

cd /path/to/worker/directory

然后使用你之前复制的 Outpost 名称和令牌运行 devin worker start 命令：

devin worker start --outpost=<your-outpost-name> --token=<your-outpost-token>

启动新的 Outpost 会话

在 Devin Cloud 上，启动一个新会话并将其配置为在你的 Outpost 上运行。在 “Configuration” → “Virtual environment” 下，你会看到新创建的 Outpost 已列出。选择它即可让会话在该 Outpost 上运行。

现在你可以让 Devin 在你的机器上开始构建了！可以先试一个简单的例子：

Create a "hello world" python script for me

然后看着脚本出现在你的工作器目录中！

后续步骤

在你的代码所在目录中启动工作器，然后让 Devin 在现有代码基础上继续构建。会话可以看到工作器工作目录下已检出的代码仓库。要同时处理更多会话，请在更多机器上运行指向同一 outpost 的工作器：N 个工作器可处理 N 个并发会话，其余会在队列中等待。

编排

在会话排队时自动预配机器，而不是始终保留长期运行的工作器。

集成

在你已经使用的平台上运行 outpost——Namespace、Modal、E2B 等。

创建 outpost

在 Devin Cloud 中，前往 Settings → Environment → Outposts，然后点击“Create Outpost”按钮。

为你的 Outpost 命名，并选择 Linux 作为平台 (你的容器运行在 Linux 上) 。然后点击“Create”按钮。

创建 Outpost 后，你会获得一个 Outpost 令牌；要分配到该 Outpost 的工作器将使用此令牌向 Devin 完成身份验证。复制该令牌并将其保存在安全的位置，以供后续使用。该令牌只会在创建 Outpost 时显示一次。

构建工作器镜像

基于官方 Devin CLI 镜像 (public.ecr.aws/e0h8a4b6/devin-cli) 进行构建，并添加机器依赖项以及你的会话所需的任何代码仓库或工具：

Dockerfile

# Devin CLI 已预装，是该镜像的 entrypoint。
# 使用 :stable，或固定到特定的 CLI 版本标签。
FROM public.ecr.aws/e0h8a4b6/devin-cli:stable

# git 为必需项；ffmpeg 可启用屏幕录制功能
RUN apt-get update && apt-get install -y --no-install-recommends \
    ca-certificates git ffmpeg \
    && rm -rf /var/lib/apt/lists/*

# 工作器运行所在的目录
WORKDIR /repos

# 可选：克隆你的 session 所需的代码仓库：
# RUN git clone https://github.com/your-org/app.git \
#     && git clone https://github.com/your-org/infra.git

CMD ["worker", "start"]

或者让 Devin 为你生成一个 Dockerfile：

Write a Dockerfile for a Devin Outposts worker image. Base it on
public.ecr.aws/e0h8a4b6/devin-cli:stable, which has the Devin CLI preinstalled
as the image's entrypoint. Install git and ffmpeg. Clone these repositories
into the working directory the worker runs in: <your repos>. The default
command should be ["worker", "start"].

Browser 功能需要镜像中安装 Chrome 或 Chromium，并且 DEVIN_CHROME_PATH 要指向该二进制程序。基础镜像是 Ubuntu，而 Ubuntu 的 chromium apt 软件包只是一个无法在容器中使用的 snap 存根包——对于 amd64 镜像，请改为安装 Google Chrome：

RUN apt-get update && apt-get install -y --no-install-recommends curl \
    && curl -fsSL https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb -o /tmp/chrome.deb \
    && apt-get install -y --no-install-recommends /tmp/chrome.deb \
    && rm /tmp/chrome.deb && rm -rf /var/lib/apt/lists/*
ENV DEVIN_CHROME_PATH=/usr/bin/google-chrome

对于私有代码仓库，请通过你偏好的方式 (例如 build secrets) 将凭据嵌入镜像中，以便在运行时能够正常执行克隆并访问远程仓库。当你确认 Dockerfile 没问题后，构建该镜像：

docker build -t devin-worker .

运行 Outpost 工作器

使用 worker start 命令基于你的镜像启动一个容器，并传入你的 Outpost 名称以及你之前复制的令牌 (该镜像的 entrypoint 是 Devin CLI，因此参数会直接传给 devin) ：

docker run devin-worker \
  worker start --outpost=<your-outpost-name> --token=<your-outpost-token>

启动新的 Outpost 会话

在 Devin Cloud 上，启动一个新 session，并将其配置为在你的 Outpost 上运行。在 “Configuration” → “Virtual environment” 下，你会看到新建的 Outpost 已列出。选择它，即可让你的 session 在该 Outpost 上运行。

现在，你可以让 Devin 开始在你的 container 中进行构建了！可以先试试一些简单的内容，比如

Create a "hello world" python script for me

然后即可看到脚本出现在容器的工作目录中！

后续步骤

将你希望 Devin 使用的代码仓库预置到 image 中，并让 Devin 在此基础上进行构建——session 将看到已检出至工作器工作目录下的代码仓库。如需并发处理更多 session，可运行更多指向同一 outpost 的 container：N 个工作器可并发处理 N 个 session，其余 session 在队列中等待。

编排

在会话进入队列时自动预配容器，无需一直保留长期运行的工作器。

集成

在你已使用的平台上运行 outpost——Namespace、Modal、E2B 等。

开始使用

核心指南

部署并接入 Devin

与 Devin 协作

产品使用指南

集成

Admin

发布说明

后续步骤

编排

集成

后续步骤

编排

集成

​后续步骤

编排

集成

​后续步骤

编排

集成

后续步骤

后续步骤