Utilizzo degli strumenti AI su Server
Configura ed esegui Strumenti IA su Server con un'entità di servizio. Utilizza questa guida per creare un'entità di servizio in Alteryx One e connetti gli strumenti AI. Per ulteriori informazioni sulle entità di servizio in Alteryx One, vai alla pagina Entità di servizio.
Requisiti
Un Amministratore dello spazio di lavoro deve creare e gestire le entità di servizio.
Per utilizzare gli strumenti AI, devi avere un ruolo Utente completo o personalizzato con la funzionalità Strumenti di AI generativa.
Devi abilitare AMP per Server. Un amministratore deve abilitare AMP nelle Impostazioni di sistema. Per ulteriori informazioni su AMP e Server, vai a Best practice di AMP Engine.
Configurazione iniziale
Completa questi passaggi una volta per consentire agli strumenti AI di connettersi alla tua connessione LLM in Alteryx One.
Crea un'entità di servizio in Alteryx One
Nota
Devi avere un ruolo Amministratore dello spazio di lavoro per completare questo passaggio.
In Alteryx One, apri il menu del profilo.
Vai ad Admin dello spazio di lavoro > Entità di servizio.
Seleziona Nuovo.
Immetti i valori:
Nome: immetti un nome univoco.
Descrizione: Inserisci una descrizione.
Durata del segreto (giorni): immetti un valore da 1 a 365.
In Ruoli, seleziona un ruolo Utente completo o un ruolo personalizzato con la funzionalità Strumenti di AI generativa.
Seleziona Crea.
Dopo aver creato l'entità di servizio:
Copia l'ID client.
Copia il Segreto client.
Memorizza questi valori in modo sicuro.
Condividi la connessione LLM in Alteryx One
Vai a Dati.
Seleziona Connessioni.
Individua la connessione LLM.
Seleziona il menu a tre puntini, quindi seleziona Condividi.
In Seleziona utenti o entità di servizio, seleziona l'entità di servizio.
Nel menu a discesa dei ruoli, seleziona Editor (o il ruolo richiesto).
Assicurati di modificare la condivisione delle credenziali da Non condividere le credenziali a Condividi credenziali.
Seleziona Condividi.
Configurazione dello strumento Sostituzione LLM o Prompt in Designer
Selezione della connessione dell'entità di servizio
In Designer, apri il flusso di lavoro.
Seleziona lo strumento Prompt.
Nella sezione Opzioni di connessione, seleziona Entità di servizio (per Server).
Creazione di una connessione
Seleziona Crea una nuova connessione.
In Data Connection Manager (DCM), seleziona + Nuovo.
Dal menu a discesa Seleziona tecnologia, seleziona Applicazione OAuth Alteryx One.
Inserimento delle credenziali
Nota
Per immettere queste credenziali, devi avere accesso all'ID client e al Segreto client dell'entità di servizio. Se non hai creato l'entità di servizio, chiedi a Amministratore dello spazio di lavoro di fornire questi valori.
In Nome dell'origine dati, inserisci un nome.
In ID client, immetti l'ID client dell'entità di servizio.
Nel campo Segreto client, immetti il segreto client dell'entità di servizio.
Seleziona Salva.
Pubblicazione del flusso di lavoro in Server
Una volta configurata la connessione dell'entità di servizio, pubblica il tuo flusso di lavoro su Server.
Il flusso di lavoro viene eseguito su Server utilizzando l'entità di servizio. Gli strumenti AI utilizzano la connessione LLM condivisa e funzionano senza richiedere l'autenticazione dell'utente.
Rotazione dei segreti dell'entità di servizio
I segreti client per un'entità di servizio scadono dopo un anno. Quando il segreto scade, aggiorna la connessione dell'entità di servizio con un nuovo segreto client in Data Connection Manager. Per ulteriori informazioni sulla rotazione dei segreti, vai alla pagina Entità di servizio.
Nota
Se non hai creato l'entità di servizio, chiedi a Amministratore dello spazio di lavoro di fornire un nuovo segreto client.
Generazione di un nuovo segreto client
Da Alteryx One, vai a Amministratore dell'area di lavoro > Entità di servizio.
Sulla pagina Entità di servizio, seleziona un'entità di servizio per aprire la relativa pagina dei dettagli.
Seleziona Genera segreto.
Copia e conserva in modo sicuro il nuovo segreto.
Aggiorna la Connessione in Designer
In Designer, seleziona File > Gestisci connessioni.
Nella pagina Connessioni, seleziona la connessione dell'entità di servizio.
Seleziona Modifica.
Inserisci il Segreto client e poi seleziona Salva.
Rivedi la connessione per assicurarti che funzioni come previsto prima di utilizzarla nei flussi di lavoro.