Despache o seu primeiro agente

O que vai construir

No final deste tutorial, terá:

• Um agente que criou e configurou você mesmo
• Um espaço onde você e esse agente conversam
• Uma execução concluída, com trabalho commitado numa worktree isolada e uma linha no registo de execuções do agente

Pré-requisitos: O seu primeiro espaço de trabalho concluído, para que este espaço de trabalho tenha um repo registado e pelo menos um fornecedor de modelos ligado.

Passo 1: criar um agente

1. Vá a Definições → Espaço de trabalho → Agentes
2. Clique em Novo agente. É criado imediatamente um agente chamado “Agente sem nome”, que fica selecionado na lista — não existe nenhuma caixa de diálogo de criação nem nada para confirmar. Configure-o aí mesmo.
3. No separador Definições, preencha:
   • Nome: algo curto e memorável, como alice. É isto que escreve depois de @.
   • Título: o que faz, por exemplo “Programador de backend”
   • Adaptador: Control Center (built-in). Escolha este de propósito — só o harness integrado pode ser conduzido a meio da execução e colocado em pausa num limite de turno, e não precisa de nenhuma CLI instalada no anfitrião do servidor.
   • Modelo: escolha um da lista que o fornecedor ligado disponibiliza
   • Habilidades: associe as que se adequarem, por exemplo testing ou architecture
4. Prima Guardar alterações

Um agente sem adaptador é executado no ciclo integrado

Quando o campo Adaptador está por definir, o despacho recorre ao Control Center (built-in) — o ciclo de agente dentro do servidor, pelo que não há nada para instalar no anfitrião. Ainda assim, precisa de um modelo: sem nenhum definido, pede à Anthropic o modelo predefinido, o que funciona se tiver ligado uma conta da Anthropic e, caso contrário, falha com No credential for provider "anthropic". De qualquer forma, defina ambos explicitamente, senão acabará a executar num modelo que não escolheu.

Ponto de verificação. A linha do agente na lista mostra o respetivo nome e um anel de estado vazio.

Passo 2: iniciar um espaço

1. Na barra lateral, encontre a secção Espaços e clique no botão +
2. Dê um nome ao espaço
3. Em Adicionar agentes, selecione o agente que 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-se. Em segundo plano, o Control Center aprovisiona uma worktree copy-on-write dos repos selecionados para esta conversa, no seu próprio branch. O seu checkout de origem nunca é alterado.

Passo 3: enviar uma tarefa

Escreva uma tarefa concreta e pequena sobre o repo que registou. Algo com um resultado verificável funciona melhor — adicione um teste, corrija um lint, mude o nome de um símbolo.

Prima Enter. Não precisa de mencionar ninguém com @: com um único agente no espaço, uma mensagem simples chega para o acordar. Num espaço com vários agentes, @name escolhe um.

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

Ponto de verificação. O botão de enviar do compositor transforma-se num botão de parar — há um agente a trabalhar nesta conversa — e o texto começa a chegar.

Passo 4: vê-lo a trabalhar

A conversa apresenta a execução à medida que acontece:

• Raciocínio, mostrado em linha à medida que o agente pensa
• Chamadas de ferramentas: leituras e escritas de ficheiros, pesquisas, comandos de shell, cada uma com o respetivo resultado
• Texto: resumos, explicações e perguntas para si

Se o agente fizer alguma pergunta, responda na conversa e a execução retoma.

Para ver as métricas de uma execução e os respetivos controlos de pausa, retoma e paragem, encontre o agente em execução na secção Agentes do painel Geral do espaço e escolha Abrir atividade.

No painel de atividade, o distintivo de estado apresenta Em execução e, quando a execução termina, Concluído. Uma execução que fica presa ou entra em ciclo apresenta Bloqueado; uma que dá erro apresenta Falhou. No registo de agentes, o anel de estado na lista fica vazio antes da primeira execução e preenchido quando o agente volta a ficar inativo.

O que limita a execução: a sua própria worktree copy-on-write, as credenciais negociadas em cada lançamento e revogadas no desmantelamento, um ambiente saneado, a superfície de ferramentas que o seu modo permite e as barreiras de ação. Efeitos como fazer push de um branch ou abrir uma pull request são verificados em separado — consulte Barreiras.

Passo 5: verificar o resultado

1. Abra Definições → Espaço de trabalho → Agentes e selecione o seu agente
2. Abra o separador Registos

Ponto de verificação. Uma linha de execução, com o estado, a duração, as horas de início e de fim e o adaptador em que foi executada.

As alterações do agente são commitadas no branch da conversa, na respetiva worktree. Os commits têm o agente como autor, com o crédito atribuído a si num trailer Co-Authored-By:.

Obter uma pull request

Nada abre uma pull request automaticamente. Se quiser uma, peça-a na mesma conversa:

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

Fazer push (gitPush) e criar PRs (prCreate) pedem, por predefinição, a sua aprovação, por isso conte com uma confirmação antes de cada uma. Se não estiver ligado nenhum aprovador quando o pedido é acionado, a ação é negada em vez de permitida — as barreiras falham em modo fechado.

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

Também a pode abrir por sua conta: o painel Controlo de origem do espaço tem um botão Criar pull request que leva o branch da conversa para o ecrã de composição, e Pull requests → Nova PR abre o mesmo ecrã vazio. É aqui que o próximo tutorial começa.

Resumo

Criou um agente, configurou o respetivo adaptador e modelo, deu-lhe um espaço e uma tarefa e viu uma execução real terminar numa worktree isolada sem tocar no seu checkout.

A seguir: Reveja a 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.