Aprenda a escrever prompts eficazes, a evitar erros comuns e a otimizar seu Agente de IA para conversas reais.
Na Parte 1, abordamos os fundamentos da engenharia de prompts: escrever instruções em vez de prosa, remover definições desnecessárias, evitar contradições e manter os prompts concisos. Neste blog, iremos além da estrutura dos prompts e nos concentraremos em como os modelos de IA realmente se comportam.
Entender o que um modelo pode e não pode fazer é tão importante quanto saber como escrever um prompt. Também abordaremos prompts de voz em tempo real, técnicas práticas de teste e um conjunto de hábitos que podem ajudá-lo a criar Agentes de IA 3CX mais confiáveis. Continue lendo para saber mais!
Saiba o Que o Modelo Pode e Não Pode Fazer
Grande parte do excesso nas instruções ao usuário vem da tentativa de resolver problemas que as instruções não podem resolver.
As instruções são boas para:
- Definir tom, persona e linguagem
- Definir a estrutura de uma interação (por exemplo, “fazer uma pergunta por vez”)
- Especificar quando usar qual ferramenta
- Enumerar ações permitidas e proibidas
- Recuperar-se de modos de falha específicos (por exemplo, correção de reconhecimento, hostilidade)
O prompt não é bom em:
- Forçar a formulação exata em cada turno. (o modelo irá parafrasear)
- Impor contagens precisas (“pergunte exatamente duas vezes, depois intensifique”) — quase, mas não perfeito
- Raciocinar sobre longas listas de lógica condicional em uma única frase
- Substituir ferramentas ausentes — se o agente precisar consultar algo, forneça uma ferramenta, não descreva a consulta em prosa. Todas as ferramentas são exibidas quando você clica no botão “Inserir Variável” na guia AI Prompt.
Se você se pegar escrevendo a mesma regra de três maneiras diferentes tentando forçar o modelo a “realmente, definitivamente, sempre” fazer algo, a resposta geralmente é uma chamada de ferramenta ou uma proteção no nível do código — não um prompt mais enfático. Então desista, remova quaisquer prompts extras que você adicionou e entre em contato conosco pelo Fórum 3CX.
A Diferença em Tempo Real
Ao enviar prompts para um modelo de áudio em tempo real, há uma camada extra: a fala não é texto. A OpenAI publica um Guia de Prompting em Tempo Real que é leitura obrigatória. A versão resumida:
- Mantenha as frases curtas. Frases faladas em voz alta no ritmo do modelo precisam ser ditas em uma única respiração.
- Diga como deve soar, não apenas o que dizer. “Profissional, composto, calmo, conciso” faz toda a diferença. O mesmo vale para “sem explicação de encaminhamento”.
- Lide com as situações complicadas de forma explícita. Ruído de fundo, palavras incompletas, interrupções, o interlocutor dizendo “uh, sim, desculpe — continue”. Se você não disser ao modelo como reagir, ele vai adivinhar, e a suposição geralmente está errada.
- Uma instrução por linha. Modelos de voz seguem instruções com quebras de linha de forma mais confiável do que cláusulas embutidas.
Um prompt de voz é ainda menos tolerante com a prosa do que um prompt de texto. Cada palavra a mais é um token que o modelo poderia ter usado para ouvir.
Dicas para Engenheiros de Prompts Iniciantes
Se esta é a primeira vez que você edita um prompt do sistema 3CX, alguns hábitos práticos vão economizar horas do seu tempo:
Comece a partir do prompt padrão. Não comece do zero. Os prompts do 3CX foram testados e aprovados para funcionar com modelos OpenAI Realtime. Você quase nunca vai querer substituí-los — você vai querer adicionar coisas a eles. Adicione uma seção. Substitua um comportamento específico. Deixe o resto como está.
Mude uma coisa de cada vez. Se você editar cinco seções e o agente começar a se comportar de maneira estranha, você não terá ideia de qual mudança causou isso. Faça uma alteração, teste em chamadas reais ou no link de conversação e, em seguida, faça a próxima.
Teste com chamadas realistas, não com chamadas ideais. Qualquer um consegue seguir um roteiro. Teste com chamadores que interrompem, mudam de ideia no meio da frase, murmuram um nome ou perguntam três coisas ao mesmo tempo. É aí que a qualidade do prompt realmente se destaca.
Leia seu prompt em voz alta. Sério. Se uma seção é estranha de ler em voz alta, ela também é estranha para o modelo. Seções com muita prosa saltam aos olhos imediatamente quando você tem que realmente dizê-las.
O orçamento de tokens é real. Prompts maiores não apenas custam mais — eles reduzem o espaço disponível para a própria conversa. Se o seu prompt for mais longo do que a ligação costuma ser, algo está errado.
Não diga ao modelo para “ser prestativo” ou “ser educado”. Ele já é. Essas instruções não acrescentam nada, exceto comprimento. Diga a ele o comportamento prestativo ou educado específico que você deseja — “reconheça a frustração do interlocutor uma vez antes de resolver o problema” — e dispense o adjetivo.
Na dúvida, apague. Um prompt mais curto é quase sempre um prompt melhor. Se você puder remover uma linha e o agente ainda se comportar corretamente, essa linha estava custando contexto a você à toa.
A Lista de Verificação Pré-salvamento
Antes de salvar um prompt, verifique o seguinte:
- Todas as regras estão exatamente em um único lugar? Sem repetições, sem quase-duplicações.
- As instruções são positivas sempre que possível? “Faça X” é melhor do que “Não faça Y, Z ou W”.
- Algumas regras poderiam se aplicar à mesma situação e entrar em conflito? Corrija isso agora, não na produção.
- Você está definindo algo que o modelo já entende? Apague.
- Cada frase altera o que o modelo faz? Se não, exclua-a.
- Você já a tokenizou? Passe-a pelo Tokenizer e verifique o tamanho real.
- Você testou com uma chamada confusa? Não apenas uma ideal.
Documentos da Base de Conhecimento
Embora não sejam estritamente um “prompt”, os documentos da base de conhecimento andam de mãos dadas com o seu prompt para dar a um Agente de IA sua personalidade e seu conhecimento.
Certifique-se de que seus documentos da base de conhecimento sejam os mais claros e concisos possíveis para que seu agente de IA possa trabalhar com eles. O padrão de excelência para isso é o Markdown, e a conversão de sua base de documentos já existente pode ser feita programaticamente. O projeto MarkItDown da Microsoft é uma ferramenta que você pode usar.
Use IA para Corrigir Sua IA
Aqui está um truque que vale a pena conhecer.
Esta postagem do blog — e o Guia de Prompting em Tempo Real OpenAI — foram escritos em prosa simples. Isso significa que você pode salvar qualquer um deles como um arquivo Markdown, prompt-engineering.md, e enviá-lo para a base de conhecimento do seu agente de IA como uma habilidade.
Baixe a realtime-prompting.skill e instale-a na sua IA — normalmente basta arrastar e soltar.
Depois de instalado, o agente herda o guia como conhecimento especializado. Você pode colar o rascunho do prompt do sistema em um chat com esse agente e perguntar:
“Analise este prompt de sistema em relação à minha habilidade de engenharia de prompts. Sinalize contradições, reformulações, instruções em estilo prosaico e definições desnecessárias. Sugira uma versão mais concisa.”
E a IA analisará seu prompt com a inteligência da habilidade por trás dele — identificando o tipo de problema que descrevemos acima, com exemplos específicos para o seu prompt.
Você está usando IA para corrigir o prompt de sistema de outra IA. Este é um dos fluxos de trabalho de maior impacto na engenharia de prompts no momento, e não custa nada para ser configurado.
Resumindo
Escreva instruções, não prosa. Esclareça cada regra apenas uma vez. Prefira o positivo ao negativo. Fique atento a contradições. Use o Tokenizer. Teste com chamadas confusas. Apague mais do que adicione.
Seu agente vai agradecer — deixando espaço na janela de contexto para realmente fazer seu trabalho.
Editando um prompt do Agente de IA 3CX? Comece com o padrão, altere uma coisa de cada vez e teste com chamadas reais. Se quiser se aprofundar, o Guia de Prompting em Tempo Real OpenAI é o melhor recurso técnico disponível no momento.
Participe da Discussão
Participe da discussão sobre o 3CX em nossos fóruns. Siga-nos no X e no LinkedIn para se manter atualizado sobre as últimas notícias e lançamentos de recursos.
Copyright © 2025