# Amministrazione

### Gestione ruoli

#### <mark style="color:blu;">Gestione ruoli: Gli admin devono avere autorizzazioni Basato sul ruolo per accedere a AI Studio</mark>

Per accedere ad AI Studio all'interno del portale web di un account Zoom, gli utenti (admin) devono avere un Ruolo con le autorizzazioni sufficienti per AI Studio. Per impostazione predefinito, solo il Titolare dell'account avrà Access a questa Funzionalità e al Ruolo Admin predefinito devono essere assegnate queste autorizzazioni.

Per aggiornare un Ruolo con le autorizzazioni applicabili, eseguire i passaggi seguenti:

1. Come titolare dell'account Zoom o admin autorizzato a modificare i Ruoli, vai alla [Gestione ruoli](https://zoom.us/role#/) pagina nel portale web.
2. Fai clic sull'icona a forma di matita ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXdrt4w892b-zEM2wS7LJ91RM20YJQgpbrq4oo_aydenYlSeh5rk6riEmEw0lPlO93avV08ChLRgjAtUq_no29yJFQ0kR-dfa-L0HsTiuXhawRxaQ1WU90lKAhJPOAFQaHI7wE2A?key=8xRdbBwKrN2U2fUmgGv7Q9gQ) a destra del Ruolo che stai modificando.
3. Vai alla sottosezione AI Studio e definisci l'Access al Ruolo come desiderato.
4. Ripeti per eventuali Ruoli aggiuntivi.

<div data-with-frame="true"><figure><img src="/files/dfacbfff9bf93e531f3843610ef93b64bf03aa31" alt="An image showing an example of AI Studio roles" width="563"><figcaption><p>Esempio di ruoli di AI Studio</p></figcaption></figure></div>

#### Accesso ad AI Studio

Gli admin con autorizzazioni Basato sul ruolo sufficienti possono accedere ad AI Studio tramite Zoom web portal facendo clic sul menu AI Studio sul lato sinistro dello schermo, nella sottosezione admin.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcPgi4MSwEjaqMywHyRNzsBXyBtelMYSZbyVFsr5jsDhuBKnt9JTkvbI4xTzV4oaE1tHJTucVcVRDaZ3EVG7vVlOMZjm1QKCvuWRputKt27eQcVIzKduYE2r5FewjiOkgGbh0FC?key=8xRdbBwKrN2U2fUmgGv7Q9gQ" alt="Image showing how to access AI Studio in the Web Portal" width="375"><figcaption><p>Accesso ad AI Studio nel portale Web</p></figcaption></figure></div>

### Licenza

#### <mark style="color:blu;">Licensing: Concessione agli utenti di Access alle funzionalità personalizzate di AI Companion</mark>

Per concedere agli utenti finali l'accesso a Custom AI Companion, gli utenti devono avere assegnata una licenza add-on di Custom AI Companion.

Gli amministratori dell'account possono anche Assegna agli utenti licenze Custom AI Companion sia tramite provisioning manuale sia tramite SSO, tramite mapping della risposta SAML o SCIM.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdt5GpwY92fM8riIzDb84ukL1UiJsXRPJdXsXbQj7F41L4ifi_WrpR9stcjsKmpINpWSD0ePBFgYpOTOR2h4p3sWTh5RuyTY7w-esi9W7_Mv3GMqTfomwMaxlPxFuyTfZ8FFQcs8w?key=8xRdbBwKrN2U2fUmgGv7Q9gQ" alt="An example image of assigning a Custom AI Companion License" width="563"><figcaption><p>Esempio di assegnazione di una licenza AI Companion personalizzata</p></figcaption></figure></div>

Fare riferimento al Centro assistenza di Zoom per ulteriori informazioni su [assegnazione manuale delle licenze](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0064911), provisioning tramite [mappatura avanzata delle risposte SAML](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0061497), oppure includendo il [parametro SCIM 2](https://developers.zoom.us/docs/api/scim2/#tag/user/GET/scim2/Users) per AI Companion personalizzato all'interno del payload del proprio provider di identità.

### Knowledge Bases: Cose da sapere

Per Configura una Knowledge Base, come admin, estendi il **AI Studio** menu nel Zoom web portal e fai clic su **Knowledge**.

#### <mark style="color:blu;">Le Knowledge Base vengono utilizzate per contenere le origini dati pertinenti per ciascun argomento rilevante</mark>

All'interno della scheda Knowledge, gli amministratori possono creare Knowledge Base, che funzionano come cartelle di primo livello per un determinato argomento, soggetto o gruppo.

Ad esempio, se si crea una Knowledge Base per le Risorse Umane, questa Knowledge Base verrebbe popolata con origini dati (ad es. documenti, risorse) utilizzate più comunemente dal reparto Risorse Umane.

<div data-with-frame="true"><figure><img src="/files/38d74b53b2e2df9a677f3b8b34bb08dcfa933856" alt="An image showing the interface for choosing a Knowledge Base type" width="563"><figcaption><p>Interfaccia per la scelta di un tipo di Knowledge Base</p></figcaption></figure></div>

#### <mark style="color:blu;">**Gli account sono limitati a un massimo di 100 Knowledge Base**</mark>

Ogni account supporta la creazione di un massimo di 100 Knowledge Base distinte, offrendo agli amministratori un'ampia flessibilità per organizzare e categorizzare le fonti di contenuto in base a specifici requisiti aziendali e necessità di governance degli accessi.

#### <mark style="color:blu;">**Le Knowledge Base sono personalizzabili con icone, nomi e descrizioni univoci**</mark>

Quando si crea una Knowledge Base, gli amministratori possono personalizzare il nome, la descrizione e l'icona della Knowledge Base da una libreria di emoji.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeyXgP8R5OgyEoqB_pZ1obCiIBPunX2xFXsjAEdTvgxE3i2ZYnLCRmX_G9Q106iskmoJAOTxBnyTaGoVuEik2pIYcgaz0uZFTGgyi3wfREmMHW-DI8GCkiEkcjU5avy_wNC9iHHKA?key=8xRdbBwKrN2U2fUmgGv7Q9gQ" alt="Example image of creating a Knowledge Base" width="375"><figcaption><p>Esempio di creazione di una Knowledge Base</p></figcaption></figure></div>

#### <mark style="color:blu;">**L'Access a una Knowledge Base può essere limitato dai gruppi di utenti Zoom, a meno che non vengano utilizzate le autorizzazioni di un provider di archiviazione cloud integrato**</mark>

Quando si configura l’accesso a una Knowledge Base, gli amministratori possono usare i Gruppi di utenti Zoom per definire e limitare quali utenti all’interno del proprio account sono autorizzati a visualizzare o utilizzare contenuti specifici. Ad esempio, una Knowledge Base potrebbe essere limitata esclusivamente a un reparto specifico, come Risorse Umane o Ingegneria.

Tuttavia, se la Knowledge Base è connessa tramite un provider di Archiviazione su cloud di terze parti, come Google Drive o OneDrive, e configurata per usare le autorizzazioni native del provider, l’accesso seguirà invece tali autorizzazioni. In questi casi, l’accesso degli utenti definito all’interno della piattaforma di Archiviazione su cloud stessa ha la precedenza sui Gruppi di utenti Zoom.

Ai lettori con domande su [gruppi di utenti](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0062584) si consiglia di fare riferimento al Centro assistenza di Zoom per ulteriori informazioni.

#### <mark style="color:blu;">**Ogni Knowledge Base è limitata a un tipo di origine dati**</mark>

Ogni Knowledge Base può estrarre dati da un solo tipo di origine alla volta. Ciò significa che i dati provenienti da un provider di Archiviazione su cloud di terze parti non possono essere combinati con Web Sincronizza, caricamenti diretti di dati, connessioni a indici di terze parti o qualsiasi combinazione tra questi. Ogni origine dati separata richiede una Knowledge Base separata. Ad esempio, dopo aver creato una Knowledge Base da un Web Sincronizza, in seguito non puoi aggiungere documenti dai caricamenti diretti di dati né collegarla a un indice di terze parti.

#### <mark style="color:blu;">Le origini dati sono i documenti e gli elementi che alimentano una Knowledge Base</mark>

Dopo la creazione di una Knowledge Base, gli amministratori possono riempire la “cartella” della Knowledge Base con le corrispondenti origini dati pertinenti alla Knowledge Base, come PDF, .txt, .docx e .doc.

#### <mark style="color:blu;">**Ogni Knowledge Base supporta fino a 2.500 origini, mentre la capacità totale dell’account per le origini è limitata a 20.000 origini totali**</mark>

Ogni Knowledge Base individuale supporta fino a 2.500 origini dati, con un massimo complessivo a livello di account di 20.000 origini tra tutte le Knowledge Base. Alla massima capacità (2.500 origini ciascuna), un account può avere fino a otto Knowledge Base. Tuttavia, il limite totale di 20.000 origini può anche essere distribuito su un numero maggiore di Knowledge Base con meno origini ciascuna, a seconda delle esigenze specifiche della vostra organizzazione (ad es., 100 knowledge base con 200 origini dati ciascuna).

#### <mark style="color:blu;">**Le origini dati sono limitate a 50 MB per ogni file**</mark>

Alla data di pubblicazione di questo documento, ciascuna origine dati non deve superare i 50 MB di dimensione.

#### <mark style="color:blu;">**Gli amministratori possono testare i nuovi dati aggiunti a una Knowledge Base**</mark>

Dopo aver aggiunto nuove origini dati a una Knowledge Base, gli amministratori dell'account possono testarne la Funzionalità utilizzando la Funzionalità di test. In questo ambiente di test, gli amministratori possono verificare che AI Companion sia in grado di fare correttamente riferimento alle origini dati caricate.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeRDlHYZNkuGPNAvcQ7jbs6lXANqPG_k7smLJ1xJAcyCgokLSEoGLWZCAisnCt8UTuXWYqwboOqfdS9ljE2iWPrlLd20uG0S4NUMliYpgJO0Uc0QoXM8OQbZ_CAoWER3hdQ_bWp?key=8xRdbBwKrN2U2fUmgGv7Q9gQ" alt="Example image of testing a Knowledge Base" width="563"><figcaption><p>Esempio di test di una Knowledge Base</p></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeRoE5i_dKB0uGlIBej6KtIq5H_yiZkHmSEDwy4cy3sVUjraa6lKe1bl5mCp9m7ysZpYpq-GPJ_mp5bkwSzfF0cvf3f9V1xIh3WY85gNdn66W635o9-l8Avx-r1DxXTjENJrpPjYw?key=8xRdbBwKrN2U2fUmgGv7Q9gQ" alt="Example image of testing a Knowledge Base" width="563"><figcaption><p>Esempio di test di una Knowledge Base</p></figcaption></figure></div>

#### <mark style="color:blu;">**Le Knowledge Base devono essere pubblicate formalmente dopo l'aggiunta di nuove origini dati per avere effetto**</mark>

Dopo aver aggiunto nuove origini dati a una Knowledge Base, gli amministratori dell'account devono Pubblicare la Knowledge Base delle origini dati aggiornata affinché le modifiche abbiano effetto; in caso contrario, resterà in stato di “bozza”. Se le modifiche non vengono pubblicate, AI Companion non sarà in grado di riconoscere e utilizzare le nuove origini dati.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcL0uB9rpbmL-AyNrxcpjgMWalMEVrIthV-m0I1uZRJ8BjfQQf8kavREEUQijZExg3hgL6k2sWIZ9d4VCSZ3T9yXwEsHDEey_TnYy7WC9K4WUTUG0V4Fpbv96kNFNk1zoXoEOqLtg?key=8xRdbBwKrN2U2fUmgGv7Q9gQ" alt="Example image of Publishing a Knowledge Base" width="563"><figcaption><p>Esempio di pubblicazione di una Knowledge Base</p></figcaption></figure></div>

### Knowledge Base: caricamento diretto dei dati

Per caricare file su Zoom, un utente o admin con autorizzazioni sufficienti deve creare o modificare una **manuale** Knowledge Base e caricare i file appropriati. Dopo aver testato e pubblicato la knowledge base, le informazioni dell'indice saranno Disponibile agli utenti Custom AI Companion-Concesso in licenza tramite le query di AI Companion.

### Knowledge Base: Web Sincronizza

Per creare o gestire una Knowledge Base Web Sincronizza, un utente o admin deve disporre di autorizzazioni sufficienti per gestire le Knowledge Base.

Quando crea una nuova Knowledge Base Web Sincronizza, l'utente seleziona il metodo di indicizzazione desiderato e specifica gli URL pertinenti. Successivamente, Zoom inizierà a indicizzare le pagine designate. Una volta che Zoom avrà indicizzato tutte le pagine specificate nell'istanza RAG specifica del cliente, la Knowledge Base potrà essere testata e poi pubblicata per l'uso.

<div data-with-frame="true"><figure><img src="/files/e8c6774ed3f33785c86576f9dffed3ce57d85fde" alt="Example image of creating a Web Sync Knowledge Base" width="563"><figcaption><p>Esempio di creazione di una Knowledge Base Web Sincronizza</p></figcaption></figure></div>

#### <mark style="color:blu;">**I file Web Sincronizza possono essere convertiti in articoli**</mark>

Durante il processo di creazione della Knowledge Base Web Sincronizza, l'utente può Abilita Impostazioni che convertiranno automaticamente il contenuto acquisito da una pagina web nel formato articolo per contribuire a migliorare la leggibilità, l'indicizzazione e l'accessibilità dei contenuti.

### Knowledge Base: Archiviazione su cloud di terze parti

La connessione con l'Archiviazione su cloud di terze parti consente a Zoom AI Companion di accedere, indicizzare e distribuire contenuti dalle piattaforme di archiviazione su cloud di terze parti (ad es. Google Drive, OneDrive) agli utenti autorizzati all'interno di Zoom. Per stabilire una connessione con un provider di Archiviazione su cloud di terze parti, l'utente o admin Zoom deve disporre delle autorizzazioni appropriate per gestire le Knowledge Base. Inoltre, è necessario un amministratore con privilegi sufficienti sulla piattaforma di terze parti per autorizzare determinati passaggi di Integrazioni. Questa Integrazioni comporta diversi passaggi chiave, descritti di seguito.

#### <mark style="color:blu;">Un admin deve autorizzare un'app OAuth</mark>

Quando si configura per la prima volta l'Integrazioni di Cloud Drive, un amministratore con le autorizzazioni appropriate avvia un flusso di autorizzazione OAuth tramite lo Zoom App Marketplace. Questa Integrazioni OAuth viene eseguita a livello di admin, il che significa che l'admin concede le autorizzazioni per conto dell'intero account Zoom. Tuttavia, questa autorizzazione a livello di admin concede a Zoom l'accesso solo ai file esplicitamente accessibili all'admin all'interno della piattaforma di terze parti, non a tutti i file dell'intera piattaforma.

#### <mark style="color:blu;">L'accesso dell'utente ai dati può basarsi sui Gruppi di utenti Zoom o sulle autorizzazioni native della terza parte</mark>

Dopo la connessione alla piattaforma di Archiviazione su cloud, l'amministratore deve scegliere come verranno gestite le autorizzazioni di accesso:

* **Autorizzazioni del Gruppo di utenti Zoom**: Questo metodo utilizza le autorizzazioni basate esclusivamente sui Gruppi di utenti interni di Zoom. L'admin specifica quali Gruppi di utenti Zoom hanno accesso ai documenti di Archiviazione su cloud selezionati, indipendentemente dalle autorizzazioni native della terza parte.
* **Autorizzazioni native della terza parte**: Questo metodo consente agli amministratori di configurare Zoom in modo da rispettare la struttura di autorizzazione nativa della piattaforma di terze parti (ad es. le impostazioni di accesso utente/gruppo di Google Drive o OneDrive). Quando configurato, Zoom indicizza le autorizzazioni dalla fonte originale e applica controlli di accesso in linea con il modello di autorizzazione della piattaforma esterna, aiutando a mantenere criteri coerenti di accesso ai documenti tra le piattaforme.

#### <mark style="color:blu;">**Le autorizzazioni della terza parte richiedono il mapping degli utenti**</mark>

Se l'amministratore seleziona le autorizzazioni native di terze parti e non ha mai mappato in precedenza gli utenti dalla loro piattaforma di terze parti a Zoom, Zoom gli chiederà di completare un processo di mappatura degli utenti. Questo abbina gli account utente di Zoom agli account corrispondenti nella piattaforma cloud di terze parti, in genere utilizzando identificatori univoci come gli indirizzi e-mail. A sua volta, questo passaggio stabilisce la sincronizzazione tra Zoom e il sistema di terze parti, consentendo a Zoom di verificare le autorizzazioni di accesso degli utenti in base ai diritti esistenti dell'utente nella piattaforma connessa.

#### <mark style="color:blu;">Dopo l'integrazione, Zoom indicizzerà i dati selezionati e le relative autorizzazioni</mark>

Una volta che l'admin seleziona il metodo di autorizzazione appropriato, Zoom indicizza due componenti fondamentali:

* **Contenuto del documento**: Zoom recupera, segmenta e converte il contenuto del documento dall'unità cloud in un modulo RAG specifico per il cliente che può fornire risultati di ricerca contestualmente pertinenti in base al livello di accesso e alla query dell'utente.
* **Metadati delle autorizzazioni**: Zoom indicizza metadati dettagliati delle autorizzazioni a seconda del metodo scelto:
  * Se si utilizzano i Gruppi Utente di Zoom, Zoom registra gli ID interni dei Gruppi Utente autorizzati dall'amministratore per ciascun documento.
  * Se si utilizzano le Autorizzazioni native di terze parti, Zoom indicizza gli ID nativi di utente e gruppo della piattaforma di terze parti associati all'accesso al documento, come determinato tramite il processo di mappatura degli utenti.

#### <mark style="color:blu;">Zoom verifica i livelli di accesso degli utenti prima di fornire il contenuto corrispondente</mark>

Quando un utente esegue una query, Zoom AI Companion interroga inizialmente i documenti indicizzati in base alla pertinenza e alla corrispondenza preliminare delle autorizzazioni usando i metadati indicizzati. Successivamente, Zoom verificherà le autorizzazioni del documento rispetto all'archivio delle autorizzazioni indicizzate:

* Se le autorizzazioni si basano sui Gruppi utente Zoom, l'appartenenza dell'utente al gruppo Zoom viene convalidata direttamente rispetto alle autorizzazioni di gruppo Zoom indicizzate del documento.
* Se le autorizzazioni si basano sulle autorizzazioni native di terze parti, Zoom convalida l'appartenenza dell'utente al relativo utente/gruppo di terze parti mappato rispetto alle autorizzazioni di terze parti indicizzate del documento.

Dopo, all'utente vengono forniti solo i documenti che superano la Verifica.

#### <mark style="color:blu;">Zoom esegue la sincronizzazione incrementale e periodica delle autorizzazioni</mark>

Per mantenere accuratezza e sicurezza, Zoom sincronizza in modo incrementale e periodico i dati delle autorizzazioni dalla piattaforma di terze parti nell'archivio interno delle autorizzazioni di Zoom. A causa delle limitazioni di velocità dell'API e dei vincoli di latenza, Zoom non esegue controlli live delle autorizzazioni rispetto alla piattaforma di terze parti durante le query degli utenti. Invece, Zoom verifica il set di dati delle autorizzazioni sincronizzato più di recente.

{% hint style="warning" %}
**Attenzione**

Zoom aggiorna in modo incrementale e dinamico le autorizzazioni dei provider di terze parti. Nella maggior parte dei casi, le modifiche alle autorizzazioni dovrebbero sincronizzarsi entro pochi minuti grazie agli aggiornamenti incrementali. Tuttavia, i tempi possono variare in base alle dimensioni della tua Organizzazione. Per Organizzazioni più grandi o durante i cicli di sincronizzazione completi, gli aggiornamenti possono richiedere da 2 a 24 ore per essere completati. Nel complesso, le modifiche alle autorizzazioni non dovrebbero richiedere più di 24 ore per Sincronizza completamente all'interno della tua Knowledge Base.
{% endhint %}

### Knowledge Bases: indice di terze parti

Per integrare un servizio di indice di terze parti con Custom AI Companion, un utente o admin con sufficienti autorizzazioni di Zoom App Marketplace, come determinato dal proprio Ruolo utente, deve autorizzare e completare la connessione con il provider scelto.

#### <mark style="color:blu;">Integrazioni di App Marketplace</mark>

Gli admin possono usare i seguenti link per accedere alle Integrazioni Third-Party Index per Zoom con [Amazon Q](https://marketplace.zoom.us/apps/g8rC9XKyQcGwS51wF-jGWg) sia [Glean](https://marketplace.zoom.us/apps/Hg6qTk87SxKy2F0aA3JRcA) nel Zoom App Marketplace. Per usare questa Funzionalità, il tuo account deve avere abilitata l'Impostazioni che consente ad AI Companion di [accedere alle fonti di dati della tua Organizzazione](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0080255).

Dopo aver aggiunto un'Integrazioni, apparirà all'interno dell' **Knowledge** elenco.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXctaVvKENHZR8uxkTjXPzAmRs2RSMsqZZFzjeHHMcgWGlVP_I4yXYpxn-bO7zl_P4wwa2OUlJmPq99Sg8FKN79bioxqYqgvtSQ-GliSVC28IbUj71Vkd-zG0bObgWgesbrdjC6o?key=8xRdbBwKrN2U2fUmgGv7Q9gQ" alt="Image showing a Knowledge Base with Glean and Amazon Q connections" width="563"><figcaption><p>Knowledge Base con connessioni Glean e Amazon Q</p></figcaption></figure></div>

### Avatar personalizzati per Zoom Clips

Gli admin dell'account possono abilitare o Disabilita l'uso di avatar e avatar personalizzati dal Zoom web portal. Non ci sono ulteriori Impostazioni a livello di admin da considerare per questa Funzionalità.

#### <mark style="color:blu;">L'accesso degli utenti agli Avatar può essere configurato a livello di account, gruppo e utente</mark>

Analogamente ad altre funzionalità di Zoom, le funzionalità Avatar e Avatar personalizzato di AI Companion personalizzato possono essere disabilitate su [account](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0062734), [gruppo](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0062584), e [utente](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0061300) livelli.

Gli admin possono accedere a queste funzionalità da Zoom Web Portal modificando le Impostazioni del livello appropriato, selezionando la scheda AI Companion e individuando la sottosezione Clips.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfKG1z5x12jiW309sdbpYHjT12Kc4P6aXxwjLbaXVEtL05ccPOIbuqvCun2LFS2vAAFM-zt243gGpupA9DlcBBty8LbNq956ktHK-iemhmadfQywsMSi3vNIO8hvXNjpPmcEHZG?key=8xRdbBwKrN2U2fUmgGv7Q9gQ" alt="An image showing the settings for Custom Avatar" width="563"><figcaption><p>Impostazioni per Avatar personalizzato</p></figcaption></figure></div>

### Dizionario personalizzato

Per Configura un Dizionario personalizzato come utente o admin con autorizzazioni AI Studio sufficienti, espandi il menu AI Studio all'interno del Zoom web portal e fai clic su Dizionario personalizzato.

#### <mark style="color:blu;">Il Dizionario personalizzato supporta sia la modifica manuale sia l'importazione/esportazione basata su CSV</mark>

Gli amministratori dell'account possono gestire il dizionario personalizzato del proprio account attraverso due metodi: gestione manuale oppure tramite importazione/esportazione CSV all'interno di AI Studio.

**Gestione manuale**

Per aggiungere manualmente parole a un dizionario personalizzato, fai clic sul pulsante + Aggiungi manualmente. Nel pop-up, inserisci una parola per ogni riga, separata da un'interruzione di riga.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeBOr76QQyFVw_x7I0wMUsUUPby6vUQt3jXxpIUskC5Lt0aU02R10RMPZbIVKtd8IkYA2Bq-He9jO-6-V8K96-ce8nSBwAOui0x_JD--ICCaV4c_VkZoA04oLwXhmCQD-aeks32jA?key=8xRdbBwKrN2U2fUmgGv7Q9gQ" alt="An image showing how to manually add words to a Custom Dictionary" width="563"><figcaption><p>Aggiunta manuale di parole a un Dizionario personalizzato</p></figcaption></figure></div>

Per eliminare manualmente una parola dal dizionario, fai clic sull'icona del cestino ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXcTbYFZt-GEW3c7gPHrLxq0KsioX6XX2uEePczogg0OBHVtrOacYMmi39YX9gpiAaxkadPeSa79uyOk8uxoKvct6n1zVEar1MOZ4hn3NTqyce6NqmSzyjSEGY0zMHCB8XMiiBQFzQ?key=8xRdbBwKrN2U2fUmgGv7Q9gQ).

**Importazione/Esportazione CSV**

Per creare o aggiornare in blocco un dizionario personalizzato, carica un file CSV con tutte le nuove parole in un'unica colonna del documento (ad es., Colonna A).

Prima di modificare un dizionario personalizzato tramite CSV, si consiglia agli amministratori dell'account di esportare e salvare una copia prima di apportare eventuali modifiche. Durante il caricamento del file, agli amministratori dell'account verrà chiesto di Aggiungi al dizionario oppure di sostituirlo con il file. In caso di clic errato, la copia salvata in precedenza può essere utilizzata come backup.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXe7JJgH5pRFlN_1cQhQ6C8BgWV67HwsI4YQK3UnK6OvzaQ_eZRx6kJbH9k5p5sE2Uzx5qPC8ysgX2bli3Ac8E3BJC1LXEk4fBH7nKQQLHwpowDjeZGOOBJw-viDLgtbeNVNDlI9Ww?key=8xRdbBwKrN2U2fUmgGv7Q9gQ" alt="An image showing CSV import options" width="375"><figcaption><p>Opzioni di importazione CSV</p></figcaption></figure></div>

#### <mark style="color:blu;">Dopo aver aggiornato il Dizionario personalizzato, gli amministratori dell'account possono eseguire un test per confermare che le nuove parole vengano riconosciute utilizzando un file pre-registrato o una registrazione ad hoc</mark>

Dopo aver aggiunto ulteriori parole al Dizionario Personalizzato dell’account, gli amministratori dell’account possono testare le prestazioni del riconoscimento di Zoom AI Companion delle nuove parole caricando un file audio preregistrato oppure effettuando una registrazione audio ad hoc tramite lo strumento browser.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXe8FapHwTHohDGAUNfIJwjMWynpbyBtJrv4oWG_nBCDqsv7e5w4-_jp_A9Y2PCx3AsK8MZUT7wfG1tiVpQl_kafOJujZFYUnuqq1dpwp6fxkDHggpvXVYei8Syr6OndsSvA7wxP?key=8xRdbBwKrN2U2fUmgGv7Q9gQ" alt="Image showing how to test a custom dictionary" width="375"><figcaption><p>Test di un dizionario personalizzato</p></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeNGWDpzAGKSOX_9LO8LHCws3wU8GtZuafuQiDablof9GNxPuXDvuc9gQ_cOlCUZiQEN-7JShfQF0K5IC3ULQucQ1P9S-8JdfwuGOdr2DtuHpKl5_JyvQVuHovDbOn-5E0N7AnhFw?key=8xRdbBwKrN2U2fUmgGv7Q9gQ" alt="An image showing a detected Custom Dictionary word in bold" width="375"><figcaption><p>Le parole del dizionario personalizzato sono in grassetto quando vengono rilevate nel test</p></figcaption></figure></div>

#### <mark style="color:blu;">Il Dizionario personalizzato deve essere pubblicato formalmente prima che nuove parole vengano riconosciute da AI Companion</mark>

Dopo aver aggiunto nuove parole a una Custom Dictionary, gli account admins devono Pubblicare le modifiche affinché abbiano effetto. La mancata Pubblicazione può comportare il fallimento di AI Companion nel riconoscere i nuovi termini. Una volta pubblicata, AI Companion utilizzerà la Custom Dictionary per migliorare la trascrizione dell’accuratezza in tutte le future riunioni per gli utenti con l’AI Companion add-on Custom.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXciRxfi-429E-xgQlXFArsRishxxbWSB0Cga4_6TmXWBmO4K2Lp-zgV193WhIXpLQPS4ncqaDo3-4goqhkoDvdBHIZEP6U0HYudlRpE8LJYcGD8yHh1TDXn70Kvijz1eILY8Unx?key=8xRdbBwKrN2U2fUmgGv7Q9gQ" alt="An image showing how to publish a Custom Dictionary" width="375"><figcaption><p>Pubblica dizionario personalizzato</p></figcaption></figure></div>

#### <mark style="color:blu;">Gli account sono attualmente limitati a un dizionario personalizzato</mark>

Alla data di pubblicazione di questo documento, gli account sono attualmente limitati a un solo dizionario personalizzato alla volta. Per ulteriori informazioni, contatta il tuo team dell'account Zoom.

### Modelli personalizzati di riepilogo della riunione

La sezione Modelli personalizzati di riepilogo della riunione è il punto in cui gli utenti dell'account o gli amministratori con account di AI Studio possono creare modelli personalizzati di riepilogo della riunione.

#### <mark style="color:blu;">Gli amministratori creano riepiloghi della riunione personalizzati inserendo un breve prompt, che l’IA generativa espande in un modello di riepilogo su misura in base all’argomento</mark>

Quando creano un riepilogo della riunione personalizzato, gli amministratori inseriscono un breve prompt che descrive il tipo di riunione, ad esempio “Analisi aziendale trimestrale”, e l’IA generativa utilizza tale input per creare un modello di riepilogo della riunione su misura. Ad esempio, la struttura risultante potrebbe includere sezioni dedicate ai risultati finanziari, ai progressi verso gli obiettivi, alle sfide principali e ai passaggi successivi, rendendo più semplice acquisire gli insight più rilevanti per quel tipo di riunione.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcesV2rkgjF6o642qYPaibMV5d29v5Wodsd2b6efg1tkGW3entj30Qwa2YKFvNeD932dF1phplfSU4Whmrwh1xoRsWp_bVplsLJMsxMrHQ2enzHp0DY3wXqFboSPWp72cLgErKY0w?key=8xRdbBwKrN2U2fUmgGv7Q9gQ" alt="Example image of generating a new Custom Meeting Summary Template from a prompt" width="375"><figcaption><p>Esempio di generazione di un nuovo modello di riepilogo della riunione personalizzato da un prompt</p></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeGWRi6sAn9wwh_2LY5ogqisdZV4t5X_w2-QvZjSmiDeBsCFzlORYroZg0P818P9cbR3VhC4mpP4AyoJsYPvXk9l_fuJhaKPRW7MQlsV5gurk4g1Jr8IgkK-9Qu1X9vBF3IA7sbAA?key=8xRdbBwKrN2U2fUmgGv7Q9gQ" alt="Example image of Custom Meeting Summary Template Sections" width="563"><figcaption><p>Esempio di sezioni del modello di riepilogo della riunione personalizzato</p></figcaption></figure></div>

#### <mark style="color:blu;">Gli amministratori possono personalizzare l’elenco degli argomenti del riepilogo della riunione, includendo descrizioni degli argomenti che AI Companion utilizzerà per associare il contenuto al riepilogo</mark>

Durante il processo di creazione del riepilogo personalizzato, gli amministratori possono personalizzare l’elenco degli argomenti del riepilogo definendo sezioni specifiche e aggiungendo descrizioni che guidano il modo in cui AI Companion organizza i contenuti della riunione. Queste descrizioni aiutano AI Companion a capire quale tipo di informazioni cercare e includere in თითოuna sezione. Ad esempio, se un argomento del riepilogo è etichettato “Rischi del progetto” con una descrizione come “Identificare eventuali rischi o ostacoli potenziali menzionati durante la riunione”, AI Companion analizzerà la trascrizione e popolerà quella sezione con contenuti pertinenti. Questa flessibilità offre alle organizzazioni un maggiore controllo su come vengono acquisiti e strutturati gli insight della riunione.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdkZxNk0jYwm0K4Eqx6L0-mPyMbA58i88v220uZG3U0lc-oV4L1sqKTHsKRJCMeFTrzxGum5UMTo5HrPG9mbPqUd59dcevS8bEsr2gRvXgfaapcJ4_PCVzqzOQ79aBYKyAc2KOybg?key=8xRdbBwKrN2U2fUmgGv7Q9gQ" alt="Example image of defining the purpose of a Custom Meeting Template section" width="563"><figcaption><p>Esempio di definizione dello scopo di una sezione del modello di riepilogo della riunione personalizzato</p></figcaption></figure></div>

#### <mark style="color:blu;">Una volta creati gli argomenti, gli amministratori possono testare i modelli di riepilogo in AI Studio</mark>

Dopo aver confermato l’elenco degli argomenti del riepilogo, gli amministratori possono testare il modello di riepilogo della riunione personalizzato utilizzando dati conversazionali simulati, che vengono successivamente elaborati tramite il modello per verificarne qualità e coerenza.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeewfIck_Gvr3It3p1b-8k0r5d4djpngEiU_gSlt-CwQE9_pxoYJRCrPmxgrNRBjr19ZR8NT8VdJ7ZIciNzfmPIgEESBATOtHRN2kAi91NdE73P-lfb7Mo64aEhYwyMLvQr-efe?key=8xRdbBwKrN2U2fUmgGv7Q9gQ" alt="" width="563"><figcaption></figcaption></figure></div>

<mark style="color:blu;">**Gli amministratori possono anche testare il modello di riepilogo personalizzato utilizzando una trascrizione di una precedente riunione Zoom**</mark>

Se lo desiderano, gli amministratori possono testare il modello utilizzando la trascrizione di una precedente riunione Zoom per valutarne le prestazioni con contenuti reali della riunione e verificare la qualità del modello personalizzato di riepilogo della riunione. Questo è particolarmente utile per affinare i modelli in base ai tipi di riunioni che i loro team svolgono regolarmente.

#### <mark style="color:blu;">Dopo aver testato il modello, può essere pubblicato sull'intero account o su un sottoinsieme di Gruppi utente</mark>

Una volta completato il test del modello, può essere pubblicato sull’intero account oppure su un sottoinsieme specifico dei Gruppi utente di Zoom.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcJm1fCIMv78oLIgAfsIXlICHa1umhfLO99QC453NrN7upvx09ntYxAWNUByBDGNW4_StT2Fs3UfHJ1DEpuIr0s0EjaZZbrJ-WCqaeO43FoqIzlaUvs_PSwPKyQuwsQ7C6VClje0w?key=8xRdbBwKrN2U2fUmgGv7Q9gQ" alt="Example image of selecting User Groups permissions" width="563"><figcaption><p>Esempio di selezione dei permessi dei gruppi utente</p></figcaption></figure></div>

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

Gli utenti devono avere una licenza con add-on AI Companion personalizzato assegnata per utilizzare un modello personalizzato di riepilogo della riunione.
{% endhint %}

### Riunioni di terze parti con AI Companion

Questa sezione spiega come regolare le Impostazioni di Custom AI Companion per partecipare a riunioni di terze parti.

#### <mark style="color:blu;">L'uso di AI Companion nelle riunioni di terze parti può essere configurato a livello di account, gruppo e utente</mark>

Simile ad altre funzionalità di Zoom, la capacità di AI Companion personalizzato di Partecipa alle Riunioni di Terze Parti può essere disabilitata sul [account](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0062734), [gruppo](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0062584), e [utente](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0061300) livelli.

Gli amministratori possono accedere a queste funzioni da Zoom web portal modificando le Impostazioni del livello appropriato, selezionando la scheda AI Companion e individuando la sottosezione AI Companion personalizzata.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeLfyEa8lnI5ux2Yhxwmy4_9htk--9IVMt5kl4B9qrKvR6ZDRAc2WxUHynfu6Zg4YIh-6022SQnhN_M2CkE56pFNyYoFMYaDnk3KWj1pASr9GKlS00vWFIZ16EF7MyqhwybQbuGPw?key=8xRdbBwKrN2U2fUmgGv7Q9gQ" alt="" width="563"><figcaption></figcaption></figure>

### App di terze parti

Per integrare app di terze parti con Custom AI Companion, un utente o un admin con autorizzazioni sufficienti di Zoom App Marketplace, come determinato dal proprio Ruolo utente, deve autorizzare e completare la connessione con il provider scelto.

#### <mark style="color:blu;">Integrazioni di App Marketplace</mark>

Gli admin possono cercare nel Zoom App Marketplace le integrazioni supportate di AI Companion, come [Jira](https://marketplace.zoom.us/apps/wc9NSSgESB-qLJed0RSZjQ). Per usare questa Funzionalità, il tuo account deve avere l'impostazione abilitata che [consente ad AI Companion di eseguire attività nelle app di terze parti](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0080218).

### **Agenti personalizzati: come creare**

#### <mark style="color:blu;">Creazione di un agente personalizzato</mark>

Gli admin dell'account o gli utenti autorizzati possono creare un Agente personalizzato nella **AI Studio** sottosezione facendo clic sul **Agenti personalizzati** opzione nel Zoom web portal.

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

Se il tuo account ha acquistato Custom AI Companion e l'opzione Custom Agents non è disponibile, un admin dell'account deve inviare un ticket di assistenza Zoom richiedendo di Abilita la Funzionalità.
{% endhint %}

#### <mark style="color:blu;">Modelli di Custom Agent</mark>

Quando crea un Custom Agent, gli admin possono selezionare da un elenco predefinito di modelli oppure iniziare da una configurazione vuota. I modelli offrono un modo rapido per avviare una configurazione pronta all'uso, in linea con ruoli o flussi di lavoro comuni, aiutando le organizzazioni a scalare rapidamente le capacità di AI senza partire da zero.

I modelli predefiniti includono:

* **Rilevatore di attività di engineering**: Aiuta gli sviluppatori a gestire i ticket assegnati e le attività tecniche tra sprint e progetti. Cerca e aggiorna i problemi, monitora i progressi e segnala i bug per mantenere gli engineer concentrati su priorità e scadenze.
* **Assistente per il supporto ai colloqui**: Aiuta gli intervistatori a prepararsi fornendo accesso rapido alle policy HR di assunzione, ai suggerimenti per i colloqui e ai dettagli specifici del ruolo. Recupera le descrizioni delle posizioni, esamina i profili dei candidati ed elenca i ruoli aperti dalle piattaforme ERP.
* **Assistente per la gestione degli Incidenti**: Aiuta gli sviluppatori a semplificare i flussi di lavoro di risposta agli Incidente tra i team. Aiuta le organizzazioni a gestire, documentare e rispondere in modo efficiente agli Incidente di tutti i livelli di gravità לאורך l'intero ciclo di vita dell'Incidente.
* **Assistente per campagne di marketing**: Supporta i marketer nella pianificazione, esecuzione e ottimizzazione delle campagne. Semplifica la creazione delle campagne, genera idee di contenuto e tiene traccia delle scadenze chiave e delle metriche di performance.
* **Cerca ticket di assistenza**: Aiuta gli agenti a trovare rapidamente ticket risolti in precedenza con problemi simili, riducendo i tempi di risoluzione e migliorando la coerenza grazie alla ricerca nella cronologia dei ticket e alla fornitura di contesto dai casi passati.

I template sono anche personalizzabili e possono essere creati da un template vuoto, consentendo agli amministratori di perfezionarne lo scopo, aggiornare le fonti di conoscenza o estendere le funzionalità con strumenti e prompt secondo necessità.

<div data-with-frame="true"><figure><img src="/files/3948e0a23b28f9ec23e6fce1479fc5e578da8d1e" alt=""><figcaption><p>Template di agenti personalizzati</p></figcaption></figure></div>

#### Le basi di conoscenza forniscono agli agenti personalizzati un contesto specializzato

Ogni agente personalizzato può essere associato a una o più basi di conoscenza che ne definiscono l'esperienza di dominio. Queste basi di conoscenza possono includere documenti di policy interne, guide di prodotto, materiali di Onboarding o schemi di processo specifici del team.

Ad esempio, un Agente di Assistenza potrebbe essere configurato per accedere a una combinazione di fonti del Centro assistenza, articoli IT interni e documentazione di prodotto. Facendo riferimento sia ai contenuti di assistenza rivolti al pubblico sia ai materiali tecnici interni — come guide di configurazione, registri dei problemi noti o best practice di configurazione — il Custom Agent può fornire risposte precise e aggiornate, allineate alle informazioni di prodotto più recenti. Questo approccio combinato aiuta a garantire che le risposte siano coerenti, affidabili e basate sulle stesse risorse utilizzate dai team di supporto ufficiali.

<div data-with-frame="true"><figure><img src="/files/31b1adfe6bb808fba9520d930b2f06b71f3bbf4b" alt=""><figcaption><p>Basi di conoscenza assegnate a un Agente personalizzato</p></figcaption></figure></div>

#### Gli strumenti consentono agli Agenti personalizzati di eseguire azioni con sistemi di terze parti

Gli strumenti definiscono ciò che un Agente personalizzato è in grado di fare oltre la conversazione: sono le autorizzazioni e le integrazioni che consentono all'agente di agire per tuo conto.

Alcuni strumenti sono integrati, come la possibilità di leggere, creare o interagire con un Zoom Doc. Altri possono essere connessi tramite integrazioni di Zoom App Marketplace usando Model Context Protocol (MCP), consentendo agli Agenti personalizzati di eseguire azioni su piattaforme esterne. Ad esempio:

* Creare nuovi ticket o aggiornare quelli esistenti in Jira
* Recuperare e modificare i record in Salesforce
* Visualizzare o aggiornare i task in Asana
* Access dati strutturati dai sistemi interni tramite API

<div data-with-frame="true"><figure><img src="/files/666f3025233aac577461375a6d93dd4cbf4f00df" alt=""><figcaption><p>Strumenti assegnati a un Agente personalizzato</p></figcaption></figure></div>

Gli amministratori possono anche progettare strumenti personalizzati tramite chiamate API o funzioni JavaScript, oppure un server MCP per abilitare funzionalità specifiche e uniche per la propria Organizzazione.

**Importante**: Quando si crea uno strumento personalizzato, la descrizione dello strumento diventa particolarmente importante. Indica al Custom Agent quando e come usare quello strumento. Questa descrizione funge da insieme di istruzioni su cui il modello si basa per decidere se richiamare lo strumento è rilevante per la richiesta di un utente, contribuendo a garantire che ogni azione automatizzata rimanga precisa, intenzionale e contestualmente corretta.

<div data-with-frame="true"><figure><img src="/files/372d7d2eea8a21aab1ade760668ebb394c4217b9" alt=""><figcaption><p>Interfaccia di creazione dello strumento personalizzato</p></figcaption></figure></div>

#### <mark style="color:blu;">La descrizione di un Custom Agent definisce il suo comportamento e come AI Companion lo utilizza</mark>

Quando si crea un Custom Agent, la descrizione diventa particolarmente importante: indica ad AI Companion cosa fa l'agente, quando usare i suoi strumenti e come dovrebbe comportarsi in un determinato contesto. Ad esempio, includere una riga come “Pubblica i risultati nel canale Slack #Engineering” aiuta l'agente a capire non solo cosa fare, ma anche dove e come farlo. Questi dettagli guidano il ragionamento di AI Companion e modellano direttamente il modo in cui interpreta e applica l'agente.

Una descrizione solida e ben scritta aiuta a garantire che ogni azione automatizzata sia accurata, mirata e allineata all'intento della conversazione. Più la descrizione è chiara e specifica, più efficacemente AI Companion può comprendere il contesto, seguire le indicazioni e fornire risultati in linea con le tue aspettative.

#### <mark style="color:blu;">I Hero Prompts rendono facile eseguire le attività comuni</mark>

Gli amministratori possono definire Hero Prompts — prompt precompilati che fungono da scorciatoie selezionate per attività comuni o di alto valore che gli utenti eseguono spesso con un Custom Agent. Questi prompt compaiono direttamente nel gruppo AI Companion, consentendo agli utenti di avviare i flussi di lavoro con un solo clic.

Ad esempio, un Hero Prompt potrebbe:

* **Riepilogare l'attività dei ticket del turno:** Raccogliere metriche su casi nuovi, risolti e aperti dal tuo CRM, insieme a tendenze o problemi ricorrenti.
* **Fornisci il riepilogo odierno di Jira**: Recupera tutti i ticket o le segnalazioni di bug creati di recente nell'ultimo giorno, categorizzali per progetto, componente o priorità e genera un riepilogo conciso che evidenzi tendenze o problemi ricorrenti. Pubblica automaticamente il riepilogo in un canale messaggi designato per la visibilità del team.
* **Mostra le opportunità di rinnovo in chiusura questo mese**: Interroga i dati CRM, calcola le tempistiche di rinnovo e metti in evidenza gli account che richiedono attenzione.
* **Fornisci un riepilogo settimanale di Onboarding**: Elenca i nuovi assunti, le attività completate in Workday e i passaggi di Onboarding ancora in sospeso.

Predefinendo queste interazioni, gli amministratori aiutano gli utenti a bypassare i passaggi di configurazione ridondanti, consentendo risultati più rapidi e coerenti con un input manuale minimo.

<div data-with-frame="true"><figure><img src="/files/cee503cecc3c34d1f938c23272421179c7636557" alt="" width="369"><figcaption><p>Esempio di Hero Prompts con un Custom Agent</p></figcaption></figure></div>

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

La capacità di un Custom Agent di eseguire queste funzioni di esempio può essere limitata dai suoi strumenti e dalla descrizione.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://library.zoom.com/technical-library/it/zoom-workplace/artificial-intelligence/artificial-intelligence-bluepaper/custom-ai-companion-explainer/admin-experience.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.