Início rápido

Pré-requisitos

Uma organização com Outposts habilitado
Um token da API v3 com os escopos apropriados do Outposts:
- account.outposts.orchestrator para orquestradores que gerenciam outposts (implica o escopo de máquina)
- account.outposts.machine para workers que leem a fila e reivindicam e liberam sessões
Uma máquina (VM ou contêiner) com:
- O Devin CLI instalado
- As dependências da máquina
- Seus repositórios clonados, com remotos configurados
- Acesso às ferramentas de build, aos registros de pacotes, aos segredos e aos serviços internos de que suas sessões precisam

Sua máquina
Docker

As sessões são executadas diretamente na máquina com as permissões do seu usuário. Recomendamos executar o worker em um diretório dedicado onde você se sinta à vontade para deixar um agente trabalhar livremente — ou, melhor ainda, em uma máquina reservada para trabalho autônomo de longa duração, como um Mac Mini na sua mesa.

Instale o Devin CLI

Baixe e instale o Devin CLI:

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

Crie um outpost

No Devin Cloud, vá para Configurações → Ambiente → Outposts e clique no botão “Create Outpost”.

Dê um nome ao seu Outpost e escolha o tipo de máquinas que ele atenderá (por exemplo, Linux, Windows ou Mac). Em seguida, clique no botão “Create”.

Depois de criar seu Outpost, você receberá um token do Outpost que os workers atribuídos a ele usarão para se autenticar com o Devin.Copie o token e salve-o em um local seguro para uso futuro. O token será exibido apenas uma vez quando você criar o Outpost.

Execute o worker do seu Outpost

Navegue até um diretório em que você quer executar o worker:

cd /path/to/worker/directory

Em seguida, execute o comando devin worker start com o nome do seu Outpost e o token copiado anteriormente:

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

Inicie uma nova sessão do Outpost

No Devin Cloud, inicie uma nova sessão e configure-a para ser executada no seu Outpost. Em “Configuration” → “Virtual environment”, você verá seu novo Outpost na lista. Selecione-o para executar sua sessão nele.

Agora você pode pedir ao Devin para começar a programar na sua máquina! Tente algo simples, como

Create a "hello world" python script for me

E veja o script aparecer no diretório do seu worker!

Próximas etapas

Inicie o worker em um diretório onde está o seu código e peça ao Devin para desenvolver a partir dele. As sessões têm acesso aos repositórios clonados no diretório de trabalho do worker. Para atender mais sessões simultaneamente, execute o worker em mais máquinas apontadas para o mesmo outpost: N workers atendem N sessões simultâneas, e o restante aguarda na fila.

Orquestração

Provisione máquinas automaticamente à medida que as sessões entram na fila, em vez de manter workers de longa duração em execução.

Integrações

Execute seu outpost na plataforma que você já usa — Namespace, Modal, E2B e muito mais.

Criar um outpost

No Devin Cloud, vá para Configurações → Ambiente → Outposts e clique no botão “Create Outpost”.

Dê um nome ao seu Outpost e escolha Linux como plataforma (seus contêineres executam Linux). Em seguida, clique no botão “Create”.

Depois de criar seu Outpost, você receberá um token do Outpost, que os workers que quiser atribuir a ele usarão para se autenticar no Devin.Copie o token e salve-o em um local seguro para uso futuro. O token só será exibido uma vez, quando você criar o Outpost.

Fazer build de uma imagem de worker

Use como base a imagem oficial do Devin CLI (public.ecr.aws/e0h8a4b6/devin-cli), adicionando as dependências da máquina e quaisquer repositórios ou ferramentas de que suas sessões precisem:

Dockerfile

# O Devin CLI está pré-instalado e é o entrypoint da imagem.
# Use :stable ou fixe uma tag de versão específica do CLI.
FROM public.ecr.aws/e0h8a4b6/devin-cli:stable

# git é obrigatório; ffmpeg habilita os recursos de gravação de tela
RUN apt-get update && apt-get install -y --no-install-recommends \
    ca-certificates git ffmpeg \
    && rm -rf /var/lib/apt/lists/*

# O diretório em que o worker é executado
WORKDIR /repos

# Opcionalmente, faça checkout dos repositórios que suas sessões precisam:
# RUN git clone https://github.com/your-org/app.git \
#     && git clone https://github.com/your-org/infra.git

CMD ["worker", "start"]

Ou peça ao Devin para criar um Dockerfile para você:

Escreva um Dockerfile para uma imagem de worker do Devin Outposts. Baseie-a em
public.ecr.aws/e0h8a4b6/devin-cli:stable, que tem o Devin CLI pré-instalado
como entrypoint da imagem. Instale git e ffmpeg. Clone estes repositórios
no diretório de trabalho em que o worker é executado: <your repos>. O comando
padrão deve ser ["worker", "start"].

Os recursos do Browser precisam do Chrome ou Chromium na imagem, com DEVIN_CHROME_PATH apontando para o binário. A imagem base é Ubuntu, e o pacote apt chromium do Ubuntu é um stub do snap que não funciona em contêineres — para imagens amd64, instale o 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

Para repositórios privados, inclua credenciais usando o mecanismo de sua preferência (por exemplo, segredos de build) para que as operações de clone e os remotos funcionem em tempo de execução.Quando estiver satisfeito com seu Dockerfile, faça o build da imagem:

docker build -t devin-worker .

Inicie seu worker do Outpost

Inicie um contêiner a partir da sua imagem com o comando worker start, passando o nome do seu Outpost e o token que você copiou anteriormente (o entrypoint da imagem é o Devin CLI, então os argumentos vão direto para devin):

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

Iniciar uma nova sessão do Outpost

No Devin Cloud, inicie uma nova sessão e configure-a para rodar no seu Outpost. Em “Configuração” → “Ambiente virtual”, você verá seu novo Outpost na lista. Selecione-o para executar sua sessão nele.

Agora você pode pedir ao Devin para começar a desenvolver no seu contêiner! Tente algo simples como

Create a "hello world" python script for me

E veja o script aparecer no diretório de trabalho do contêiner!

Próximas etapas

Incorpore os repositórios nos quais você deseja que o Devin trabalhe na image e peça ao Devin para fazer build sobre eles — as sessões enxergam os repositórios com checkout feito no diretório de trabalho do worker. Para atender mais sessões simultaneamente, execute mais contêineres apontados para o mesmo outpost: N workers atendem N sessões simultâneas, e o restante aguarda na fila.

Orquestração

Provisione contêineres automaticamente conforme as sessões entram na fila, em vez de manter workers de longa duração em execução.

Integrações

Execute seu outpost na plataforma que você já usa — Namespace, Modal, E2B e muito mais.

Introdução

Diretrizes fundamentais

Integração do Devin

Trabalhando com o Devin

Guias do produto

Integrações

Admin

Notas de versão

Próximas etapas

Orquestração

Integrações

Próximas etapas

Orquestração

Integrações

​Próximas etapas

Orquestração

Integrações

​Próximas etapas

Orquestração

Integrações

Próximas etapas

Próximas etapas