Este guia explica como configurar chaves de API para o Amazon Bedrock para habilitar os recursos do Discourse AI que exigem chaves de LLM de terceiros.
Nível de usuário necessário: Administrador
Neste exemplo, estamos usando o Amazon Bedrock para gerar as chaves.
Nota: Você precisará de um plano pago e de chaves de API configuradas
As plataformas estão em constante mudança, portanto, este guia pode não refletir 100% do processo.
Obter chaves de API
Configurar chaves no Amazon Bedrock é um pouco mais complicado do que na maioria dos outros provedores. Provavelmente, você precisará estar familiarizado com conceitos como funções IAM e outros. As instruções sobre como obter as chaves estão em:
Quais modelos do Bedrock o Discourse AI suporta?
O Discourse AI suporta todos os modelos Anthropic Claude e todos os modelos de linguagem Nova (Micro / Lite e Pro).
Esses modelos são suportados com imagens, vídeos e chamadas de ferramentas (XML e nativas).
Aqui estão alguns IDs de modelo principais:
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 muitos outros
Para a lista completa e atualizada de IDs de modelos Claude suportados, consulte o método bedrock_model_id no código-fonte. Além disso, qualquer nome de modelo não mapeado explicitamente será passado como está, permitindo que você use novos IDs de modelo diretamente.
Lembre-se de que nem todos os modelos estão disponíveis em todas as regiões; verifique sua página de configuração do Bedrock.
Usando chaves de API para o Discourse AI
- Vá para
Admin→Plugins→AI→ abaLLMs - Clique no botão \u003ckbd\u003eConfigurar\u003c/kbd\u003e em “Configuração manual”
- Insira todas as configurações do modelo:
O Discourse AI suporta dois métodos de autenticação para o Bedrock:
- Chaves de acesso estáticas: Forneça uma chave de API (chave de acesso secreta), um ID da chave de acesso e uma região.
- Autenticação baseada em função IAM: Forneça um ARN de função e uma região. Isso usa o AWS STS AssumeRole para rotação automática de credenciais.
Você deve configurar um ID da chave de acesso ou um ARN de função (juntamente com uma região) para autenticação.
Como tokenizer, você pode usar o OpenAiTokenizer para modelos Nova e o AnthropicTokenizer para modelos baseados em Claude.
Devo desativar o suporte a ferramentas nativas ou não?
O Discourse vem com configurações baseadas em ferramentas nativas e em ferramentas XML. Em alguns casos, as ferramentas XML superam a implementação de ferramentas nativas; experimente para descobrir qual configuração funciona melhor para você.