クイックスタート

前提条件

Outposts が有効になっている組織
必要な Outposts スコープを持つ v3 API トークン:
- アウトポストを管理するオーケストレーター用の account.outposts.orchestrator (マシンスコープを含む)
- キューを読み取り、セッションを引き取る／解放するワーカー用の account.outposts.machine
以下を備えたマシン (VM またはコンテナ) :
- Devin CLI がインストールされている
- マシン依存関係
- リポジトリがクローンされ、リモートが設定されている
- セッションに必要なビルドツール、パッケージレジストリ、シークレット、内部サービスにアクセスできること

お使いのマシン
Docker

セッションは、ユーザーの権限でマシン上に直接実行されます。ワーカーは、エージェントに自由に作業させても差し支えない専用ディレクトリで実行することをおすすめします。できれば、デスク上の Mac Mini のように、長時間の自律的な作業専用のマシンで実行するのが理想です。

Devin CLI をインストール

Devin CLI をダウンロードしてインストールします。

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

アウトポストを作成

Devin Cloud で、Settings → Environment → Outposts に移動し、「Create Outpost」ボタンをクリックします。

アウトポストに名前を付け、提供するマシンの種類 (例: Linux、Windows、Mac) を選択します。次に、「Create」ボタンをクリックします。

アウトポストを作成すると、割り当てるワーカーが Devin に認証するためのアウトポストトークンが発行されます。トークンをコピーして、安全な場所に保存してください。トークンはアウトポスト作成時に一度だけ表示されます。

アウトポストワーカーを実行

ワーカーを実行したいディレクトリに移動します。

cd /path/to/worker/directory

次に、先ほどコピーしたアウトポスト名とトークンを指定して devin worker start コマンドを実行します。

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

新しいアウトポストセッションを開始

Devin Cloud で新しいセッションを開始し、アウトポスト上で実行するよう設定します。「Configuration」→「Virtual environment」に、新しいアウトポストが表示されます。これを選択すると、そのアウトポスト上でセッションを実行できます。

これで、あなたのマシンでビルドを始めるよう Devin に依頼できます。まずは次のような簡単なものを試してみてください。

Create a "hello world" python script for me

ワーカーのディレクトリにスクリプトが現れるはずです。

次のステップ

コードがあるディレクトリでワーカーを起動し、その上でビルドするよう Devin に依頼してください。セッションからは、ワーカーの作業ディレクトリ配下にチェックアウトされたリポジトリを参照できます。より多くのセッションを同時に処理するには、同じアウトポストを指定したワーカーをより多くのマシンで実行してください。N 台のワーカーで N 件のセッションを同時に処理し、それ以外はキューで待機します。

オーケストレーション

常駐ワーカーを維持する代わりに、セッションがキューに入るたびにマシンを自動的にプロビジョニングします。

統合

すでに利用しているプラットフォーム上でアウトポストを実行できます — Namespace、Modal、E2B などに対応しています。

アウトポストを作成

Devin Cloud で Settings → Environment → Outposts を開き、“Create Outpost” ボタンをクリックします。

アウトポストに名前を付け、プラットフォームとして Linux を選択します (コンテナは Linux 上で実行されるためです) 。その後、“Create” ボタンをクリックします。

アウトポストを作成すると、そのアウトポストに割り当てるワーカーが Devin への認証に利用するアウトポストトークンが発行されます。トークンをコピーし、今後の利用に備えて安全な場所に保存してください。トークンはアウトポストの作成時に一度だけ表示されます。

ワーカーイメージをビルドする

公式の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

# 必要に応じて、セッションで使用するリポジトリをチェックアウトしてください:
# 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 .

アウトポストワーカーを起動する

先ほどコピーしたトークンとご使用のアウトポスト名を指定して、worker start コマンドでイメージからコンテナを起動します (イメージのentrypointはDevin CLIなので、引数はそのままdevinに渡されます) :

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

新しいアウトポストセッションを開始

Devin Cloud で新しいセッションを開始し、Outpost 上で実行するように設定します。“Configuration” → “Virtual environment” に、新しいアウトポストが表示されます。これを選択すると、そのアウトポスト上でセッションが実行されます。

これで、Devin にコンテナ内でビルドを開始するよう依頼できます。まずは次のような簡単なものを試してみてください

「hello world」のPythonスクリプトを作成してください

すると、コンテナの作業ディレクトリにスクリプトが現れます！

次のステップ

Devin に作業させたいリポジトリをイメージに組み込み、その上でビルドするよう Devin に指示してください。セッションでは、ワーカーの作業ディレクトリ配下にチェックアウトされたリポジトリを参照できます。より多くのセッションを同時に処理するには、同じアウトポストを指定したコンテナを複数起動してください。N 個のワーカーが N 個のセッションを同時に処理し、残りはキューで待機します。

オーケストレーション

常時稼働のワーカーを維持することなく、セッションがキューに入ると自動的にコンテナをプロビジョニングします。

統合

既に利用しているプラットフォーム上でアウトポストを実行できます — Namespace、Modal、E2B など。

概要

基本ガイドライン

Devin の導入

Devin の使い方

製品ガイド

統合

管理

リリースノート

クイックスタート

次のステップ

オーケストレーション

統合

次のステップ

オーケストレーション

統合

​次のステップ

オーケストレーション

統合

​次のステップ

オーケストレーション

統合

次のステップ

次のステップ