Construindo com Agent

Documentation Index

Fetch the complete documentation index at: https://docs.replit.com/llms.txt

Use this file to discover all available pages before exploring further.

Agent é o construtor de IA do Replit e seu companheiro para transformar ideias em software. Agent pode planejar mudanças, escrever código, explicar comportamentos, depurar problemas e melhorar seu app. Vibe coding 101 explica a mentalidade, enquanto esta página explica como trabalhar com Agent na prática. Effective prompting explica como escrever instruções mais claras. Pense no Agent como o quarterback em campo: ele lê a situação, escolhe um caminho e avança o trabalho. Você é o técnico: você define a estratégia, chama a jogada, revisa o que aconteceu e decide o próximo movimento. Agent pode fazer muito, mas funciona melhor quando você lidera o processo: seja específico, planeje o trabalho, adicione contexto, revise e teste, e use checkpoints quando precisar se recuperar.

​

Cinco dicas para construir com Agent

Use esses hábitos ao trabalhar com Agent:

1. Seja específico.
2. Planeje o trabalho.
3. Adicione contexto.
4. Revise e teste.
5. Use checkpoints.

​

Seja específico

Agent pode lidar com trabalhos complexos, mas precisa de direções claras. Uma solicitação útil explica o que você quer, o que importa e o que deve permanecer igual. Não precisa descrever cada detalhe de implementação, mas deve dar ao Agent orientação suficiente para tomar boas decisões. Em vez de: Tente: O segundo prompt dá ao Agent um objetivo, uma área de foco e restrições. Quando sua solicitação tem várias partes, diga o que é mais importante. Agent pode dividir esse trabalho em etapas, mas sua orientação diz a ele como é o sucesso. Para mais exemplos de instruções específicas, veja Effective prompting.

​

Planeje o trabalho

O planejamento ajuda quando o trabalho tem incerteza, múltiplas etapas, trade-offs ou qualquer coisa que você queira aprovar antes de os arquivos serem alterados. Você pode pedir ao Agent para criar um plano na conversa: Use o Plan mode quando quiser que o Agent pense primeiro e aguarde sua aprovação antes de alterar arquivos. Ative Plan no composer de prompts antes de enviar. Quando Agent terminar de pensar, você verá um banner task plan is ready for review com um botão Review now.

​

Adicione contexto

O contexto ajuda o Agent a entender o que importa. Você pode adicionar contexto com texto, capturas de tela, esboços, arquivos, dados, erros ou anotações do Canvas. Use o formato que melhor explica o problema. Use texto quando a mudança é sobre comportamento, objetivos ou restrições: Use capturas de tela ou esboços quando o layout é difícil de descrever em palavras: Use anotações do Canvas quando a mudança é visual e você quer apontar para uma parte específica do app. Um bom contexto também inclui o que não deve mudar. Isso ajuda o Agent a melhorar uma área sem reescrever outra acidentalmente.

​

Revise e teste

Agent pode propor um plano antes de construir e pode resumir o que foi alterado depois. Leia os dois. Abra o plano selecionando View no card do plano de tarefa. O plano expandido mostra o que Agent pretende construir, os critérios de sucesso, o que está fora do escopo e as etapas que Agent seguirá. Antes de Agent construir, revise o plano:

• Isso resolve o problema certo?
• Está faltando alguma coisa?
• Há algo fora do escopo?
• Existe uma versão menor para construir primeiro?
• Explica como você deve testar o resultado?

Se o plano for muito abrangente, peça ao Agent para reduzi-lo. Após Agent construir, teste o app você mesmo. Abra o Preview e use-o como a pessoa para quem ele foi criado. Verifique:

• Alguém consegue completar a ação principal?
• A mudança solicitada aconteceu?
• O app ainda funciona em dispositivos móveis?
• Algum comportamento importante quebrou?
• Agent alterou algo não relacionado?
• O resultado é bom o suficiente para continuar construindo?

Se algo estiver errado, descreva o que você viu. Em vez de: Tente: Feedback específico ajuda Agent a corrigir o problema certo.

​

Use checkpoints

Checkpoints ajudam você a se recuperar quando uma mudança vai na direção errada. Use feedback focado quando o resultado está próximo: Use um checkpoint quando o app estiver pior do que antes, um comportamento importante quebrou ou Agent alterou mais do que o esperado. Abra History no painel do Agent para ver os checkpoints. Cada checkpoint mostra o que foi alterado, com os controles Rollback here e Changes. Quando você seleciona Rollback here, Agent confirma o que será restaurado antes de aplicar o rollback. Se você não tiver certeza se deve corrigir para frente ou reverter, peça ao Agent para ajudar a comparar. Erros de percurso são normais. Checkpoints permitem que você explore sem perder a capacidade de retornar a uma versão mais segura. Para mais orientações sobre recuperação, veja Checkpoints and rollbacks.

​

Como é uma boa colaboração com Agent

Você está no caminho certo quando:

• Suas solicitações explicam o objetivo e as restrições
• O plano do Agent é claro o suficiente para revisar
• Você adiciona capturas de tela, arquivos ou notas do Canvas quando palavras não são suficientes
• Você testa fluxos importantes após as mudanças
• Você dá feedback focado quando algo está errado
• Você usa checkpoints em vez de tentar desembaraçar uma mudança ruim indefinidamente

​

Próximo passo