> For the complete documentation index, see [llms.txt](https://library.zoom.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://library.zoom.com/technical-library/it/zoom-workplace/zoom-phone/expert-insights/zoom-virtual-agent-receptionist-start-guide.md).
# Guida di avvio per receptionist di Zoom Virtual Agent
### **Introduzione**
Zoom Virtual Agent Receptionist (ZVA Receptionist) porta la gestione chiamata intelligente al tuo sistema telefonico aziendale. Utilizzando l'IA conversazionale, ZVA Receptionist risponde alle chiamate In entrata, fornisce informazioni da una Base di conoscenza configurata, indirizza i chiamanti alla persona o al reparto giusto e pianifica appuntamenti senza richiedere intervento umano. Precedentemente noto come AI Concierge o ZVA Concierge, ZVA Receptionist è configurato e gestito tramite AI Studio nello Zoom web portal.
Questa guida copre il processo completo di configurazione e quattro casi d'uso principali: creare una Base di conoscenza, configurare l'inoltro chiamate verso le destinazioni Zoom Phone, abilitare l'instradamento Dial-by-Name e aggiungere la pianificazione appuntamenti con Zoom Scheduler. Copre inoltre la messa a punto dell'agente vocale, la pubblicazione e i test e l'ottimizzazione continui.
### **Cosa devi sapere prima di iniziare**
#### **Prerequisiti**
Conferma quanto segue prima di iniziare la configurazione:
**Ruolo:** Titolare dell'account o admin **Licenze:**
* Zoom Phone o Zoom centro di contatto
* licenza Zoom Virtual Agent (ZVA)
* licenza Zoom Scheduler (richiesta solo per il caso d'uso della pianificazione appuntamenti)
**Access:** Zoom web portal con AI Studio abilitato
**Facoltativo:** Zoom Canvas o un sito web accessibile per i contenuti della Base di conoscenza
#### **Concetti chiave di ZVA Receptionist**
**Base di conoscenza:** L'archivio di informazioni da cui l'agente attinge per rispondere alle domande dei chiamanti. I contenuti vengono aggiunti come file caricati o URL collegati. **Competenze:** Funzionalità distinte aggiunte all'agente oltre a rispondere alle domande della Base di conoscenza. Le competenze definiscono le azioni di Instradamento, il comportamento Dial-by-Name e la pianificazione appuntamenti. **Guida dell'agente:** La sezione di configurazione in cui definisci la personalità, il tono, gli obiettivi e i limiti dell'agente. Questa è la sezione più importante per personalizzare l'agente per la tua azienda. **AI Studio:** L'interfaccia del portale Zoom in cui ZVA Receptionist viene creato, configurato e pubblicato. **centralinista automatico:** Il componente Zoom Phone che collega un numero di telefono In entrata al tuo ZVA Receptionist pubblicato.
#### **Risorse aggiuntive**
* **Passaggi di configurazione:** [Configurazione di Zoom Virtual Agent Receptionist](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0084960)
* **Analisi:** [Visualizzazione delle analisi di Virtual Agent](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0080984)
### **Configurazione di ZVA Receptionist**
A livello generale, la configurazione di ZVA Receptionist prevede cinque passaggi:
1. **Crea una Base di conoscenza:** Carica documenti o collega un sito web.
2. **Crea l'agente virtuale:** Scegli un percorso di configurazione, configura il saluto, la voce e la Guida dell'agente.
3. **Aggiungi competenze:** Definisci cosa può fare l'agente oltre a rispondere alle domande (Instradamento, Dial-by-Name, pianificazione).
4. **Configura le Impostazioni dell'agente vocale:** Perfeziona la temperatura, le parole riempitive e gli altri controlli comportamentali.
5. **Pubblica e Assegna:** Collega l'agente a un numero Zoom Phone tramite centralinista automatico.
{% stepper %}
{% step %}
**Crea una Base di conoscenza**
La tua Base di conoscenza è il fondamento di ZVA Receptionist. Fornisce le informazioni che l'agente usa per rispondere alle domande dei chiamanti. Due decisioni chiave definiscono la tua strategia per la Base di conoscenza.
**Precisione vs attualità: file o URL**
* **Scegli i file quando ti serve precisione:** Collega Zoom Canvas o carica PDF, documenti Word, fogli di calcolo o altri formati file supportati quando vuoi il pieno controllo su ciò che l'agente sa. I file sono ideali per policy, listini prezzi o procedure che cambiano di rado. L'agente fa riferimento solo a ciò che fornisci esplicitamente.
* **Scegli gli URL quando ti serve attualità:** Collega il tuo sito web, il Centro assistenza o la base di conoscenza quando i contenuti si aggiornano regolarmente. L'agente recupera automaticamente le informazioni più recenti, quindi non devi ricaricare i file ogni volta che qualcosa cambia. Gli URL sono ideali per cataloghi di prodotti, FAQ o offerte di servizi.
**Ampiezza versus profondità: copertura completa o competenza mirata**
Ti consigliamo di non tentare di caricare l'intero wiki aziendale al momento della distribuzione iniziale. Inizia con i 3-5 documenti che rispondono alle tue domande più comuni (ad esempio: orario lavorativo, politiche di reso, informazioni sulla Posizione). Dopo la tua prima settimana di chiamate, rivedi le trascrizioni delle conversazioni per identificare le lacune, quindi aggiungi contenuti in base ai modelli reali delle chiamate.
{% hint style="info" %}
**Nota**
ZVA può fornire Assistenza per molti documenti (oltre 100), documenti lunghi e siti web con migliaia di pagine di dettagli. La raccomandazione sopra riportata serve ad aiutare a mantenere il tuo Agente virtuale focalizzato sui casi di chiamata più comuni ed espandersi secondo necessità.==
{% endhint %}
{% endstep %}
{% step %}
**Crea il tuo Agente virtuale**
Una volta che la tua Knowledge Base è pronta, crea l'agente virtuale che interagirà con i chiamanti. Sono disponibili due percorsi di configurazione: la procedura guidata ZVA Receptionist per casi d'uso semplici e i modelli basati su istruzioni per configurazioni più complesse o specifiche per settore.
**Procedura guidata ZVA Receptionist**
La procedura guidata ti accompagna nella configurazione iniziale completa in un unico flusso di lavoro, inclusi:
* Selezione del saluto e della voce
* Knowledge Library (una o più sorgenti)
* Instradamento a Zoom Phone
* Trasferimento per nome (Dial-by-Name)
* Pianificazione con Zoom Scheduler
* Creazione di un nuovo centralinista automatico o Connessione a un centralinista automatico esistente
La procedura guidata è il punto di partenza consigliato. L'agente risultante può essere modificato e ulteriormente personalizzato al termine della procedura guidata.
**Modelli basati su istruzioni**
Questi modelli sono progettati per specifici casi d'uso Business e di settore, con integrazioni di strumenti sia Basic sia avanzate. Quando utilizzi un Modello basato su istruzioni, è meglio usare quelli con "Zoom Phone" nel nome e concentrarti sulle seguenti decisioni strategiche.
{% hint style="info" %}
**Nota**
Dopo aver creato l'Agente virtuale usando il Modello, dovrai collegarlo manualmente a un centralinista automatico oppure impostarlo come overflow da una coda delle chiamate, gruppo linea condivisa, utente, ecc.
{% endhint %}
**Selezione del modello e della voce:** Allinea il tuo modello alle aspettative dei chiamanti. I Clienti del retail si aspettano in genere interazioni rapide e cordiali; i chiamanti del Settore sanitario potrebbero aver bisogno di risposte più dettagliate e rassicuranti. Seleziona una voce che rifletta la personalità del tuo brand: calorosa e conversazionale per l'assistenza clienti, professionale ed efficiente per gli ambienti B2B.
**Progettazione del saluto:** Mantieni il saluto breve (meno di 10 secondi) e orientato all'azione. Dì chi sei e Invita immediatamente il chiamante a parlare. Evita menu lunghi o gergo aziendale. Esempio: "Grazie per aver chiamato Omzo Hardware. In che modo posso aiutarti oggi?"
**Guida dell'agente:** Questa sezione definisce la personalità, il tono, gli obiettivi e i limiti dell'agente. Descrivi il contesto della tua attività, imposta il tono e specifica quando passare a un operatore umano (ad esempio per problemi complessi, chiamanti frustrati o richieste al di fuori dell'ambito della Knowledge Base). I modelli forniscono solide proposte iniziali per ciascun componente; prevedi di dedicare molto tempo alla personalizzazione di questa sezione per le tue esigenze specifiche.
La sezione Guida dell'agente include i seguenti componenti:
* **Personalità:** Definisce come l'agente virtuale si rivolge ai chiamanti. L'agente è professionale o informale? Conversazionale o diretto?
* **Ambiente:** Descrive perché i Clienti stanno chiamando e cosa dovrebbe fare l'agente per aiutare. Un ambiente retail ha aspettative diverse da uno studio medico.
* **Tono:** Si abbina alla Personalità per descrivere il carattere dell'agente. L'agente dovrebbe evitare il gergo tecnico e fornire risposte brevi, oppure usare una terminologia precisa per un pubblico tecnico?
* **Obiettivo:** Delinea ciò che l'agente dovrebbe raggiungere in ogni chiamata. L'agente dovrebbe esaminare ogni sorgente disponibile della Knowledge Base e ogni competenza prima di passare a un operatore, oppure passare dopo uno o due tentativi?
* **Vincoli:** Definisce cosa l'agente deve e non deve fare. Ad esempio: richiedi la Verifica del chiamante prima di cercare ordini o appuntamenti.
{% endstep %}
{% step %}
**Aggiungi competenze**
Le competenze definiscono cosa può fare il tuo ZVA Receptionist oltre a rispondere alle domande della Knowledge Base. Di seguito sono illustrati i tre casi d'uso più comuni.
**Caso d'uso 1: Instradamento a Zoom Phone**
**Scopo:** Instrada i chiamanti verso la destinazione corretta in Zoom Phone.
Quando configuri l'inoltro chiamate, concentrati su tre decisioni chiave:
1. **Tipo di destinazione:** Scegli in base alle esigenze del chiamante e alla struttura del team. Instrada a una coda delle chiamate quando più agenti possono gestire la richiesta (Assistenza generale, richieste del Reparto vendite). Instrada a un utente per richieste specialistiche che richiedono una persona specifica. Usa il centralinista automatico per l'instradamento multilivello o la gestione fuori orario, e gruppo linea condivisa quando hai bisogno di squillo Simultaneo in tutto il team.
2. **Chiarezza del trigger:** Definisci condizioni precise che attivano ogni competenza di instradamento. Sii specifico sull'intento del chiamante: "vuole parlare con Fatturazione" è più chiaro di "ha una domanda". La precisione aiuta l'agente a distinguere tra richieste simili e a instradarle con precisione.
3. **Copertura di instradamento:** Pianifica per più scenari: orario lavorativo, fuori orario, esigenze specifiche del reparto e percorsi di escalation. Valuta di creare abilità di Instradamento separate per le ore di punta rispetto alle ore non lavorative, così che i chiamanti raggiungano la risorsa giusta.
{% hint style="info" %}
**Nota**
Inizia con 2 o 3 percorsi di Instradamento principali basati sui tipi di chiamata più comuni, poi amplia man mano che impari dai modelli di chiamata.
{% endhint %}
**Caso d'uso 2: rubrica con composizione per nome**
**Scopo:** Consenti ai chiamanti di pronunciare o sillabare un nome per raggiungere un utente specifico di Zoom Phone o un reparto.
Quando configuri l'Instradamento con composizione per nome, concentrati su tre decisioni chiave:
1. **Ambito della rubrica:** Includi solo ruoli a contatto con i clienti: rappresentanti del Reparto vendite, responsabili account, specialisti dell'Assistenza e responsabili di reparto che interagiscono regolarmente con chiamanti esterni. Escludi le posizioni solo interne (personale IT, addetti HR, operazioni di back office) per evitare instradamenti errati e proteggere i flussi di lavoro interni.
2. **Flessibilità di ricerca:** Decidi se i chiamanti possono cercare per nome, cognome o entrambi. I clienti esistenti potrebbero conoscere i nomi completi; i nuovi prospect potrebbero ricordare solo un nome di battesimo. Bilancia Accessibilità con la dimensione della rubrica per evitare confusione.
3. **Casi d'uso appropriati:** La composizione per nome funziona meglio quando i chiamanti hanno già una relazione con qualcuno della tua Organizzazione: clienti abituali che contattano il proprio referente account, clienti che fanno un follow-up con un consulente o prospect che si riconnettono con un addetto del Reparto vendite. È meno efficace per i chiamanti al primo contatto che non conoscono nessuno per nome.
{% hint style="info" %}
**Nota**
Inizia con una rubrica mirata di 10-15 membri chiave del team a contatto con i clienti. Espandi gradualmente in base ai modelli di chiamata e al feedback.
{% endhint %}
**Caso d'uso 3: pianificazione degli appuntamenti con Zoom Scheduler**
**Scopo:** Consenti ai chiamanti di prenotare appuntamenti direttamente tramite Zoom Scheduler.
Quando configuri la pianificazione degli appuntamenti, concentrati su tre decisioni chiave:
1. **Candidati all'automazione:** Identifica quali tipi di appuntamento consumano più tempo del personale tramite pianificazione manuale. I candidati di maggior valore includono consulenze di routine (demo del Reparto vendite, chiamate di Onboarding), appuntamenti di servizio (visite di manutenzione, sessioni di Assistenza) e prenotazioni ricorrenti (check-in settimanali, riunioni di follow-up). Automatizza prima questi per liberare il tuo team per interazioni complesse che richiedono giudizio umano.
2. **Strategia dei link di Scheduler:** Scegli tra link di team condivisi e link individuali in base all'erogazione del servizio. Usa i link di Scheduler di qualsiasi organizzatore quando qualsiasi membro qualificato del team può gestire l'appuntamento (consulenze iniziali, demo di prodotto, assistenza generale). Usa i link di Scheduler One to One quando la continuità è importante: relazioni con clienti esistenti, esigenze di competenze specialistiche o appuntamenti di follow-up con lo stesso rappresentante.
3. **Chiarezza del trigger:** Definisci condizioni precise che attivano la pianificazione. Sii specifico sull'intento del chiamante e sul tipo di appuntamento: "vuole prenotare una demo di prodotto" o "ha bisogno di un appuntamento di servizio" invece di frasi generiche come "vuole pianificare qualcosa". Questo aiuta l'agente a distinguere tra i tipi di appuntamento e a indirizzare al link corretto di Zoom Scheduler.
{% hint style="info" %}
**Nota**
Inizia automatizzando i tipi di appuntamento con il volume più alto e la complessità più bassa (consulenze iniziali, visite di servizio standard). Espandi agli appuntamenti specializzati una volta convalidato il flusso di lavoro.
{% endhint %}
{% endstep %}
{% step %}
**Configura le Impostazioni dell'agente vocale**
Oltre alla configurazione di base, ZVA Receptionist include Impostazioni avanzate che controllano come il tuo agente virtuale suona e si comporta durante le chiamate. Considerale come manopole di personalità: regolarle cambia il modo in cui l'agente parla, risponde e gestisce l'incertezza. Le due impostazioni configurate più spesso sono descritte di seguito.
**Controllo della temperatura**
**Cosa fa:** Controlla quanto siano creative o prevedibili le risposte dell'agente.
* **Temperatura più bassa (0,0-0,5):** Risposte più prevedibili e coerenti. L'agente rimane strettamente allineato ai contenuti della tua Knowledge Base e usa una formulazione simile ogni volta.
* **Temperatura più alta (0,6-1,0):** Risposte più varie e dal suono naturale. L'agente parafrasa e adatta il proprio linguaggio con maggiore libertà.
**Quando regolarlo:**
* **Usa una temperatura più bassa** per settori sensibili alla conformità (Settore sanitario, Finanza, legale) in cui coerenza e accuratezza sono fondamentali.
* **Usa una temperatura più alta** per scenari di servizio clienti in cui la varietà conversazionale mantiene le interazioni naturali.
* **Impostazione predefinita (0,5)** funziona bene per la maggior parte delle aziende, bilanciando accuratezza e conversazione naturale.
{% hint style="info" %}
**Nota**
Esempio: uno studio medico potrebbe usare 0,3 in modo che le policy sugli appuntamenti siano espresse come scritte. Un negozio al dettaglio potrebbe usare 0,7 per far sembrare i consigli sui prodotti più conversazionali.
{% endhint %}
**Parole e frasi di riempimento**
**Cosa fa:** Aggiunge schemi di parlato naturali come "ehm", "vediamo", o "un momento" mentre l'agente elabora le informazioni.
**Perché è importante:** Queste brevi pause fanno sembrare l'agente più umano e danno a chi chiama un momento per elaborare ciò che ha sentito. Senza di esse, le risposte a raffica possono sembrare robotiche o opprimenti.
**Quando abilitarlo o disabilitarlo:**
* **Abilita** per ruoli a contatto con i clienti in cui conta un tono amichevole e colloquiale: Reparto vendite, Assistenza e richieste generali.
* **Disabilita** per scenari orientati all'efficienza in cui chi chiama dà più valore alla velocità che alla cordialità, come i controlli dello stato degli ordini o le consultazioni dell'account.
* **Provali entrambi:** Chiama il tuo agente con questa impostazione attiva e disattiva per sentire la differenza. Alcune aziende trovano che le parole riempitive rendano l'agente più accessibile; altre preferiscono la schiettezza di un linguaggio senza riempitivi.
{% endstep %}
{% step %}
**Pubblica e Assegna a un Numero di Telefono**
Una volta configurato, pubblica il tuo ZVA Receptionist e collegalo al tuo sistema telefonico Zoom Phone. La pubblicazione è un passaggio in due fasi: attiva l'agente in AI Studio, quindi collegalo a un numero di telefono tramite un centralinista automatico di Zoom Phone.
**Pubblicazione dell'agente**
1. In AI Studio, vai alla configurazione del tuo ZVA Receptionist.
2. Rivedi la configurazione, quindi fai clic su Pubblica.
{% hint style="info" %}
**Nota**
Le modifiche apportate in AI Studio non hanno effetto finché non fai clic su Pubblica. Se il tuo agente non risponde come previsto dopo aver apportato modifiche, verifica che sia stata pubblicata la versione più recente.
{% endhint %}
**Assegnazione a un Numero di Zoom Phone**
1. Nel Zoom web portal, vai a Gestione del sistema telefonico.
2. Seleziona il centralinista automatico che vuoi collegare all'agente.
3. Nelle Impostazioni del centralinista automatico, seleziona la tua sede e il Virtual Agent corretto.
4. Conferma che al centralinista automatico sia assegnato un numero di telefono. L'agente virtuale non riceverà chiamate finché non viene assegnato esplicitamente un numero di telefono.
{% endstep %}
{% endstepper %}
### **Test e ottimizzazione**
#### **Test del tuo agente virtuale**
Testa a fondo il tuo ZVA Receptionist dopo la pubblicazione per confermare che gestisca le chiamate come previsto prima che i clienti lo incontrino. Usa il seguente approccio:
1. **Chiama il numero assegnato:** Usa il numero di telefono collegato al tuo centralinista automatico e interagisci con l'agente come farebbe un vero chiamante.
2. **Testa ogni caso d'uso:** Verifica che ogni competenza configurata funzioni correttamente: poni domande dalla tua Knowledge Base, richiedi l'Instradamento verso reparti o utenti diversi, prova il Dial-by-Name con vari formati di nome e cerca di Pianificare un appuntamento.
3. **Testa i casi limite:** Prova scenari che potrebbero confondere l'agente: domande non coperte dalla tua Knowledge Base, richieste di Instradamento verso utenti o reparti non disponibili, linguaggio poco chiaro o ambiguo e interruzioni dell'agente a metà risposta.
4. **Esamina i dettagli della conversazione:** Dopo ogni chiamata di test, analizza l'interazione in AI Studio per capire come si è comportato l'agente.
#### **Analisi dei dettagli della conversazione**
AI Studio offre informazioni dettagliate su ogni chiamata gestita dal tuo agente virtuale. Accedi ai dettagli della conversazione andando in AI Studio, selezionando il tuo ZVA Receptionist e aprendo la scheda Trascrizione. Seleziona qualsiasi chiamata da analizzare. Quando esamini una conversazione, concentrati su tre aree chiave:
* **Ciò che voleva il chiamante:** Riconoscimento dell'intento e punteggi di confidenza
* **Come ha risposto l'agente:** trascrizione e query della Knowledge Base
* **Dove è andata la chiamata:** Azioni di Instradamento e risultati
Usa i dettagli della conversazione per identificare schemi e opportunità di miglioramento:
* **Identifica le lacune di conoscenza:** Cerca le domande a cui l'agente non ha saputo rispondere. Se più chiamanti chiedono «Offrite finanziamenti?» ma l'agente dice di non avere queste informazioni, aggiungi una FAQ sui finanziamenti alla tua Knowledge Base.
* **Affina il riconoscimento dell'intento:** Se chi chiama dice «Ho bisogno di aiuto con la mia bolletta», ma l'agente instrada verso l'Assistenza generale invece che verso la Fatturazione, aggiorna il trigger della competenza di Instradamento per includere frasi come «bolletta», «fattura» e «pagamento».
* **Migliora la qualità delle risposte:** Se chi chiama chiede spesso «Cosa significa?» dopo la risposta dell'agente, la risposta potrebbe essere troppo tecnica. Semplifica i contenuti della Knowledge Base o aggiungi esempi.
* **Traccia gli schemi di escalation:** Se più chiamanti richiedono l'escalation quando chiedono informazioni su un argomento specifico, aggiungi una sezione dedicata alla tua Knowledge Base con dettagli chiari su quell'argomento.
{% hint style="info" %}
**Nota**
Rivedi almeno da 10 a 20 conversazioni della tua prima settimana di distribuzione. Questa dimensione del campione ti aiuta a identificare i problemi comuni rispetto ai casi limite isolati.
{% endhint %}
#### **Best practice per l’ottimizzazione continua**
I test non sono un’attività una tantum. Affina continuamente il tuo agente virtuale in base alle prestazioni nel mondo reale:
* Mantieni i saluti brevi e cordiali: meno di 10 secondi è l’ideale.
* Rivedi settimanalmente le trascrizioni delle chiamate in AI Studio per identificare i problemi ricorrenti.
* Aggiorna regolarmente i documenti della Knowledge Base man mano che il tuo Business cambia.
* Affina la Guida dell’agente in base ai malintesi comuni o ai pattern di escalation.
* Usa le analisi per monitorare i tassi di deviazione delle chiamate, il tempo medio di gestione e la soddisfazione del cliente.
* Esegui i test dopo ogni modifica importante: nuove skill, contenuti aggiornati della Knowledge Base o logica di Instradamento modificata.
#### **Metriche chiave da monitorare**
| Metrica | Descrizione |
| ---------------------------------------------- | -------------------------------------------------------------------------------- |
| Tasso di contenimento | Percentuale di chiamate risolte senza trasferimento a un operatore umano |
| Durata media della chiamata | Per quanto tempo i chiamanti interagiscono con l’agente |
| Precisione del riconoscimento delle intenzioni | Con quale frequenza l’agente identifica correttamente le richieste dei chiamanti |
| Tasso di riscontro nella Knowledge Base | Percentuale di domande a cui si risponde dalla Knowledge Base |
| Tasso di escalation | Con quale frequenza i chiamanti richiedono o necessitano assistenza umana |
Per maggiori dettagli, vedi [Visualizzazione delle analisi di Virtual Agent](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0080984).
### **Risoluzione dei problemi e FAQ**
#### **Il mio agente virtuale non risponde alle chiamate**
Conferma che l’agente sia stato pubblicato in AI Studio e che sia mostrato come Attiva. Verifica che un numero di telefono sia assegnato esplicitamente al centralinista automatico collegato all’agente. Controlla che il test venga eseguito durante l’orario lavorativo configurato, se sono presenti restrizioni di orario lavorativo. Vai in Gestione del sistema telefonico, quindi nei Registri, per tracciare il percorso completo della chiamata e confermare se la chiamata ha raggiunto il centralinista automatico.
#### **Ho pubblicato le modifiche, ma l’agente continua a non rispondere come previsto**
Le modifiche in AI Studio non diventano effettive finché non fai clic su Pubblica. Apri l’agente in AI Studio e conferma che la versione corrente rifletta le tue modifiche, quindi pubblica di nuovo. Dopo la pubblicazione, attendi qualche minuto prima di testare.
#### **I chiamanti segnalano che le chiamate vengono instradate verso la destinazione sbagliata**
Apri la configurazione dell’agente in AI Studio e rivedi i trigger della skill di Instradamento. Verifica che il linguaggio dei trigger sia abbastanza specifico da distinguere tra diversi percorsi di Instradamento. Controlla le Impostazioni del centralinista automatico per confermare che siano selezionati la sede e l’agente virtuale corretti. Rivedi le trascrizioni delle chiamate recenti in AI Studio per determinare se il problema di Instradamento è dovuto a una mancata corrispondenza del trigger o a un problema di configurazione.
#### **Il mio agente fornisce risposte generiche invece di usare la mia Knowledge Base**
Aggiungi un guardrail nella sezione Guida dell’agente. Ad esempio: «Non fornire raccomandazioni generiche alle richieste dei clienti. Fornisci solo dettagli esplicitamente contenuti nella Knowledge Base». Dopo aver aggiunto il guardrail, pubblica l’agente aggiornato e prova di nuovo.
#### **I chiamanti non riescono a trovare qualcuno usando la composizione per nome**
Conferma che l’utente di destinazione sia incluso nella configurazione della skill Dial-by-Name. Verifica che le Impostazioni di flessibilità della ricerca corrispondano al formato del nome che i chiamanti probabilmente useranno (solo nome, solo cognome o nome completo). Prova la skill chiamando il numero e cercando di raggiungere un utente per nome usando formati diversi.
#### **L’agente virtuale non esegue correttamente la pianificazione degli appuntamenti**
Verifica che i link di Zoom Scheduler configurati nella skill di pianificazione siano corretti e segnati come Attiva. Conferma che il linguaggio del trigger della skill sia sufficientemente specifico da corrispondere al modo in cui il chiamante formula la richiesta. Prova chiamando il numero e cercando di pianificare ogni tipo di appuntamento. Rivedi le trascrizioni delle conversazioni per vedere se l’agente riconosce l’intento di pianificazione ma non riesce a completare la prenotazione, oppure se il riconoscimento dell’intento non attiva affatto la skill.
#### **L’agente non può rispondere alle domande presenti nella mia Knowledge Base**
Rivedi la fonte della Knowledge Base in AI Studio per confermare che i contenuti siano aggiornati. Se hai usato caricamenti di file, verifica che il file sia stato elaborato correttamente e che il contenuto rilevante sia incluso. Se hai usato un URL, conferma che l’URL sia ancora accessibile e che il contenuto della pagina non sia cambiato in modo significativo. Valuta di caricare un documento FAQ mirato che risponda direttamente alle domande più comuni.
#### **I chiamanti dicono spesso di non capire le risposte dell’agente**
Rivedi le trascrizioni delle conversazioni per identificare quali risposte causano confusione. Semplifica il contenuto della Knowledge Base per quegli argomenti: usa frasi più brevi, linguaggio semplice ed esempi concreti. Se l’agente sta leggendo documentazione complessa, valuta di creare un documento FAQ separato con un linguaggio adatto ai chiamanti e aggiungerlo come fonte della Knowledge Base.
#### **Molti chiamanti stanno escalando su un argomento specifico**
Aggiungi una sezione dedicata alla tua Knowledge Base che tratti quell’argomento in dettaglio. Se l’escalation avviene perché l’agente non può completare l’attività (non solo perché il chiamante preferisce parlare con una persona), verifica se è necessario aggiungere o riconfigurare una skill. Aggiorna la Guida dell’agente per chiarire quando l’escalation è appropriata per quello scenario.
#### **Il riconoscimento delle intenzioni dell’agente non corrisponde a ciò che dicono i chiamanti**
Aggiorna le descrizioni dei trigger della skill di Instradamento o di pianificazione per includere le frasi specifiche, i sinonimi e le varianti che i tuoi chiamanti usano davvero. Rivedi le trascrizioni delle conversazioni per identificare il linguaggio esatto che i chiamanti stanno usando e incorpora quelle frasi nelle descrizioni dei trigger. Se i chiamanti usano costantemente un linguaggio informale, modifica il trigger di conseguenza.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://library.zoom.com/technical-library/it/zoom-workplace/zoom-phone/expert-insights/zoom-virtual-agent-receptionist-start-guide.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.