Conectar AWS Bedrock
Conectar AWS Bedrock: guía fácil de entender basada en la documentación oficial
Piensa en Amazon Bedrock como una máquina expendedora gigante de modelos de IA: en lugar de snacks, sirve potentes modelos de lenguaje de Anthropic, Meta y otros, todo con un único método de pago: tu cuenta de AWS.
Lo que necesitarás
Antes de empezar, asegúrate de tener:
- Una cuenta de AWS (el plan gratuito funciona perfectamente)
- Credenciales de AWS: son como tu documento de identidad. Puedes usar:
- Un rol de IAM si estás en EC2/ECS/Lambda (¡cero configuración!)
- Las variables de entorno
AWS_ACCESS_KEY_ID+AWS_SECRET_ACCESS_KEY - Un
AWS_PROFILEpara SSO o perfiles con nombre - O simplemente ejecuta
aws configurepara desarrollo local
Paso 1: Instala Hermes con soporte para Bedrock
Abre tu terminal y ejecuta:
cd ~/.hermes/hermes-agent
uv pip install -e ".[bedrock]"
Esto añade el “complemento” de Bedrock a tu instalación de Hermes. Piénsalo como instalar un paquete de idiomas en tu teléfono.
Paso 2: Dile a Hermes que use Bedrock
Ejecuta este comando para elegir tu proveedor:
hermes model
Cuando te lo pida:
- Elige “More providers…”
- Selecciona “AWS Bedrock”
- Escoge tu región (como
us-east-2) - Elige un modelo (por ejemplo, Claude Sonnet 4)
Hermes guardará tu configuración automáticamente. Tu ~/.hermes/config.yaml se verá algo así:
model:
default: us.anthropic.claude-sonnet-4-6
provider: bedrock
base_url: https://bedrock-runtime.us-east-2.amazonaws.com
bedrock:
region: us-east-2
Paso 3: Empieza a chatear
hermes chat
¡Eso es todo! Ya estás hablando con un modelo a través de AWS Bedrock.
Configurar tu región
Puedes establecer tu región de AWS de tres maneras (de mayor a menor prioridad):
- Añade
regionbajobedrock:en tu archivo de configuración - Define la variable de entorno
AWS_REGION - Define la variable de entorno
AWS_DEFAULT_REGION
Si no la configuras, Hermes usará us-east-1 por defecto.
Extra: Guardrails (filtros de seguridad)
¿Quieres añadir filtros de contenido? Añade esto a tu configuración:
bedrock:
region: us-east-2
guardrail:
guardrail_identifier: "abc123def456" # Desde la consola de Bedrock
guardrail_version: "1" # O "DRAFT"
stream_processing_mode: "async" # "sync" o "async"
trace: "disabled" # "enabled", "disabled", "enabled_full"
Descubrimiento de modelos
Hermes encuentra automáticamente los modelos disponibles en tu región. Puedes personalizar cuáles muestra:
bedrock:
discovery:
enabled: true
provider_filter: ["anthropic", "meta"]
Resumen
Conectar AWS Bedrock a Hermes es como conectar una nueva consola a tu televisor: instalas el controlador, eliges tu juego y a jugar. Obtienes acceso a modelos de primer nivel con la seguridad y fiabilidad de AWS.
Consejo práctico: Si estás en EC2 o Lambda, olvídate de las claves API. Solo adjunta un rol de IAM con AmazonBedrockFullAccess y Hermes lo detectará automáticamente. Sin configuración, sin complicaciones: solo puro poder de IA.
📖 Documentación oficial
Este artículo se basa en la documentación oficial de Hermes Agent :Docs oficiales › guides/aws-bedrock