Conectar AWS Bedrock

Pense no Amazon Bedrock como uma máquina de vendas gigante para modelos de IA — em vez de salgadinhos, ela serve modelos de linguagem poderosos da Anthropic, Meta e outros, tudo com um único método de pagamento simples: sua conta AWS.

O Que Você Vai Precisar

Antes de começar, certifique-se de ter:

• Uma conta AWS (o nível gratuito funciona perfeitamente)
• Credenciais AWS — são como seu documento de identidade. Você pode usar:
  • Uma role IAM se estiver no EC2/ECS/Lambda (zero configuração!)
  • As variáveis de ambiente AWS_ACCESS_KEY_ID + AWS_SECRET_ACCESS_KEY
  • Um AWS_PROFILE para SSO ou perfis nomeados
  • Ou simplesmente rode aws configure para desenvolvimento local

Passo 1: Instale o Hermes com Suporte ao Bedrock

Abra seu terminal e execute:

cd ~/.hermes/hermes-agent
uv pip install -e ".[bedrock]"

Isso adiciona o “plug-in” do Bedrock à sua instalação do Hermes. Pense nisso como instalar um pacote de idiomas no seu celular.

Passo 2: Diga ao Hermes para Usar o Bedrock

Execute este comando para escolher seu provedor:

hermes model

Quando solicitado:

1. Escolha “More providers…”
2. Selecione “AWS Bedrock”
3. Escolha sua região (como us-east-2)
4. Escolha um modelo (ex.: Claude Sonnet 4)

O Hermes salvará suas configurações automaticamente. Seu ~/.hermes/config.yaml ficará mais ou menos assim:

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

Passo 3: Comece a Conversar

hermes chat

Pronto! Agora você está conversando com um modelo através do AWS Bedrock.

Definindo Sua Região

Você pode definir sua região AWS de três maneiras (da maior para a menor prioridade):

1. Adicione region na seção bedrock: do seu arquivo de configuração
2. Defina a variável de ambiente AWS_REGION
3. Defina a variável de ambiente AWS_DEFAULT_REGION

Se você não definir, o Hermes usará us-east-1 como padrão.

Extra: Guardrails (Filtros de Segurança)

Quer adicionar filtros de conteúdo? Adicione isso à sua configuração:

bedrock:
  region: us-east-2
  guardrail:
    guardrail_identifier: "abc123def456"  # Do console do Bedrock
    guardrail_version: "1"                # Ou "DRAFT"
    stream_processing_mode: "async"       # "sync" ou "async"
    trace: "disabled"                     # "enabled", "disabled", "enabled_full"

Descoberta de Modelos

O Hermes encontra automaticamente os modelos disponíveis na sua região. Você pode personalizar quais ele exibe:

bedrock:
  discovery:
    enabled: true
    provider_filter: ["anthropic", "meta"]

Resumo

Conectar o AWS Bedrock ao Hermes é como plugar um novo videogame na sua TV — instale o driver, escolha o jogo e jogue. Você ganha acesso a modelos de primeira linha com a segurança e confiabilidade da AWS.

Dica prática: Se você estiver rodando no EC2 ou Lambda, esqueça as chaves de API. Basta anexar uma role IAM com AmazonBedrockFullAccess e o Hermes detectará automaticamente. Sem configuração, sem complicação — apenas poder de IA puro.

---