Creazione di connessioni LLM
Controlli degli accessi per gli amministratori
Gli utenti con il ruolo Utente completo possono creare connessioni LLM per impostazione predefinita. Se invece vuoi limitare l'accesso alle connessioni LLM, devi assegnare un ruolo per cui la connessione LLM è disabilitata. Ulteriori informazioni su ruoli utente e funzionalità.
Per usare i modelli linguistici di grandi dimensioni (LLM) con i tuoi strumenti IA, devi prima connettere Alteryx One al modello LLM che desideri utilizzare. A tale scopo...
Accedi al tuo account Alteryx One e vai alla pagina Connessioni dalla barra di navigazione superiore. Se nel tuo spazio di lavoro è attivata l'Esperienza del nuovo set di dati, vai prima alla pagina Dati dalla barra di navigazione superiore, quindi seleziona la scheda Connessioni.
Seleziona Nuova connessione. Per informazioni dettagliate sulla creazione di una connessione, vai alla pagina Finestra Crea connessione.
Puoi usare la Barra di ricerca per trovare il modello LLM che desideri o selezionare LLM per filtrare l'elenco in modo da visualizzare solamente le connessioni LLM disponibili.
Scegli il modello LLM che desideri e inserisci i dati di configurazione.
Una volta creata la connessione, il modello LLM è disponibile in Designer tramite gli strumenti Sostituzione LLM e Prompt. Se avevi già creato la connessione LLM per altri utenti, puoi condividerla con loro dalla pagina Connessioni.
Importante
Ogni connessione LLM presenta requisiti di configurazione diversi, sia per le impostazioni necessarie nel modello LLM stesso, sia per le impostazioni di configurazione in Alteryx One.
Per ulteriori informazioni, consulta le informazioni relative alla configurazione specifica del modello LLM, più avanti in questo argomento.
Informazioni connessione
Nome connessione: specifica un nome descrittivo per la connessione, a cui gli utenti potranno fare riferimento per utilizzare la connessione in futuro.
Descrizione connessione (facoltativo): fornisci una descrizione per la connessione.
Informazioni credenziali
Nome regione AWS: specifica la regione del tuo account AWS (ad esempio, US-West).
Tipo di credenziale: al momento, l'unica opzione disponibile è Chiave di accesso AWS. Inserisci l'ID della chiave di accesso AWS e la Chiave di accesso al segreto AWS per l'account che desideri connettere. Per ulteriori informazioni, consulta la documentazione di AWS IAM. È consigliabile creare un ruolo IAM e utilizzare le chiavi di accesso corrispondenti.
Per concedere autorizzazioni complete, aggiungi
AmazonBedrockFullAccessal ruolo IAM.Per concedere autorizzazioni minime, aggiungi quanto segue al ruolo IAM:
bedrock:InvokeModelbedrock:InvokeModelWithResponseStreambedrock:ListFoundationModelsbedrock:GetFoundationModel
Informazioni connessione
Nome connessione: specifica un nome descrittivo per la connessione, a cui gli utenti potranno fare riferimento per utilizzare la connessione in futuro.
Descrizione connessione (facoltativo): fornisci una descrizione per la connessione.
Informazioni credenziali
Tipo di credenziale: al momento, l'unica opzione disponibile è Chiave API.
Chiave API: immetti la chiave API di Anthropic. Recupera la chiave API tramite la console di Anthropic.
Informazioni connessione
Nome connessione: specifica un nome descrittivo per la connessione, a cui gli utenti potranno fare riferimento per utilizzare la connessione in futuro.
Descrizione connessione (facoltativo): fornisci una descrizione per la connessione.
Informazioni credenziali
Esistono 2 tipi di credenziali selezionabili per Auzure OpenAI.
Configura la connessione Azure direttamente in Alteryx One. Configura questi campi:
Nota
Prima di generare chiamate di contenuti, è necessario implementare un modello. Per iniziare, scopri come creare e implementare un modello Azure OpenAI.
Chiave API Azure: immetti la chiave API di Azure OpenAI. Per configurare il modello ai fini dell'utilizzo con Azure OpenAI API, devi seguire le istruzioni della guida alla gestione delle API Azure.
URL di base API Azure: immetti l'URL di base di Azure (ad esempio
https://<account_name>.openai.azure.com).Versione API Azure: immetti la versione API Azure (ad esempio
2024-10-21).ID client Azure: contatta il team IT per assistenza nella creazione di questo parametro. Fornisci questa guida alla configurazione come riferimento.
ID tenant Azure: contatta il team IT per assistenza nella creazione di questo parametro. Fornisci questa guida alla configurazione come riferimento.
Segreto client Azure: contatta il team IT per assistenza nella creazione di questo parametro. Fornisci questa guida alla configurazione come riferimento.
ID iscrizione Azure: immetti il tuo ID iscrizione Azure. Puoi trovarlo in Gruppi risorse > il tuo gruppo risorse > Iscrizione > la tua iscrizione > ID iscrizione. In alternativa, puoi accedere ad AI Foundry, selezionare il nome del tuo account, quindi il portale Foundry per trovare le informazioni.
Nome gruppo risorse Azure: immetti il nome del gruppo di risorse Azure. Puoi trovarlo in Gruppi risorse > Il tuo gruppo risorse. In alternativa, puoi accedere ad AI Foundry, selezionare il nome del tuo account, quindi il portale Foundry per trovare le informazioni.
Nome account Azure (risorsa): immetti il nome dell'account Azure. Puoi trovarlo nella pagina AI Foundry.
Utilizza Oauth 2.0 per autenticare la connessione Azure. Configura questi campi:
Nota
Prima di generare chiamate di contenuti, è necessario implementare un modello. Per iniziare, scopri come creare e implementare un modello Azure OpenAI.
Importante
Se aggiorni la connessione, seleziona Autentica per il client Oauth. In caso contrario, la connessione si interrompe.
URL di base API Azure: immetti l'URL di base di Azure (ad esempio
https://<account_name>.openai.azure.com).Versione API Azure: immetti la versione API Azure (ad esempio
2024-10-21).Elenco modelli: immetti un elenco di modelli separati da virgole (ad esempio,
gpt-5,gpt-4o,custom). Utilizza il nome del modello implementato per i modelli personalizzati.Nota
Assicurati che i modelli selezionati siano implementati con i nomi corretti. In caso contrario, non sarà possibile usarli per effettuare richieste nello strumento Prompt.
Client Oauth: seleziona il client Oauth da utilizzare. Poi seleziona Autentica per convalidarlo. Per creare un client Oauth, attieniti alla seguente procedura:
Nota
Solo Amministratore dello spazio di lavoro può creare e condividere client Oauth. Se non disponi dell'autorizzazione, contatta il tuo Amministratore dello spazio di lavoro.
Accedi al menu del profilo, quindi vai alla sezione Admin dello spazio di lavoro > Client Oauth.
Seleziona Nuova.
Immetti i dati del client Oauth:
Nome: immetti un nome descrittivo.
Tecnologia: seleziona
azure.Tipo di concessione: seleziona Credenziali client.
ID client: contatta il team IT per la configurazione. Fornisci questa guida alla configurazione come riferimento.
Segreto client: contatta il team IT per la configurazione. Fornisci questa guida alla configurazione come riferimento.
Data di scadenza segreto client: seleziona una data di scadenza futura.
URL token: immetti
https://login.microsoftonline.com/{tenant_id}/oauth2/v2.0/token. Sostituisci{tenant_id}con il tuo ID tenant. Per ottenere il tuo ID tenant, contatta il team IT. Fornisci questa guida alla configurazione come riferimento.Campi: immetti
https://cognitiveservices.azure.com/.default.Scadenza token di accesso: immetti la durata del token in secondi.
Informazioni connessione
Nome connessione: specifica un nome descrittivo per la connessione, a cui gli utenti potranno fare riferimento per utilizzare la connessione in futuro.
Descrizione connessione (facoltativo): fornisci una descrizione per la connessione.
Informazioni credenziali
Tipo di credenziale: al momento, l'unica opzione disponibile è Chiave API.
Chiave API: immetti la chiave API di Cohere. Scopri come recuperare la chiave API dal tuo account Cohere.
Informazioni connessione
Nome connessione: specifica un nome descrittivo per la connessione, a cui gli utenti potranno fare riferimento per utilizzare la connessione in futuro.
Descrizione connessione (facoltativo): fornisci una descrizione per la connessione.
Informazioni credenziali
Tipo di credenziale: al momento, l'unica opzione disponibile è Chiave API.
URL di base: inserisci l'URL di base per Databricks (ad esempio,
https://<workspace>.databricks.com/serving-endpoints).Chiave API : inserisci il tuo token di accesso personale per Databricks. In questo modo puoi accedere ai modelli base di Databricks o ai modelli personalizzati implementati.
Informazioni connessione
Nome connessione: specifica un nome descrittivo per la connessione, a cui gli utenti potranno fare riferimento per utilizzare la connessione in futuro.
Descrizione connessione (facoltativo): fornisci una descrizione per la connessione.
Informazioni credenziali
Tipo di credenziale: al momento, l'unica opzione disponibile è Chiave API.
Chiave API: immetti la chiave API di DeepSeek. Scopri come recuperare la chiave API dal tuo account DeepSeek.
Informazioni connessione
Nome connessione: specifica un nome descrittivo per la connessione, a cui gli utenti potranno fare riferimento per utilizzare la connessione in futuro.
Descrizione connessione (facoltativo): fornisci una descrizione per la connessione.
Informazioni credenziali
Tipo di credenziale: al momento, l'unica opzione disponibile è Credenziale Vertex JSON.
Credenziali Vertex: copia e incolla il file JSON che contiene le chiavi del tuo account di servizio. Scopri come creare le chiavi del tuo account di servizio da Google Cloud.
Informazioni connessione
Nome connessione: specifica un nome descrittivo per la connessione, a cui gli utenti potranno fare riferimento per utilizzare la connessione in futuro.
Descrizione connessione (facoltativo): fornisci una descrizione per la connessione.
Informazioni credenziali
Tipo di credenziale: al momento, l'unica opzione disponibile è Chiave API.
Chiave API: immetti la chiave API di GroqCloud. Scopri come creare la chiave API dal tuo account GroqCloud.
Informazioni connessione
Nome connessione: specifica un nome descrittivo per la connessione, a cui gli utenti potranno fare riferimento per utilizzare la connessione in futuro.
Descrizione connessione (facoltativo): fornisci una descrizione per la connessione.
Elenco modelli: inserisci un elenco di modelli da utilizzare con questa connessione. Separa i modelli con virgole (ad esempio
meta-lama/Llama-prompt-Guard-2-86M,meta-lama/Llama-3.3-70B-Instruct,katanemo/Arch-Router-1.5B). Assicurati che ogni modello sia implementato su Hugging Face utilizzando il provider di inferenza Hugging Face, supporti la generazione di testo e che tu vi abbia accesso. Al momento, sono supportati solo i modelli implementati con il provider di inferenza Hugging Face.Nota
Assicurati che i nomi dei modelli siano corretti. Se i nomi sono errati, non puoi inviare richieste tramite lo strumento Prompt.
Informazioni credenziali
Tipo di credenziale: al momento, l'unica opzione disponibile è Chiave API.
Chiave API : inserisci il tuo token di accesso utente Hugging Face. Scopri come creare il token di accesso utente dal tuo account Hugging Face.
Informazioni connessione
Nome connessione: specifica un nome descrittivo per la connessione, a cui gli utenti potranno fare riferimento per utilizzare la connessione in futuro.
Descrizione connessione (facoltativo): fornisci una descrizione per la connessione.
Informazioni credenziali
Tipo di credenziale: al momento, l'unica opzione disponibile è Chiave API.
Chiave API: immetti la chiave API di Mistral. Scopri come creare la chiave API dal tuo account Mistral.
Informazioni connessione
Nome connessione: specifica un nome descrittivo per la connessione, a cui gli utenti potranno fare riferimento per utilizzare la connessione in futuro.
Descrizione connessione (facoltativo): fornisci una descrizione per la connessione.
Informazioni credenziali
Tipo di credenziale: al momento, l'unica opzione disponibile è Chiave API.
Chiave API: immetti la chiave API di OpenAI. Scopri come creare la chiave API dal tuo account OpenAI.
Utilizza connessioni compatibili con OpenAI per connetterti alle API LLM che seguono la specifica API OpenAI.
Informazioni connessione
Nome connessione: specifica un nome descrittivo per la connessione, a cui gli utenti potranno fare riferimento per utilizzare la connessione in futuro.
Descrizione connessione (facoltativo): fornisci una descrizione per la connessione.
Informazioni credenziali
Tipo di credenziale: al momento, l'unica opzione disponibile è Chiave API.
URL di base: endpoint API per il provider o modello personalizzato compatibile con OpenAI (ad esempio,
https://your-custom-endpoint.com/v1).Chiave API: inserici la chiave API per il tuo provider o modello personalizzato compatibile con OpenAI.
Informazioni connessione
Nome connessione: specifica un nome descrittivo per la connessione, a cui gli utenti potranno fare riferimento per utilizzare la connessione in futuro.
Descrizione connessione (facoltativo): fornisci una descrizione per la connessione.
Informazioni credenziali
Tipo di credenziale: al momento, l'unica opzione disponibile è Chiave API.
Chiave API: immetti la chiave API di Perplexity. Scopri come creare la chiave API dal tuo account Perplexity.
Informazioni connessione
Nome connessione: specifica un nome descrittivo per la connessione, a cui gli utenti potranno fare riferimento per utilizzare la connessione in futuro.
Descrizione connessione (facoltativo): fornisci una descrizione per la connessione.
Informazioni credenziali
Tipo di credenziale: al momento, l'unica opzione disponibile è Chiave API.
Chiave API: immetti la chiave API di xAI. Scopri come creare la chiave API dal tuo account xAI.