Despache seu primeiro agente

O que você vai construir

Ao final deste tutorial, você terá:

• Um agente que você mesmo criou e configurou
• Um espaço onde você e esse agente conversam
• Uma execução concluída, com trabalho commitado em um worktree isolado e uma linha no log de execução do agente

Pré-requisitos: Seu primeiro espaço de trabalho concluído, para que este espaço de trabalho tenha um repo registrado e pelo menos um provedor de modelos conectado.

Etapa 1: Criar um agente

1. Acesse Configurações → Espaço de trabalho → Agentes
2. Clique em Novo agente. Um agente chamado “Agente sem nome” é criado imediatamente e selecionado na lista de agentes — não há diálogo de criação nem nada a confirmar. Você o configura ali mesmo.
3. Na aba Configurações, preencha:
   • Nome: algo curto e memorável, como alice. É o que você digita depois de @.
   • Título: o que ele faz, por exemplo “Engenheiro de backend”
   • Adaptador: Control Center (built-in). Escolha este de propósito — só o harness integrado pode ser direcionado no meio da execução e pausado em uma fronteira de turno, e ele não precisa de nenhuma CLI instalada no host do servidor.
   • Modelo: escolha na lista que o provedor conectado serve
   • Skills: anexe as que fizerem sentido, por exemplo testing ou architecture
4. Pressione Guardar alterações

Um agente sem adaptador roda no loop integrado

Quando o campo Adaptador não está definido, o despacho recorre ao Control Center (built-in) — o loop de agente dentro do servidor, então não há nada a instalar no host. Ele ainda precisa de um modelo: sem nenhum definido, ele pede à Anthropic o modelo padrão dela, o que funciona se você tiver conectado uma conta da Anthropic e, caso contrário, falha com No credential for provider "anthropic". Mesmo assim, defina os dois explicitamente, ou você estará executando em um modelo que não escolheu.

Ponto de verificação. A linha da lista de agentes mostra o nome do seu agente e um anel de status vazado.

Etapa 2: Iniciar um espaço

1. Na barra lateral, encontre a seção Espaços e clique no botão +
2. Dê um nome ao espaço
3. Em Adicionar agentes, selecione o agente que você acabou de criar
4. Se o espaço de trabalho tiver repos, escolha em quais este espaço deve trabalhar
5. Clique em Criar

O espaço abre. Em segundo plano, o Control Center provisiona um worktree copy-on-write dos repos selecionados para esta conversa, em um branch próprio. Seu checkout de origem nunca é alterado.

Etapa 3: Enviar uma tarefa

Digite uma tarefa pequena e concreta para o repo que você registrou. Algo com um resultado verificável funciona melhor — adicione um teste, corrija um lint, renomeie um símbolo.

Pressione Enter. Você não precisa mencionar ninguém com @: com um único agente no espaço, uma mensagem simples o desperta. Em um espaço com vários agentes, @name escolhe um.

O Control Center monta o prompt a partir das instruções, da persona e das skills do agente e do contexto do espaço, e então despacha a execução.

Ponto de verificação. O botão de enviar do composer vira um botão de parar — um agente está trabalhando nesta conversa — e o texto começa a chegar.

Etapa 4: Ver o agente trabalhar

A conversa renderiza a execução conforme ela acontece:

• Raciocínio, exibido em linha enquanto o agente pensa
• Chamadas de ferramentas: leituras e gravações de arquivos, buscas, comandos de shell, cada uma com o seu resultado
• Texto: resumos, explicações e perguntas para você

Se o agente perguntar algo, responda na conversa e ele retoma.

Para ver as métricas de uma execução e os controles de pausar, retomar e parar, encontre o agente em execução na seção Agentes do painel Geral do espaço e escolha Abrir atividade.

No painel de atividades, o selo de status mostra Em execução e depois Concluído quando a execução termina. Uma execução que trava ou entra em loop mostra Bloqueado; uma que dá erro mostra Falhou. No registro de agentes, o anel da lista fica vazado antes da primeira execução e sólido quando o agente volta a ficar inativo.

O que limita a execução: a worktree copy-on-write dela mesma, as credenciais intermediadas para ela no lançamento e revogadas no encerramento, um ambiente higienizado, a superfície de ferramentas que o modo dela permite e as barreiras de ação. Efeitos como fazer push de um branch ou abrir uma pull request são controlados separadamente — consulte Barreiras.

Etapa 5: Conferir o resultado

1. Abra Configurações → Espaço de trabalho → Agentes e selecione o seu agente
2. Abra a aba Registros

Ponto de verificação. Uma linha de execução, mostrando o status, a duração, os horários de início e de término e o adaptador usado.

As alterações do agente são commitadas no branch da conversa, na worktree dela. Os commits têm o agente como autor, com você creditado em um trailer Co-Authored-By:.

Obter uma pull request

Nada abre uma pull request sozinho. Se você quiser uma, peça na mesma conversa:

Faça push deste branch e abra uma pull request contra o branch padrão.

Fazer push (gitPush) e criar uma PR (prCreate) pedem a sua aprovação por padrão, então espere uma confirmação antes de cada um. Se nenhum aprovador estiver conectado quando o prompt dispara, a ação é negada em vez de permitida — as barreiras falham fechadas.

A PR é aberta sob a identidade do GitHub cujo token a execução usou — a sua, se você armazenou um token pessoal — e não sob o nome do agente. A autoria do agente aparece nos commits.

Você também pode abri-la por conta própria: o painel Controlo de origem do espaço tem um botão Criar pull request que leva o branch da conversa para a tela de composição, e Pull requests → Nova PR abre a mesma tela vazia. É aí que o próximo tutorial começa.

Recapitulação

Você criou um agente, configurou o adaptador e o modelo dele, deu a ele um espaço e uma tarefa e viu uma execução real terminar em uma worktree isolada sem tocar no seu checkout.

A seguir: Revise sua primeira pull request para aprender o fluxo de revisão.

Para saber mais sobre agentes: O modelo de agentes. Para detalhes do despacho: Ciclo de vida do despacho de agentes.