sidebar_position: 14 title: "AWS Bedrock" description: "Use Hermes Agent with Amazon Bedrock — native Converse API, IAM authentication, Guardrails, and cross-region inference" lang: ru


Основа AWS

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

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

:::совет EC2/ECS/Lambda На вычислениях AWS прикрепите роль IAM с помощью AmazonBedrockFullAccess, и все готово. Никаких ключей API, никакой конфигурации .env — Hermes автоматически определяет роль экземпляра.

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

# Install with Bedrock support
pip install hermes-agent[bedrock]

# Select Bedrock as your provider
hermes model
# → Choose "More providers..." → "AWS Bedrock"
# → Select your region and model

# Start chatting
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. По умолчанию: us-east-1.

Ограждения

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

bedrock:
  region: us-east-2
  guardrail:
    guardrail_identifier: "abc123def456"  # From the Bedrock console
    guardrail_version: "1"                # Version number or "DRAFT"
    stream_processing_mode: "async"       # "sync" or "async"
    trace: "disabled"                     # "enabled", "disabled", or "enabled_full"

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

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

bedrock:
  discovery:
    enabled: true
    provider_filter: ["anthropic", "amazon"]  # Only show these providers
    refresh_interval: 3600                     # Cache for 1 hour

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

Модели Bedrock используют идентификаторы профилей вывода для вызова по требованию. Средство выбора 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 Последние новости Меты

ℹ️ Info

Межрегиональный вывод Модели с префиксом `us.` используют межрегиональные профили вывода, которые обеспечивают лучшую пропускную способность и автоматическое переключение при сбое в разных регионах AWS. Модели с префиксом `global.` маршрутизируются во все доступные регионы по всему миру.

Переключение моделей в середине сеанса

Используйте команду /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 к своему вычислительному экземпляру.

«Вызов идентификатора модели... с пропускной способностью по требованию не поддерживается»

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

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

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