Claude в Microsoft Foundry

Это руководство проведет вас через процесс настройки и выполнения вызовов API к Claude в Foundry на Python, TypeScript или с использованием прямых HTTP-запросов. Когда вы получаете доступ к Claude в Foundry, вам выставляется счет за использование Claude на Microsoft Marketplace с помощью вашей подписки Azure, что позволяет вам получить доступ к последним возможностям Claude при управлении затратами через вашу подписку Azure.

Доступность по регионам: При запуске Claude доступен как тип развертывания Global Standard в ресурсах Foundry (US DataZone скоро появится). Цены на Claude на Microsoft Marketplace используют стандартное ценообразование API Anthropic. Посетите страницу цен для получения подробной информации.

Предпросмотр

В этой интеграции платформы предпросмотра модели Claude работают на инфраструктуре Anthropic. Это коммерческая интеграция для выставления счетов и доступа через Azure. Как независимый обработчик данных для Microsoft, клиенты, использующие Claude через Microsoft Foundry, подчиняются условиям использования данных Anthropic. Anthropic продолжает предоставлять свои ведущие в отрасли обязательства по безопасности и данным, включая доступность нулевого хранения данных.

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

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

• Активная подписка Azure
• Доступ к Foundry
• Установленный Azure CLI (опционально, для управления ресурсами)

Установка SDK

Client SDKs Anthropic поддерживают Foundry через пакеты для конкретных платформ.

Подготовка

Foundry использует двухуровневую иерархию: ресурсы содержат вашу конфигурацию безопасности и выставления счетов, а развертывания — это экземпляры модели, которые вы вызываете через API. Сначала вы создадите ресурс Foundry, а затем создадите одно или несколько развертываний Claude в нем.

Подготовка ресурсов Foundry

Создайте ресурс Foundry, который требуется для использования и управления услугами в Azure. Вы можете следовать этим инструкциям для создания ресурса Foundry. Кроме того, вы можете начать с создания проекта Foundry, что включает создание ресурса Foundry.

Для подготовки вашего ресурса:

1. Перейдите на портал Foundry
2. Создайте новый ресурс Foundry или выберите существующий
3. Настройте управление доступом, используя ключи API, выданные Azure, или Entra ID для управления доступом на основе ролей
4. Опционально настройте ресурс так, чтобы он был частью частной сети (Azure Virtual Network) для повышенной безопасности
5. Запомните имя вашего ресурса. Вы будете использовать его как {resource} в конечных точках API (например, https://{resource}.services.ai.azure.com/anthropic/v1/*)

Создание развертываний Foundry

После создания вашего ресурса разверните модель Claude, чтобы сделать ее доступной для вызовов API:

1. На портале Foundry перейдите к вашему ресурсу
2. Перейдите в Models + endpoints и выберите + Deploy model > Deploy base model
3. Найдите и выберите модель Claude (например, claude-sonnet-4-6)
4. Настройте параметры развертывания:
   • Deployment name: По умолчанию совпадает с ID модели, но вы можете его настроить (например, my-claude-deployment). Имя развертывания не может быть изменено после его создания.
   • Deployment type: Выберите Global Standard (рекомендуется для Claude)
5. Выберите Deploy и дождитесь завершения подготовки
6. После развертывания вы можете найти URL вашей конечной точки и ключи в разделе Keys and Endpoint

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

Claude на Foundry поддерживает два метода аутентификации: ключи API и токены Entra ID. Оба метода используют размещенные в Azure конечные точки в формате https://{resource}.services.ai.azure.com/anthropic/v1/*.

Аутентификация с помощью ключа API

После подготовки вашего ресурса Claude на Foundry вы можете получить ключ API на портале Foundry:

1. Перейдите к вашему ресурсу на портале Foundry
2. Перейдите в раздел Keys and Endpoint
3. Скопируйте один из предоставленных ключей API
4. Используйте либо заголовок api-key, либо x-api-key в ваших запросах, либо предоставьте его SDK

SDK для Python и TypeScript требуют ключ API и либо имя ресурса, либо базовый URL. SDK автоматически прочитают эти значения из следующих переменных окружения, если они определены:

• ANTHROPIC_FOUNDRY_API_KEY - Ваш ключ API
• ANTHROPIC_FOUNDRY_RESOURCE - Имя вашего ресурса (например, example-resource)
• ANTHROPIC_FOUNDRY_BASE_URL - Альтернатива имени ресурса; полный базовый URL (например, https://example-resource.services.ai.azure.com/anthropic/)

Пример использования ключа API:

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

Для повышенной безопасности и централизованного управления доступом вы можете использовать токены Entra ID (ранее Azure Active Directory):

1. Включите аутентификацию Entra для вашего ресурса Foundry
2. Получите токен доступа из Entra ID
3. Используйте токен в заголовке Authorization: Bearer {TOKEN}

Пример использования Entra ID:

Идентификаторы запросов корреляции

Foundry включает идентификаторы запросов в заголовки HTTP-ответов для отладки и трассировки. При обращении в поддержку предоставьте оба значения request-id и apim-request-id, чтобы помочь командам быстро найти и исследовать ваш запрос в системах Anthropic и Azure.

Поддерживаемые функции

Claude на Foundry поддерживает большинство мощных функций Claude. Все функции, которые в настоящее время поддерживаются, вы можете найти в документации обзора.

Контекстное окно

Claude Opus 4.7, Claude Opus 4.6 и Claude Sonnet 4.6 имеют контекстное окно в 1M токенов на Microsoft Foundry. Другие модели Claude, включая Sonnet 4.5, имеют контекстное окно в 200k токенов.

Неподдерживаемые функции

• Admin API (конечные точки /v1/organizations/*)
• Models API (/v1/models)
• Message Batch API (/v1/messages/batches)

Ответы API

Ответы API от Claude на Foundry следуют стандартному формату ответа Claude API. Это включает объект usage в телах ответов, который предоставляет подробную информацию о потреблении токенов для ваших запросов. Объект usage согласован на всех платформах (первичный API, Foundry, Amazon Bedrock и Google Vertex AI).

Для получения подробной информации о заголовках ответов, специфичных для Foundry, см. раздел идентификаторы запросов корреляции.

ID моделей API и развертывания

Следующие модели Claude доступны через Foundry. Модели последнего поколения (Opus 4.7, Opus 4.6, Sonnet 4.6 и Haiku 4.5) предлагают наиболее продвинутые возможности:

По умолчанию имена развертываний совпадают с ID моделей, показанными выше. Однако вы можете создать пользовательские развертывания с разными именами на портале Foundry для управления различными конфигурациями, версиями или ограничениями скорости. Используйте имя развертывания (не обязательно ID модели) в ваших запросах API.

Мониторинг и логирование

Azure предоставляет комплексные возможности мониторинга и логирования для вашего использования Claude через стандартные шаблоны Azure:

• Azure Monitor: Отслеживайте использование API, задержку и частоту ошибок
• Azure Log Analytics: Запрашивайте и анализируйте журналы запросов/ответов
• Cost Management: Мониторьте и прогнозируйте затраты, связанные с использованием Claude

Anthropic рекомендует логировать вашу деятельность по крайней мере на основе 30-дневного скользящего окна, чтобы понять закономерности использования и исследовать любые потенциальные проблемы.

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

Ошибки аутентификации

Ошибка: 401 Unauthorized или Invalid API key

• Решение: Проверьте, что ваш ключ API правильный. Вы можете получить новый ключ API на портале Azure в разделе Keys and Endpoint для вашего ресурса Claude.
• Решение: Если вы используете Azure Entra ID, убедитесь, что ваш токен доступа действителен и не истек. Токены обычно истекают через 1 час.

Ошибка: 403 Forbidden

• Решение: Ваша учетная запись Azure может не иметь необходимых разрешений. Убедитесь, что вам назначена соответствующая роль Azure RBAC (например, "Cognitive Services OpenAI User").

Ограничение скорости

Ошибка: 429 Too Many Requests

• Решение: Вы превысили ваше ограничение скорости. Реализуйте логику экспоненциального отката и повтора в вашем приложении.
• Решение: Рассмотрите возможность запроса увеличения ограничений скорости через портал Azure или поддержку Azure.

Заголовки ограничения скорости

Foundry не включает стандартные заголовки ограничения скорости Anthropic (anthropic-ratelimit-tokens-limit, anthropic-ratelimit-tokens-remaining, anthropic-ratelimit-tokens-reset, anthropic-ratelimit-input-tokens-limit, anthropic-ratelimit-input-tokens-remaining, anthropic-ratelimit-input-tokens-reset, anthropic-ratelimit-output-tokens-limit, anthropic-ratelimit-output-tokens-remaining и anthropic-ratelimit-output-tokens-reset) в ответах. Управляйте ограничением скорости через инструменты мониторинга Azure.

Ошибки модели и развертывания

Ошибка: Model not found или Deployment not found

• Решение: Проверьте, что вы используете правильное имя развертывания. Если вы не создали пользовательское развертывание, используйте ID модели по умолчанию (например, claude-sonnet-4-6).
• Решение: Убедитесь, что модель/развертывание доступны в вашем регионе Azure.

Ошибка: Invalid model parameter

• Решение: Параметр model должен содержать имя вашего развертывания, которое можно настроить на портале Foundry. Проверьте, что развертывание существует и правильно настроено.

Дополнительные ресурсы

• Документация Foundry: ai.azure.com/catalog
• Цены Azure: azure.microsoft.com/en-us/pricing
• Подробности цен Anthropic: Документация по ценообразованию
• Руководство аутентификации: См. раздел аутентификация выше
• Портал Azure: portal.azure.com