O que é versionamento de prompts?
O que é versionamento de prompts, por que equipes de agentes de voz versionam cada alteração e como testar, lançar e reverter sem quebrar chamadas ao vivo.
O versionamento de prompts é a prática de salvar cada alteração no prompt de um agente de IA como uma versão numerada e fixa. Assim, a equipe pode testar a alteração antes que ela entre no ar, ver exatamente o que mudou e voltar para uma versão anterior se a nova falhar. Essa prática também é chamada de controle de versão de prompts. O gerenciamento de prompts é a tarefa mais ampla de escrever, armazenar e organizar prompts; o versionamento é a parte que controla os lançamentos.
A engenharia de prompts define o que o prompt diz. O versionamento de prompts define quando quem liga vai ouvi-lo.
Por que uma alteração de prompt é mais arriscada em um agente de voz?
Um agente de voz fala com pessoas ao vivo, em tempo real. Por isso, um prompt ruim chega a elas antes que alguém revise a transcrição. Não há como desfazer uma frase que quem ligou já ouviu.
| Assistente de chat | Agente de voz por telefone | |
|---|---|---|
| Onde um erro aparece | Na tela, onde o usuário pode reler ou tentar de novo | Falado uma única vez, no meio da conversa |
| O que o prompt controla | Respostas em texto e, às vezes, chamadas de ferramentas | Respostas, além de transferências, agendamentos e mensagens de texto que chegam a sistemas reais |
| O que um teste em texto não detecta | Pouca coisa, já que o produto é texto | Voz, interrupções, transferências e entrada pelo teclado |
Em um agente de voz, o prompt não é a única coisa que muda. Na Retell AI, uma versão é o agente inteiro: o prompt, a voz, as ferramentas, o fluxo de conversa e as bases de conhecimento vinculadas. Uma nova voz ou uma ferramenta renomeada pode quebrar chamadas tão facilmente quanto uma instrução reescrita. Por isso, as equipes versionam o agente, não apenas o texto do prompt.
Como funciona o versionamento de prompts na Retell AI?
A Retell documenta um fluxo de lançamento baseado em rascunhos, versões publicadas e tags de ambiente. Cada etapa abaixo vem da documentação da Retell sobre versões de agentes, testes, análises e alertas.
- Rascunho. Uma nova versão começa como um rascunho editável. Você pode criar um rascunho a partir de qualquer versão anterior e manter vários rascunhos ao mesmo tempo.
- Teste. Execute em lote os casos de teste de simulação que você salvou e compare a taxa de aprovação com a execução anterior. Depois, ouça a alteração em uma chamada web e confirme as transferências e a entrada pelo teclado em uma chamada telefônica. As duas opções funcionam em um rascunho, sem precisar publicá-lo.
- Comparação. A caixa de diálogo de publicação permite comparar o rascunho com a última versão publicada, mostrando até as palavras adicionadas ou removidas do prompt.
- Publicação. Ao publicar, a versão passa a ser somente leitura: V3 (rascunho) se torna V3, uma configuração fixa à qual você pode voltar depois.
- Lançamento. Cada agente começa com as tags
prodestaging. Os números de telefone atribuídos aprodseguem a versão para a qual a tag aponta. Assim, moverprodde V2 para V3 troca a versão de todos esses números sem editar cada um deles. Para testar uma alteração primeiro em uma parte das chamadas, o teste A/B divide o tráfego de um número entre agentes por porcentagem. - Monitoramento. O painel de análises segmenta as métricas por versão do agente, e as regras de alerta podem ser limitadas à tag
prod. - Reversão. Mova
prodde volta para V2.
Quem deve ser responsável pelas versões de prompts?
Uma pessoa específica deve ser responsável por cada lançamento, porque uma alteração de prompt em uma linha telefônica é uma alteração em produção. Alguns clientes da Retell atribuem essa função a um engenheiro de automação de CX. Esse é o responsável interno que identifica chamadas mal conduzidas, escreve a correção, testa e volta para a última versão publicada se a correção não funcionar.
Um hábito simples de lançamento mantém as versões úteis:
- Dê a cada versão um título com o motivo da alteração, como "Corrigir transferência de reembolso".
- Simule (mock) todas as funções que acessam um sistema real antes de executar os testes. A documentação da Retell alerta que uma função personalizada sem mock chama o endpoint real.
- Antes de mover
prod, anote para qual versão você voltaria em caso de reversão. - Acompanhe as chamadas da nova versão, filtrando por versão, durante o primeiro dia.
Perguntas frequentes sobre versionamento de prompts
Qual é a diferença entre versionamento de prompts e gerenciamento de prompts?
O gerenciamento de prompts abrange escrever, armazenar, organizar e editar prompts. O versionamento de prompts é a parte do gerenciamento que salva cada alteração como uma versão fixa, para que a equipe possa testá-la, compará-la e revertê-la.
O que são ferramentas de versionamento de prompts?
São ferramentas que armazenam cada versão de prompt com um identificador, mostram o que mudou e controlam qual versão roda em produção. Em uma plataforma de agentes de voz, o versionamento pode ficar dentro do construtor de agentes. Na Retell AI, rascunhos, versões publicadas e tags de ambiente fazem parte de todos os agentes.
Como reverter uma alteração de prompt em um agente de voz?
Aponte a produção de volta para a última versão que funcionou. Na Retell AI, você move a tag de ambiente prod de volta para a versão anterior, e os números de telefone atribuídos a essa tag acompanham a mudança.
É possível testar uma nova versão de prompt sem afetar as chamadas ao vivo?
Sim. Mantenha a alteração em um rascunho e teste-a com testes de simulação, uma chamada web ou uma chamada telefônica em um número de teste. A Retell permite vincular uma versão de rascunho a um número de telefone sem publicá-la. Não altere as variáveis dinâmicas da tag prod durante os testes, já que elas se aplicam às chamadas ao vivo.
Versione e teste seus agentes de voz com a Retell AI
A Retell AI é uma plataforma de agentes de voz com IA para centrais de atendimento. Ela oferece rascunhos, comparação de versões, tags de ambiente e testes de simulação e em lote integrados ao construtor de agentes. Após um lançamento, o QA com IA avalia uma amostra de chamadas em produção, para que você possa verificar a qualidade das chamadas depois de cada lançamento.
