Configura chiavi API per Azure OpenAI

[Discourse]

Questa guida spiega come configurare le chiavi API per Azure OpenAI per abilitare le funzionalità di Discourse AI che richiedono chiavi LLM di terze parti.

Livello utente richiesto: Amministratore

In questo esempio, utilizzeremo Azure OpenAI per generare le chiavi.

Nota: È probabile che sia necessario un piano a pagamento e che si paghi per l’utilizzo. Consultare qui per dettagli e prezzi aggiornati.

Le piattaforme cambieranno sempre, quindi questa guida potrebbe non riflettere il processo al 100%.

Per utilizzare determinati moduli AI, gli utenti devono disporre di una chiave API da un provider di terze parti come OpenAI (ChatGPT), Anthropic (Claude), Stability AI (Stable Diffusion), ecc.

Controllare ciascun modulo AI per vedere quali provider di terze parti possono essere utilizzati.

Ottenere le chiavi API

1. Seguire la documentazione qui per ottenere le chiavi API necessarie a seconda dei modelli OpenAI scelti e dei moduli/funzionalità di Discourse AI utilizzati
2. Una volta ottenute le chiavi, conservarle in un luogo sicuro e copiarle

Aggiungere una credenziale

Le chiavi API vengono gestite centralmente tramite la pagina Credentials (Credenziali). È necessario creare una credenziale prima di configurare l’LLM.

1. Andare su Admin → Plugins → AI → Credentials
2. Cliccare su New credential (Nuova credenziale)
3. Assegnarle un nome descrittivo (es. “Azure OpenAI API Key”)
4. Incollare la chiave API di Azure nel campo Value (Valore)
5. Salvare la credenziale

Utilizzo delle chiavi API per Discourse AI

1. Andare su Admin → Plugins → AI → LLMs
2. Cliccare sul pulsante + New Model (+ Nuovo Modello)
3. Selezionare il modello appropriato dall’elenco.
   
   
4. Selezionare Azure dall’elenco Provider (Fornitore)
5. Inserire l’URL del servizio che ospita il modello

URL di esempio: https://{RESOURCE_NAME}.openai.azure.com/openai/deployments/{DEPLOYMENT_NAME}/chat/completions?api-version=2024-02-15-preview dove

• RESOURCE_NAME è il nome della tua risorsa Azure OpenAI
• DEPLOYMENT_NAME è il nome della tua distribuzione del modello Azure OpenAI

6. Selezionare la credenziale creata in precedenza dal menu a discesa delle credenziali
7. Salvare l’LLM