Claude в Microsoft Foundry

​

Предварительный просмотр

​

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

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

​

Установка SDK

# Python
pip install -U "anthropic"

# Typescript
npm install @anthropic-ai/foundry-sdk

​

Подготовка

​

Подготовка ресурсов 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

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

​

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

​

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

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

import os
from anthropic import AnthropicFoundry

client = AnthropicFoundry(
    api_key=os.environ.get("ANTHROPIC_FOUNDRY_API_KEY"),
    resource_name="{resource}",
)

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

​

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

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

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

# Получите токен Azure Entra ID, используя шаблон поставщика токенов
token_provider = get_bearer_token_provider(
    DefaultAzureCredential(),
    "https://cognitiveservices.azure.com/.default"
)

# Создайте клиент с аутентификацией Entra ID
client = AnthropicFoundry(
    resource_name="{resource}",  # Имя вашего ресурса Azure
    azure_ad_token_provider=token_provider  # Используйте поставщика токенов для аутентификации Entra ID
)

# Выполните запрос
message = client.messages.create(
    model="claude-sonnet-4-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}]
)
print(message.content)

​

Установка SDK

# Python
pip install -U "anthropic"

# Typescript
npm install @anthropic-ai/foundry-sdk

​

Параметр модели и развертывания

# Если вы создали пользовательское развертывание с именем "my-claude-deployment"
message = client.messages.create(
    model="my-claude-deployment",  # Имя вашего пользовательского развертывания
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}]
)

​

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

​

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

​

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

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

​

Ответы API

​

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

​

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

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

​

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

​

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

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

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

​

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

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

​

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

​

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

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

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

​

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

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