All Glossaries

/

Cos'è il versioning dei prompt?

Cos'è il versioning dei prompt?

Cos'è il versioning dei prompt, perché versionare ogni modifica di un agente vocale e come testare, rilasciare e fare rollback senza rischi sulle chiamate.

Il versioning dei prompt è la pratica di salvare ogni modifica al prompt di un agente IA come versione numerata e fissa. Così un team può testare la modifica prima che vada in produzione, vedere esattamente cosa è cambiato e tornare a una versione precedente se quella nuova non funziona. È chiamato anche controllo di versione dei prompt. La gestione dei prompt è l'attività più ampia di scrittura, archiviazione e organizzazione dei prompt. Il versioning è la parte che controlla i rilasci.

Il prompt engineering decide cosa dice il prompt. Il versioning dei prompt decide quando lo sentono i chiamanti.

Perché una modifica al prompt è più rischiosa su un agente vocale?

Un agente vocale parla con chiamanti reali in tempo reale. Per questo un prompt sbagliato raggiunge le persone prima che qualcuno riveda la trascrizione. Non si può ritirare una frase che il chiamante ha già sentito.

Assistente chatAgente vocale telefonico
Dove emerge un erroreSullo schermo, dove l'utente può rileggere o riprovarePronunciato una sola volta, a metà conversazione
Cosa controlla il promptRisposte testuali, a volte chiamate a strumentiRisposte, più trasferimenti, prenotazioni e SMS che raggiungono sistemi reali
Cosa sfugge a un test testualePoco, dato che il prodotto è testoVoce, interruzioni, trasferimenti e input da tastierino

Su un agente vocale, il prompt non è l'unica cosa che cambia. In Retell AI, una versione è l'intero agente: prompt, voce, strumenti, flusso di conversazione e knowledge base collegate. Una nuova voce o uno strumento rinominato possono compromettere le chiamate quanto un'istruzione riformulata. Per questo i team versionano l'agente, non solo il testo del prompt.

Come funziona il versioning dei prompt in Retell AI?

Retell documenta un percorso di rilascio basato su bozze, versioni pubblicate e tag di ambiente. Ogni passaggio qui sotto proviene dalla documentazione di Retell su versioni dell'agente, test, analytics e avvisi.

Ciclo di vita del versioning dei prompt per un agente vocale in sei fasi. Bozza: una nuova versione nasce come bozza modificabile copiata da qualsiasi versione precedente. Test: esegui la suite di simulazione in batch, poi una chiamata web e una chiamata telefonica sulla bozza. Confronto: rivedi un diff parola per parola rispetto all'ultima versione pubblicata. Pubblicazione: la versione diventa di sola lettura e V3 (bozza) diventa V3. Rilascio: sposta il tag di ambiente prod da V2 a V3, e i numeri di telefono associati al tag lo seguono. Monitoraggio: suddividi le analytics per versione e imposta avvisi sul tag prod. Rollback: riporta il tag prod su V2.
Il percorso di rilascio documentato per un agente vocale di Retell AI, dalla bozza al rollback. Diagramma di Retell AI, ottobre 2026.
  • Bozza. Una nuova versione nasce come bozza modificabile. Puoi crearne una da qualsiasi versione passata e mantenere più bozze contemporaneamente.
  • Test. Esegui i tuoi casi di test di simulazione salvati in batch e confronta il tasso di superamento con l'esecuzione precedente. Poi ascolta la modifica in una chiamata web e verifica trasferimenti e input da tastierino con una chiamata telefonica. Entrambe funzionano su una bozza, senza pubblicarla.
  • Confronto. La finestra di pubblicazione può confrontare la bozza con l'ultima versione pubblicata, fino alle singole parole aggiunte o rimosse nel prompt.
  • Pubblicazione. La pubblicazione rende la versione di sola lettura: V3 (bozza) diventa V3, una configurazione fissa a cui puoi tornare in seguito.
  • Rilascio. Ogni agente parte con i tag prod e staging. I numeri di telefono assegnati a prod seguono la versione a cui punta il tag. Spostare prod da V2 a V3 li aggiorna quindi senza modificare ogni singolo numero. Per provare prima una modifica su una parte delle chiamate, l'A/B testing suddivide il traffico di un numero tra più agenti in base a percentuali.
  • Monitoraggio. La dashboard di analytics suddivide le metriche per versione dell'agente, e le regole di avviso possono essere limitate al tag prod.
  • Rollback. Riporta prod su V2.

Chi dovrebbe essere responsabile delle versioni dei prompt?

Ogni rilascio dovrebbe avere un responsabile designato, perché una modifica al prompt su una linea telefonica è una modifica in produzione. Alcuni clienti di Retell affidano questo compito a un CX automation engineer. È il responsabile interno che individua le chiamate gestite male, scrive la correzione e la testa, e torna all'ultima versione pubblicata se non funziona.

Una breve routine di rilascio mantiene utili le versioni:

  1. Dai a ogni versione un titolo che indichi il motivo della modifica, ad esempio "Correzione trasferimento rimborsi".
  2. Simula (mock) ogni funzione che raggiunge un sistema reale prima di eseguire i test. La documentazione di Retell avverte che una funzione personalizzata non simulata chiama il suo endpoint reale.
  3. Prima di spostare prod, annota a quale versione faresti il rollback.
  4. Durante il primo giorno, monitora le chiamate filtrandole per versione.

Domande frequenti sul versioning dei prompt

Qual è la differenza tra versioning dei prompt e gestione dei prompt?

La gestione dei prompt comprende scrittura, archiviazione, organizzazione e modifica dei prompt. Il versioning dei prompt è la parte della gestione dei prompt che salva ogni modifica come versione fissa. Così un team può testarla, confrontarla e annullarla con un rollback.

Cosa sono gli strumenti di versioning dei prompt?

Sono strumenti che archiviano ogni versione del prompt con un identificativo, mostrano cosa è cambiato e controllano quale versione è in esecuzione in produzione. Su una piattaforma di agenti vocali, il versioning può essere integrato nell'agent builder. In Retell AI, bozze, versioni pubblicate e tag di ambiente fanno parte di ogni agente.

Come si fa il rollback di una modifica al prompt su un agente vocale?

Riporta la produzione sull'ultima versione funzionante. In Retell AI, sposti il tag di ambiente prod sulla versione precedente, e i numeri di telefono assegnati a quel tag lo seguono.

Puoi testare una nuova versione del prompt senza influire sulle chiamate live?

Sì. Mantieni la modifica in una bozza e testala con test di simulazione, una chiamata web o una chiamata telefonica su un numero di test. Retell ti permette di collegare una versione in bozza a un numero di telefono senza pubblicarla. Durante i test non modificare le variabili dinamiche del tag prod, perché si applicano alle chiamate live.

Versiona e testa i tuoi agenti vocali con Retell AI

Retell AI è una piattaforma di agenti vocali con IA per contact center. Bozze, confronto tra versioni, tag di ambiente e test di simulazione e in batch sono integrati nell'agent builder. Dopo un rilascio, QA con IA assegna un punteggio a un campione di chiamate in produzione, così puoi verificare la qualità delle chiamate dopo ogni rilascio.

Add Retell AI as a preferred source on Google
Recommendation

Related AI Voice Agent Terms

Rivoluziona le tue operazioni di chiamata con Retell