Questa guida spiega come configurare le chiavi API per Amazon Bedrock per abilitare le funzionalità di Discourse AI che richiedono chiavi LLM di terze parti.
Livello utente richiesto: Amministratore
In questo esempio, stiamo utilizzando Amazon Bedrock per generare le chiavi.
Nota: È necessario un piano a pagamento e le chiavi API configurate
Le piattaforme cambiano continuamente, quindi questa guida potrebbe non riflettere il processo al 100%.
Ottenere le chiavi API
Configurare le chiavi su Amazon Bedrock è leggermente più complesso rispetto alla maggior parte degli altri provider. Probabilmente dovrai avere familiarità con concetti come i ruoli IAM e altro. Le istruzioni su come ottenere le chiavi si trovano qui:
Quali modelli Bedrock supporta Discourse AI?
Discourse AI supporta tutti i modelli Anthropic Claude e tutti i modelli linguistici Nova (Micro / Lite e Pro).
Questi modelli sono supportati con immagini, video e chiamate agli strumenti (XML e nativo).
Ecco alcuni ID modello chiave:
Nova:
- amazon.nova-pro-v1:0
- amazon.nova-lite-v1:0
- amazon.nova-micro-v1:0
Claude:
- anthropic.claude-sonnet-4-6
- anthropic.claude-opus-4-6-v1
- anthropic.claude-haiku-4-5-20251001-v1:0
- E molti altri
Per l’elenco completo e aggiornato degli ID dei modelli Claude supportati, consulta il metodo bedrock_model_id nel codice sorgente. Inoltre, qualsiasi nome di modello non esplicitamente mappato verrà passato così com’è, consentendoti di utilizzare direttamente nuovi ID di modello.
Tieni presente che non tutti i modelli sono disponibili in tutte le regioni; controlla la pagina di configurazione di Bedrock.
Utilizzo delle chiavi API per Discourse AI
- Vai su
Admin→Plugins→AI→ schedaLLMs - Clicca sul pulsante Configura su “Configurazione manuale”
- Inserisci tutte le impostazioni del modello:
Discourse AI supporta due metodi di autenticazione per Bedrock:
- Chiavi di accesso statiche: Fornisci una chiave API (chiave di accesso segreta), un ID chiave di accesso e una regione.
- Autenticazione basata su ruoli IAM: Fornisci un ARN del ruolo e una regione. Questo utilizza AWS STS AssumeRole per il rotolamento automatico delle credenziali.
Devi configurare un ID chiave di accesso oppure un ARN di ruolo (insieme a una regione) per l’autenticazione.
Come tokenizer puoi utilizzare OpenAiTokenizer per Nova e AnthropicTokenizer per i modelli basati su Claude.
Dovrei disabilitare il supporto nativo degli strumenti o no?
Discourse include configurazioni basate su strumenti nativi e strumenti XML; in alcuni casi gli strumenti XML offrono prestazioni migliori rispetto all’implementazione nativa degli strumenti. Dovresti sperimentare per scoprire quale configurazione funziona meglio per te.