Delegar issues ao agente de código
Sessões de código permitem que um administrador delegue uma issue Forge a um agente de IA: o agente clona o repositório GitHub vinculado, implementa a correção com base na descrição da issue e abre um pull request em rascunho para revisão.
Antes de começar
- O GitHub deve estar conectado e pelo menos um repositório deve estar sincronizado em
Repositórios. - Somente administradores do Forge (
Administrador) enxergam e iniciam sessões de código.
Delegue uma issue
- 1
Abra a issue no Forge.
A seção
Sessões de códigoaparece na barra lateral direita da issue, visível apenas para administradores. - 2
Clique em `Nova sessão`.
O diálogo
Nova sessão de códigoabre. Selecione oRepositórioe aBranch de origem— o agente criará a branch da issue a partir dessa referência e abrirá o pull request contra ela. - 3
Adicione `Instruções` (opcional).
Use este campo para orientar o agente: estratégia de implementação, restrições, arquivos a evitar, etc.
- 4
Clique em `Iniciar sessão`.
O agente entra na fila (
Na fila), começa a execução (Em execução) e abre o pull request em rascunho ao concluir.resultadoA seção Sessões de código exibe o status da sessão em tempo real: Na fila → Em execução → PR aberto. - 5
Clique em `Ver pull request` quando aparecer.
O link leva diretamente ao PR em rascunho no GitHub. Revise, ajuste e aprove normalmente pelo fluxo do GitHub.
Acompanhe e reinicie sessões
A seção Sessões de código mostra a sessão mais recente. Clique nela para abrir o histórico completo de sessões e acompanhar o log de Atividade de cada uma. Se uma sessão falhar (Falhou), clique em Tentar novamente para iniciar uma nova com os mesmos parâmetros.
Apenas uma sessão ativa por vez
O botão Nova sessão fica desativado enquanto houver uma sessão em execução para a mesma issue. Aguarde a conclusão ou a falha antes de iniciar outra.
Configure o modelo do agente
Por padrão o agente usa Claude Opus 4.8 (maior qualidade). Para trocar por Claude Sonnet 4.6 (menor custo), acesse Forge → GitHub e localize o card Modelo do agente de código. Administradores e gerentes do time podem alterar esta configuração — salvar exige autenticação de dois fatores (MFA).