Prerequisiti per abilitare l’IA in Tableau Server

Per configurare e attivare Tableau Agent per Tableau Server, ti serve quanto segue:

• Il ruolo Amministratore Tableau Server. L’impostazione del sito IA in Tableau è specifica del sito e, se attivata, consente a tutti gli utenti con accesso a quel sito di utilizzare la funzionalità di intelligenza artificiale.

• Un account presso un provider LLM attivo o un endpoint Gateway personalizzato. A seconda del metodo di autenticazione, una distribuzione attiva con chiavi API, URL di endpoint o credenziali OAuth

• La tua chiave API. Ti servirà per connettere Tableau Server al provider LLM OpenAI o Azure OpenAI o al tuo gateway personalizzato quando utilizzi la modalità di autenticazione con chiave API. È opportuno seguire le procedure consigliate dagli standard di sicurezza e ruotare la chiave API con regolarità.

• Se utilizzi Azure OpenAI, un modello di chat/completamento e incorporamento distribuito in Azure.

• I modelli LLM che Tableau Agent dovrà utilizzare per completare attività come la comprensione delle richieste degli utenti e l’emissione di output pertinente. A partire dalla versione 2026.3, se utilizzi una connessione diretta a OpenAI, puoi accettare le impostazioni predefinite suggerite. Puoi inoltre selezionare i tuoi modelli. Se utilizzi Azure OpenAI o una connessione a un gateway personalizzato, devi selezionare i tuoi modelli.

  Per ottenere risultati ottimali, Tableau consiglia i seguenti modelli:

  • Comprensione delle richieste degli utenti (modello per attività di dimensioni o durata ridotta): gpt-4o-mini o versione successiva

  • Esecuzione di attività di analisi (ragionamenti complessi o modello di grandi dimensioni): gpt-4o o versione successiva o Claude Sonnet 4.6 o versione successiva

  • Elaborazione del contesto dei dati (modello di incorporamento): text-embedding-3-small o un modello di incorporamento simile di dimensioni ridotte supportato dal provider LLM.

• Se utilizzi un proxy di inoltro con Tableau Server, devi configurarlo per la comunicazione con il modello LLM. Per i dettagli, consulta Configurare un proxy di inoltro più avanti.

Connessioni supportate

Funzionalità disponibili

In Tableau Server sono disponibili le seguenti funzioni di IA in Tableau:

• Tableau Agent nell’ambiente di creazione: consente di creare visualizzazioni o di completare attività per tuo conto tramite un’interfaccia utente conversazionale: consenti agli utenti di esplorare i dati, creare visualizzazioni e calcoli e scoprire informazioni dettagliate con l’aiuto di Tableau Agent nel Web authoring di Tableau Server e in Tableau Desktop (versione 2025.3 e successive). Per maggiori informazioni su Tableau Agent, consulta Esplorare i dati con Tableau Agent(Il collegamento viene aperto in una nuova finestra).

• Tableau Agent nelle dashboard (beta): richiede Tableau Server+. Non disponibile se utilizzi un gateway personalizzato con autenticazione OAuth. Per attivare questa funzionalità, devi aderire alla versione beta. Consenti agli utilizzatori e agli autori di dashboard di ottenere rapidamente una panoramica della propria dashboard o informazioni dettagliate sulle visualizzazioni all’interno di essa e di porre domande sui propri dati tramite Domande e risposte sulla dashboard. In qualità di autore di dashboard, puoi attivare o disattivare ogni funzionalità a livello di dashboard. Puoi anche configurare Informazioni dettagliate della dashboard in modo da includere o escludere determinati fogli di lavoro oppure concentrarti solo su determinati tipi di informazioni dettagliate. Per maggiori informazioni, consulta Tableau Agent nelle dashboard (beta)(Il collegamento viene aperto in una nuova finestra).

  Nota: Tableau Agent nelle dashboard richiede che gli utenti dispongano delle funzionalità delle autorizzazioni Accesso all’IA e Query sui dati completi per tutte le cartelle di lavoro in cui desiderano utilizzare Tableau Agent. L’autorizzazione Query sui dati completi garantisce a Tableau Agent l’accesso ai dati sottostanti necessari per il suo funzionamento. Per maggiori informazioni, consulta Autorizzazioni(Il collegamento viene aperto in una nuova finestra).

• Tableau Agent in Tableau Prep: suggerisce fasi per la pulizia e la trasformazione dei tuoi dati: consente agli utenti di pulire i propri dati, creare campi calcolati e generare flussi con l’aiuto di Tableau Agent. Questa funzionalità è disponibile nel Web authoring di Tableau Prep, in Tableau Server e in Tableau Prep Builder (versione 2025.3 e successive). Per maggiori informazioni su Tableau Agent in Tableau Prep, consulta Creare flussi di Tableau Prep con Tableau Agent(Il collegamento viene aperto in una nuova finestra).

Configurare IA in Tableau

Le fasi per la configurazione di IA in Tableau e le informazioni da inserire variano in base al provider LLM selezionato. È supportata la configurazione di un provider LLM diverso per ogni sito.

Fase 1. Connettersi al provider LLM o al gateway personalizzato

1. Accedi a Tableau Server come amministratore del server.

2. Nel sito in cui desideri attivare le funzioni di intelligenza artificiale generativa seleziona Impostazioni.

3. In IA in Tableau, fai clic su Connetti.

   

4. Nella finestra di dialogo Connetti a LLM seleziona il tuo provider dall’elenco a discesa Provider LLM.

   

5. A seconda della selezione effettuata, esegui le operazioni indicate di seguito:

   • OpenAI: immetti la Chiave API.

   • Azure OpenAI: immetti la Chiave API e il Nome risorsa.

   • Gateway personalizzato (beta): accetta la dichiarazione di non responsabilità per aderire alla versione beta.

     • Immetti l’URL del gateway personalizzato (esempio: https://gateway.esempio.com/v1).

     • Seleziona la Modalità di autenticazione:

       • Nessuna autenticazione: seleziona questa opzione se il gateway è protetto da regole di rete interne (ad esempio, elenco di IP consentiti o perimetro VPC/VPN).

       • Chiave API: immetti il token o la chiave richiesta dal gateway API interno.

       • OAuth: specifica i dettagli richiesti per i client OAuth:

         • ID client e Segreto client: credenziali dell’applicazione generate dal provider di identità.

         • URL di reindirizzamento: endpoint di callback richiesto da Tableau Server. Immetti un URL valido che termini con /auth/add_oauth_token (esempio: https://<your-server-name>/auth/add_oauth_token). Se utilizzi HTTP anziché HTTPS, il nome di dominio deve essere localhost.

         • File di configurazione OAuth: carica un file di configurazione XML personalizzato configurato per il tuo IdP. Per maggiori informazioni, consulta Elementi XML(Il collegamento viene aperto in una nuova finestra) (in inglese) in Tableau Connector SDK.

6. Fai clic su Connetti.

Fase 2. Configurare le impostazioni del modello

Se utilizzi OpenAI, seleziona i modelli consigliati (selezionati per impostazione predefinita), quindi fai clic su Applica. Per prestazioni ottimali Tableau consiglia questi modelli. I modelli vengono aggiornati automaticamente ogni volta che Tableau cambia il modello consigliato.

Se utilizzi Azure OpenAI o un gateway personalizzato, devi selezionare i modelli. Per Azure OpenAI i modelli selezionati devono essere prima distribuiti e denominati. Qualunque sia il nome che utilizzi per il modello distribuito, corrisponde al nome che digiterai nei campi del modello. Potrai quindi immettere questo nome nel campo.

Devi inoltre gestire i modelli selezionati manualmente e aggiornare l’impostazione quando questi modelli non sono più supportati, per evitare che gli utenti perdano l’accesso a Tableau Agent.

1. Fai clic su Modifica modelli.

2. Nella finestra di dialogo Impostazioni dei modelli seleziona o immetti gli ID modello specifici forniti dall’host o dal gateway LLM:

   • Comprendi le richieste degli utenti: seleziona o immetti l’identificatore della versione più leggera del modello (ad esempio, gpt-4o-mini o versione successiva).

   • Crea visualizzazioni, campi calcolati e genera flussi: seleziona o immetti l’identificatore del modello di ragionamento primario (ad esempio, gpt-4o o Claude Sonnet 4.6).

   • Elabora contesto dati: seleziona o immetti l’identificatore del modello di incorporamento (ad esempio, text-embedding-3-small).

     

3. Fai clic su Applica.

Fase 3. Attivare le funzionalità di IA per gli utenti

Nota: Tableau Agent nelle dashboard richiede Tableau Server versione 2026.3 o successiva o Tableau Server+ e non è disponibile in caso di utilizzo di un gateway personalizzato con autenticazione OAuth.

1. In Impostazioni IA per funzionalità fai clic su Attiva per ogni funzionalità che desideri rendere disponibile agli utenti di questo sito (Tableau Agent nel Web authoring, Tableau Agent in Tableau Prep, Tableau Agent nelle dashboard (beta)).

2. Fai clic su Salva nella parte superiore della pagina Impostazioni.

   

Esperienza di autenticazione dell’utente finale (gateway OAuth)

Quando un gateway personalizzato viene configurato tramite OAuth, agli utenti finali che accedono a Tableau Agent viene richiesto di accedere al gateway LLM e consentire l’accesso a Tableau Agent.

1. Quando apri Tableau Agent in una cartella di lavoro o in una sessione di authoring e digiti una domanda, il riquadro dell’agente visualizza Accedi al gateway LLM.

2. Se fai clic su Accedi, si apre la schermata di accesso al provider OAuth o di identità della tua organizzazione in una finestra del browser separata.

3. Una volta autenticato, l’utente viene reindirizzato di nuovo a Tableau e può interagire con Tableau Agent.

Configurare un proxy di inoltro

Se Tableau Server è configurato per la connessione a Internet tramite un proxy di inoltro, puoi configurare Tableau Server in modo che contatti il modello LLM tramite le impostazioni relative all’host proxy e alle porte.

Per eseguire le modifiche usa il comando, tsm configuration set(Il collegamento viene aperto in una nuova finestra).

• Per gli host proxy HTTPS, utilizza le seguenti coppie chiave-valore:

  -k tomcat.https.proxyHost -v host.domain

  -k tomcat.https.proxyPort -v port_number

  Ad esempio, se il server proxy è all’indirizzo https://proxy.esempio.lan:8443, esegui i seguenti comandi:

  tsm configuration set -k tomcat.https.proxyHost -v proxy.example.lan

  tsm configuration set -k tomcat.https.proxyPort -v 8443

  tsm pending-changes apply

  L’operazione riavvierà Tableau Server. Tienilo presente quando configuri l’ambiente di produzione.

• Per gli host proxy HTTP, utilizza le seguenti coppie chiave-valore:

  -k tomcat.http.proxyHost -v host.domain

  -k tomcat.http.proxyPort -v port_number

  Dopo aver impostato queste chiavi, esegui

  tsm pending-changes apply

  L’operazione riavvierà Tableau Server. Tienilo presente quando configuri l’ambiente di produzione.