> 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/servizi-business/zoom-virtual-agent/zoom-virtual-agent-explainer.md).

# Spiegazione di Zoom Virtual Agent

Esplora l'architettura, la configurazione, le integrazioni, il comportamento e le analisi di Zoom Virtual Agent per voce e chat.

### Panoramica

Questa sezione offre una panoramica e un'introduzione alla prossima generazione di Zoom Virtual Voice and Chat Agent (ZVA).

#### <mark style="color:blu;">L'IA agentica consente a Zoom Virtual Agent di passare da un'Assistenza reattiva a flussi di lavoro autonomi configurabili tramite un'elaborazione conversazionale intelligente</mark>

Zoom Virtual Agent ora opera con la capacità di ragionare sui problemi, mantenere il contesto all'interno della sessione corrente e intraprendere azioni indipendenti per risolvere i problemi dei clienti senza input manuale.

#### <mark style="color:blu;">Gli agenti virtuali possono interpretare il contesto, adattarsi dinamicamente e completare attività end-to-end</mark>

Zoom Virtual Agent va oltre le risposte statiche e predefinite adattandosi dinamicamente alle esigenze degli utenti, automatizzando i flussi di lavoro e gestendo richieste complesse dall'inizio alla fine su voce e chat.

#### <mark style="color:blu;">Le esperienze conversazionali sono unificate tra canali, sistemi e reparti</mark>

Questa nuova generazione di Zoom Virtual Agent si integra con Zoom centro di contatto, Zoom Phone, strumenti di qualità e analisi selezionati e fonti di dati Enterprise per migliorare continuamente e offrire interazioni di Assistenza di alta qualità.

#### <mark style="color:blu;">Le Integrazioni di terze parti offrono flessibilità a livello Enterprise dentro e fuori dall'ecosistema Zoom</mark>

Zoom Virtual Agent include Integrazioni predefinite con le principali piattaforme di Customer Relationship Management (CRM) e centro di contatto come Salesforce, ServiceNow, Genesys e Amazon Connect, consentendo ai Clienti di connettere i propri sistemi back-end esistenti e unificare le operazioni di Assistenza in tutta l'Enterprise.

### Concetti fondamentali dell'IA agentica per voce e chat

Le sezioni seguenti illustrano i concetti fondamentali di Zoom Virtual Agent di nuova generazione sia per la voce sia per la chat.

#### <mark style="color:blu;">Ogni agente vocale agentico e chatbot ha un'identità unica progettata per assistere un pubblico specifico con domande, problemi o dubbi</mark>

I componenti descritti di seguito si basano su un servizio AI Runtime proprietario e sulla relativa infrastruttura di supporto, ciascuno dei quali svolge un ruolo distinto nell'abilitare interazioni conversazionali intelligenti, automatizzate e consapevoli del contesto.

#### <mark style="color:blu;">Componenti fondamentali dell'Agente vocale</mark>

<div data-with-frame="true"><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2FlKJVeyvdypF2H1XBHhbl%2Funknown.png?alt=media&amp;token=47f425de-2763-4a04-bc20-1e938f3e77c2" alt=""></div>

Questa sezione illustra i componenti fondamentali che abilitano il comportamento intelligente e automatizzato della nuova generazione di Zoom Virtual Agent quando viene distribuito in un ambiente vocale. Come l'agente chat, il sistema è incentrato sull'AI Runtime Service e sui suoi componenti interconnessi, che insieme consentono il processo decisionale agentico, l'elaborazione del linguaggio e l'esecuzione delle azioni su tutti i canali digitali.

**Un AI Runtime Service orchestra ragionamento, memoria e azione in tutto il sistema**

L'AI Runtime Service è il livello centrale di orchestrazione di Zoom Virtual Agent. Gestisce:

* **Interpretariato dell'input**: Riceve l'input vocale dell'utente, lo elabora tramite speech-to-text e determina l'intento.
* **Decisione**: Applica la logica di business e le regole di Instradamento per decidere l'azione successiva migliore.
* **Gestione delle Integrazioni**: Coordina sistemi di conoscenza, strumenti e modelli per comporre risposte o avviare flussi di lavoro.
* **Comportamenti agentici**: Supporta l'esecuzione automatizzata delle attività, il tracciamento del contesto e l'adattabilità conversazionale senza richiedere supervisione umana.

Il backend di runtime include controlli chiave della conversazione come il rilevamento della fine del turno, il rilevamento dell'intervento, la generazione di risposte di riempimento e le barriere di gestione degli errori.

Il framework vocale migliora continuamente il comportamento di questi controlli nelle conversazioni live. I recenti miglioramenti rendono le conversazioni più reattive e meglio cadenzate, e rendono i passaggi di consegne più affidabili: l'agente si riaggancia in modo più intelligente quando chi chiama tace, scandisce le risposte per evitare tempi morti e completa i trasferimenti agli agenti live in modo pulito anche quando chi chiama continua a parlare. Questi miglioramenti si applicano automaticamente a ogni agente ZVA e non richiedono alcuna configurazione admin.

**Il framework Worker-Talker consente l'elaborazione parallela durante le interazioni vocali**

Gli agenti vocali tradizionali devono mettere in pausa le conversazioni per eseguire attività di backend, creando ritardi. L'architettura Worker-Talker separa queste responsabilità.

L'agente Talker mantiene una conversazione continua con l'utente finale. L'agente Worker esegue in parallelo operazioni di backend, come chiamate agli strumenti, recuperi di dati e attività di ragionamento. Sia l'agente Talker sia l'agente Worker accedono a un contesto unificato, inclusi la cronologia della conversazione, le variabili del cliente e gli aggiornamenti in tempo reale. Il Worker trasmette risultati parziali al Talker, così la conversazione continua durante le attività in background.

Gli amministratori non configurano direttamente la suddivisione Worker-Talker. Essa opera all'interno dell'AI Runtime Service. Questo significa che Skills e Tools che coinvolgono chiamate API a lunga durata non causeranno pause della conversazione né timeout.

**I sistemi di Knowledge Base consentono domande e risposte con recupero aumentato**

La nuova generazione di Zoom Virtual Agent utilizza la Generazione aumentata dal recupero (RAG) per migliorare l'accuratezza fattuale delle sue risposte:

* **Accesso alle conoscenze Enterprise**: Si connette a repository di dati strutturati e non strutturati, come i centri assistenza o la documentazione interna.
* **Recupero dinamico**: Durante le conversazioni, l'agente recupera frammenti di conoscenza pertinenti per rispondere a domande fattuali o basate su policy.
* **Scalabilità**: I sistemi di Knowledge Base possono scalare su più marchi, linee di prodotto o segmenti di Clienti con un controllo granulare.

Gli admin possono configurare i connettori di conoscenza e gestire l'indicizzazione dei documenti tramite il portale amministratori di Zoom Virtual Agent.

**LLM Gateway facilita l'accesso all'intelligenza dei modelli linguistici di grandi dimensioni**

Questo componente consente a Zoom Virtual Agent di:

* **Inviare prompt** a modelli esterni o interni in base alle espressioni dell'utente.
* **Ricevere completamenti generati** che aiutano con la comprensione linguistica complessa, il ragionamento multi-turno e il dialogo aperto.
* **Disaccoppiare la logica di orchestrazione** da modelli specifici, consentendo flessibilità e gestione dei modelli.

Il gateway fornisce un'interfaccia standardizzata per l'Instradamento delle richieste, supportando sia i modelli ospitati da Zoom sia quelli di terze parti.

**Il Text-to-Speech di terze parti consente una resa naturale e conversazionale**

Una volta che AI Runtime compone una risposta basata sul testo, tale risposta viene inviata a un motore di sintesi vocale per il rendering audio. Questo sistema:

* **Converte il testo in voce in tempo reale** per supportare conversazioni in tempo reale.
* **Consente la selezione di voci personalizzate** per rispecchiare la personalità del brand o le esigenze di Accessibilità.
* **Supporta l'output multilingue** per migliorare l'usabilità nelle implementazioni globali.

Le Integrazioni con i principali provider consentono flessibilità nella qualità della voce, nelle lingue e nelle opzioni di implementazione.

Anche l'infrastruttura text-to-speech dell'agente vocale include monitoraggio e ripristino automatici del failover. Il sistema monitora continuamente la latenza e i tassi di errore tra i provider TTS e passa automaticamente a un provider di backup se il servizio primario presenta guasti. Una volta che il provider primario si riprende, il sistema torna automaticamente al precedente. Questo processo funziona senza configurazione dell'amministratore.

**Zoom Skills and Tools e gli Strumenti di terze parti estendono la capacità del sistema di intraprendere azioni**

Zoom Virtual Agent di nuova generazione va oltre il semplice rispondere alle domande, consentendo il completamento delle attività:

* **Zoom Skills and Tools**: Integrazioni native con l'ecosistema Zoom (ad es. Zoom centro di contatto, Zoom Scheduler, Zoom Revenue Accelerator) per azioni come escalation, prenotazione o tagging per l'analisi.
* **Strumenti di terze parti**: Estendono la funzionalità oltre Zoom tramite Integrazioni con sistemi e applicazioni esterni. I Clienti possono scegliere tra:
  * **Strumenti di terze parti predefiniti sviluppati da Zoom**: Disponibile per configurazioni rapide.
  * **Strumenti di terze parti personalizzati creati dagli sviluppatori dei Clienti usando AI Studio**: Offrono maggiore flessibilità e integrazioni su misura con CRM, IT Service Management (ITSM), ticketing o altre piattaforme aziendali.

Questi strumenti consentono all'agente virtuale di eseguire processi aziendali reali senza trasferire la conversazione a un agente umano.

#### <mark style="color:blu;">Componenti principali dell'agente Chat</mark>

<div data-with-frame="true"><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2F08VkWHgV3U7KGjmuj1U0%2Funknown.png?alt=media&amp;token=4ee83542-5b06-4b0f-8e71-0ae118543954" alt=""></div>

Questa sezione illustra i componenti fondamentali che consentono il comportamento intelligente e automatizzato del Zoom Virtual Agent di nuova generazione quando viene implementato in un ambiente basato su chat. Come per l'agente vocale, il sistema è incentrato su AI Runtime Service e sui suoi componenti interconnessi, che nel complesso consentono il processo decisionale agentico, l'elaborazione del linguaggio e l'esecuzione delle azioni su tutti i canali digitali.

**AI Runtime Service governa l'intero ciclo di vita delle interazioni digitali**

AI Runtime Service coordina le decisioni, l'accesso ai dati e le integrazioni con gli strumenti necessari per alimentare interazioni di chat intelligenti. Esegue:

* **Interpretariato dell'input**: Analisi dei messaggi e riconoscimento dell'intento dagli input della chat.
* **Decisione**: Esecuzione della logica di business per guidare l'adempimento delle attività, i flussi condizionali o l'escalation.
* **Gestione delle Integrazioni**: Integrazione con fonti di conoscenza e strumenti per supportare conversazioni ricche e reattive.
* **Comportamenti agentici**: Supporta l'esecuzione automatizzata delle attività, il tracciamento del contesto e l'adattabilità conversazionale senza richiedere supervisione umana.

Il servizio gestisce inoltre il tracciamento del contesto, il ripristino dagli errori, il ritmo della conversazione e le strategie di fallback per offrire esperienze resilienti.

AI Runtime Service sfrutta inoltre l'elaborazione parallela per le operazioni vocali back-end. Vedi la [Componenti fondamentali dell'Agente vocale](#core-components-of-the-voice-agent) sezione per maggiori dettagli.

**I sistemi di Knowledge Base consentono domande e risposte con recupero aumentato**

Durante le interazioni in chat, il Zoom Virtual Agent di nuova generazione può:

* **Interroga** i repository di conoscenza aziendali in tempo reale in base ai messaggi dell'utente.
* **Recupera** gli estratti più pertinenti utilizzando corrispondenze semantiche o basate su parole chiave.
* **Genera** risposte contestuali utilizzando le informazioni recuperate e LLM Gateway.

Questo approccio migliora l'accuratezza, così le risposte si basano su contenuti approvati dall'azienda.

**LLM Gateway supporta l'elaborazione dinamica del linguaggio naturale e la generazione delle risposte**

LLM Gateway funge da livello di astrazione tra AI Runtime Service e i modelli linguistici di grandi dimensioni connessi. Consente al runtime di:

* **Instradare** i prompt verso più LLM per capacità di ragionamento flessibili.
* **Accedere** ai risultati del modello per interpretare domande complesse, riassumere articoli o generare risposte composte da più frasi.
* **Passare a un altro provider o eseguire un upgrade** dei provider del modello senza modificare la logica di orchestrazione.

Questa struttura consente un uso sicuro e scalabile dell'IA generativa nei flussi di lavoro aziendali.

**Gli LLM di terze parti offrono modelli linguistici diversificati e opzioni di personalizzazione**

Attraverso LLM Gateway, le organizzazioni possono:

* **Seleziona modelli** ottimizzati per il loro dominio o caso d'uso (ad es., assistenza, HR, Onboarding del prodotto).
* **Controlla la latenza** e i compromessi tra costi e prestazioni abbinando i modelli agli intenti o ai segmenti di traffico.
* **Scegli i provider** in base ai requisiti organizzativi e alle opzioni di residenza dati disponibili.

Queste integrazioni supportano un ecosistema plug-and-play per strategie di IA in evoluzione.

**Zoom Skills, Tools e strumenti di terze parti consentono azioni in tempo reale ed esecuzione dei flussi di lavoro**

Lo Zoom Virtual Agent di nuova generazione fa molto più che rispondere: agisce in tempo reale tramite integrazioni quasi perfette:

* **Zoom Skills and Tools**: Le integrazioni native con l’ecosistema Zoom (ad es., Zoom Scheduler, Zoom centro di contatto) consentono all’agente di instradare gli utenti, prenotare riunioni, escalare le interazioni o taggare automaticamente il feedback.
* **Strumenti di terze parti**: Estendi l’automazione oltre Zoom collegandoti a sistemi e applicazioni esterni. Questi includono:
  * **Strumenti di terze parti predefiniti sviluppati da Zoom**: abilitato con un solo clic per un’attivazione rapida e risultati più veloci.
  * **Strumenti di terze parti personalizzati creati dagli sviluppatori dei Clienti usando AI Studio**: Offre una personalizzazione più approfondita e integrazioni flessibili con CRM, ITSM, ticketing o altre piattaforme Enterprise.

Ciò consente alle organizzazioni di risolvere rapidamente le esigenze dei clienti, senza escalation.

**Engagement Runtime Service gestisce l’erogazione dell’esperienza e il coordinamento del sistema**

Nel flusso dell’agente chat, Engagement Runtime Service gestisce:

* **Gestione dello stato della sessione** per mantenere il contesto tra i turni.
* **Generazione e registrazione della trascrizione**, che vengono inoltrati allo storage dei file.
* **Hook di test e strumenti di admin** per la convalida del flusso della conversazione.

Aiuta l’agente virtuale a operare in modo affidabile, coerente e con una traccia verificabile negli ambienti live.

**La chat basata sul web offre accesso flessibile a Zoom Virtual Agent**

I proprietari dell’account e gli admin possono abilitare un’esperienza di chat immersiva su dispositivi desktop e tablet.

* **Le finestre si aprono centrate sullo schermo**, mantenendo gli utenti concentrati sulla loro conversazione.
* **L’interazione in background può essere disabilitata** da un admin per ridurre le uscite accidentali.

**Una porta d’ingresso digitale offre alle campagne una schermata di benvenuto brandizzata**

I proprietari dell’account e gli amministratori possono configurare una schermata di benvenuto brandizzata per le campagne di Zoom Virtual Agent, offrendo ai consumatori un punto di ingresso strutturato e professionale prima che abbia inizio un’interazione. La schermata di benvenuto si incorpora nel sito web di un brand tramite un’interfaccia no-code e supporta gli agenti chat. Gli amministratori controllano l’immagine di branding della schermata, il testo dell’annuncio, la descrizione, gli orari di apertura, i campi di input del modulo e le risorse secondarie come un link alle Condizioni d’uso.

**Gli agenti virtuali multimodali possono elaborare immagini e documenti caricati nelle conversazioni di chat**

I proprietari dell’account e gli amministratori possono abilitare gli agenti chat a elaborare immagini e documenti caricati nelle conversazioni di chat. Gli agenti vocali possono persino ricevere caricamenti di file tramite SMS durante la chiamata. Virtual Agent estrae testo da screenshot e file nei formati JPEG, PNG, HEIC, WEBP e PDF. I clienti possono caricare ricevute, schermate di errore, etichette con numeri di serie e altri documenti invece di digitare manualmente le informazioni.

Il sistema presenta riepiloghi delle informazioni estratte e chiede conferma al cliente prima di procedere. Quando l’estrazione del testo non è chiara o è incompleta, l’agente fornisce domande di chiarimento per verificare l’accuratezza. È importante sottolineare che ciò significa che l’agente non estrae e agisce sul contenuto in modo silenzioso. Invece, prima di procedere, lo conferma con il cliente.

Durante le interazioni con un cliente, Zoom Voice Agent può creare e inviare un link di caricamento file tramite SMS per il caricamento degli allegati. I link di caricamento sono attivi solo durante la chiamata e scadono automaticamente quando l’interazione termina. Tutti gli allegati caricati vengono ricondotti all’interazione e compaiono nelle trascrizioni e nelle analisi.

Zoom Virtual Agent include anche guardrail dei contenuti che rilevano immagini inappropriate e generate dall’IA caricate durante le conversazioni. Il sistema analizza i caricamenti in tempo reale e risponde con messaggi predefiniti quando viene identificato contenuto soggetto a restrizioni. Se qualcuno carica ripetutamente materiale inappropriato, tali violazioni attivano automaticamente l’escalation a un agente umano. Questi guardrail dei contenuti sono abilitati per impostazione predefinita e non richiedono configurazione da parte dell’admin.

{% hint style="info" %}
Questa funzionalità richiede l’attivazione da parte di Zoom. Contatta il tuo team account Zoom per abilitare questa funzionalità. Inoltre, gli admin dovrebbero confermare i requisiti di conformità per la gestione dei dati relativi ai caricamenti di immagini nel loro ambiente.
{% endhint %}

#### <mark style="color:blu;">Agent Guidance è l’identità fondamentale di un agente, e definisce il suo tono, il suo scopo e le sue capacità</mark>

La funzionalità Agent Guidance in Zoom Virtual Agent definisce un’identità impostandone tono, scopo, capacità e limiti operativi. Gli amministratori possono creare guidance utilizzando modelli predefiniti specifici per settore, che semplificano e accelerano la stesura di guidance personalizzate per altri casi d’uso.

Ad esempio, se un admin configura Agent Guidance con un tono caldo e conversazionale, risponderà agli utenti con un linguaggio comprensibile. Se è configurato con una guidance rigorosa e fattuale, risponderà in modo freddo e diretto.

Per configurare Agent Guidance, gli amministratori specificano il ruolo dell’agente, definiscono le attività che dovrebbe svolgere e revisionano gli scenari supportati e non supportati. Zoom AI genera una bozza iniziale che può essere perfezionata per soddisfare i tuoi requisiti unici. La funzione integrata **Prompt Assistant** aiuta a semplificare questo processo consentendo agli utenti di tutti i livelli di esperienza di ottimizzare e rifinire i prompt. Ciò offre guidance chiare ed efficaci per ogni agente.

Sebbene guidance stabilisca il comportamento di alto livello, l’efficacia dell’agente dipende dall’allineamento con la sua knowledge base e le sue competenze.

**Agent Architect crea un agente completo a partire da una descrizione in linguaggio semplice**

Il nuovo e migliorato Agent Architect consente ai proprietari dell’account e agli admin di creare un Zoom Virtual Agent pienamente funzionante descrivendo ciò di cui hanno bisogno in linguaggio semplice. Gli admin inseriscono i propri requisiti nel prompt e Agent Architect genera un insieme strutturato di istruzioni per l’agente senza richiedere un modello o una configurazione manuale.

Un gruppo laterale destro mantiene trasparente ogni decisione generata: competenze consigliate, una voce suggerita con il ragionamento che la motiva, strumenti inferiti insieme al loro stato di configurazione, variabili rilevate e domande di chiarimento emerse dal brief. Gli admin continuano a modellare l’agente tramite una barra laterale persistente, e le istruzioni di follow-up rifiniscono la bozza sul posto senza riavviare il flusso. Le bozze sono testabili immediatamente — anche quando alcuni strumenti non sono ancora completamente configurati — così gli admin possono convalidare la struttura dell’agente prima di collegare ogni integrazione a valle.

**Miglioramenti di Agent Architect**

L’esperienza di miglioramento dell’agente in Agent Architect include tre upgrade:

* **Elaborazione visibile ed esecuzione degli strumenti**: Gli aggiornamenti di elaborazione e le operazioni degli strumenti sono visibili durante il turno attivo. Ogni strumento appare come un elemento singolo con un nome leggibile, passa da **In esecuzione** a **Completato**, e viene visualizzato in ordine di esecuzione. Le catene di pensiero grezze e i risultati degli strumenti rimangono nascosti per progettazione.
* **Copertura completa degli strumenti conversazionali per Receptionist**: SMS In uscita, Transfer by Name e Pianificazione sono configurabili in modo conversazionale, in linea con la copertura di Voice Agent. Agent Architect gestisce la configurazione generale e le scelte finite, mentre gli input specifici dell'account — mittenti, destinazioni di instradamento, URL e variabili — restano sotto il controllo dell'utente in Revisione/Modifica. I dettagli mancanti lasciano la bozza incompleta anziché inventata.
* **Solo variabili esistenti con flusso guidato dei segnaposto**: Agent Architect non crea più variabili automaticamente. Ogni associazione deve risolversi in una variabile esistente e autorizzata. I riferimenti non risolti diventano segnaposto che gli utenti risolvono tramite la selezione guidata della Skill Library. L'Applicazione finale è bloccata finché ogni associazione non è valida e i campi degli strumenti che richiedono variabili (come il destinatario SMS e il link di pianificazione) restano vuoti finché non vengono collegati esplicitamente.

{% hint style="info" %}
Questa Funzionalità richiede l'attivazione da parte di Zoom. Contatta il team del tuo account Zoom per abilitare questa funzionalità.
{% endhint %}

**Una pagina semplificata dei dettagli dell'agente mette in evidenza le Impostazioni più utilizzate**

La pagina dei dettagli dell'agente è stata riorganizzata in modo che le Impostazioni che gli amministratori usano di più — come la voce e il saluto — siano in primo piano, mentre le opzioni modificate meno spesso sono raggruppate in una sezione Avanzate dedicata. Tutte le funzionalità esistenti restano intatte; il layout rende semplicemente più facile la navigazione della configurazione ordinaria e abbrevia l'Onboarding per i nuovi amministratori. Poiché questo layout è abilitato per impostazione predefinita, non è richiesta alcuna attivazione.

**Gli amministratori possono selezionare e gestire il modello di IA che alimenta un agente**

I proprietari dell'account e gli amministratori possono scegliere il modello di IA alla base di un agente da un menu a discesa dei modelli certificati Disponibili nelle Impostazioni Avanzate dell'agente. Prima che una Modifica del modello venga salvata, appare un prompt di conferma in modo che il passaggio sia deliberato — i risultati possono variare da un modello all'altro, quindi Zoom consiglia di testare prompt e istruzioni sul modello selezionato prima di usarlo in produzione. I nuovi account iniziano con l'ultimo modello predefinito certificato, mentre gli account esistenti mantengono il modello attuale finché un amministratore non lo modifica.

Zoom avvisa inoltre gli amministratori prima che un modello venga ritirato. Quando è pianificata la dismissione di un modello usato da un agente, le Impostazioni dell'agente mostrano la data di dismissione e una sostituzione suggerita, e gli amministratori ricevono un preavviso di almeno 30 giorni prima che la Modifica abbia effetto. Una volta che un modello è stato rimosso completamente, non appare più nel selettore.

**L'Onboarding di Receptionist offre un modo guidato per iniziare**

L'Onboarding di Receptionist offre agli admin un percorso più rapido e con meno sforzo verso un agente funzionante — un'alternativa guidata al più impegnativo processo tradizionale di creazione dei bot. Invece di configurare ogni componente manualmente, gli admin seguono un flusso di competenze consigliate che mette in atto le funzionalità comuni in pochi passaggi.

Gli admin possono collegare il proprio calendario Google, Outlook o Apple e creare una pagina di prenotazione Zoom Scheduler in un solo passaggio all'interno del flusso di Onboarding di Zoom Virtual Agent. Selezionando la **Pianificazione** competenza durante il passaggio delle competenze consigliate apre una procedura guidata Scheduler incorporata che gestisce la connessione del calendario, la disponibilità e la creazione della pagina di prenotazione end-to-end, così il receptionist può prenotare in base a una disponibilità reale e aggiornata fin dal primo giorno. Al termine, un gruppo di conferma mostra il calendario collegato, una descrizione precompilata del tipo di riunione e un menu a discesa per selezionare o aggiungere pagine di prenotazione. Gli admin che hanno già pagine di prenotazione Zoom Scheduler possono sceglierne una dall'elenco invece di crearne una duplicata.

I chiamanti possono anche prenotare appuntamenti usando il proprio numero di telefono come identificativo principale, in linea con il modo in cui già contattano Receptionist. L'e-mail non è più richiesta per impostazione predefinita, anche se può ancora essere raccolta come campo secondario Facoltativo se il chiamante la condivide. Per gli appuntamenti originariamente prenotati con l'e-mail come identificativo, durante la transizione rimane attiva una ricerca e-mail di fallback, così le prenotazioni esistenti restano recuperabili. Gli appuntamenti effettuati con un numero di telefono come identificativo chiave ricevono anche un SMS direttamente da Zoom Scheduler, offrendo al chiamante modi per confermare, riprogrammare o annullare.

#### <mark style="color:blu;">Le Basi di conoscenza sono fonti di risposte intelligenti per bot agentici</mark>

L'Agente virtuale fornisce risposte accurate tramite un processo in tre fasi: recupero, arricchimento e generazione (RAG). Quando un utente invia una domanda, il sistema recupera innanzitutto le informazioni più pertinenti dalla Base di conoscenza, ancorando la risposta a dati fattuali e specifici dell'azienda. Questo contenuto recuperato viene poi arricchito e associato alla richiesta originale dell'utente per fornire al modello linguistico un contesto preciso. Infine, il modello genera una risposta naturale, coerente e contestualmente pertinente per l'utente finale.

**Comprendere la base di conoscenza nell'Agente virtuale**

L'Agente virtuale si affida alla propria Base di conoscenza per fornire risposte coerenti e accurate, in linea con le policy aziendali. Gli amministratori hanno diverse Integrazioni per popolare la Base di conoscenza:

* **Integrazioni API**: Sincronizza automaticamente gli articoli della knowledge base da fonti come Zendesk, ServiceNow e Zoom Docs.
* **Integrazioni manuali**: Carica contenuti come PDF e CSV oppure crea e modifica gli articoli direttamente nell'interfaccia web.
* **Sincronizzazione web**: Usa il web crawling per importare FAQ e articoli della base di conoscenza da siti pubblici, con estrazione personalizzabile tramite JavaScript.

Questo approccio flessibile consente alle organizzazioni di sfruttare i propri sistemi esistenti di gestione della conoscenza oppure di creare direttamente all'interno dell'ecosistema Zoom.

**Generazione aumentata dal recupero (RAG)**

Zoom Virtual Agent incorpora la Generazione aumentata dal recupero (RAG), che ancora le risposte dell'IA ai contenuti della Base di conoscenza per garantirne accuratezza e pertinenza contestuale. Questa nuova versione opera sull'infrastruttura unificata single-stack di Zoom AI mantenendo metodi coerenti di Integrazioni con la Base di conoscenza. Questa architettura migliora la scalabilità, le prestazioni e l'Integrazioni tra gli strumenti di IA, offrendo un'esperienza coerente sia per gli utenti finali sia per gli amministratori.

**Buone pratiche per i contenuti della base di conoscenza**

L'efficacia dell'Agente virtuale dipende dalla qualità della sua Base di conoscenza. Gli amministratori devono curare strategicamente questo contenuto, dando priorità alla coerenza e all'appropriatezza e rimuovendo regolarmente le informazioni obsolete o irrilevanti. Ogni articolo dovrebbe concentrarsi su un singolo argomento distinto e fornire un contesto completo per rispondere alle domande correlate. Evita di suddividere gli argomenti in più articoli o di combinare argomenti non correlati, poiché ciò riduce la chiarezza del recupero.

Una struttura chiara, con un solo argomento per articolo, consente all'Agente virtuale di recuperare in modo efficiente le informazioni più pertinenti. Per ridurre al minimo l'ambiguità, i contenuti dovrebbero usare frasi concise e strutturate e un linguaggio semplice. I riferimenti dipendenti dalla Posizione, come “vedi sopra”, dovrebbero essere sostituiti con identificativi espliciti per maggiore chiarezza.

**Le Basi di conoscenza possono essere create usando varie opzioni, incluse alcune Integrazioni API predefinite/personalizzate, la Sincronizzazione web o manualmente**

I Clienti possono creare o aggiungere a una Base di conoscenza esistente utilizzando varie opzioni, tra cui:

* Integrazioni API con Zendesk, ServiceNow, Salesforce, Kustomer, Freshdesk o Confluence. Per ulteriori informazioni sulle Integrazioni, consulta l'articolo di Assistenza Zoom [Comprendere i tipi di sincronizzazione della base di conoscenza di Virtual Agent](https://support.zoom.com/hc/en/article?id=zm%5Fkb\&sysparm%5Farticle=KB0075644).
* Sincronizzazione web da siti web disponibili pubblicamente, tramite sitemap, caricamento di URL e individuazione dei link (l'estrazione JavaScript è supportata su richiesta di abilitazione).

**I Clienti possono avere Basi di conoscenza separate per contenuti manuali e CRM**

Sebbene una Base di conoscenza non possa mescolare contenuti manuali e integrati, gli account possono creare più Basi di conoscenza per contenuti diversi. Ad esempio, un account crea una Base di conoscenza per articoli integrati tramite API e una seconda Base di conoscenza per caricamenti manuali di articoli.

**Un agente virtuale può attingere a più Basi di conoscenza contemporaneamente**

Le Basi di conoscenza separate non devono trovarsi su agenti diversi. Nella versione attuale di Zoom Virtual Agent, un amministratore può Assegna direttamente più Basi di conoscenza di tipo diverso a un singolo agente, così un agente attinge sia ai contenuti curati manualmente sia a quelli provenienti da Integrazioni all'interno della stessa interazione.

I Gruppi di Knowledge Base — il meccanismo usato per raggruppare più Knowledge Base insieme in ZVA 1.0 — non si applicano alla versione di nuova generazione di ZVA. Nella versione attuale non puoi assegnare a un agente un Gruppo di Knowledge Base. Invece, assegni direttamente le singole Basi di conoscenza.

**Le Basi di conoscenza sono soggette a varie limitazioni, a seconda del loro tipo**

Le Basi di conoscenza sono soggette a varie limitazioni a seconda del tipo di Base di conoscenza. Queste limitazioni sono descritte di seguito:

**Basi di conoscenza generali**

* Un account può avere un totale di 100 Basi di conoscenza. Può trattarsi di qualsiasi combinazione di Basi di conoscenza curate manualmente, connesse tramite API o basate sul web.

**Articoli della Knowledge Base**

* La dimensione del file di testo per un articolo (incluso HTML) non può superare 50.000 caratteri.
* Solo Basic HTML (stili come grassetto, collegamenti ipertestuali, `<div>` tag, ecc.) è supportato. HTML avanzato, come i tag script, viene rimosso al momento del salvataggio del contenuto.
* Le tabelle non sono supportate al momento e vengono rimosse al momento del salvataggio.

**Knowledge Base manuali**

* Le KB manuali sono limitate a 5.000 articoli per Knowledge Base.

**Knowledge Base collegate ad API**

Non ci sono restrizioni specifiche per questo tipo di Knowledge Base.

**Basi di conoscenza connesse a Web Sincronizza**

* Le KB Web sono limitate a 5.000 articoli per Knowledge Base.
* Web Sincronizza può importare contenuti usando la Sincronizza della sitemap, la scoperta dei link o il caricamento di URL.
* Web Sincronizza rileverà solo fino a 250 URL della sitemap.
* C'è un timeout di 60 secondi durante il recupero delle sitemap e delle singole pagine. L'opzione di crawler basata sull'IA ha un timeout di 30 secondi.
* Il crawler della sitemap utilizza l'intestazione agente utente “Zoom KB Crawler.” Questo può essere usato per Aggiungi un crawler bloccato dal tuo sistema a un elenco approvato.
* Ogni articolo ha un limite di dimensione di ingestione di 250 MB e un limite di dimensione del testo di 10 MB (esclusi i dati delle immagini).

**Sincronizzazione generale**

L'attività di Sincronizza include timeout integrati per affidabilità e prestazioni. L'attività individuale più lunga è **creazione dell'indice**, che ha un **timeout di 30 minuti**. Se la creazione dell'indice supera questo limite, l'attività non riuscirà e dovrà essere riavviata.

Gli amministratori possono anche Configura programmi di Sincronizza periodica (ad es. giornalieri o settimanali) per mantenere automaticamente aggiornati i contenuti con il sistema di origine. Inoltre, gli strumenti di convalida integrati consentono agli amministratori di eseguire query sulla knowledge base prima di distribuirla in produzione, aiutando a verificare l'accuratezza e le prestazioni del componente KB in modo indipendente.

#### <mark style="color:blu;">Le Skills e gli Strumenti aiutano gli agenti virtuali a offrire conversazioni empatiche e contestuali, consentendo al contempo la risoluzione automatizzata di problemi complessi</mark>

**Introduzione alla Tool Library**

La Tool Library in Zoom Virtual Agent consente al sistema di connettersi con piattaforme esterne tramite API. Nella terminologia dei modelli linguistici di grandi dimensioni (LLM), che Zoom definisce anche modelli di terze parti, uno Strumento rappresenta un metodo definito per recuperare dati da o inviare dati a sistemi di terze parti. Ciò consente al Virtual Agent di andare oltre le knowledge base statiche interagendo dinamicamente con servizi esterni, fornendo risposte più accurate e utili durante le conversazioni.

**Utilizzo degli Strumenti per gestire i dati esterni**

Gli Strumenti sono progettati per fornire un controllo preciso durante il recupero o l'aggiornamento delle informazioni. Invece di fare affidamento sul modello di terze parti per analizzare risposte API complesse o lunghe, gli Strumenti consentono agli amministratori di definire esattamente quali campi dati devono essere restituiti. Questo approccio riduce l'ambiguità, migliora l'affidabilità e consente all'Agente virtuale di fornire risposte coerenti senza essere sovraccaricato da payload API non necessari o irrilevanti.

**Gestione dei dati sensibili ed eccessivi**

Quando si integrano sistemi esterni, le API possono restituire informazioni sensibili come dati personali identificabili (PII) o grandi quantità di dati non necessari. La Libreria degli strumenti supporta l'uso di JavaScript per manipolare le risposte prima di passarle al modello di terze parti. Gli amministratori possono filtrare, trasformare o eliminare i campi per mantenere solo le informazioni essenziali. Ciò aiuta a limitare l'esposizione dei dati sensibili, evita di sovraccaricare il modello e semplifica l'interazione tra l'agente virtuale e i servizi di terze parti.

**Best practice per la configurazione degli strumenti**

Gli amministratori dovrebbero progettare pensando a semplicità e precisione. I casi d'uso che prevedono il recupero di valori specifici, come un ID caso o lo stato di un ordine, traggono il massimo vantaggio dalle integrazioni guidate dagli strumenti. Restringendo l'ambito della risposta, gli strumenti possono eseguire azioni mirate riducendo al minimo la complessità trasferita nel contesto del modello di terze parti. Ogni Tool dovrebbe essere adattato al proprio caso d'uso e testato rispetto alle API a cui si connette per garantire un comportamento coerente in scenari diversi.

**I casi di test precompilano e convalidano gli input dello strumento prima della pubblicazione**

Gli amministratori possono convalidare ciò che restituisce uno strumento di chiamare API o uno script personalizzato prima di collegarlo a un flusso attivo. Nel gruppo di anteprima del Tool, una scheda Casi di test consente agli amministratori di creare e salvare casi di test con nome — ogni nome fino a 30 caratteri — che memorizzano i valori dei parametri di input per tutti i tipi di dati supportati. Quando eseguono il debug, gli amministratori possono usare la funzione Seleziona per un caso di test salvato per precompilare i parametri di input (il caso di test usato per ultimo viene mantenuto automaticamente) oppure inserire i valori manualmente, quindi eseguire il debug per confermare che il Tool si comporti come previsto. Questo elimina la necessità di reinserire gli input di esempio a ogni esecuzione di debug e consente agli amministratori di verificare l'output variabile rispetto agli input di esempio prima di pubblicare l'agente.

**Lo strumento integrato della knowledge base è visibile e direttamente invocabile nel builder**

Gli amministratori possono visualizzare e invocare esplicitamente lo strumento integrato della knowledge base direttamente nel builder di Zoom Virtual Agent. In precedenza, questo strumento operava come componente interno del sistema, senza visibilità né controllo diretto nell'interfaccia del builder. Ora appare insieme agli altri strumenti integrati, etichettato come strumento fornito dal sistema, con un nome in sola lettura e una descrizione modificabile. Gli amministratori possono invocare lo strumento più volte nei percorsi di guida dell'agente o nelle Skills, rendendo la consultazione della knowledge base un passaggio deliberato e definito in un workflow.

**Comprendere le Skills nel Virtual Agent**

Le Skills sono il fondamento di come l'agente virtuale esegue le attività. Ogni Skill è definita da due elementi fondamentali: una **descrizione del trigger** che specifica quando la Skill dovrebbe attivarsi e un insieme di **istruzioni** che guidano il Virtual Agent su come completare l'attività. Le istruzioni possono includere indicazioni in linguaggio naturale così come riferimenti a Tools, con la funzione di consentire alla Skill di interagire con API e sistemi esterni.

**Come l'agente decide quando usare Skill e Tools**

Una volta che la descrizione del trigger corrisponde a una richiesta del cliente, il Virtual Agent valuta tutte le istruzioni all'interno della Skill. L'agente determina in modo indipendente quando chiamare un Tool in base al nome e alla descrizione del Tool piuttosto che a istruzioni esplicite passo passo. Ciò significa che gli amministratori devono fornire istruzioni della Skill e descrizioni dei Tool chiare affinché l'agente possa interpretarle correttamente. È importante sottolineare che l'agente ha Access a tutte le Skill e i Tools e può decidere di usare Tools associati a Skill diverse se sono pertinenti all'attività.

**Migliori pratiche per progettare le Skill**

Per un'esecuzione affidabile, gli amministratori dovrebbero scrivere **descrizioni del trigger chiare e concise** che riflettano accuratamente quando una Skill dovrebbe attivarsi. Le istruzioni possono essere organizzate in più caselle per una migliore gestione della Skill; tuttavia, vengono combinate durante l'esecuzione. Gli amministratori dovrebbero evitare di incorporare comandi espliciti come “chiamare questo Tool ora” nelle istruzioni. Invece, le istruzioni dovrebbero descrivere il risultato previsto, mentre i nomi e le descrizioni dei Tool dovrebbero indicarne il corretto utilizzo. Si raccomanda di limitare il numero di Skill a circa cinque (5), poiché una configurazione eccessiva può portare a limitazioni della finestra di contesto.

**Salvataggio e gestione delle variabili con le Skill**

Le Skills da sole non possono salvare direttamente i dati nelle variabili globali. Invece, gli amministratori devono combinare le istruzioni con l'uso di Tool integrati o personalizzati. Ad esempio, una Skill può includere istruzioni per raccogliere il numero di account di un cliente, ma il salvataggio effettivo di quei dati in una variabile deve avvenire tramite un Tool come **collect\_save\_response** oppure tramite Integrazioni personalizzate. Questa separazione consente una gestione coerente e sicura dei dati sensibili all'interno del framework Virtual Agent.

**Scenari di esempio dell'esecuzione delle Skill**

L'interazione tra Skill e Tool rispecchia il modo in cui un agente umano addestrato applica le proprie conoscenze. Ad esempio, quando un cliente segnala una carta di credito smarrita, il Virtual Agent avvia la Skill “Ha perso la carta di credito”. Le istruzioni richiedono la Verifica dei Membri, invitando l'agente a usare la Skill “Verifica dei Membri” prima di continuare. Dopo la Verifica, l'agente torna per disattivare la carta, offre di controllare le transazioni recenti e, se opportuno, trasferisce il chiamante a un agente in tempo reale. Allo stesso modo, in uno scenario “Controlla le transazioni recenti”, il Virtual Agent conferma prima l'identità dei Membri prima di recuperare i dettagli delle transazioni. Questi scenari illustrano come le Skill forniscano struttura, mentre l'agente seleziona automaticamente i Tool e sequenzia le attività per completare il lavoro.

**Le istruzioni possono includere collegamenti ipertestuali cliccabili con testo di etichetta personalizzato**

Gli amministratori possono inviare collegamenti ipertestuali cliccabili con testo da mostrare personalizzabile tramite la Funzionalità Instructions in Zoom Virtual Agent chat. In precedenza, gli URL apparivano come testo normale senza alcun modo di definire un'etichetta, il che rendeva più difficile per gli utenti finali sapere dove conducesse un link. Ora gli amministratori possono usare Assegna per definire un testo descrittivo per qualsiasi collegamento ipertestuale, così gli utenti vedono un contesto chiaro sulla destinazione prima di fare clic. I collegamenti ipertestuali cliccabili sono supportati su chat web, WhatsApp, app desktop, app mobili e canali aggiuntivi.

**Uno strumento e-mail può inviare e-mail all'interno di una Skill**

I proprietari dell'account e gli amministratori possono usare Aggiungi per inserire uno strumento e-mail direttamente nel costruttore di skill dell'agente digitando una barra obliqua (/). Lo strumento espone attributi configurabili — nome dello strumento, descrizione, oggetto, corpo, indirizzo del mittente, indirizzo del destinatario e una variabile per archiviare l'e-mail. Sia l'oggetto sia il corpo accettano testo statico, variabili concatenate e URL, e tutte le variabili si risolvono nei loro valori effettivi prima dell'invio dell'e-mail. Lo strumento e-mail è Disponibile su chat e implementazioni vocali, inclusi Zoom centro di contatto e Zoom Phone.

**Lo strumento e-mail può essere eseguito in qualsiasi flusso, inclusi i passaggi post-interazione**

Al di là del costruttore di Skill, lo strumento e-mail è Disponibile come passaggio in qualsiasi flusso — conversazionale, curato o con trasferimento a un agente umano — e nelle azioni post-engagement che vengono eseguite dopo la chiusura di una sessione. Questo consente a un agente di inviare in qualsiasi momento di una conversazione un’e-mail di riepilogo o di follow-up, non solo al passaggio di consegne. Ad esempio, un flusso fuori orario può inviare via e-mail un riepilogo del caso quando non è Disponibile un agente umano. Il destinatario può essere una variabile di sessione raccolta, come l’e-mail dell’utente dalla chat, oppure un indirizzo statico, e l’oggetto e il corpo supportano sia testo statico sia variabili, con supporto multilingue.

**La configurazione del modulo e del canale di supporto è integrata nel flusso di lavoro dell’agente**

La creazione del modulo per gli agenti vocali fa ora parte del flusso di lavoro di creazione dell’agente, così gli amministratori non devono più allontanarsi dalla scheda corrente per crearne uno. La creazione del canale di supporto per gli agenti chat è integrata nella stessa esperienza di creazione. Il risultato è un processo di configurazione coerente per entrambi i tipi di agente e meno passaggi per configurare e distribuire un nuovo caso d’uso.

**Custom Action esegue una logica basata su LLM e salva il risultato in una variabile**

Custom Action è uno strumento integrato, ed è Disponibile durante la creazione di Skills per agenti chat. Gli amministratori forniscono istruzioni personalizzate che definiscono lo scopo e il comportamento dell’esecuzione LLM dello strumento, e l’output viene salvato in una variabile — String, Numeric, JSON o Array. Ciò supporta attività post-engagement come la generazione di riepiloghi, la creazione di tag o la preparazione di note da passare a sistemi CRM, piattaforme di ticketing o agenti umani.

{% hint style="info" %}
Questa Funzionalità richiede l'attivazione da parte di Zoom. Contatta il team del tuo account Zoom per abilitare questa funzionalità.
{% endhint %}

**Una libreria di Skill fornisce Skill predefinite e riutilizzabili**

Gli amministratori possono consultare una libreria di Skill — un catalogo ricercabile di Skill predefinite e riutilizzabili che accelera la creazione dell’agente. Ogni Skill della libreria combina uno o più Tools con istruzioni incorporate e guardrail adattati a casi d’uso comuni come pianificazione degli appuntamenti, creazione di casi o lead, ricerche account e reimpostazioni della password. Gli amministratori possono Aggiungi una Skill direttamente a un flusso dell’agente, modificarla per creare una nuova copia senza cambiare l’originale e salvare le nuove Skill create nella libreria per riutilizzarle tra gli agenti.

{% hint style="info" %}
Questa Funzionalità richiede l'attivazione da parte di Zoom. Contatta il team del tuo account Zoom per abilitare questa funzionalità.
{% endhint %}

#### <mark style="color:blu;">Le Integrazioni si collegano a servizi di terze parti come strumenti CRM, fornitori di e-commerce o piattaforme di dati dei clienti</mark>

Le Integrazioni di Zoom Virtual Agent collegano le funzionalità vocali e chat a servizi di terze parti per ulteriori funzionalità del chatbot. Le Integrazioni consentono a ZVA di inviare e recuperare dati da fonti di terze parti. Ad esempio, interrogando la piattaforma dati di un cliente o il fornitore di e-commerce per recuperare le informazioni necessarie ad automatizzare il self-service, scrivendo al contempo i dati su quegli stessi sistemi. Le Integrazioni collegano inoltre ZVA a fornitori CCaaS (Centro di contatto as a Service) di terze parti per aiutare a inoltrare le conversazioni a un agente umano quando necessario.

**Integrazioni di Microsoft Teams per campagne Zoom Virtual Agent**

Le Integrazioni di Microsoft Teams consentono alle organizzazioni di incorporare le campagne di Zoom Virtual Agent direttamente all'interno di Microsoft Teams come app nativa. Ciò porta le funzionalità di chat degli agenti nell'area di lavoro di Teams, consentendo ai bot di helpdesk interno, HR o Assistenza IT di servire i dipendenti direttamente nei canali o nelle chat di Teams senza dover passare da una piattaforma all'altra. Le Integrazioni supportano sia la versione desktop sia quella web di Teams.

**Integrazioni di WhatsApp e Facebook Messenger per Zoom Virtual Agent**

Gli agenti di chat di Zoom Virtual Agent possono ora essere distribuiti su WhatsApp e Facebook Messenger tramite Zoom centro di contatto, estendendo l'Assistenza basata sull'IA a più piattaforme di messaggistica preferite dai Clienti.

Gli amministratori Configura questa Integrazioni tramite il Bot Widget del ZCC Flow Builder. Le funzionalità supportate includono:

* messaggistica testuale
* Invio di piccoli file multimediali
* Avvio dei sondaggi
* Trasferimento agli operatori umani

Le funzionalità attualmente non supportate includono:

* Immagini e video di grandi dimensioni
* Caroselli curati

{% hint style="info" %}
Questa Funzionalità richiede l'attivazione da parte di Zoom. Contatta il team del tuo account Zoom per abilitare questa funzionalità.
{% endhint %}

**Gli agenti chat possono connettersi ai canali di messaggistica SMS e Zoom Chat**

Gli amministratori di Zoom Virtual Agent e di Zoom centro di contatto possono collegare gli agenti chat ai canali di messaggistica supportati, inclusi SMS e Zoom Chat, tramite il framework esistente dei canali di messaggistica di ZCC. Questo estende le capacità degli agenti chat oltre le attuali integrazioni di chat web e messaggistica social, consentendo alle organizzazioni di offrire un'assistenza coerente basata sull'IA su ulteriori canali preferiti dai clienti.

**Le Integrazioni di Okta consentono la Verifica dell'identità self-service nelle interazioni vocali e chat**

Il Connettore di Okta integra la piattaforma di identità di Okta con Zoom Virtual Agent, così sia i chiamanti vocali sia gli utenti chat possono recuperare gli account senza l'intervento di un agente. L'agente identifica l'utente e verifica l'identità tramite le notifiche push di Okta Verify. Dopo la Verifica riuscita, può attivare azioni automatizzate come reimpostazioni della password, sblocco degli account, reimpostazioni dei fattori MFA e generazione di un codice temporaneo di Access (TAC). Okta rimane invisibile all'utente finale per tutto il tempo.

{% hint style="info" %}
Questa Funzionalità richiede l'attivazione da parte di Zoom. Contatta il team del tuo account Zoom per abilitare questa funzionalità.
{% endhint %}

**Il Connettore FedEx consente l'autoservizio per il tracciamento delle spedizioni**

Il Connettore FedEx porta l'autoservizio logistico in Zoom Virtual Agent tramite l'API FedEx Basic Integrated Visibility. I Clienti possono tracciare qualsiasi spedizione FedEx — inclusi Express, Ground e SmartPost — usando un numero di tracciamento, e l'agente restituisce stato in tempo reale, Posizione attuale, tempo di consegna stimato e cronologia completa delle scansioni. I Clienti possono anche iscrivere un indirizzo e-mail per ricevere notifiche FedEx sugli eventi chiave, come consegne, eccezioni e stime di consegna aggiornate. Tali notifiche vengono inviate direttamente da FedEx al destinatario, quindi non è richiesta alcuna infrastruttura webhook da parte vostra.

**Gli strumenti di script personalizzati possono autenticare tramite un Connettore di terze parti**

Gli amministratori possono Seleziona e importa l'autenticazione di un Connettore di terze parti esistente direttamente all'interno dello strumento di script personalizzato per eseguire chiamate API autenticate a qualsiasi endpoint esterno. Non è necessario archiviare o gestire manualmente le credenziali — la sicurezza e la gestione delle credenziali restano governate dal framework del Connettore di terze parti. Questo consente agli amministratori di estendere le Integrazioni oltre le opzioni di Connettore predefinite per interazioni API personalizzate più flessibili.

### Comportamento di Virtual Agent

La seguente sezione descrive il comportamento di Zoom Virtual Agent di nuova generazione durante una conversazione con un utente finale.

#### <mark style="color:blu;">Il comportamento dell'agente nelle conversazioni combina prompt strutturati, Skills, Tools e conversazioni precedenti</mark>

Virtual Agent è alimentato da modelli di terze parti che prevedono la parola successiva in una sequenza. Per offrire risposte accurate e utili, il sistema combina un prompt strutturato con indicazioni, Skills, Disponibile Tools e la cronologia delle conversazioni precedenti. Virtual Agent usa questo contesto per decidere se rispondere direttamente, fare riferimento alla base di conoscenza o attivare una Skill.

**Come l'agente sceglie tra Skills e una base di conoscenza Disponibile**

Quando un utente pone una domanda, Virtual Agent valuta se la richiesta è coerente con una Skill definita o se può essere پاسخata direttamente dalla base di conoscenza. Le Skills vengono usate quando una query richiede l'esecuzione di un'attività o passaggi del flusso di lavoro, mentre la base di conoscenza viene usata quando le informazioni fattuali sono sufficienti. L'agente determina questa scelta automaticamente in base alle proprie istruzioni e al contesto Disponibile.

Anche Agent Guidance influenza Virtual Agent, soprattutto nei casi in cui alcuni argomenti sono vietati. Virtual Agent non eseguirà attività agentiche, come cercare articoli pertinenti della Knowledge Base, per qualsiasi argomento che gli sia stato indicato, tramite le indicazioni, di evitare. Per maggiori informazioni su Agent Guidance, vedere la sezione precedente [Agent Guidance è l’identità fondamentale di un agente, e definisce il suo tono, il suo scopo e le sue capacità](#agent-guidance-is-an-agents-foundational-identity-defining-its-tone-purpose-and-capabilities).

**Come Virtual Agent gestisce le escalation e i passaggi di consegne**

Zoom Virtual Agent include un controllo della soglia di escalation che determina quante volte un utente deve richiedere un agente umano prima che il sistema trasferisca la conversazione. Questa impostazione offre al virtual agent ulteriori opportunità di risolvere le richieste dei clienti prima dell'Instradamento all'Assistenza dal vivo.

In precedenza, qualsiasi messaggio di un utente che richiedeva un agente dal vivo attivava immediatamente un'escalation. Con questo aggiornamento, gli amministratori possono Configura un conteggio dei tentativi nelle Impostazioni dell'agente chat che richiede agli utenti di richiedere assistenza umana più volte prima che avvenga il trasferimento. Durante queste richieste intermedie, il virtual agent invita l'utente a riformulare la propria domanda, fornendo all'IA un contesto aggiuntivo per tentare di risolvere il problema. Il sistema tiene traccia di ogni richiesta di escalation e, una volta che il conteggio raggiunge la soglia configurata, la chat viene instradata verso un canale di Assistenza umana.

Il valore predefinito è **1**, che preserva il comportamento precedente in cui la prima richiesta viene trasferita immediatamente. Impostare una soglia più alta consente all’agente virtuale di effettuare ulteriori tentativi di risoluzione prima di passare la conversazione. Questo approccio può migliorare le metriche di contenimento e deflection riducendo i passaggi di consegne non necessari e aumentando i tassi di automazione. La soglia di escalation si allinea con la funzionalità di soglia esistente disponibile per gli agenti vocali, fornendo un comportamento coerente tra i canali.

**L’escalation-by-design fornisce un framework standardizzato per l’analisi dei passaggi di consegne**

L’analisi di Zoom Virtual Agent include un framework standardizzato di escalation-by-design sia per chat sia per voce. Questo framework consente agli amministratori di definire condizioni di business che classificano alcune escalation verso un agente umano come "by design", con conseguenti trasferimenti intenzionali.

Per configurare questa funzionalità, gli amministratori devono abilitare "Additional conditions for 'escalated by design'" in AI Studio. Una volta abilitato, il sistema rileva automaticamente le escalation by design alla pubblicazione. Gli amministratori possono includere nelle istruzioni per l’agente e nelle istruzioni della skill un testo che indica che "l’escalation è by design", che verrà poi usato da questa funzionalità per determinare le condizioni in cui un’escalation è by design.

**Come il prompt di sistema modella il comportamento**

Ogni interazione è guidata da un prompt di sistema, che include la data corrente, l’identità dell’utente, le istruzioni dell’agente, le preferenze linguistiche, le API disponibili, le descrizioni degli strumenti, la cronologia della conversazione e l’ultima richiesta dell’utente. Gli amministratori influenzano direttamente il comportamento dell’agente tramite le **istruzioni dell’agente** e la **gli strumenti che configurano**, mentre il sistema gestisce tutti gli altri campi. Questo contesto strutturato fornisce all’Agente Virtuale le informazioni giuste per produrre risposte coerenti e pertinenti.

**Flusso di una conversazione tipica**

Una tipica interazione segue questo schema prevedibile:

{% stepper %}
{% step %}
L’utente invia una richiesta.
{% endstep %}

{% step %}
L’agente esamina la propria guida, le Skills, gli strumenti e il contenuto della Knowledge Base.
{% endstep %}

{% step %}
L’agente "ragiona" sulle opzioni disponibili, identificando quali informazioni mancano e se è necessaria una Skill, uno strumento o una chiamata API.
{% endstep %}

{% step %}
L’agente effettua la chiamata (se necessario) oppure fornisce una risposta diretta.
{% endstep %}

{% step %}
Se la knowledge base restituisce istruzioni in più passaggi, l’agente fornisce solo il primo passaggio, conferma i progressi dell’utente e poi procede in sequenza.
{% endstep %}
{% endstepper %}

**Instradamento per composizione per nome per Zoom Phone**

Zoom Virtual Agent ora supporta l’instradamento dial-by-name (chiamato anche transfer-by-name) per Zoom Phone. Quando viene distribuito in un flusso vocale, l’agente può raccogliere un nome parlato o digitato, interpretare la richiesta e instradare la chiamata all’utente o all’interno corretto. Questo miglioramento consente una navigazione vocale più naturale e riduce l’inserimento manuale sul tastierino. Gli amministratori possono configurare le regole di instradamento dial-by-name nelle Impostazioni di Zoom Phone per determinare quali utenti o reparti sono idonei all’instradamento automatico.

**Rubrica autonoma con composizione per nome**

Per le implementazioni vocali autonome di Receptionist, gli amministratori possono creare e gestire una rubrica di contatti locale all’interno dello strumento Transfer-by-Name per supportare il trasferimento delle chiamate basato sul nome. Ogni voce contiene un nome del contatto e un numero di telefono esterno. Quando un chiamante chiede di essere messo in contatto con una persona o un reparto, l’agente vocale confronta la richiesta con la rubrica e trasferisce la chiamata al numero associato. Le voci possono essere aggiunte singolarmente o importate in blocco da un CSV, e l’elenco importato può essere aggiunto a quello esistente o sostituirlo con voci simili, ed esportato. Le modifiche hanno effetto senza ricostruire l’intero agente vocale.

La rubrica autonoma è progettata per le distribuzioni autonome di ZVA in cui il cliente non dispone di una rubrica Zoom Phone da consultare. I clienti Zoom Phone possono usare anche lo strumento Transfer-by-Name, ma poiché per ogni agente è supportata una sola copia dello strumento, devono scegliere se lo strumento attinge alla propria rubrica (del cliente) o alla rubrica di Zoom Phone. Le due sono alternative selezionate per agente, non sovrapposte.

**Durata massima estesa del coinvolgimento per le conversazioni inattive**

Gli amministratori possono impostare il **timer per la chiusura automatica dei coinvolgimenti inattivi nei flussi** a un massimo di 24 ore, rispetto al precedente limite di 12 ore. L’interfaccia admin mostra la durata del coinvolgimento in un formato chiaro ore-e-minuti, che allinea i limiti di durata del coinvolgimento di Zoom centro di contatto con Zoom Virtual Agent e aiuta a ridurre gli errori di configurazione eliminando la necessità di calcoli manuali dei minuti.

**Riepilogo delle chiamate e Integrazioni delle variabili con Zoom Phone**

Zoom Virtual Agent può trasferire i riepiloghi delle conversazioni e i metadati personalizzati agli agenti di Zoom Phone durante i passaggi di consegne delle chiamate tramite il pass-through delle variabili. Gli amministratori configurano, usando il portale amministratori ZVA, quali variabili mostrare nell’interfaccia Zoom Phone durante le chiamate trasferite, contribuendo a migliorare la rilevanza dei dati dando agli agenti accesso in tempo reale alle informazioni raccolte in precedenza. Ciò può ridurre i tempi medi di gestione fornendo agli utenti di Zoom Phone riepiloghi delle chiamate generati da ZVA e variabili chiave prima di rispondere a una chiamata, durante la conversazione e dopo la fine della chiamata.

Questa funzionalità richiede una licenza Zoom Phone Customer Engagement Pack (precedentemente nota come Zoom Phone Power Pack).

{% hint style="info" %}
Questa Funzionalità richiede l'attivazione da parte di Zoom. Contatta il team del tuo account Zoom per abilitare questa funzionalità.
{% endhint %}

**Migliori pratiche per ottimizzare il comportamento dell’agente**

Gli amministratori dovrebbero progettare le Skills in modo che ogni insieme di istruzioni sia chiaro e indipendente, riducendo sovrapposizioni o conflitti. L’ordine delle Skill può influire sul modo in cui l’agente dà priorità alle azioni, quindi le descrizioni dovrebbero essere scritte per ridurre al minimo l’ambiguità. Se combinate con contenuti della Knowledge Base ben strutturati, queste pratiche aiutano l’agente a determinare con fluidità quando rispondere direttamente, quando fare riferimento alla documentazione e quando eseguire un flusso di lavoro.

Per ulteriori informazioni, consulta i nostri articoli della Libreria tecnica [Personalizza l'esperienza di Assistenza chat dell'utente](https://library.zoom.com/business-services/zoom-contact-center/expert-insights/customize-user-chat-support-experience) e [Integra le funzionalità di Zoom centro di contatto nel tuo sito web](https://library.zoom.com/business-services/zoom-contact-center/expert-insights/integrate-zoom-contact-center-features-into-your-website).

**Virtual Agent affina il proprio ragionamento tramite un auto-miglioramento strutturato**

Zoom Virtual Agent utilizza un framework di auto-miglioramento strutturato che affina il modo in cui l’agente ragiona sui compiti e segue le policy aziendali. È automatico e non richiede configurazione admin.

Il sistema converte policy e procedure aziendali in protocolli decisionali strutturati e passo passo. Questo aiuta Virtual Agent a seguire percorsi logici verificabili anziché affidarsi a inferenze implicite.

Le azioni di auto-miglioramento includono:

* Generazione di scenari di test
* Valutazione delle risposte dell’agente rispetto ai risultati attesi
* Individuazione delle lacune nel ragionamento
* Aggiornamento dei protocolli decisionali

Gli amministratori non interagiscono direttamente con il sistema di auto-miglioramento. L’agente diventa nel tempo più coerente, conforme alle policy e preciso, senza riaddestramento manuale. Il miglioramento è osservabile tramite le prestazioni e analisi di Virtual Agent e Agent Tracing. Vedi le [Prestazioni e analisi di Virtual Agent](#virtual-agent-performance-and-analytics) e [Agent Tracing fornisce visibilità passo passo sul processo decisionale dell’agente virtuale](#agent-tracing-provides-step-by-step-visibility-into-virtual-agent-decision-making) sezioni per ulteriori informazioni.

**Virtual Agent può avviare chiamate automatizzate in uscita verso elenchi di clienti**

Gli amministratori possono configurare Zoom Virtual Agent per effettuare chiamate in uscita verso elenchi di clienti in base a regole di business e parametri di pianificazione definiti. L’agente virtuale può avviare chiamate, inviare messaggi predefiniti, rispondere alle domande dei clienti usando le proprie Knowledge Base e Skills e passare a operatori in tempo reale quando necessario. I controlli integrati per la gestione delle chiamate aiutano ad allineare le attività di contatto alle preferenze dei clienti.

Gli amministratori creano campagne in uscita all’interno di AI Studio selezionando un elenco contatti, assegnando un agente vocale virtuale, definendo un ID chiamante, pianificando le finestre di chiamata e configurando il comportamento dei tentativi.

La chiamata in uscita sfrutta l’infrastruttura delle campagne in uscita di Zoom centro di contatto, e i risultati del coinvolgimento e lo stato della chiamata vengono registrati nell’analisi di ZVA. La chiamata in uscita è attualmente disponibile per i soli canali vocali.

**Modalità dialer di anteprima**

ZVA In Uscita ora utilizza la modalità dialer di anteprima al posto della precedente modalità dialer senza agente. In precedenza, la chiamata in uscita veniva effettuata per prima e la sessione del flusso vocale del bot veniva avviata solo dopo la risposta, quindi la persona chiamata poteva sentire un tratto di silenzio prima che il bot parlasse. Ora la sessione del bot viene inizializzata e mantenuta in uno stato silenzioso e pronto prima che la chiamata venga effettuata. Nel momento in cui la chiamata viene collegata, il bot è già in ascolto e risponde immediatamente — eliminando la pausa che i destinatari sentivano al momento della risposta e facendo sembrare le chiamate in uscita una vera conversazione fin dal primo saluto.

**I clienti Zoom Phone possono utilizzare le funzionalità SMS all’interno di Zoom Virtual Agent**

I Clienti di Zoom Virtual Agent e Zoom Phone possono usare le funzionalità SMS di Zoom Phone direttamente all'interno di ZVA per migliorare le interazioni vocali. Durante una chiamata, l'agente virtuale può inviare messaggi SMS personalizzabili contenenti testo dinamico, URL o link a sondaggi. Il sistema supporta le variabili e suddivide i messaggi più lunghi per una consegna efficiente. Ciò consente ai clienti di ricevere informazioni dettagliate che sono difficili da trasmettere solo a voce.

Per utilizzare questa funzionalità, devono essere soddisfatti i seguenti prerequisiti:

* Assegna un numero valido al centralinista automatico (AR)
* Abilita la policy SMS
* Aggiungi almeno un membro AR all'elenco SMS/Membri consentiti

{% hint style="info" %}
Questa Funzionalità richiede l'attivazione da parte di Zoom. Contatta il team del tuo account Zoom per abilitare questa funzionalità.
{% endhint %}

**Uno strumento di orario lavorativo consente l'instradamento condizionale e la messaggistica in base alle pianificazioni**

Gli amministratori possono configurare uno strumento di orario lavorativo che consente saluti, istruzioni e regole di instradamento personalizzati in base all'orario lavorativo e ai calendari festivi. Lo strumento supporta fusi orari personalizzati, orari lavorativi e configurazioni festive con opzioni per pianificazioni ricorrenti. Ogni strumento di orario lavorativo può essere richiamato in Skills per creare una logica condizionale.

Ad esempio, può indirizzare le chiamate ad agenti in tempo reale durante l'orario di apertura o mostrare messaggi di chiusura fuori orario. Lo strumento si applica sia agli scenari in entrata sia a quelli in uscita.

{% hint style="info" %}
Questa Funzionalità richiede l'attivazione da parte di Zoom. Contatta il team del tuo account Zoom per abilitare questa funzionalità.
{% endhint %}

#### <mark style="color:blu;">Distribuzione multi-istanza per più sedi e reparti</mark>

La piattaforma multi-istanza di Zoom Virtual Agent con Zoom Phone offre esperienze vocali scalabili e personalizzate in numerose sedi o reparti. Le organizzazioni gestiscono centralmente le configurazioni a livello di brand, consentendo al tempo stesso la personalizzazione specifica per negozio o filiale per saluti, basi di conoscenza e competenze. Utilizzando i dati di instradamento di Zoom Phone, Zoom Virtual Agent determina automaticamente il corretto interno del reparto o del negozio, eliminando la necessità di configurare manualmente l'instradamento per ogni negozio. La gestione gerarchica dei ruoli, il controllo delle versioni e la pubblicazione selettiva semplificano l'amministrazione, velocizzano la distribuzione e mantengono coerente l'esperienza del cliente in tutti i siti.

**Nota:** I filtri per istanza e gruppo di istanze consentono agli amministratori di circoscrivere le interazioni a una singola istanza (ad esempio, la sede di un negozio) o a un gruppo di istanze (ad esempio, un gruppo regionale di negozi), insieme ai filtri già esistenti per agente virtuale e versione. Questi filtri si applicano ai report Panoramica, Prestazioni dell'agente virtuale e Dettagli conversazione.

{% hint style="info" %}
Questa Funzionalità richiede l'attivazione da parte di Zoom. Contatta il team del tuo account Zoom per abilitare questa funzionalità.
{% endhint %}

### Prestazioni e analisi di Virtual Agent

Le sezioni seguenti descrivono i report offerti da Zoom Virtual Agent.

Gli amministratori possono creare un'unica sottoscrizione contenente i diversi report descritti in questa sezione. Possono filtrare le sottoscrizioni per agenti specifici, gruppi di agenti o tipi di report come Panoramica, Prestazioni dell'agente virtuale, Prestazioni della conoscenza, Approfondimento query, Dettagli conversazione e Sondaggi sul coinvolgimento dei consumatori. I destinatari ricevono un'unica e-mail con tutti i report selezionati, etichettati per tipo di report e ambito dell'agente.

Le sottoscrizioni ai report ora offrono una cadenza di consegna estesa, copertura della Dashboard e contenuti e-mail. Gli amministratori possono scegliere qualsiasi giorno della settimana per la consegna settimanale oppure passare alla consegna giornaliera. È disponibile una selezione più ampia di dashboard incluse nella sottoscrizione, e il modello di e-mail del report è stato rivisto per includere più metriche e un riepilogo generato dall'IA.

#### <mark style="color:blu;">Il Dizionario dei dati fornisce definizioni trasparenti delle metriche per le analisi di Virtual Agent</mark>

Le analisi di Zoom Virtual Agent includono un Dizionario dei dati integrato. Gli amministratori possono sfogliare dataset e report per comprendere definizioni delle metriche, calcoli, filtri e indicazioni interpretative. Le definizioni possono essere esportate e condivise, contribuendo a chiarire i KPI e a favorire l'adozione tra i team.

#### <mark style="color:blu;">Le metriche della Dashboard supportano il drill-down diretto e i tooltip delle colonne</mark>

Gli amministratori possono fare clic su qualsiasi metrica nella Dashboard di Zoom Virtual Agent per approfondire le conversazioni sottostanti. I filtri attivi della dashboard vengono applicati automaticamente, così puoi passare dall'elenco delle conversazioni a una singola trascrizione e tornare indietro senza perdere il contesto. Ogni tabella del report aggiunge anche tooltip alle intestazioni di colonna. Passa il mouse su una metrica per vederne la definizione e un collegamento diretto alla voce completa del Dizionario dei dati.

#### <mark style="color:blu;">Il report Prestazioni dell'agente virtuale dettaglia gli esiti di Strumento, Skill e latenza durante il coinvolgimento dell'utente finale</mark>

Il report Prestazioni dell'agente virtuale fornisce dati per i principali indicatori di prestazione dell'agente IA.

* **Metriche principali:** Numero totale e univoco di strumenti richiamati, numero totale e univoco di skill richiamate, metriche di latenza (latenza del primo token P90/P50), tendenza della latenza, tasso di contenimento, tasso di escalation, utilizzo del coinvolgimento e risparmio sui costi.
  * **Metrica di avvio**: Una nuova metrica avanzata che misura quando e come vengono avviate le interazioni, offrendo una visibilità più chiara su come gli utenti entrano nell'esperienza dell'agente virtuale. Questa metrica aiuta gli amministratori a valutare le prestazioni del punto di ingresso, esaminare le strategie di instradamento e comprendere come le modifiche ai flussi di lavoro o alle superfici di ingresso influenzino il comportamento complessivo del coinvolgimento.
  * **Metriche totali dei messaggi**: Fornisce conteggi aggregati di tutti i messaggi scambiati tra le interazioni di Zoom Virtual Agent e Zoom AI Expert Assist. Queste metriche aiutano gli amministratori ad analizzare il volume conversazionale, confrontare i modelli di messaggio tra i canali e comprendere meglio il carico multimodale sui flussi di lavoro di assistenza basati sull'IA.
  * **Guardrail**: Una vista aggregata dell'attività dei guardrail di sicurezza back-end, inclusi il numero totale di violazioni, il tasso di violazione ogni 1.000 interazioni, una ripartizione per categoria e un andamento nel tempo. L'apertura dell'aggregato mostra le conversazioni interessate nel report Dettagli conversazione, prefiltrate in base alla categoria di guardrail selezionata. La reportistica dei guardrail copre sia la voce sia la chat.
* **Filtri:** Intervallo di date, tipo di agente (voce, chat, chatbot) e agente IA specifico.
  * **Gruppi di argomenti** sono inoltre disponibili come filtro e dimensione di visualizzazione nei report di analisi, consentendo ai supervisori di visualizzare i dati sulle prestazioni a livello di categoria aziendale.
* **Caso d'uso:** Aiuta gli amministratori a valutare l'efficienza dell'agente IA, monitorare l'utilizzo di strumenti e skill e tracciare le tendenze di latenza e contenimento per migliorare le prestazioni e il ROI.

{% hint style="info" %}
Il report dell'agente IA dispone di un'impostazione di risparmio sui costi che influisce sulle prestazioni dell'agente virtuale in base a un costo token predefinito.
{% endhint %}

#### <mark style="color:blu;">Il report Prestazioni della conoscenza fornisce dettagli su come gli articoli della knowledge base vengono usati durante le interazioni</mark>

Questo report offre una panoramica su come gli articoli della tua Knowledge Base contribuiscono a risolvere i problemi dei tuoi clienti.

* **Metriche principali**: interazioni assistite dalla conoscenza, tasso di interazioni assistite dalla conoscenza, articoli citati e media di articoli citati per interazione.
* **Filtri**: Intervallo di date, tipo di agente (voce, chat, chatbot), agente IA specifico e fonte dell'articolo.
  * Il filtro della fonte dell'articolo ha due valori — suggerito dall'IA e aggiunto manualmente — e ogni riga dell'articolo mostra un'etichetta di origine, così gli amministratori possono verificare quanto contribuisce il motore di raccomandazione.
* **Caso d'uso**: Aiuta gli amministratori a valutare l'efficacia dei contenuti della knowledge base e a ottimizzarli per migliorare i tassi di risoluzione.
* **Badge KB attivo/inattivo**: Questa funzionalità aggiunge un'icona in stile badge agli articoli della KB che sono stati sostituiti o aggiornati. Sia la versione precedente sia quella nuova rimangono visibili nel report ZVA con chiari indicatori di stato che mostrano se ciascun articolo è attivo o inattivo.

#### <mark style="color:blu;">Il report Query Insight offre una vista dettagliata delle query dei consumatori gestite dagli agenti virtuali</mark>

Questo report fornisce una vista a colpo d'occhio dei dati delle query, inclusi volume delle query, copertura delle corrispondenze, collegamento con l'interazione ed esiti a livello di argomento.

* **Metriche principali:** Query totali, media di query per interazione, argomenti popolari, argomenti risolti, argomenti escalati e tendenze di corrispondenza delle query.
* **Filtri:** Intervallo di date, tipo di agente (voce, chat, chatbot), agente AI, tipo di corrispondenza della query, articolo, argomento, esito dell'interazione, base di conoscenza e lingua.
* **Caso d'uso:** Aiuta gli amministratori e gli analisti a comprendere il comportamento delle query, valutare la copertura degli argomenti e identificare aree di miglioramento della qualità delle risposte e delle prestazioni dell'automazione.

Zoom Virtual Agent analisi offre anche i Topic Groups, una gerarchia a due livelli che organizza automaticamente i topic granulari in categorie allineate al Business come "Fatturazione e Pagamenti" o "Spedizione e Consegna." I supervisori possono identificare a colpo d'occhio i principali fattori di contatto tramite il livello di categoria, mantenendo la possibilità di analizzare più a fondo topic specifici.

Le regole di redazione configurate nelle preferenze del tenant di Zoom Virtual Agent ora si applicano in modo uniforme a tutto il dashboard Query Insights, inclusi l'elenco delle query e le viste di approfondimento. In precedenza queste sezioni mostravano enunciati grezzi indipendentemente dal set di regole configurato; ora rispettano lo stesso set di regole di redazione del resto del prodotto.

#### <mark style="color:blu;">Analisi di confronto: Mostra due segmenti di dati fianco a fianco</mark>

Gli amministratori possono confrontare due segmenti di dati direttamente all'interno delle dashboard di Zoom Virtual Agent, senza esportare o cambiare schermata. Da qualsiasi report, fai clic su Compare, Seleziona un insieme di filtri e il dashboard viene rielaborato in un layout a due coorti, così puoi leggere i due segmenti uno rispetto all'altro. Le analisi di confronto funzionano insieme alle funzionalità di drill-down e cross-filtering della dashboard.

#### <mark style="color:blu;">Il cross-filtering ricalcola le visualizzazioni della dashboard per dimensione</mark>

I supervisori possono fare clic su un valore dimensionale nelle pagine Query Insights, Conversation Details, Knowledge Performance e Agent Performance per applicare il cross-filtering a ogni visualizzazione della pagina. I valori cliccabili includono topic, agenti, strumenti o segmenti del grafico.

Un chip di filtro Mostra la selezione attiva e può essere cancellato facendo clic **x**, selezionando di nuovo il valore oppure facendo clic all'esterno di esso. Più cross-filtro possono essere combinati tra loro e con le impostazioni esistenti della barra dei filtri per mostrare risultati intersecati. Passando il mouse su un elemento filtrabile viene mostrato un cursore a forma di puntatore e un tooltip che anteprima l'azione.

#### <mark style="color:blu;">Il report Conversation Details fornisce informazioni sulle conversazioni basate sulle interazioni per gli agenti virtuali</mark>

La reportistica Conversation Details fornisce dati per i principali indicatori di interazione dell'agente AI.

* **Metriche principali:** Interazioni totali, interazioni multi-turno, durata media e totale dell'interazione e log delle interazioni con metadati (topic, strumenti, skill, motivi di escalation e rispondenti). Per distribuzioni multiistanza, il report aggiunge anche un **Istanza** colonna che identifica quale istanza ha gestito ciascuna interazione.
* **Filtri:** Intervallo di date, tipo di agente (voce, chat, chatbot), agente AI, strumento, esito dell'interazione, ultimo rispondente, skill, topic, trigger della guardrail per trasferimento accettato (solo voce) e per fine dell'agente AI (solo voce) e — per distribuzioni multiistanza — istanza e gruppo di istanze.
* **Caso d'uso:** Consente agli amministratori di analizzare la qualità delle interazioni, monitorare le prestazioni dell'agente AI e della skill e rivedere il comportamento a livello di conversazione per l'ottimizzazione, la supervisione operativa e la reportistica interna.

Quando una conversazione attiva una guardrail di sicurezza back-end, il report Conversation Details la contrassegna con un badge guardrail sull'interazione interessata e con un gruppo che Mostra quali categorie di guardrail si sono attivate e in quale turno. Gli amministratori possono filtrare l'elenco delle interazioni per categoria di violazione — ad esempio, reati violenti, abuso dell'Interprete di codice, privacy o diffamazione — per esaminare solo le conversazioni che hanno attivato una regola. Queste sono le guardrail di sicurezza back-end di Zoom, non le guardrail che un amministratore scrive in Agent Guidance.

Conversation Details include anche una barra di visualizzazione configurabile nella parte superiore del dashboard. Puoi creare le tue visualizzazioni per le variabili — sia di sistema sia personalizzate — scegliendo tra grafici a torta, a barre e a linee. Le visualizzazioni possono essere aggiunte, spostate e ridimensionate, e le tue Impostazioni vengono mantenute a livello di account per la tua sessione successiva. I grafici ancorati rispettano i filtri attivi della pagina, offrendoti una visione chiara della distribuzione delle variabili proprio dove ti serve.

#### <mark style="color:blu;">Il report Consumer Engagement Surveys presenta il feedback dei consumatori raccolto dai sondaggi post-interazione in Zoom Virtual Agent</mark>

Questo report raccoglie il feedback dei sondaggi post-interazione per misurare la soddisfazione dei consumatori, il successo della risoluzione e le opportunità di miglioramento.

* **Metriche principali:** Assegnato all'agente, avvii, risposte, tasso di risposta, tasso di completamento, andamento degli avvii, risposte alle domande del sondaggio e distribuzione del feedback in testo libero.
* **Filtri:** Intervallo di date, agente AI e bot (incluse le varianti se ne esistono più di una).
* **Caso d'uso:** Consente agli amministratori di valutare il sentiment dei consumatori, misurare le prestazioni del chatbot e identificare opportunità per migliorare la qualità dell'interazione e la soddisfazione degli utenti.

#### <mark style="color:blu;">Le metriche di risoluzione implicita deducono gli esiti dei clienti dal comportamento dell'interazione</mark>

Gli amministratori possono valutare le prestazioni dell'agente virtuale con la risoluzione implicita, che deduce automaticamente la risoluzione e la soddisfazione dell'utente in base al comportamento reale, come il completamento del flusso di lavoro e i livelli di interazione. L'analisi comportamentale basata sull'AI funge da giudice.

Questa metrica offre un'alternativa ai sondaggi tradizionali quando i tassi di risposta CSAT espliciti sono bassi e funziona insieme alle metriche basate sui sondaggi esistenti invece di sostituirle. I dati di risoluzione implicita sono disponibili nel Zoom web portal, tramite API o nei report scaricabili, aiutando gli amministratori a ottimizzare l'efficacia di Zoom Virtual Agent.

La logica che determina la risoluzione implicita è stata migliorata per leggere le conversazioni con maggiore precisione, riducendo le classificazioni errate in entrambe le direzioni. Di conseguenza, il tasso di risoluzione riflette con maggiore accuratezza gli esiti effettivi. Gli amministratori potrebbero notare un lieve cambiamento nelle metriche man mano che il miglioramento entra in vigore.

#### <mark style="color:blu;">Il registro delle interazioni fornisce una registrazione dettagliata di ciascuna interazione dell'agente AI e dell'agente vocale, inclusi esiti, durata e trascrizioni per la revisione</mark>

<div data-with-frame="true"><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2FBekwbdgq0PzE6LyvSslJ%2Funknown.png?alt=media&amp;token=228a0e64-0379-4341-8546-1567ff1ccd6d" alt=""></div>

Il registro delle interazioni fornisce una vista dettagliata di ogni interazione gestita dai tuoi agenti AI o vocali. Ti aiuta ad analizzare come è stata gestita ciascuna conversazione, se è stata contenuta dall'AI o inoltrata a un agente in tempo reale, e le principali metriche di performance di quell'interazione.

Questo report è prezioso per supervisori, amministratori e analisti che necessitano di visibilità sull'efficacia dell'agente, sull'esperienza del cliente e sulle prestazioni del sistema.

**Colonne chiave nel registro delle interazioni**

* **ID interazione**: Un identificativo univoco per ciascuna interazione. Puoi usare questo ID per cercare e rivedere conversazioni specifiche.
* **canale**: Indica se l'interazione è arrivata tramite un agente di chat o un agente vocale.
* **Origine**: Mostra il punto di ingresso, ad esempio Zoom centro di contatto, da cui è stata avviata l'interazione.
* **Consumatore**: Il cliente o l'utente finale che ha avviato l'interazione. Potrebbe apparire come un numero di telefono per le chiamate vocali o come un Nome utente per le sessioni di chat.
* **Agente IA**: Identifica quale agente AI ha gestito l'interazione.
* **Strumento / skill / argomento / articolo**: Mostra quali strumenti, skill o risorse di conoscenza l'agente AI ha utilizzato durante l'interazione, come "get ticket status" o "Agent Transfer Request".
* **Esito dell'interazione**: Il risultato finale dell'interazione. "Containment" significa che l'agente AI ha risolto il problema senza escalation. "Escalation" indica che l'interazione è stata trasferita a un agente umano. I motivi dell'escalation vengono mostrati quando applicabile, ad esempio "Escalated by design" o "Escalation requested".
* **Ora di inizio / Ora di fine**: Le marche temporali di inizio e fine dell'interazione.
* **Ultimo rispondente**: Indica chi ha completato l'interazione, l'agente AI o un agente umano dopo l'escalation.
* **Durata dell'interazione**: Il tempo totale in cui è durata l'interazione.
* **Turni di interazione**: Il numero di scambi avanti e indietro tra l'agente AI e il cliente.
* **Durata interattiva**: Per quanto tempo il cliente è stato coinvolto nell'interazione, il che è particolarmente utile per le chiamate vocali.
* **Trasferimento accettato / agente AI uscito**: Mostra se il trasferimento a un agente umano è riuscito e se l'agente AI ha lasciato l'interazione.

Questa reportistica supporta auditabilità, revisione e formazione fornendo tracce di audit che possono migliorare le prestazioni sia dell'AI sia dell'agente umano.

Ad esempio, se l'IT Helpdesk Agent mostra un numero elevato di escalation per le attività di creazione dei ticket, i supervisori possono esaminare le trascrizioni per identificare perché gli utenti stanno richiedendo un agente umano e aggiornare la configurazione dell'AI o i dati di formazione.

**Agent Tracing fornisce visibilità passo passo sul processo decisionale dell’agente virtuale**

Quando esaminano un'interazione, gli amministratori possono usare Agent Tracing per vedere l'intera catena decisionale, dall'elaborazione dell'input fino alla risposta finale. Questo supporta la risoluzione dei problemi, la revisione Quality Assurance e l'ottimizzazione delle prestazioni.

Agent Tracing fornisce una traccia unificata e leggibile dall'uomo collegata a un'interazione specifica. Include una trascrizione completa del cliente insieme alle azioni del sistema. Ogni fase della pipeline è contrassegnata da timestamp con durate di inizio e fine.

Agent Tracing include:

* Acquisizione dell'input
* Classificazione dell'intento/NLU
* Fasi di ricerca e recupero (ad es. riscrittura delle query e selezione delle fonti)
* Inferenza LLM
* Chiamate a strumenti/funzioni
* Rendering della risposta

Agent Tracing fornisce anche riepiloghi a livello di interazione che velocizzano la risoluzione dei problemi. Un riepilogo delle chiamate agli strumenti elenca ogni strumento invocato durante l'interazione, con il relativo stato di successo o fallimento, così gli admin non devono più scorrere la traccia turno per turno per trovare una chiamata specifica. Un riepilogo delle variabili offre una vista consolidata di ogni variabile impostata durante la stessa interazione. Insieme, questi riepiloghi mettono in evidenza, a colpo d'occhio, le esecuzioni degli script, le attivazioni delle skill e il percorso complessivo dell'interazione.

Agent Tracing acquisisce inoltre informazioni dettagliate di tracing e debug per gli strumenti integrati, inclusi lo strumento SMS, lo strumento e-mail, salva risposta e termina conversazione. Per ogni invocazione dello strumento, la traccia registra il motivo per cui lo strumento è stato selezionato, i parametri di input passati, l'output della risoluzione delle variabili, lo stato di esecuzione ed eventuali errori restituiti. La traccia mostra anche perché una conversazione è terminata, incluso se è stata attivata da un'istruzione o da un timeout dopo i tentativi di sollecito.

{% hint style="info" %}
Puoi trovare Agent Tracing all'interno delle analisi di Zoom Virtual Agent. È accessibile dal registro delle interazioni quando si esaminano le singole interazioni.
{% endhint %}

Per convalidare le modifiche dell'agente prima della distribuzione, consulta la sezione Valutazione qui sotto.

#### <mark style="color:blu;">La valutazione convalida le modifiche dell'agente prima della distribuzione tramite test di scenario e confronto tra versioni</mark>

Quando si modifica la configurazione, le indicazioni, le Skill o gli Strumenti di un agente, gli admin devono verificare che tali modifiche non degradino le prestazioni prima della pubblicazione in produzione. La valutazione fornisce per questo un ambiente di test strutturato.

Gli admin possono eseguire valutazioni su qualsiasi versione dell'agente pubblicata o storica, non solo sulla bozza corrente. Le valutazioni vengono eseguite in sola lettura rispetto allo snapshot della versione selezionata, così la versione Attiva dell'agente non viene modificata. Ciò ancora i risultati a una configurazione specifica e nota.

Puoi quindi valutare due versioni dell'agente affiancandole usando lo stesso set di scenari. I risultati servono a mostrare metriche per versione (come i tassi di successo degli scenari, i punteggi di corrispondenza del comportamento e altro ancora), così gli admin possono vedere esattamente dove le prestazioni sono cambiate tra le versioni. Una vista dettagliata della trascrizione consente agli admin di esaminare i singoli casi di test per vedere in che cosa differiscono le risposte.

Prima dell'esecuzione di una valutazione, il sistema convalida l'integrità dei casi di test. Ciò include il controllo di strumenti mancanti, variabili non definite o incongruenze di schema. Questo evita esecuzioni di valutazione inutili ed elimina i falsi negativi causati da errori di configurazione anziché dal comportamento reale dell'agente.

La valutazione supporta gli sforzi degli amministratori per apportare modifiche all'agente pronte per la produzione, il che può aiutare ad accelerare i cicli di iterazione e gestire il rischio. Insieme ad Agent Tracing, crea un flusso di lavoro diagnostico e di convalida robusto.

#### <mark style="color:blu;">La Dashboard ZVA Receptionist offre alle implementazioni più piccole una vista delle prestazioni su un unico schermo</mark>

Per le implementazioni più piccole di ZVA Receptionist che non hanno bisogno dell'intera suite di analisi, una Dashboard su un unico schermo presenta le prestazioni in linguaggio semplice. Ogni valore è aggregato dalle metriche esistenti, quindi non è richiesta alcuna nuova strumentazione. Una riga principale mostra le chiamate gestite, il tempo telefonico gestito (espresso in ore) e il risparmio sui costi. Un anello di contenimento si abbina a un conteggio delle escalation e a un link "Leggi queste conversazioni" che consente di passare direttamente alle interazioni sottostanti. La Dashboard mostra anche i principali motivi per cui le persone hanno chiamato e una ripartizione degli esiti risolto/non risolto, mentre una tabella per agente e un registro delle conversazioni semplificato completano lo schermo — il tutto delimitato da un'unica riga di filtri.

### Dettagli supplementari

Le sezioni seguenti dettagliano informazioni varie relative a Zoom Virtual Agent.

#### <mark style="color:blu;">La privacy e la trasparenza sono al centro di Zoom AI</mark>

Zoom AI segue un approccio federato ai modelli che pone la privacy e la trasparenza dei dati dell'utente al centro. Zoom non utilizza i contenuti dei clienti (come audio, video, chat, condivisione dello schermo, allegati, lavagne e reazioni) per addestrare i modelli AI di Zoom o di terze parti.

Per maggiori dettagli su come i dati fluiscono, vengono elaborati, archiviati e conservati, e su come funzionano i controlli delle Funzionalità, consulta il [Whitepaper sulla sicurezza e la privacy di Zoom AI](https://www.zoom.com/en/products/ai-assistant/resources/privacy-security/#ai-companion-features).

#### <mark style="color:blu;">Agli utenti deve essere concesso Access ai ruoli per modificare le Impostazioni di Zoom Virtual Agent</mark>

Agli utenti deve essere concesso Access a Zoom Virtual Agent prima di configurare o modificare una qualsiasi delle Impostazioni.

{% stepper %}
{% step %}
Come titolare dell'account Zoom o admin autorizzato a modificare i ruoli, vai alla [Gestione ruoli](https://zoom.us/role#/) pagina nel portale web.
{% endstep %}

{% step %}
Fai clic sull'icona a matita a destra del ruolo che stai modificando.
{% endstep %}

{% step %}
Vai alla **AI Studio** sottosezione e definisci l'Access ai ruoli come desiderato.
{% endstep %}

{% step %}
Ripeti per eventuali altri ruoli.
{% endstep %}
{% endstepper %}

**Zoom Virtual Agent non supporta l'Access granulare ai ruoli al momento**

Zoom Virtual Agent non supporta l'Access granulare ai ruoli per la configurazione del prodotto o le modifiche alle Impostazioni. I ruoli utente a cui viene concesso Access possono modificare tutte le Impostazioni e configurazioni del prodotto senza limiti. Gli admin dell'account dovrebbero procedere con cautela quando concedono Access ai ruoli, ma hanno la possibilità di controllare l'Access di visualizzazione e/o di modifica ai vari sottocomponenti.

**L'Access alla dashboard Utilizzo (Fatturazione) può essere concesso separatamente**

Gli amministratori possono concedere Access alla Dashboard di utilizzo Zoom Virtual Agent (Fatturazione) indipendentemente dalle altre Dashboard Zoom Virtual Agent in AI Studio. Una Autorizzazione separata per Virtual Agents in Report di utilizzo controlla autonomamente la Dashboard di Fatturazione, così gli utenti di finanza e operations possono rivedere i dati di Fatturazione senza vedere Dashboard di prodotto non pertinenti, e gli utenti di prodotto e engineering possono usare le Dashboard operative senza visibilità sulla Fatturazione.

<div data-with-frame="true"><img src="https://2272214008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2FNi6DTRoLMjb77L43Q889%2Funknown.png?alt=media&amp;token=8fe77459-bc12-4418-8292-e69a4e78d799" alt=""></div>

#### <mark style="color:blu;">I messaggi e i file delle conversazioni possono essere configurati per l'eliminazione permanente o temporanea nel tempo</mark>

I dati dei messaggi e dei file generati tramite l’uso di Zoom Virtual Agent possono essere configurati per l’eliminazione automatica nel tempo. Con questa opzione, i dati possono essere eliminati in incrementi giornalieri o mensili compresi tra 1 e 30 giorni oppure tra 1 e 12 mesi.

I dati contrassegnati per l'eliminazione permanente verranno rimossi in modo irreversibile da un account e non potranno essere ripristinati su richiesta. I dati contrassegnati per l'eliminazione soft verranno rimossi da un account, ma potranno essere recuperati fino a 30 giorni su richiesta prima dell'eliminazione permanente.

#### <mark style="color:blu;">Zoom Virtual Agent è Disponibile a livello globale, ma i dati elaborati dall'AI non possono essere localizzati</mark>

Zoom Virtual Agent è Disponibile per tutti i Clienti commerciali globali in [paesi e regioni senza restrizioni](https://support.zoom.us/hc/en-us/articles/203806119-Restricted-countries-or-regions). I contenuti delle comunicazioni, come registrazioni e trascrizioni, possono essere localizzati nelle Impostazioni admin tramite Zoom web portal. Tuttavia, i dati elaborati utilizzando funzionalità AI/LLM non possono essere localizzati in regioni specifiche. Il [Zoom AI per centro di contatto e AI Expert Assist: libro bianco su sicurezza e privacy](https://www.zoom.com/en/products/ai-assistant/resources/privacy-security/zoom-contact-center/) contiene ulteriori informazioni sulla gestione dei dati di Zoom centro di contatto.

#### <mark style="color:blu;">I registri delle modifiche e i confronti tra versioni sono disponibili per gli Agent pubblicati</mark>

Gli amministratori possono visualizzare un registro delle modifiche quando pubblicano modifiche dell'agent. Il registro mostra tutti gli aggiornamenti alla versione bozza, incluse aggiunte, eliminazioni e modifiche, con codifica a colori e informazioni sul titolare per ogni modifica. Gli amministratori possono rivedere le modifiche prima di decidere se pubblicare o annullare.

Gli amministratori possono anche confrontare due versioni pubblicate dell'agent. Il confronto copre tutti i componenti dell'agent, inclusi saluto, guida, competenze di saluto, competenze e strumenti. Indicatori visivi evidenziano eventuali differenze, sostituendo il tracciamento manuale tramite strumenti esterni.

#### <mark style="color:blu;">Zoom Virtual Agent supporta più lingue e dialetti</mark>

La Zoom Virtual Agent di nuova generazione supporta più lingue e dialetti nella chat e nella voce. L'elenco delle lingue attualmente supportate include:

| <p>Arabo<br>Arabo (Golfo)<br>Cantonese<br>Catalano<br>Cinese (semplificato)<br>Cinese (tradizionale)<br>Danese<br>Olandese (Paesi Bassi)<br>Inglese (Australia)<br>Inglese (India)<br>Inglese (italiano)<br>Inglese (Nuova Zelanda)<br>Inglese (Scozia)<br>Inglese (Singapore)<br>Inglese (Regno Unito)</p> | <p>Inglese (Stati Uniti)<br>Francese (Francia)<br>Francese (Canada)<br>Finlandese<br>Tedesco<br>Inglese (gallese)<br>Ebraico<br>Hindi<br>Indonesiano<br>Italiano<br>Giapponese<br>Coreano<br>Norvegese<br>Malese<br></p> | <p>Polacco<br>Portoghese (Portogallo)<br>Portoghese (Brasile)<br>Rumeno<br>Russo (Russia)<br>Spagnolo (Europa)<br>Spagnolo (Messico)<br>Spagnolo (Stati Uniti)<br>Svedese<br>Tailandese<br>Turco<br>Vietnamita<br><br><br></p> |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

Il sistema mostra le voci disponibili specifiche per la lingua selezionata e supporta funzionalità localizzate di sintesi vocale per numeri, date, Numeri telefonici e altri contenuti formattati. Questa espansione consente alle organizzazioni di offrire esperienze cliente più localizzate in più regioni.

{% hint style="info" %}
Lingue aggiuntive verranno aggiunte nel tempo. Questo documento verrà aggiornato man mano che verrà rilasciato il supporto per nuove lingue. L'aggiunta di nuove lingue richiede l'attivazione da parte di Zoom. Contatta il team del tuo account Zoom per abilitare ulteriori funzionalità linguistiche.
{% endhint %}

**Supporto multilingue esteso per gli agenti chat**

Le esperienze di chat di Zoom Virtual Agent ora supportano un insieme ampliato di lingue, consentendo agli amministratori di Configura un singolo agente chat che serve Clienti in più regioni e lingue. Questo miglioramento elimina la necessità di creare e gestire agenti separati per ogni lingua supportata, tornando all'approccio multilingue semplificato che era Disponibile in ZVA 1.0.

Quando crea un agente chat, gli amministratori possono Seleziona più lingue che l'agente supporterà. Una volta configurato, il sistema determina automaticamente la Lingua di coinvolgimento in base a fattori come le selezioni della schermata di benvenuto, le Impostazioni della Lingua HTML del browser e altri segnali contestuali. La Lingua selezionata rimane coerente per tutta la conversazione, offrendo un'esperienza coerente per l'utente finale.

La traduzione automatica gestisce automaticamente la localizzazione dei messaggi di saluto, dei contenuti del flusso e del testo dei pulsanti. Ciò significa che gli amministratori non devono tradurre ogni elemento dell'esperienza di chat quando aggiungono il supporto linguistico.

La versione attuale si concentra sulla selezione della Lingua all'inizio della conversazione. Gli amministratori Configura le lingue supportate durante la creazione dell'agente chat e il sistema fissa la Lingua di coinvolgimento quando la conversazione inizia.

#### <mark style="color:blu;">Zoom Virtual Agent non è Disponibile per i Clienti di Zoom per la Pubblica amministrazione</mark>

Zoom Virtual Agent non è Disponibile per i Clienti di Zoom per la Pubblica amministrazione (FedRAMP) al momento.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://library.zoom.com/technical-library/it/servizi-business/zoom-virtual-agent/zoom-virtual-agent-explainer.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
