Esta guía explica cómo configurar las claves de API para Amazon Bedrock para habilitar las funciones de Discourse AI que requieren claves de LLM de terceros.
Nivel de usuario requerido: Administrador
En este ejemplo, estamos utilizando Amazon Bedrock para generar las claves.
Nota: Se requiere un plan de pago y claves de API configuradas.
Las plataformas siempre cambian, por lo que esta guía podría no reflejar el proceso al 100 %.
Obtener claves de API
Configurar las claves en Amazon Bedrock es un poco más complicado que en la mayoría de los demás proveedores. Probablemente necesites estar familiarizado con conceptos como roles de IAM y más. Las instrucciones sobre cómo obtener las claves están en:
¿Qué modelos de Bedrock admite Discourse AI?
Discourse AI admite todos los modelos Anthropic Claude y todos los modelos de lenguaje Nova (Micro / Lite y Pro).
Estos modelos admiten imágenes, videos y llamadas a herramientas (XML y nativas).
Aquí tienes algunos IDs de modelo clave:
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
- Y muchos más
Para obtener la lista completa y actualizada de IDs de modelos Claude admitidos, consulta el método bedrock_model_id en el código fuente. Además, cualquier nombre de modelo que no esté mapeado explícitamente se pasará tal cual, lo que te permite usar IDs de modelos más nuevos directamente.
Ten en cuenta que no todos los modelos están disponibles en todas las regiones; consulta tu página de configuración de Bedrock.
Uso de claves de API para Discourse AI
- Ve a
Administración→Plugins→IA→ PestañaLLMs. - Haz clic en el botón
<kbd>Configurar</kbd>en “Configuración manual”. - Ingresa todos los ajustes del modelo:
Discourse AI admite dos métodos de autenticación para Bedrock:
- Claves de acceso estáticas: Proporciona una clave de API (clave de acceso secreta), un ID de clave de acceso y una región.
- Autenticación basada en roles de IAM: Proporciona un ARN de rol y una región. Esto utiliza AWS STS AssumeRole para la rotación automática de credenciales.
Debes configurar ya sea un ID de clave de acceso o un ARN de rol (junto con una región) para la autenticación.
Como tokenizador, puedes usar OpenAiTokenizer para Nova y AnthropicTokenizer para los modelos basados en Claude.
¿Debo deshabilitar el soporte de herramientas nativas o no?
Discourse incluye configuraciones basadas en herramientas nativas y herramientas XML. En algunos casos, las herramientas XML superan a la implementación de herramientas nativas; deberías experimentar para encontrar qué configuración funciona mejor para ti.