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
   
   

[Zak]

Ciao,

Sto riscontrando un problema con l’endpoint OpenAI Azure. Sembra non funzionare come previsto per il seguente URL:

https://***.openai.azure.com/openai/deployments/DEPLOYMENT_NAME/chat/completions?api-version=2023-07-01-preview

Dove DEPLOYMENT_NAME è impostato su gpt-4-32k.

Potresti aiutarmi a risolvere questo problema? Qualsiasi indicazione o suggerimento sarebbe molto apprezzato.

Inoltre, ho alcune domande sui plugin di Discourse:

1. Come fare il Fork di un Plugin Discourse: Potresti fornire istruzioni dettagliate o una guida su come fare il fork di un plugin Discourse esistente?
2. Testare il Plugin Forkato: Una volta che ho fatto il fork di un plugin, quali sono i passaggi per testare questa versione forkata sulla mia istanza Discourse?
3. Caricare e Attivare il Plugin: Dopo il test, come posso caricare e attivare questo plugin forkato sulla mia istanza Discourse?

La tua assistenza con queste domande sarebbe estremamente utile. Grazie per il tuo tempo e supporto.

Cordiali saluti,