> ## 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 e IA

> Respostas às perguntas comuns sobre o Agent—corrigir um Agent travado ou em loop, reduzir custos, modos do Agent, reverter alterações e usar suas próprias chaves de API.

Estas respostas abrangem o trabalho com o Agent. Para referência completa, veja a [visão geral do Agent](/references/agent/overview), os [modos do Agent](/references/agent/agent-modes) e a [cobrança de IA](/billing/ai-billing).

<AccordionGroup>
  <Accordion title="O Agent está travado ou continua desconectando—como corrijo?">
    1. Abra o painel **Shell** no seu projeto—não o chat do Agent.
    2. Digite `kill 1` e pressione Enter para interromper o processo travado. (`kill 1` é seguro no Replit—reinicia o processo principal do seu projeto, não exclui nada.)
    3. Abra um novo chat do Agent e descreva sua tarefa novamente para continuar.

    Enquanto o Agent parece travado, pare de enviar mensagens—mensagens extras criam instruções conflitantes. Se o Agent continuar travando na mesma tarefa, divida o trabalho em prompts menores e mais focados.
  </Accordion>

  <Accordion title="O Agent está em loop ou repetindo os mesmos passos—como paro?">
    1. Selecione **Parar** no painel do Agent para interrompê-lo imediatamente.
    2. Abra o painel **Shell** (não o chat do Agent), digite `kill 1` e pressione Enter.
    3. Abra um novo chat do Agent e reformule sua tarefa de forma mais específica.

    Para evitar loops:

    * Divida tarefas grandes em prompts menores—um objetivo por mensagem.
    * Use o [Modo de planejamento](/references/agent/plan-mode) para definir o escopo do trabalho antes que o Agent construa.
    * Defina um limite de uso em [Gerenciando seus gastos](/billing/managing-spend) para que um loop não gere uma conta alta.
  </Accordion>

  <Accordion title="Como reduzir os custos do Agent—quais configurações realmente ajudam?">
    Três configurações fazem a maior diferença:

    * **[Modo Economy](/references/agent/agent-modes)**—usa menos créditos por tarefa e é um bom padrão para builds do dia a dia.
    * **[Modo de planejamento](/references/agent/plan-mode)**—defina o escopo e aprove o trabalho antes que o Agent construa, para não pagar por alterações que você não quis.
    * **Limite de uso e orçamento**—defina um teto máximo em [Gerenciando seus gastos](/billing/managing-spend).

    Também ajuda iniciar um novo chat do Agent ao trocar de tarefa. Verifique seu painel de uso para ver quais tarefas custam mais.
  </Accordion>

  <Accordion title="Quais são os modos do Agent e como eles diferem?">
    O Agent tem três modos principais e um toggle opcional de velocidade. Veja [Modos do Agent](/references/agent/agent-modes) para orientação completa.

    * **Lite**—modelos rápidos e leves para edições rápidas e com escopo definido.
    * **Economy**—otimizado para custo; um padrão sólido para builds do dia a dia.
    * **Power**—os modelos mais capazes para tarefas complexas e bases de código maiores.
    * **Turbo**—um toggle nas Configurações avançadas, disponível no modo Power, que executa os modelos mais rápidos. É significativamente mais rápido, mas custa mais, portanto use com intenção.

    Separadamente, o [Modo de planejamento](/references/agent/plan-mode) permite ao Agent definir o escopo do trabalho antes de fazer alterações, enquanto o modo de criação aplica as alterações diretamente. Veja [Modo de planejamento vs. modo de criação](/learn/plan-vs-build-mode). Todos os modos usam créditos, incluindo o raciocínio no Modo de planejamento.
  </Accordion>

  <Accordion title="O Agent fez alterações que não quis—como reverter?">
    O Replit salva [checkpoints](/references/version-control/checkpoints-and-rollbacks) enquanto o Agent trabalha. No chat do Agent, encontre a mensagem anterior à alteração que deseja desfazer e selecione a opção de reversão ao lado dela para restaurar seu projeto a esse ponto.

    Para opções completas de reversão—incluindo recuperação de arquivos específicos e implantações ao vivo—veja [Checkpoints e reversões](/references/version-control/checkpoints-and-rollbacks).
  </Accordion>

  <Accordion title="O Agent diz que não pode acessar a internet ou APIs externas—isso é esperado?">
    Durante a fase de criação e edição, o Agent trabalha em um ambiente sandboxed com acesso de saída restrito. Seu aplicativo implantado ainda pode fazer chamadas a APIs externas quando é executado—o sandbox se aplica ao ambiente de edição do Agent, não ao seu aplicativo em execução.

    Se uma chamada de API falhar no seu aplicativo em execução, confirme que suas chaves estão salvas no painel [Secrets](/core-concepts/project-editor/app-setup/secrets), depois verifique a página de status do provedor. Em uma rede corporativa ou escolar, conexões de saída do seu aplicativo podem ser bloqueadas—verifique com o administrador da sua rede.
  </Accordion>

  <Accordion title="Posso usar minhas próprias chaves de API com o Agent?">
    Sim. Adicione suas chaves ao painel [Secrets](/core-concepts/project-editor/app-setup/secrets) e seu aplicativo as usa para suas chamadas de API. Abra a ferramenta **Secrets**, selecione **+ Novo secret** e insira um nome (como `OPENAI_API_KEY`) e valor.

    Você pode [trazer suas próprias chaves de provedor de IA](/references/integrations/replit-ai-integrations) para os modelos que seu aplicativo chama. O modelo que alimenta a experiência do Agent em si é executado na infraestrutura do Replit e não pode ser substituído.
  </Accordion>

  <Accordion title="O Agent continua adicionando recursos que não pedi—como obter um comportamento mais preciso?">
    Mantenha o Agent focado com prompts mais específicos:

    * Comece com a palavra *Apenas*—por exemplo, "Apenas adicione um botão de excluir ao cartão do usuário. Não mude mais nada."
    * Use o [Modo de planejamento](/references/agent/plan-mode) primeiro para revisar o que o Agent pretende fazer antes de fazer qualquer alteração.
    * Se o Agent fizer uma alteração indesejada, peça para desfazer essa alteração no mesmo chat imediatamente.

    Para mais informações, veja [Criação de prompts eficazes](/learn/effective-prompting).
  </Accordion>
</AccordionGroup>

## Ainda precisa de ajuda?

Se sua dúvida sobre o Agent não foi respondida aqui, [entre em contato com o Suporte do Replit](https://replit.com/support).