Otimizador de prompts

O que ele faz

O Otimizador é a contraparte assistida por IA do Analisador de qualidade. O analisador diz o que está errado; o Otimizador propõe uma correção. O resultado é um único corpo de Prompt reescrito que você pode revisar, editar e salvar.

Diferente do analisador, o Otimizador chama o modelo e consome créditos. Em troca, você recebe uma reescrita real, não apenas uma lista de problemas.

O que é retornado

O resumo explica a reescrita em alto nível — o que foi cortado por verbosidade, o que foi reorganizado para melhorar a estrutura, o que foi removido por ser redundante. Leia-o antes de aplicar para identificar qualquer coisa que não corresponda à sua intenção.

O que o modelo vê

O Otimizador não está apenas parafraseando o prompt isoladamente. Ele recebe uma solicitação estruturada que inclui:

• O conteúdo original do prompt — o texto que está sendo otimizado
• O tipo de prompt — persona, instrução, schema, etc., para que a reescrita siga a estrutura correta
• O canal — canais voltados ao cliente priorizam segurança, brevidade e tom amigável; canais internos podem ser mais densos e técnicos
• A definição do agente, quando fornecida — persona, nome de exibição, canal, para que a reescrita permaneça alinhada ao propósito
• Prompts irmãos no mesmo agente — para que o Otimizador não duplique instruções que já existem em outro prompt
• As ferramentas atribuídas ao agente — para que a reescrita reflita o que o agente realmente pode fazer
• Uma instrução opcional do usuário — texto livre seu que direciona a reescrita (“corte pela metade”, “adicione uma etapa sobre confirmação”, etc.). Você pode inserir até 15.000 caracteres, e a instrução completa chega ao modelo.
• Um arquivo de amostra opcional — anexe um documento representativo (PDF, imagem, CSV, TXT ou JSON) que o agente irá processar em tempo de execução. O Otimizador o lê para adaptar o prompt à estrutura desse documento (quais campos extrair, formatos esperados), tratando-o como uma amostra de entrada em tempo de execução, e não copiando seu conteúdo para dentro do prompt.

A saída é intencionalmente apenas o prompt reescrito — sem explicações nem marcação circundante — para que possa ser salva de volta no registro sem limpeza manual. A plataforma também remove quaisquer marcadores de bloco de código, caso o modelo os adicione.

Otimização sensível ao canal

Os objetivos de otimização variam por canal:

• Canais voltados ao cliente (External Widget, Community) recebem reescritas que enfatizam segurança, brevidade e tom amigável — linguagem mais direta, menos suposições sobre conhecimento interno.
• Canais internos recebem reescritas que podem ser mais densas, técnicas e detalhadas — o público é formado por usuários com contexto completo do Salesforce.
• Canais de API recebem reescritas ajustadas para chamadores automatizados — mais curtas, mais determinísticas, menos conversacionais.

A plataforma envia automaticamente o canal configurado do agente ao Otimizador; você não o define separadamente.

Como funciona uma execução

Detecção de truncamento

Prompts longos podem gerar saídas de otimização que excedem o orçamento de resposta. A plataforma detecta quando a reescrita foi interrompida no meio do processo e exibe um erro claro em vez de persistir um prompt incompleto:

“The optimized prompt was truncated due to output token limits. Try shortening the original prompt, or increase "Optimizer_Max_Output_Tokens" in REDA AI Setup.”

A mensagem nomeia a solução: Optimizer Max Output Tokens é uma Configuração da plataforma, 4096 por padrão. Aumentá-la permite que a reescrita termine. Dividir o prompt é a outra opção, e a melhor quando o prompt realmente tenta fazer coisas demais.

Se isso ocorrer de forma consistente em um único prompt, provavelmente ele está tentando fazer coisas demais — divida-o em múltiplos Prompts personalizados (cada um com uma função específica) e otimize cada um separadamente.

Tratamento de timeout

Com IA incluída, uma chamada que atinge o tempo limite pode gerar a cobrança documentada de 20 créditos. Com Traga sua própria IA, a REDA não desconta uma franquia de créditos; a cobrança é controlada pelo provedor. Confira o uso registrado e o erro antes de tentar novamente. O tempo limite, sozinho, não identifica a causa.

Custo em créditos

O custo aumenta com o tamanho da entrada (o prompt sendo otimizado, mais o contexto do agente, os prompts irmãos e a lista de ferramentas) e o tamanho da reescrita. A plataforma informa os créditos efetivamente consumidos após a execução.

Prompts menores custam menos, mas os ganhos também são menores; prompts grandes demais custam mais, mas também são onde a reescrita normalmente se paga em poucas conversas reais.

O que o Otimizador não faz

• Não aplica automaticamente. Toda reescrita é revisável; nada é salvo até você confirmar.
• Não altera a semântica intencionalmente. O modelo é instruído a preservar o significado do prompt — os cortes visam a verbosidade, não a substância do que você escreveu. Sempre leia o resumo antes de aplicar.
• Não analisa conflitos entre prompts. O Otimizador tem conhecimento dos prompts irmãos para não duplicá-los, mas não resolve contradições entre prompts — para isso, leia o relatório de conflitos em Pré-visualização de Execução do Agente.
• Não substitui o analisador. As reescritas ainda são pontuadas posteriormente, então o analisador continua sendo a fonte da verdade sobre qualidade.

Em que ele difere de recursos relacionados

• Analisador de qualidade — pontua prompts de forma determinística. Gratuito, instantâneo, sem chamada ao modelo.
• Criar agente com IA — revisa o agente de ponta a ponta e propõe alterações em persona, prompts, contexto, ferramentas e chips. Use-o para abrangência.
• Otimizador de prompts — reescreve um único prompt com contexto sensível ao canal e às ferramentas. Use-o para profundidade em um prompt específico que teve pontuação baixa ou cresceu ao longo do tempo.

Use o Analisador de qualidade para encontrar os prompts a otimizar; use o Otimizador para fazer a reescrita; use a Pré-visualização de Execução para verificar se o prompt reescrito ainda se encaixa no panorama geral do agente.

Boas práticas

Leia o resumo sempre. “Cortou frases verbosas, removeu regra redundante sobre concisão, adicionou cabeçalho de seção” é um bom resumo; “reescrito para clareza” é vago. Resumos vagos merecem uma análise mais atenta do diff.

Use a instrução do usuário. Uma frase de orientação costuma produzir uma reescrita visivelmente melhor do que executar o Otimizador sem instrução alguma.

Otimize primeiro os prompts com pontuação baixa. O Analisador de qualidade sinaliza os piores casos; o retorno sobre o esforço do Otimizador é maior neles. Um prompt com pontuação 95 geralmente não precisa de reescrita.

Não aceite cortes grandes às cegas. Uma reescrita que reduz a contagem de tokens em 70% provavelmente eliminou algo importante. O resumo deve explicar o corte; se não explicar, leia as duas versões com atenção.

Reexecute o Analisador de qualidade mentalmente. As pontuações de qualidade antes/depois mostram a visão do analisador; seu próprio julgamento sobre se a reescrita ainda diz o que você quis dizer é a outra metade da decisão.

Perguntas frequentes

Próximos passos

Navegue pela Galeria de modelos de Prompt para pontos de partida prontos para uso, ou revisite o Analisador de qualidade para priorizar quais prompts vale a pena otimizar.