Развертывание и использование моделей Claude в Microsoft Foundry

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

В этой статье описано, как:

  • Развертывание моделей Claude в Microsoft Foundry
  • Проверка подлинности с помощью ключей Microsoft Entra ID или API
  • Вызов API Claude Messages с использованием Python, JavaScript или REST

Доступные модели, версии моделей и возможности см. в разделе "Модели Claude" в Microsoft Foundry. Сведения о квотах по умолчанию для разных типов подписки см. в разделе Квоты для модели Claude и ограничения скорости.

Важно

Элементы, помеченные предварительным просмотром в этой статье, в настоящее время находятся в предварительной версии. Эта предварительная версия предоставляется без соглашения об уровне обслуживания, и Microsoft не рекомендует использовать её для рабочих нагрузок в производственной среде. Некоторые функции могут не поддерживаться или их возможности могут быть ограничены. Для получения дополнительной информации см. Дополнительные условия использования для предварительных версий Microsoft Azure.

Необходимые условия

Поддержка типа подписки и региона

Чтобы использовать модели Claude в Microsoft Foundry, необходимо иметь платную подписку Azure с учетной записью для выставления счетов в стране или регионе, где Anthropic предлагает модели для покупки. Список распространенных ошибок, связанных с подпиской, см. в разделе "Распространенные сообщения об ошибках и решениях". В настоящее время следующие типы подписок не поддерживаются:

  • Корпоративные учетные записи, расположенные в Южной Корее
  • Подписки поставщика облачных решений
  • Azure подписки, которые не имеют активной системы оплаты по факту использования (например, студенческие подписки, бесплатные пробные учетные записи или учетные записи, основанные на кредитах)
  • Спонсируемые подписки, которые используют только кредиты Azure. Примечание: если у вас есть учетная запись, привязанная к кредитной карте, плата будет списана с кредитной карты вместо Azure Credits.

Список поддерживаемых регионов см. в поддерживаемых географических расположениях. Примечание: Политика Anthropic по поддерживаемым регионам может применяться для обеспечения доступности в вашем регионе; проверьте поддерживаемые регионы для получения подробной информации.

Используйте Claude в стартовом наборе Foundry

Сведения о развертывании моделей Claude в Microsoft Foundry с помощью средств инфраструктуры как кода см. в статье "Развертывание моделей Claude в Microsoft Foundry с помощью Bicep или Terraform". Эта статья основана на наборе начальных средств Claude в Foundry, а также описывается, как подготовить учетную запись и проект Foundry, развернуть выбранную модель Claude и настроить проверку подлинности с помощью ключей Microsoft Entra ID или API с помощью Bicep или автоматизации Terraform.

Развертывание моделей Claude

Разверните модель Claude, выполнив следующие действия на портале Foundry:

  1. Войдите в Microsoft Foundry. Убедитесь, что переключатель New Foundry включен. Эти действия относятся к Foundry (new).

  2. На домашней странице портала Foundry выберите "Обнаружить " в правой верхней части навигации и выберите "Модели " в левой области.

  3. Выберите модель Claude и просмотрите ее сведения в карточке модели. Если модель доступна в обеих версиях, по умолчанию используется размещенная на Azure (версия 2) модели. Вы можете определить, какая версия открыта, найдя сведения Hosted on на панели Быстрые факты в карточке модели.

    Tip

    Если выбранная модель Claude доступна в обеих версиях, карточка модели содержит ссылку, которая позволяет перейти к альтернативной версии модели.

  4. Выберите Развертывание>Настраиваемые настройки, чтобы настроить развертывание.

  5. Ознакомьтесь с условиями Azure Marketplace, выберите отрасль и выберите "Согласиться" и "Продолжить", чтобы принять условия подписки на Azure Marketplace.

  6. Если доступны обе версии, страница развертывания имеет версию модели2: размещена на Azure по умолчанию. Измените этот выбор на 1: размещено в инфраструктуре Anthropic при необходимости.

    Note

    Если выбрать параметр "Развернуть>параметры по умолчанию", развертывание автоматически устанавливается на версию 2: размещено в Azure.

  7. Настройте другие параметры развертывания:

    • По умолчанию развертывание использует имя модели. Это имя можно изменить перед развертыванием. Во время вывода используйте имя развертывания в параметре model для маршрутизации запросов к этому конкретному развертыванию.
    • Выберите область региона: глобальная (доступна для всех моделей и версий Claude) или зоны данных (если она доступна для вашей модели и сочетания версий).

  8. Выберите Развертывание, чтобы создать развертывание.

  9. Когда развертывание завершится, вы приземлились на игровых площадках Foundry , где можно интерактивно протестировать модель. Проект и ресурс должны находиться в одном из поддерживаемых регионов развертывания модели.

  10. Перейдите на вкладку "Сведения" , чтобы проверить сведения о развертывании и убедиться, что состояние развертывания отображается успешно.

Вызов API claude Messages

После развертывания модели Claude взаимодействуйте с ней для создания текстовых ответов:

  • Используйте пакеты SDK Anthropic и API Claude, например:

    • API сообщений: отправка структурированного списка входных сообщений с текстом или содержимым изображения. Модель создает следующее сообщение в беседе.
    • API подсчета токенов: подсчет количества токенов в сообщении.

Дополнительные сведения о поддерживаемых API см. в разделе "Модели Claude" в Microsoft Foundry.

Отправка сообщений с проверкой подлинности

В следующих примерах показано, как отправлять запросы в Claude Sonnet 4.6 с помощью проверки подлинности Microsoft Entra ID или ключа API. Чтобы работать с развернутой моделью, вам потребуется:

  • Базовый URL в форме https://<resource name>.services.ai.azure.com/anthropic.
  • Ваш целевой универсальный идентификатор ресурса (URI) из сведений о развертывании имеет формат https://<resource name>.services.ai.azure.com/anthropic/v1/messages.
  • Microsoft Entra ID для аутентификации без использования ключей или ключ API вашего развертывания для аутентификации API.
  • Имя развертывания, выбранное во время создания развертывания. Это имя может отличаться от идентификатора модели.

Дополнительные функции и возможности моделей Claude см. в статье Claude models in Microsoft Foundry.

Используйте проверку подлинности Microsoft Entra ID

Для конечных точек API сообщений используйте базовый URL-адрес с аутентификацией Microsoft Entra ID.

  1. Установите клиентскую библиотеку удостоверений Azure: установите эту библиотеку для использования . Авторизация становится проще, если использовать DefaultAzureCredential, так как сервис находит лучшие учетные данные для использования в своей рабочей среде.

    pip install azure-identity

    Задайте значения идентификатора клиента, идентификатора клиента и секрета клиента приложения Microsoft Entra ID в качестве переменных среды: AZURE_CLIENT_ID, AZURE_TENANT_ID, AZURE_CLIENT_SECRET.

    export AZURE_CLIENT_ID="<AZURE_CLIENT_ID>"
export AZURE_TENANT_ID="<AZURE_TENANT_ID>"
export AZURE_CLIENT_SECRET="<AZURE_CLIENT_SECRET>"

  2. Установка зависимостей: Установите пакет SDK Anthropic с помощью pip (требуется версия Python 3.8 или выше).

    pip install -U "anthropic"

  3. Выполните базовый пример кода , чтобы выполнить следующие задачи:

    1. Создайте клиента, используя Anthropic SDK и аутентификацию Microsoft Entra ID.
    2. Выполните базовый вызов API сообщений. Вызов синхронный.
    from anthropic import AnthropicFoundry
from azure.identity import DefaultAzureCredential, get_bearer_token_provider

baseURL = "https://<resource-name>.services.ai.azure.com/anthropic" # Your base URL. Replace <resource-name> with your resource name
deploymentName = "claude-sonnet-4-6" # Replace with your deployment name

# Create token provider for Entra ID authentication
tokenProvider = get_bearer_token_provider(
    DefaultAzureCredential(), "https://ai.azure.com/.default"
)

# Create client with Entra ID authentication
client = AnthropicFoundry(
    azure_ad_token_provider=tokenProvider,
    base_url=baseURL
)

# Send request
message = client.messages.create(
    model=deploymentName,
    messages=[
        {"role": "user", "content": "What are 3 things to visit in Seattle?"}
    ],
    max_tokens=1048,
    temperature=1,
    thinking={"type":"adaptive"},
    output_config={"effort": "max"},
    stream=False
)

print(message.content)

    Ожидаемые выходные данные: Ответ JSON, содержащий завершение текста модели с тремя рекомендациями Сиэтла.

    Reference:Anthropic Клиентский пакет SDK, DefaultAzureCredential

Использование проверки подлинности ключа API

Важно

Claude Mythos 5-1, Mythos 5 и Mythos Preview поддерживают только проверку подлинности Microsoft Entra ID.

Для конечных точек API сообщений используйте базовый URL-адрес и ключ API для проверки подлинности в службе.

  1. Install dependencies: установите пакет SDK Anthropic с помощью pip (требуется Python 3.8 или более поздней версии):

    pip install -U "anthropic"

  2. Выполните базовый пример кода , чтобы выполнить следующие задачи:

    1. Создайте экземпляр клиента с помощью Anthropic SDK, передав ключ API в его конфигурацию. Этот метод проверки подлинности позволяет легко взаимодействовать со службой.
    2. Выполните базовый вызов API сообщений. Вызов синхронный.
    from anthropic import AnthropicFoundry

baseURL = "https://<resource-name>.services.ai.azure.com/anthropic" # Your base URL. Replace <resource-name> with your resource name
deploymentName = "claude-sonnet-4-6" # Replace with your deployment name
apiKey = "YOUR_API_KEY" # Replace YOUR_API_KEY with your API key

# Create client with API key authentication
client = AnthropicFoundry(
    api_key=apiKey,
    base_url=baseURL
)

# Send request
message = client.messages.create(
    model=deploymentName,
    messages=[
        {"role": "user", "content": "What are 3 things to visit in Seattle?"}
    ],
    max_tokens=1048,
    temperature=1,
    thinking={"type":"adaptive"},
    output_config={"effort": "max"},
    stream=False
)

print(message.content)

    Ожидаемые выходные данные: Ответ JSON, содержащий завершение текста модели с тремя рекомендациями Сиэтла.

    Reference:Anthropic Клиентский пакет SDK

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

В следующей таблице перечислены распространенные ошибки при работе с моделями Claude в Foundry и их решениях:

Ошибка Причина Решение
401 Несанкционированный доступ Недопустимый или просроченный ключ API или неправильная область действия токена Entra ID. Проверьте правильность ключа API. Для Entra ID убедитесь, что используется область https://ai.azure.com/.default.
403 Запрещено Недостаточно разрешений на ресурс или подписку. Убедитесь, что у вас есть роль участника или владельца в группе ресурсов. Для Entra ID убедитесь, что назначена роль Cognitive Services User.
404 Не найдено Неверный URL-адрес конечной точки или имя развертывания. Убедитесь, что базовый URL-адрес соответствует шаблону https://<resource-name>.services.ai.azure.com/anthropic , а имя развертывания соответствует конфигурации.
429 слишком много запросов Превышено ограничение скорости для уровня подписки. Реализуйте экспоненциальную обратную передачу с помощью логики повторных попыток. Рассмотрите возможность уменьшения частоты запросов или запроса увеличения квоты.
Требуется хранение данных (400 invalid_request_error) Модель является определённой Anthropic Covered Model, для которой требуется хранение данных, но для вашей подписки включено отсутствие хранения данных (ZDR). В вышестоящем сообщении Anthropic говорится, что в вашей "организации или рабочей области" должно быть включено хранение данных, но в Foundry эта настройка относится к вашей подписке. Anthropic независимо управляет хранением данных для Claude на Azure, поэтому Microsoft не может изменить этот параметр. Чтобы использовать модель, обратитесь непосредственно к Anthropic, чтобы отключить ZDR для подписки или создать новую подписку (так как хранение данных включено по умолчанию для новых подписок) и разверните модель там. Общие сведения см. в разделе "Рекомендации по хранению данных" для покрытых моделей.
Ошибка права на подписку Тип подписки Azure или регион выставления счетов не поддерживается, или уровень подписки имеет квоту по умолчанию 0 для модели. Убедитесь, что подписка имеет активный метод выставления счетов по мере использования и поддерживаемую страну или регион выставления счетов. См. Сведения о типе подписки и поддержке по регионам. Ограничения по умолчанию для конкретного уровня см. в разделе квоты модели Claude и ограничения скорости.
Регион недоступен Попытка развертывания в неподдерживаемом регионе. Развертывайте в поддерживаемых регионах Azure для конкретных моделей Claude, которые вы используете. Сведения о том, в каких именно регионах Azure доступны модели, см. в разделе Доступность регионов по типу развертывания.
Запросы к Claude Sonnet 4.5 завершаются с ошибкой при использовании бета-заголовка context-1m-2025-08-07 и запросе более 200 тыс. токенов Бета-версия контекстного окна 1M для Claude Sonnet 4.5 была выведена из эксплуатации 30 апреля 2026 года. Начиная с 1 мая 2026 г. запросы, превышающие 200K маркеров с бета-заголовком context-1m-2025-08-07 , отклоняются. context-1m-2025-08-07 Удалите бета-заголовок из запросов. Для рабочих нагрузок, требующих контекста 1M, перейдите в Claude Sonnet 4.6 (где общедоступен контекст 1M) или Клод Opus 4.6 или Claude Opus 5 для рабочих нагрузок с более высоким уровнем интеллекта. Запросы к Claude Sonnet 4.5 с 200 тыс. токенов или меньше не затрагиваются, даже при наличии заголовка.

Связанное содержимое

  • Последнее обновление: