AutoPrompt

O que é

AutoPrompt é a ferramenta nativa com que o agente lê e melhora o próprio prompt de sistema a partir do que aprende em conversas reais. Ela serve para corrigir uma orientação errada ou desatualizada e para acrescentar uma regra que continuará útil em conversas futuras.

O agente pode listar e ler as seções atuais, reescrever uma seção ou criar uma nova. A configuração decide se a mudança vira uma proposta para revisão ou se é aplicada automaticamente.

AutoPrompt não é memória da conversa nem base de conhecimento. Um pedido que só vale para a resposta atual deve ser atendido sem alterar o prompt. Fatos, catálogos e conteúdo de consulta devem ficar em bases ou blocos de contexto.

Adicionar e configurar

Você precisa poder editar o agente (agents.write). Em um agente já salvo:

1. Abra Agentes, selecione o agente e entre em Ferramentas.
2. Selecione Adicionar Ferramenta.
3. No grupo Ferramentas Nativas, escolha AutoPrompt.
4. Escolha o modo e salve.

Uma AutoPrompt nova começa em Ele propõe, alguém do time aprova. Uma instalação antiga que ainda não tenha o campo de modo preserva o comportamento anterior, automático. O resumo no cartão mostra qual modo está valendo; abra a configuração para conferir antes de expor o agente a clientes.

Modo	O que acontece	Quando usar
Ele propõe, alguém do time aprova	Reescrever ou criar uma seção gera uma proposta. O prompt não muda até a aprovação.	Padrão recomendado, especialmente para agentes externos ou regras sensíveis.
Ele muda na hora, sem aprovação	A alteração é gravada diretamente e passa a valer no turno seguinte.	Somente para agente interno, com uso controlado e risco aceito.

Não existe um modo “desligado”. Para impedir novas leituras e mudanças pelo agente, remova AutoPrompt na aba Ferramentas.

Quando o agente deve usar

O próprio contrato da ferramenta orienta o modelo a agir quando uma conversa revela que as instruções estão erradas, desatualizadas ou incompletas, por exemplo:

• alguém corrige uma regra durável de comportamento;
• o agente percebe que respondeu com base em uma orientação antiga;
• falta uma instrução para uma situação recorrente.

Um pedido explícito como “mude suas instruções” não garante que a alteração será aceita: o modelo ainda decide se a informação é durável e se pertence ao prompt. Não use AutoPrompt para um pedido pontual nem para armazenar fatos que deveriam ser pesquisáveis em uma base.

Revisar uma proposta

Quando existe ao menos uma proposta, a seção Prompt do agente mostra o botão Sugestões de melhorias e a quantidade pendente. Abra-o para:

• comparar o texto anterior e o proposto por seção;
• ler o motivo e abrir as conversas que originaram a proposta;
• Aprovar, Editar e aprovar ou Rejeitar;
• alternar entre Aguardando você e Já revisadas.

Quem revisa precisa da mesma permissão agents.write exigida para editar o agente. Aprovar aplica a seção e registra a mudança no Histórico do prompt; rejeitar impede que a mesma proposta volte durante 30 dias.

Propostas equivalentes são agrupadas e mostram quantas pessoas pediram a mudança. Se a seção for editada depois da proposta, a aprovação não sobrescreve o texto mais novo: a proposta fica Desatualizada e o agente pode criá-la novamente a partir da versão atual.

No modo revisado, AutoPrompt trabalha por seção. A substituição do prompt inteiro é recusada porque não produziria um diff legível. Estruture o prompt com títulos Markdown para permitir revisões pequenas. Se o documento não tiver seções, edite-o manualmente ou reorganize-o antes de usar esse modo.

Modo automático

No modo Ele muda na hora, sem aprovação, o agente também consegue substituir o prompt inteiro quando uma edição por seção não for suficiente. Toda alteração passa a orientar as conversas do agente a partir do próximo turno, inclusive conversas paralelas.

O Histórico mantém até as 20 versões mais recentes e permite comparar ou restaurar uma delas. Alterações automáticas também geram versão, mas hoje podem aparecer com o rótulo de versão inicial em vez de identificar AutoPrompt como a origem. Portanto, histórico não substitui revisão prévia nem monitoramento das conversas.

O modo automático aceita uma mudança decidida pelo modelo dentro de uma conversa, sem uma segunda autorização humana. Uma mensagem persuasiva ou maliciosa pode tentar transformar uma instrução passageira em regra permanente. Use esse modo apenas quando todas as pessoas que conversam com o agente forem confiáveis e uma mudança indevida puder ser detectada e revertida rapidamente.

Contexto da organização

A opção Ele também pode sugerir mudanças nos blocos que usa é independente do modo do prompt e começa desligada. Quando ativada, o agente pode listar os blocos de contexto anexados a ele e propor a edição ou criação de uma seção.

Esse alcance tem três limites importantes:

• blocos não anexados ao agente não são exibidos nem aceitos;
• a mudança no bloco sempre exige revisão, mesmo quando o prompt próprio está no modo automático;
• a aprovação afeta todos os agentes que usam aquele bloco.

As propostas de bloco são revisadas em Contexto da organização por uma pessoa com permissão administrativa. Confira o diff e a conversa de origem antes de aprovar, porque o texto é compartilhado.

Checklist de uso seguro

• Prefira o modo revisado para qualquer agente acessível a clientes.
• Escreva o prompt em seções Markdown pequenas e com títulos únicos.
• Antes de aprovar, confirme se a regra é durável, está no lugar certo e não contradiz outra seção.
• Use Editar e aprovar quando a intenção estiver correta, mas o texto ainda precisar de ajuste.
• Revise Histórico depois de qualquer comportamento inesperado e restaure uma versão anterior se necessário.
• Remova AutoPrompt quando o agente não precisar mais melhorar as próprias instruções.