🏠 Главная › guides › aws bedrock

Основа AWS

Агент Hermes поддерживает Amazon Bedrock в качестве отдельного провайдера, используя Converse API (конечная точка, несовместимая с OpenAI). Это дает вам полный доступ к экосистеме. Основа: IAM-аутентификация, Guardrails, кросс-региональные профили, результаты и все базовые модели.

Предварительные требования

Быстрый старт

# Установка с поддержкой Bedrock
pip install hermes-agent[bedrock]

# Выберите Bedrock как провайдера
hermes model
# → Выберите "Больше провайдеров..." → "AWS Bedrock"
# → Выберите регион и модель

# Начните чат
hermes chat

Конфигурация

После запуска hermes model ваш ~/.hermes/config.yaml будет сохраняться:

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

Регион

Выберите регион AWS одним из следующих способов (приоритет по убыванию):

  1. bedrock.region в config.yaml
  2. Переменная окружения AWS_REGION
  3. Переменная окружения AWS_DEFAULT_REGION
  4. По умолчанию: нас-восток-1

Ограждения

Чтобы применить Amazon Bedrock Guardrails ко всем вызовам моделей:

bedrock:
  region: us-east-2
  guardrail:
    guardrail_identifier: "abc123def456"  # из консоли Bedrock
    guardrail_version: "1"                # номер версии или "DRAFT"
    stream_processing_mode: "async"       # "sync" или "async"
    trace: "disabled"                     # "enabled", "disabled" или "enabled_full"

Обнаружение моделей

Гермес автоматически обнаруживает доступные модели через управляющую плоскость Bedrock. Вы можете настроить определение поведения:

bedrock:
  discovery:
    enabled: true
    provider_filter: ["anthropic", "amazon"]  # показывать только этих провайдеров
    refresh_interval: 3600                     # кэшировать на 1 час

Доступные модели

Модели Bedrock используют ID профиля вывода для вызова инструмента. Селектор hermes model автоматически показывает наиболее рекомендуемые модели — вверху:

Модель уверенность личности Описание
Клод Сонет 4.6 us.anthropic.claude-sonnet-4-6 Рекомендуется — лучший баланс скорости и возможностей
Клод Опус 4.6 us.anthropic.claude-opus-4-6-v1 Самая мощная
Клод Хайку 4.5 us.anthropic.claude-haiku-4-5-20251001-v1:0 Самый быстрый Клод
Амазон Нова Про us.amazon.nova-pro-v1:0 Флагманская модель Amazon
Амазон Нова Микро us.amazon.nova-micro-v1:0 Самая быстрая и дешёвая
ДипСик V3.2 deepseek.v3.2 Мощная открытая модель
Лама 4 Скаут 17Б us.meta.llama4-scout-17b-instruct-v1:0 Последняя модель Мета
Модели с префиксом us. используют кросс-региональные профильные выводы, которые ограничивают ограничение ёмкости и ограничение переключения между регионами AWS. Модели с префиксом «глобальные». Маршруты разрабатываются во всех доступных регионах мира.
## Переключение модели во время сессии

Используйте команду /model в диалоге:

/model us.amazon.nova-pro-v1:0
/model deepseek.v3.2
/model us.anthropic.claude-opus-4-6-v1

Диагностика

hermes doctor

Диагностика на день: - Доступность учётных данных AWS (переменные окружения, IAM-роль, SSO) - Установлен ли boto3 - Доступность API Bedrock (ListFoundationModels) - Количество доступных моделей в ваших странах

Шлюзы (мессенджеры)

Bedrock работает со всеми шлюзами Hermes (Telegram, Discord, Slack, Feishu и др.). Настройте Bedrock как провайдера, затем запустите шлюз обычным способом:

hermes gateway setup
hermes gateway start

Шлюз читает config.yaml и использует ту же конфигурацию провайдера Bedrock.

Устранение неполадок

"Не найден ключ API" / "Нет учётных данных AWS"

Гермес впоследствии учётные данные в следующем порядке: 1. AWS_BEARER_TOKEN_BEDROCK 2. AWS_ACCESS_KEY_ID + AWS_SECRET_ACCESS_KEY 3. AWS_PROFILE 4. Метаданные экземпляра EC2 (IMDS) 5. Учётные данные контейнера ECS 6. Роль выполнения Lambda

Если ничего не найдено, выполните aws configure или прикрепите IAM-роль к вашему вычислительному экземпляру.

"Вызов модели ID с пропускным ограничением по функциям не требуется..."

Используйте ID-профиль вывода (с префиксом us. или global.), а не хороший идентификатор модели. Например: - ❌ anthropic.claude-sonnet-4-6 - ✅ us.anthropic.claude-sonnet-4-6

"Исключение регулирования"

Вы соблюдаете лимит на перемещение моделей данных в Bedrock. Гермес автоматически повторяет запросы с экспоненциальной задержкой. Чтобы увеличить лимиты, запросите увеличение квот в консоли AWS Service Quotas.

Развёртывание в AWS одной командой

Для полного автоматизированного развёртывания EC2 с CloudFormation:

sample-hermes-agent-on-aws-with-bedrock — создаёт VPC, IAM-роли, EC2-инстанс и автоматически настраивает Bedrock. Развёртывание в любой части одной команды.