クイックスタート

前提条件

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 で認証する際に利用するアウトポストトークンが発行されます。トークンをコピーし、今後利用できるよう安全な場所に保存してください。トークンが表示されるのは、アウトポストの作成時の 1 回だけです。

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

公式の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 機能を使用するには、image 内に Chrome または Chromium が必要で、 DEVIN_CHROME_PATH がその実行ファイルを指している必要があります。ベース image は Ubuntu ですが、 Ubuntu の chromium apt パッケージはコンテナ内では動作しない snap スタブのため、 amd64 image では代わりに 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

非公開リポジトリでは、クローンやリモート操作が実行時に機能するよう、任意の方法 (例: ビルドシークレット) で認証情報を組み込んでください。Dockerfile の内容に問題がなければ、image を build します:

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 で新しいセッションを開始し、お使いのアウトポストで実行するよう設定します。“Configuration” → “Virtual environment” に、新しいアウトポストが表示されます。これを選択すると、そのアウトポスト上でセッションを実行できます。

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

Create a "hello world" python script for me

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

次のステップ

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

オーケストレーション

セッションがキューに入ると自動的にコンテナをプロビジョニングできるため、長時間稼働するワーカーを維持しておく必要がありません。

統合

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

概要

基本ガイドライン

Devin の導入

Devin の使い方

製品ガイド

統合

管理

リリースノート

クイックスタート

次のステップ

オーケストレーション

統合

次のステップ

オーケストレーション

統合

​次のステップ

オーケストレーション

統合

​次のステップ

オーケストレーション

統合

次のステップ

次のステップ