Como mandar um chamado para a IA com o botão Com IA

Com o botão Com IA, você manda um chamado para o Claude de alguém da equipe. A IA lê o pedido, trabalha no código na máquina do dono do agente, roda os testes, registra as evidências e avisa quando está pronto no local. Para isso, o executor precisa estar ligado nessa máquina.

Ligar o executor

O executor é o programa do plugin Benflow que fica esperando os trabalhos do painel. Ele dá sinal a cada 30 segundos e roda o Claude Code na pasta do repositório.

1. 1
   Passo 1: Ao ligar o seu Claude, a tela Seu Claude está quase ligado mostra a seção 2. Deixe o executor rodando para o botão Com IA, com os comandos prontos para a sua organização. Faça estes passos com essa tela aberta, porque o comando de configurar pede o token do agente.
2. 2
   Passo 2: No Claude Code, com o plugin Benflow instalado, rode /benflow:status para ver onde fica o arquivo benflow.mjs na sua máquina.
3. 3
   Passo 3: No terminal, rode o comando de configurar, trocando os caminhos pelas pastas dos seus repositórios na sua máquina. Quando ele pedir, cole o token: ele não aparece na tela.
4. 4
   Passo 4: Rode o comando de executar e deixe o terminal aberto: o executor só recebe trabalho enquanto estiver rodando.

node "<caminho do benflow.mjs>" configurar --url <URL do painel> --org-slug <sua organização> --repo dono/app=/pasta/do/app
node "<caminho do benflow.mjs>" executar --org <sua organização>
node "<caminho do benflow.mjs>" status

O comando status confere a configuração, os repositórios, o cofre pessoal e se o token ainda vale no Benflow. No Windows, use o PowerShell e ponha o caminho do benflow.mjs entre aspas; pastas com espaço no nome funcionam.

Mandar o chamado para a IA

1. 1
   Passo 1: Abra o chamado no quadro e vá até a seção Trabalho.
2. 2
   Passo 2: Clique em Iniciar trabalho (ou Iniciar novo trabalho, se o chamado já teve outro) e escolha Com IA.
3. 3
   Passo 3: Na janela Iniciar com IA, confira o Pedido original. Os anexos vão junto e a IA baixa o que precisar.
4. 4
   Passo 4: Em Complementar o prompt, conte o que você sabe: onde mexer, como testar, o que não mudar. É opcional, com até 4.000 caracteres.
5. 5
   Passo 5: Escolha o Agente, o Modelo e o Effort, e marque os Repositórios envolvidos (até 10). A lista mostra os repositórios cadastrados em Ambientes e avisa quando um deles não está na máquina do agente.
6. 6
   Passo 6: Clique em Começar. A Janela da IA abre para você acompanhar.

O filtro por data fica em src/pages/Relatorios. Rode os testes do backend antes de concluir e não mude o layout da tabela.

Se o agente estiver sem sinal, o trabalho fica na fila e começa quando o executor voltar. Se ele estiver ocupado com outro chamado, este espera aquele terminar. Cada chamado tem um trabalho em andamento por vez, e chamado concluído ou fechado precisa ser reaberto antes.

O que a IA faz

• Cria a branch do chamado a partir da develop, como chamado/acme-12, e faz commits com a etiqueta, como [acme-12] Corrige filtro por data.
• Atualiza a etapa e o percentual: Planejamento, Desenvolvimento, Testes e Evidências.
• Roda os testes e registra as evidências: quantos passaram e falharam, capturas de tela, logs e links.
• Termina com o resumo do que mudou e de como testar. O trabalho fica em Aguardando subir para homologação e nada vai para o GitHub nessa hora.

Tudo aparece na seção Trabalho do chamado: Resumo, Evidências, Onde ver (inclusive o endereço local do app, que só abre na máquina do dono do agente), Sessão do Claude, Detalhes e a Linha do tempo.

Deu erro? Para o dono do agente e para o admin, aparece o botão Mandar a IA corrigir, que abre a Janela da IA para mandar uma instrução. Com o trabalho pronto, o próximo passo é publicar em homologação.

Trabalho manual

Prefere fazer você mesmo? Em Iniciar trabalho, escolha Manual, sem IA. O painel mostra a etiqueta do chamado para usar nas mensagens de commit, e você atualiza a etapa, o percentual e o resumo em Salvar andamento.