# Chat com o agente e modos de execução

Saiba como o agente responde a cada pedido, quando usar o modo Agent ou Chat, como anexar referências e apontar elementos da tela e como ler o custo de cada resposta.

Fonte: https://guides.adapta.org/guias/skip/recursos-do-skip/chat-do-agente/

**TL;DR** · O chat do builder é a conversa do projeto: cada mensagem sua vira um pedido, e a resposta do agente traz o entendimento, o plano, o rastro do que foi feito e o resumo final, com o custo em créditos no rodapé. O seletor **Modo de execução** alterna entre **Agent**, que planeja e constrói, e **Chat**, para conversar sem alterar o projeto. Anexos e o botão de selecionar elemento deixam o pedido mais preciso do que só texto.

![Gravação do builder do Skip: o botão Selecionar elemento como anexo é acionado, o botão Entrar da tela de login fica contornado no preview, o painel Propriedades abre à direita e o campo Peça ao Skip recebe o pedido de correção com o sintoma, o resultado esperado e a restrição.](https://guides.adapta.org/media/screenshots/skip/chat-2026-09-22/skip-chat-2026-09-22.gif)

*Aponte, descreva, restrinja: o elemento selecionado no preview vira o alvo do pedido e o campo Peça ao Skip recebe o texto; enviar é o passo seguinte, que não aparece aqui.*

## Como o agente responde

Quando você envia um pedido, a sua mensagem aparece com o horário e o link **restaurar checkpoint**, que marca o estado do projeto antes daquele pedido. A resposta do agente segue uma ordem fixa:

1. **Entendimento**: o agente reescreve o pedido com as próprias palavras ("vou montar o Registro de Horas Aurora: cadastro de clientes e projetos, lançamento de horas...") e anuncia o plano.

2. **Plano**: um painel com as etapas numeradas e o contador de concluídas ("Plano: 3 de 8 concluídas"), atualizado conforme avança.

3. **Rastro**: uma linha por ação, com verbo no passado: "Planejou com o PM", "Consultou o banco", "Criado Painel.tsx", "Editado App.tsx", "Verificou qualidade". Enquanto trabalha, aparece "Pensando..." com o tempo decorrido e o botão **Parar o agente** fica disponível.

4. **Resumo**: o total de etapas e o tempo ("37 etapas concluídas · 265s", um botão que recolhe ou expande o rastro), o que existe no app, os dados de exemplo criados e **Próximos passos sugeridos**.

![Trecho final da resposta do agente no chat do Skip: próximos passos sugeridos, horário, botões de avaliação e cópia, contador de créditos e o estado Concluído com a versão.](https://guides.adapta.org/media/screenshots/skip/chat-2026-09-12/resposta-concluida.png)

*O rodapé de cada resposta traz o custo em créditos e a versão gerada.*

No rodapé ficam o horário, os botões **Gostei do resultado** e **Não gostei do resultado**, **Copiar mensagem**, o contador de **créditos consumidos nesta interação** e o estado com a versão ("Concluído - Versão 0.0.1").

Leia o resumo antes de testar: ele diz o que o agente acredita ter entregue, e é contra isso que você vai conferir o app no preview.

## Os dois modos de execução

Ao lado da caixa de mensagem, o botão **Modo de execução** mostra o modo atual. Com o botão focado, a seta para baixo abre a lista:

|  Modo |  O que faz |  Quando usar |
| --- | --- | --- |

|  **Agent** |  Lê o pedido, monta o plano e executa: cria e edita arquivos, banco e testes, gerando uma nova versão |  Construir, corrigir e evoluir o app |

|  **Chat** |  Modo de conversa: a resposta vem em texto (o curso do Skip o descreve como o modo que só conversa, sem implementar) |  Tirar dúvidas, entender como algo foi feito, pedir sugestões e refinar o próximo pedido |

Um bom ritmo é alternar: em **Chat**, pergunte como o agente faria uma mudança e o que ela afeta; volte a **Agent** e mande executar o que foi combinado.

````
Implemente a sugestão acima, sem alterar mais nada.

````

## Deixe o pedido mais preciso

A caixa **Mensagem para o agente** tem três ajudas ao lado:

- **Adicionar anexo**: imagens e documentos entram como referência (um print do visual desejado, uma planilha com a estrutura, um PDF com regras).

- **Selecionar elemento como anexo**: ative o botão, clique na parte do app no preview e descreva a mudança em cima dela; o botão fica realçado enquanto o modo está ativo.

- **Enviar mensagem**: dispara o pedido no modo escolhido.

![Rodapé do chat do Skip: caixa Mensagem para o agente, botões de anexo e de selecionar elemento, seletor de modo Agente e botão de enviar.](https://guides.adapta.org/media/screenshots/skip/chat-2026-09-12/rodape-e-caixa.png)

*Anexo, seleção de elemento e modo de execução ficam na própria caixa de mensagem.*

O idioma das respostas é uma configuração do projeto: **Configurações e Estatísticas > Configurações > Idioma do Chat** ([Configurações do projeto](https://guides.adapta.org/guias/skip/recursos-do-skip/configuracoes-do-projeto/)).

## Um pedido de correção bem feito

1. **Aponte o lugar**

    Nomeie a página e o elemento ("na página Lançar Horas, o campo Descrição") ou use **Selecionar elemento como anexo** para marcar direto na tela.

![Preview do Skip com o botão Entrar da tela de login selecionado e contornado, o campo flutuante Peça ao Skip logo abaixo dele e o painel Propriedades do elemento aberto à direita.](https://guides.adapta.org/media/screenshots/skip/chat-2026-09-22/apontar-2026-09-22.png)

    *Depois de Selecionar elemento como anexo: **1** o elemento marcado no preview, **2** o campo Peça ao Skip, preso ao elemento, e **3** o painel Propriedades, que confirma o que foi selecionado (aqui, um Button).*

2. **Descreva o sintoma e o resultado esperado**

    "O campo aceita texto vazio; deve exigir pelo menos 5 caracteres e mostrar a mensagem 'Informe uma descrição'". Se houver erro, copie a mensagem do **Bug Scanner** ([Inspetor de Build e Bug Scanner](https://guides.adapta.org/guias/skip/recursos-do-skip/diagnostico/)).

![Caixa Mensagem para o agente do chat do Skip com o pedido digitado: na tela de login, o botão Entrar aceita e-mail vazio; deve exigir e-mail e mostrar Informe seu e-mail.](https://guides.adapta.org/media/screenshots/skip/chat-2026-09-22/sintoma-2026-09-22.png)

    *Sintoma e resultado esperado na mesma frase: **1** o texto na caixa do chat, com a página, o elemento e a mensagem que deve aparecer, e **2** o botão de enviar, que só acende com texto.*

3. **Feche com a restrição**

    "Não altere outras páginas nem o design atual." Uma mudança por pedido: fica mais barato conferir e mais fácil restaurar se algo sair errado.

![Caixa Mensagem para o agente do chat do Skip com o pedido completo em duas linhas: o botão Entrar aceita e-mail vazio, exija e-mail e mostre Informe seu e-mail, e a frase final Não altere mais nada, com o seletor Modo de execução em Agente.](https://guides.adapta.org/media/screenshots/skip/chat-2026-09-22/restricao-2026-09-22.png)

    *O pedido fechado: **1** a restrição no fim do texto e **2** o Modo de execução em Agente, o único que altera o projeto. Uma mudança por pedido.*

4. **Confira e avalie**

    Teste no preview, leia o contador de créditos e use **Gostei** ou **Não gostei** para registrar o resultado daquela resposta.

![Trecho final da resposta do agente no chat do Skip: próximos passos sugeridos, horário, botões de avaliação e cópia, contador de créditos e o estado Concluído com a versão.](https://guides.adapta.org/media/screenshots/skip/chat-2026-09-12/resposta-concluida.png)

    *No rodapé da resposta: o horário, Gostei e Não gostei, Copiar mensagem, o custo em créditos daquela execução e o estado Concluído com a versão gerada.*

Cada resposta no modo **Agent** gera uma nova versão e consome créditos; o valor aparece no rodapé da própria resposta. Antes de uma sequência longa de ajustes, veja o saldo em [Créditos e plano](https://guides.adapta.org/guias/skip/conta-e-organizacao/creditos/). E nunca cole senhas, tokens ou dados pessoais na conversa ([Cuidados com dados e chaves](https://guides.adapta.org/guias/skip/conta-e-organizacao/dados/)).

**Dica do curso:** em *Os 10 Mandamentos do Skip*, Romário Melo usa o modo chat para nomear as partes da interface (barra lateral, cabeçalho) e pedir sugestões de implementação antes de construir, e recomenda o comando "implemente as sugestões" em seguida. Para erros, a fórmula dele é "quando faço X aparece o erro Y; analise profundamente no código e me dê uma solução".

## O que conferir

- **Modo certo:** se a resposta veio só em texto quando você esperava uma mudança, veja se o modo estava em **Chat**.

- **Plano antes do resultado:** se o plano já mostra algo diferente do pedido, use **Parar o agente** e reescreva; sai mais barato do que corrigir depois.

- **Como voltar atrás:** o link **restaurar checkpoint** de cada mensagem marca o ponto de retorno; o método completo está em [Como pedir à IA](https://guides.adapta.org/guias/skip/comece-aqui/preparar-pedidos/) e no caso [Construa um registro de horas para uma equipe](https://guides.adapta.org/guias/casos-de-uso/por-plataforma/skip/registro-horas/).
