Claude в Amazon Bedrock

Это руководство проведет вас через процесс настройки и выполнения вызовов API к Claude в Amazon Bedrock. Claude в Amazon Bedrock работает на инфраструктуре, управляемой AWS, без доступа оператора (сотрудники Anthropic не имеют доступа к инфраструктуре вывода), позволяя вам создавать чувствительные приложения полностью внутри границы безопасности AWS, используя тот же API Messages, который вы используете с первоклассным API Anthropic.

Исследовательский предпросмотр

Claude в Amazon Bedrock находится в исследовательском предпросмотре, доступном в регионе US East (N. Virginia) us-east-1 при запуске. Свяжитесь с вашим менеджером аккаунта Anthropic, чтобы запросить доступ.

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

Перед началом убедитесь, что у вас есть:

• Новый аккаунт AWS в us-east-1. Исследовательский предпросмотр требует выделенного аккаунта для изоляции. Ваш менеджер аккаунта Anthropic отправит ваш ID аккаунта команде Bedrock Marketplace для добавления в список разрешений (обычно обрабатывается в течение 24 часов).
• AWS CLI установлен и настроен (опционально, для управления учетными данными)
• После добавления в список разрешений AWS отправит приветственное письмо с вашим ID модели и дополнительными деталями настройки.

Аутентификация

Claude в Amazon Bedrock поддерживает три пути аутентификации. Выберите тот, который лучше всего соответствует вашим требованиям безопасности.

Роль сервиса Bedrock (рекомендуется)

Используйте роль сервиса Bedrock с управляемыми AWS ключами для наиболее безопасного долгосрочного доступа:

Предполагаемые роли IAM

Для доступа с федерацией идентификации с максимальной сессией 12 часов:

Токены Bearer

Для краткосрочного доступа без ролей IAM (максимум 12 часов, наименее предпочтительно):

Установка SDK

Клиентские SDK Anthropic поддерживают Claude в Amazon Bedrock через пакет или модуль, специфичный для Bedrock.

Выполнение вашего первого запроса

Конечная точка следует шаблону https://bedrock-mantle.{region}.api.aws/anthropic/v1/messages. В отличие от устаревшей интеграции Bedrock, эта конечная точка использует стандартную потоковую передачу SSE и ту же форму тела запроса, что и первоклассный API Anthropic.

SDK разрешает учетные данные и регион, используя стандартный приоритет AWS: аргументы конструктора, затем переменные окружения (AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_SESSION_TOKEN, AWS_REGION), затем файл конфигурации AWS и цепь учетных данных (SSO, предполагаемые роли, роль задачи ECS, IMDS).

from anthropic import AnthropicBedrockMantle

client = AnthropicBedrockMantle(aws_region="us-east-1")

message = client.messages.create(
    model="CLAUDE_MODEL_ID",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello, Claude"}],
)

print(message.content[0].text)

Поддерживаемые модели

ID моделей в Claude в Amazon Bedrock содержат префикс поставщика anthropic.. Возможности и поведение моделей задокументированы на странице Обзор моделей. Смотрите ваше приветственное письмо AWS для точного ID модели, включенного для вашего аккаунта.

Доступность функций

Claude в Amazon Bedrock поддерживает функции, которые работают внутри модели. Функции, которые требуют инфраструктуры, управляемой Anthropic, недоступны.

Поддерживается:

• Messages API (/v1/messages)
• Кэширование подсказок
• Расширенное мышление
• Использование инструментов (инструменты, определяемые клиентом)
• Цитирования
• Структурированные выходные данные
• Вывод в регионе (запросы остаются в одном регионе AWS)

Не поддерживается:

• Инструменты, определяемые Anthropic (Web Search, Web Fetch, Remote MCP, Memory, Files API, Computer Use, Skills, Code Execution)
• Agent API
• Message Batches API
• Конечная точка /v1/users

Регионы

Исследовательский предпросмотр доступен только в us-east-1 (IAD).

Квоты

Квота по умолчанию составляет 2 миллиона входных токенов в минуту (TPM). Вы можете запросить до 4 миллионов входных TPM без дополнительного одобрения Anthropic. AWS применяет ограничения на количество запросов в минуту (RPM) на стороне Bedrock; свяжитесь с поддержкой AWS для корректировки RPM.

Хранение данных

Все данные вывода хранятся в течение 30 дней в вашем хранилище AWS. На этом предложении нет опции отказа от нулевого хранения данных. Для стандартных клиентов Anthropic может проверять сохраненные данные для проверки безопасности и рассмотрения злоупотреблений. Для клиентов уровня Select только AWS может проверять данные; Anthropic может выполнять автоматизированные операции, но не ручное рассмотрение. Для получения информации о приемлемости уровня Select свяжитесь с вашим менеджером аккаунта Anthropic.

Наблюдаемость

Claude в Amazon Bedrock отправляет журналы как в CloudWatch, так и в CloudTrail. Anthropic рекомендует сохранять журналы активности по крайней мере на 30-дневной скользящей основе, чтобы понять закономерности использования и исследовать потенциальные проблемы.

Поддержка

Для поддержки исследовательского предпросмотра свяжитесь с [email protected]. Включите ваш ID аккаунта AWS и request-id из любых неудачных ответов API.