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

SDK-клиенты 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:

import os
from anthropic import AnthropicFoundry

client = AnthropicFoundry(
    api_key=os.environ.get("ANTHROPIC_FOUNDRY_API_KEY"),
    resource="example-resource",  # your resource name
)

message = client.messages.create(
    model="claude-opus-4-6",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}],
)
print(message.content)

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

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

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

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

import os
from anthropic import AnthropicFoundry
from azure.identity import DefaultAzureCredential, get_bearer_token_provider

# Get Azure Entra ID token using token provider pattern
token_provider = get_bearer_token_provider(
    DefaultAzureCredential(), "https://cognitiveservices.azure.com/.default"
)

# Create client with Entra ID authentication
client = AnthropicFoundry(
    resource="example-resource",  # your resource name
    azure_ad_token_provider=token_provider,  # Use token provider for Entra ID auth
)

# Make request
message = client.messages.create(
    model="claude-opus-4-6",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}],
)
print(message.content)

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

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

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

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

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

• 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.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