> 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-admin-experience.md).

# Esperienza admin

Esplora l'architettura di Zoom Virtual Agent, la configurazione, le integrazioni e il comportamento degli agenti vocali e chat.

### 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 la conversione da voce a testo e ne determina l'intento.
* **Processo decisionale**: Applica la logica di business e le regole di Instradamento per determinare la migliore azione successiva.
* **Gestione delle Integrazioni**: Si coordina con sistemi di conoscenza, strumenti e modelli per comporre risposte o avviare flussi di lavoro.
* **Comportamenti agentici**: Supporta l'esecuzione automatizzata delle attività, il monitoraggio del contesto e l'adattabilità conversazionale senza richiedere la 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:

* **Access alle conoscenze Enterprise**: Si connette a repository di dati strutturati e non strutturati, come centri assistenza o documentazione interna.
* **Recupero dinamico**: Durante le conversazioni, l'agente recupera frammenti di conoscenza pertinenti per rispondere a domande su fatti o criteri aziendali.
* **Scalabilità**: I sistemi di knowledge base possono essere estesi a più marchi, linee di prodotti 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:

* **Invia prompt** a modelli esterni o interni in base alle espressioni dell'utente.
* **Riceve completamenti generati** che facilitano la comprensione di un linguaggio complesso, il ragionamento su più turni e il dialogo aperto.
* **Disaccoppia 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 le conversazioni dal vivo.
* **Consente di selezionare una voce personalizzata** in linea con la personalità del marchio o con le esigenze di Accessibilità.
* **Supporta l'output multilingue** per migliorare l'usabilità nelle implementazioni a livello globale.

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**

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

* **Competenze e strumenti Zoom**: Integrazioni native con l'ecosistema Zoom, ad esempio centro di contatto Zoom, Zoom Scheduler e Zoom Revenue Accelerator, per azioni come l'escalation, la prenotazione o l'assegnazione di tag per le analisi.
* **Strumenti di terze parti**: Estendono le funzionalità oltre Zoom tramite Integrazioni con sistemi e applicazioni esterni. Per i Clienti, Scegli tra:
  * **Strumenti di terze parti predefiniti sviluppati da Zoom**: Disponibile per configurazioni rapide.
  * **Strumenti di terze parti personalizzati creati dagli sviluppatori dei Clienti con AI Studio**: Offrono maggiore flessibilità e Integrazioni su misura con CRM, gestione dei servizi IT (ITSM), sistemi di ticketing o altre piattaforme aziendali.

Questi strumenti servono a consentire a un agente virtuale di eseguire processi Business 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 degli intenti dagli input della chat.
* **Processo decisionale**: Esecuzione della logica di business per guidare il completamento delle attività, i flussi condizionali o l'escalation.
* **Gestione delle Integrazioni**: Integrazioni con fonti di conoscenza e strumenti per supportare conversazioni ricche e reattive.
* **Comportamenti agentici**: Supporta l'esecuzione automatizzata delle attività, il monitoraggio del contesto e l'adattabilità conversazionale senza richiedere la 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.

L'AI Runtime Service sfrutta anche l'elaborazione parallela per le operazioni vocali di backend. Per maggiori dettagli, consulta la sezione [Componenti principali dell'agente vocale](#core-components-of-the-voice-agent) .

**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 conoscenze aziendali in tempo reale in base ai messaggi dell'utente.
* **Recupera** i frammenti più pertinenti mediante corrispondenze semantiche o basate su parole chiave.
* **Genera** risposte contestuali utilizzando le informazioni recuperate e l'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:

* **Instrada** prompt a più LLM per capacità di ragionamento flessibili.
* **Access** output dei modelli per interpretare domande complesse, riassumere articoli o generare risposte di più frasi.
* **Passa a un altro piano o esegui l’upgrade** provider di modelli 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 i modelli** ottimizzati per il loro dominio o caso d’uso (ad es. assistenza, risorse umane, Onboarding dei prodotti).
* **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 dell'organizzazione 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:

* **Competenze e strumenti Zoom**: le integrazioni native con l'ecosistema Zoom (ad esempio Zoom Scheduler e il centro di contatto Zoom) consentono all'agente di indirizzare gli utenti, prenotare riunioni, inoltrare le interazioni o assegnare etichette ai feedback automaticamente.
* **Strumenti di terze parti**: estendi l'automazione oltre Zoom tramite la Connessione a sistemi e applicazioni esterni. Questi includono:
  * **Strumenti di terze parti predefiniti sviluppati da Zoom**: abilitabili con un solo clic per un'attivazione rapida e risultati più veloci.
  * **Strumenti di terze parti personalizzati creati dagli sviluppatori dei clienti con AI Studio**: offrono una personalizzazione più approfondita e integrazioni flessibili con CRM, ITSM, sistemi di ticketing o altre piattaforme aziendali.

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 un turno e l’altro.
* **Generazione e registrazione delle trascrizioni**, che vengono inoltrate allo spazio di archiviazione dei file.
* **Hook di test e strumenti di amministrazione** per convalidare il flusso della conversazione.

Aiuta gli agenti virtuali 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 al centro dello schermo**, aiutando gli utenti a concentrarsi sulla conversazione.
* **Le interazioni in background possono essere disabilitate** 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.

Per le campagne multilingue, gli amministratori possono selezionare risorse dalla libreria delle risorse per ogni campo di testo nella configurazione degli stili del front door digitale, inclusi il testo di saluto, i pulsanti di invito all’azione, i titoli delle schede, le etichette dei moduli, i nomi dei link, le descrizioni degli articoli e i blocchi di testo. In fase di esecuzione, ogni utente visualizza il testo localizzato in base alla lingua rilevata, così un singolo front door digitale può servire Clienti in più lingue. Le campagne monolingue continuano a usare l’inserimento manuale del testo. Per configurare l’agente chat stesso in più lingue, consulta [Zoom Virtual Agent supporta più lingue e dialetti](#zoom-virtual-agent-supports-multiple-languages-and-dialects)

**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 la conferma del 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 è progettato per estrarre e agire silenziosamente sul contenuto. Invece, conferma prima con il Cliente prima di procedere.

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 progettati per rilevare immagini inappropriate e generate dall'IA caricate durante le conversazioni. Il sistema analizza i caricamenti in tempo reale e risponde con messaggi predefinito quando viene identificato contenuto limitato. Se qualcuno carica ripetutamente materiale inappropriato, tali violazioni attivano l'escalation automatica a un agente umano. Questi guardrail dei contenuti sono abilitati per impostazione predefinito e non richiedono configurazione admin.

{% hint style="info" %}
**Nota**

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 la Guida per gli agenti, gli amministratori specificano il Ruolo dell'agente, definiscono le attività che deve svolgere e verificano gli scenari supportati e non supportati. Zoom AI genera una bozza iniziale che può essere perfezionata per soddisfare i requisiti specifici. L'assistente integrato **Prompt Assistant** aiuta a semplificare questo processo, consentendo agli utenti di qualsiasi livello di esperienza di ottimizzare e perfezionare i prompt. In questo modo, ogni agente riceve indicazioni chiare ed efficaci.

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 ed esecuzione degli strumenti visibili**: durante il turno attivo, gli aggiornamenti sull'elaborazione e le operazioni degli strumenti sono visibili. Ogni strumento viene visualizzato come un singolo elemento con un nome leggibile e passa da **In esecuzione** a **Completato**, seguendo l'ordine di esecuzione. Il ragionamento interno dettagliato e i risultati degli strumenti restano nascosti per scelta progettuale.
* **Copertura completa degli strumenti conversazionali per Receptionist**: SMS in uscita, trasferimento per nome e pianificazione possono essere configurati tramite conversazione, in linea con la copertura di Voice Agent. Agent Architect gestisce la configurazione generale e le opzioni predefinite, mentre gli input specifici dell’account — mittenti, destinazioni di instradamento, URL e variabili — restano sotto il controllo dell’utente in Revisione/Modifica. Se mancano dettagli, la bozza rimane incompleta anziché inventarli.
* **Variabili esclusivamente esistenti, con flusso guidato per i segnaposto**: Agent Architect non crea più variabili automaticamente. Ogni associazione deve corrispondere a una variabile esistente e autorizzata. I riferimenti non risolti diventano segnaposto che gli utenti completano tramite la selezione guidata della Libreria delle competenze. L’applicazione finale viene bloccata finché ogni associazione non è valida; i campi degli strumenti che richiedono variabili (come il destinatario dell’SMS e il link di pianificazione) restano vuoti finché non vengono associati esplicitamente.

{% hint style="info" %}
**Nota**

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 amministratori possono collegare il proprio calendario Google, Outlook o Apple e creare una pagina di prenotazione Zoom Scheduler in un unico passaggio, all’interno del flusso di Onboarding di Zoom Virtual Agent. Selezionando la **pianificazione** durante il passaggio dedicato alle competenze consigliate si apre una procedura guidata integrata di Scheduler, che gestisce dall’inizio alla fine la connessione del calendario, la disponibilità e la creazione della pagina di prenotazione. In questo modo, Receptionist può effettuare prenotazioni basate su disponibilità reali e aggiornate fin dal primo giorno. Al termine, un gruppo di conferma mostra il calendario collegato, una descrizione del tipo di riunione precompilata e un menu a discesa che consente di selezionare o aggiungere pagine di prenotazione. Gli amministratori che dispongono già di 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>

Zoom Virtual Agent fornisce risposte accurate attraverso un processo in tre fasi: recupero, arricchimento e generazione (RAG). Quando un utente invia una domanda, il sistema recupera prima le informazioni più pertinenti dalla Knowledge Base, ancorando la risposta a dati fattuali e specifici dell'azienda. Questo contenuto recuperato viene quindi arricchito e associato alla query originale dell'utente per fornire al modello linguistico un contesto preciso. Infine, il modello genera una risposta naturale, coerente e contestualmente rilevante per l'utente finale.

**Comprendere la Knowledge Base dell'agente virtuale**

Zoom Virtual Agent si affida alla sua Knowledge Base per fornire risposte coerenti e accurate in linea con le policy aziendali. Gli amministratori hanno diverse opzioni di Integrazioni per popolare la Knowledge Base:

* **Integrazioni API**: Sincronizza automaticamente gli articoli della knowledge base da fonti come Zendesk, ServiceNow e Zoom Docs.
* **Integrazione manuale**: Carica contenuti come PDF e CSV oppure crea e modifica articoli direttamente nell'interfaccia web.
* **Sincronizzazione web**: Usa la scansione web per acquisire FAQ e articoli della knowledge base 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 di un agente dipende dalla qualità della sua Knowledge Base. 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 a un Virtual Agent di recuperare in modo efficiente le informazioni più pertinenti. Per ridurre al minimo l'ambiguità, i contenuti dovrebbero utilizzare frasi concise e strutturate e una Lingua semplice. I riferimenti dipendenti dalla Posizione, come «vedi sopra», dovrebbero essere sostituiti con identificatori 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 dell'Assistenza Zoom [Informazioni sui tipi di sincronizzazione della knowledge base 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 Knowledge Base Groups — il meccanismo usato in precedenza per raggruppare più Knowledge Base insieme in ZVA 1.0 — non si applicano all'ultima versione di Zoom Virtual Agent. Nella versione corrente, non puoi Assegna un gruppo Knowledge Base a un agente. Invece, Assegna direttamente le singole Knowledge Base.

**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.
* Sono supportati solo gli elementi HTML di base (stili come grassetto, collegamenti ipertestuali, `<div>` tag ecc.). Gli elementi HTML avanzati, come i tag script, vengono rimossi al salvataggio dei contenuti.
* 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 sincronizzazione include timeout integrati per garantire affidabilità e prestazioni. L'attività singola più lunga è **la creazione dell'indice**, con un **timeout di 30 minuti**. Se la creazione dell'indice supera questo limite, l'attività non andrà a buon fine 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 libreria di Tool di Zoom Virtual Agent è pensata per consentire 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, un Tool rappresenta un metodo definito per recuperare dati da o inviare dati a sistemi di terze parti. Questo consente ai 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**

I Tool 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, i Tool sono progettati per consentire agli amministratori di definire esattamente quali campi dati devono essere restituiti. Questo approccio riduce l'ambiguità, migliora l'affidabilità e consente ai Virtual Agent di fornire risposte coerenti senza essere appesantiti da payload API non necessari o irrilevanti.

**Gestione dei dati sensibili ed eccessivi**

Quando si interagisce con sistemi esterni, le API possono restituire informazioni sensibili come dati personali identificabili (PII) o grandi quantità di dati non necessari. La Tool Library supporta l'uso di JavaScript per manipolare le risposte prima di passarle al modello di terze parti. Gli amministratori possono filtrare, trasformare o eliminare campi per mantenere solo le informazioni essenziali. Questo aiuta a limitare l'esposizione dei dati sensibili, evita di sovraccaricare il modello e semplifica l'interazione tra i Virtual Agent 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 Skill di Virtual Agent**

Le competenze sono alla base del modo in cui un agente virtuale esegue le attività. Ogni competenza è definita da due elementi fondamentali: una **descrizione del trigger** che specifica quando la competenza deve attivarsi e un insieme di **istruzioni** che guidano l'agente virtuale nel completamento dell'attività. Le istruzioni possono includere indicazioni in linguaggio naturale e riferimenti agli strumenti, che consentono alla competenza 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, Zoom 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 anziché a istruzioni esplicite passo per passo. Questo significa che gli amministratori devono fornire istruzioni chiare per la Skill e descrizioni dei Tool, così che l'agente possa interpretarle correttamente. È importante sottolineare che l'agente ha accesso a tutte le Skill e i Tool, e può decidere di usare Tool associati a Skill diverse se sono pertinenti al task.

**Il caricamento dinamico delle competenze riduce ciò che ogni conversazione deve gestire**

Per gli agenti con più funzionalità, Zoom Virtual Agent supporta il caricamento dinamico delle competenze. Invece di caricare le istruzioni e gli strumenti di ogni competenza all'inizio di ciascuna conversazione, l'agente parte da un indice leggero delle competenze e carica solo quelle pertinenti alla richiesta corrente. In questo modo riduce l'uso dei token e la latenza delle risposte, migliora la precisione nella selezione degli strumenti e rende più efficace la memorizzazione nella cache dei prompt, preservando al contempo tutte le funzionalità dell'agente.

**Migliori pratiche per progettare le Skill**

Per garantire un'esecuzione affidabile, gli amministratori dovrebbero scrivere **descrizioni dei trigger chiare e concise** che riflettano accuratamente quando una Skill deve attivarsi. Le istruzioni possono essere organizzate in più riquadri per gestire meglio le Skill; tuttavia, vengono combinate durante l'esecuzione. Gli amministratori dovrebbero evitare di inserire nelle istruzioni comandi espliciti come «chiama questo Tool ora». Le istruzioni dovrebbero invece descrivere il risultato desiderato, mentre i nomi e le descrizioni dei Tool dovrebbero indicarne l'uso corretto. Si consiglia di limitare il numero di Skill a circa cinque (5), poiché una configurazione eccessiva può causare limitazioni della finestra di contesto.

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

Le Skill non possono salvare direttamente dati nelle variabili globali. Gli amministratori devono invece combinare le istruzioni con l'uso di Tool integrati o personalizzati. Per esempio, una Skill può includere istruzioni per raccogliere il numero di account di un cliente, ma il salvataggio effettivo di questi dati in una variabile deve avvenire tramite un Tool come **collect\_save\_response** o un'integrazione personalizzata. Questa separazione è stata pensata per favorire una gestione coerente e sicura dei dati sensibili all'interno del framework Zoom Virtual Agent.

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

L'interazione tra Skills e Tools rispecchia il modo in cui un agente umano addestrato applica le proprie conoscenze. Ad esempio, quando un cliente segnala di aver smarrito una carta di credito, Zoom Virtual Agent avvia la Skill “Carta di credito smarrita”. Le istruzioni richiedono la Verifica dei Membri, inducendo l'agente a usare la Skill “Verifica i Membri” prima di proseguire. Dopo la Verifica, l'agente torna a disattivare la carta, offre di controllare le transazioni recenti e, se opportuno, trasferisce la chiamata a un agente in tempo reale. Allo stesso modo, in uno scenario “Controlla le transazioni recenti”, un agente confermerebbe prima l'identità dei Membri prima di recuperare i dettagli della transazione. Questi scenari illustrano come le Skills forniscano struttura, mentre l'agente seleziona automaticamente i Tools 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" %}
**Nota**

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" %}
**Nota**

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" %}
**Nota**

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 Okta integra la piattaforma di identità di Okta con Zoom Virtual Agent, così sia i chiamanti vocali sia gli utenti della 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 una Verifica riuscita, può attivare azioni automatizzate come il ripristino della password, lo sblocco dell'account, il ripristino dei fattori MFA e la generazione di Temporary Access Code (TAC). Okta è progettato per rimanere invisibile all'utente finale per tutto il processo.

{% hint style="info" %}
**Nota**

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

**L'integrazione con Ping Identity consente la verifica dell'identità self-service nelle interazioni vocali**

L'integrazione con Ping Identity consente ai chiamanti di risolvere autonomamente i problemi di identità più comuni tramite interazioni vocali. Le azioni supportate includono il recupero della password, lo sblocco dell'account, il ripristino di un fattore MFA e la registrazione di un fattore. Zoom Virtual Agent può anche avviare richieste di verifica tramite notifiche push o dati biometrici e controllarne l'esito prima di consentire l'esecuzione di un'azione protetta.

Ping Identity rimane completamente trasparente per il chiamante e Zoom Virtual Agent non memorizza mai informazioni sensibili come password, codici monouso o dati biometrici. Se un tentativo di Verifica non riesce o una richiesta API non va a buon fine, l'agente propone di riprovare oppure di passare a un operatore.

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

Il Connettore FedEx porta il self-service 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 iscriversi, tramite un indirizzo e-mail, per ricevere notifiche FedEx per eventi chiave come consegne, eccezioni e stime di consegna aggiornate. Tali notifiche vengono inviate direttamente da FedEx al destinatario, quindi, in base al comportamento attuale dell'API FedEx, 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>

Zoom 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, Tools disponibili e la cronologia precedente della conversazione. Gli Agenti virtuali usano 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, un agente valuta se la richiesta è in linea con una Skill definita o se può essere پاسخesa direttamente dalla base di conoscenza. Le Skills vengono usate quando una domanda richiede l'esecuzione di attività o passaggi di workflow, mentre la base di conoscenza viene usata quando le informazioni fattuali sono sufficienti. L'agente determina automaticamente questa scelta in base alle sue istruzioni e al contesto disponibile.

Le indicazioni per l'agente influenzano anche gli agenti virtuali, soprattutto quando determinati argomenti non sono consentiti. Un agente virtuale non è progettato per svolgere attività autonome, ad esempio cercare articoli pertinenti nella Knowledge Base per argomenti che gli è stato indicato di evitare. Per ulteriori informazioni sulle indicazioni per l'agente, consulta la sezione precedente [Le indicazioni per l'agente costituiscono l'identità fondamentale dell'agente e ne definiscono tono, scopo e 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 consente a un agente ulteriori opportunità per risolvere le richieste dei Clienti prima dell'Instradamento verso l'Assistenza live.

In precedenza, qualsiasi messaggio utente che richiedeva un agente in tempo reale attivava immediatamente un'escalation. Con questo aggiornamento, gli amministratori possono Configura un conteggio dei ritentativi nelle Impostazioni dell'agente chat che richiede agli utenti di chiedere aiuto umano più volte prima che avvenga il trasferimento. Durante queste richieste intermedie, un Agente virtuale invita l'utente a riformulare la domanda, fornendo all'IA un contesto aggiuntivo per tentare la risoluzione. Il sistema tiene traccia di ogni richiesta di escalation e, una volta che il conteggio raggiunge la soglia configurata, la chat viene instradata a un canale di Assistenza umana.

Il valore predefinito è **1**, che mantiene il comportamento precedente, in cui la prima richiesta viene trasferita immediatamente. Impostando una soglia più alta, l'agente può effettuare ulteriori tentativi di risoluzione prima di trasferire la conversazione. Questo approccio può migliorare le metriche di contenimento e deflessione riducendo i trasferimenti non necessari e aumentando i tassi di automazione. La soglia di escalation è allineata alla funzionalità di soglia già disponibile per gli agenti vocali, garantendo un comportamento coerente tra i diversi canali.

**Gli strumenti di trasferimento e di fine conversazione controllano ciò che i consumatori sperimentano al passaggio di consegne e alla chiusura**

Gli amministratori possono creare più istanze dello strumento di trasferimento integrato, assegnando a ciascuna un proprio nome, una destinazione di trasferimento e un messaggio pre-trasferimento. In questo modo, il messaggio che un consumatore riceve prima di passare a un agente umano, a un reparto, a una coda o ad altra destinazione designata può adattarsi allo scenario che ha attivato il trasferimento. Ogni istanza supporta anche un messaggio predefinito che si applica quando non è stato definito alcun messaggio specifico per la destinazione.

Lo strumento integrato di fine conversazione supporta messaggi di chiusura personalizzati che sostituiscono l'addio predefinito. Gli amministratori possono definire messaggi separati per chat e voce, e per conversazioni In entrata e In uscita. Se l'agente ha già fornito un messaggio di chiusura in un turno precedente, gli amministratori possono configurare una chiusura silenziosa in modo che il consumatore non riceva un addio duplicato o in conflitto. Quando non è configurato alcun messaggio personalizzato, Zoom Virtual Agent usa il messaggio predefinito.

Lo strumento di fine conversazione è inoltre Disponibile direttamente nei flussi curati per chat e voce, così gli amministratori possono terminare una conversazione in qualsiasi punto definito della logica del flusso. Per inviare prima un messaggio di chiusura, inserisci un widget Invia media prima dello strumento di fine conversazione. Questo elimina la necessità di chiamare una skill separata solo per terminare una conversazione.

**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 per l'agente, le preferenze linguistiche, le API disponibili, le descrizioni dei Tool, la cronologia della conversazione e l'ultima richiesta dell'utente. Gli amministratori influenzano direttamente il comportamento dell'agente tramite le **istruzioni per l'agente** e il **strumenti che Configura**, mentre il sistema gestisce tutti gli altri campi. Questo contesto strutturato fornisce agli agenti virtuali le informazioni giuste per dare 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 **Chiudi automaticamente gli engagement inattivi all'interno dei flussi** timer fino a un massimo di 24 ore, rispetto al precedente limite di 12 ore. L'interfaccia admin mostra la durata dell'interazione in un formato chiaro, espresso in ore e minuti. Questa modifica allinea i limiti di durata delle interazioni del centro di contatto Zoom a quelli di Zoom Virtual Agent e contribuisce a ridurre gli errori di configurazione, eliminando la necessità di calcolare manualmente i minuti.

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

Zoom Virtual Agent può trasferire riepiloghi delle conversazioni e metadati personalizzati agli agenti di Zoom Phone durante i passaggi di chiamare tramite il pass-through delle variabili. Gli amministratori usano il portale amministratori di ZVA per Scegli quali variabili mostrare nell'interfaccia di Zoom Phone durante le chiamare trasferite. Ciò fornisce agli agenti informazioni sul chiamante già raccolte, senza doverle chiedere di nuovo, e può aiutare a ridurre i tempi medi di gestione.

Gli utenti di Zoom Phone possono vedere riepiloghi di chiamare generati da ZVA e variabili chiave in tre momenti:

* Prima di rispondere a una chiamare
* Durante la conversazione
* Dopo che la chiamare termina

Il passaggio delle variabili richiede una licenza Zoom Phone Customer Engagement Pack (precedentemente nota come il Power Pack di Zoom Phone). I riepiloghi di chiamare non richiedono questa licenza.

{% hint style="info" %}
**Nota**

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 gli articoli della nostra biblioteca tecnica [Personalizza l’esperienza di assistenza via chat per gli utenti](https://library.zoom.com/business-services/zoom-contact-center/expert-insights/customize-user-chat-support-experience) e [Integra le funzionalità del centro di contatto Zoom 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. Nel tempo, l’agente diventa più coerente, conforme alle policy e preciso senza bisogno di riaddestramento manuale. I miglioramenti sono osservabili tramite le prestazioni e le analisi dell’agente virtuale e Agent Tracing. Per ulteriori informazioni, consulta la sezione [Analisi e report](https://library.zoom.com/technical-library/it/servizi-business/zoom-virtual-agent/zoom-virtual-agent-analytics-reporting.md) .

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

Gli amministratori possono Configura Zoom Virtual Agent per effettuare chiamate In uscita verso elenchi di Clienti in base a regole di Business e parametri di pianificazione definiti. Un Virtual Agent può chiamare i Clienti, fornire messaggi scriptati, rispondere alle domande dei Clienti usando le proprie basi di conoscenza e skill, ed escalare agli agenti live quando necessario. I controlli integrati di gestione delle chiamate aiutano ad allineare le attività di contatto con le 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 Zoom Virtual Agent per migliorare le interazioni vocali. Durante una chiamata, un Virtual Agent può chiamare l'attenzione dei Clienti inviando messaggi SMS personalizzabili contenenti testo dinamico, URL o link a sondaggi. Il sistema supporta variabili e divide i messaggi più lunghi per una consegna efficiente. Ciò consente ai Clienti di ricevere informazioni dettagliate che è difficile comunicare 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" %}
**Nota**

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" %}
**Nota**

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, un punto vendita) o a un gruppo di istanze (ad esempio, un gruppo regionale di punti vendita), in aggiunta ai filtri esistenti per agente virtuale e versione. Questi filtri si applicano ai report Panoramica, Prestazioni dell’agente virtuale e Dettagli della conversazione.

{% hint style="info" %}
**Nota**

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;">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" %}
**Nota**

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-admin-experience.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.
