Claude modellerini Microsoft Foundry'de dağıtma ve kullanma (klasik)

Şu anda izleniyor:Foundry (klasik) portal versiyonu - Yeni Foundry portalı için sürüme geç

Not

Bu makaledeki bağlantılar, şu anda görüntülediğiniz Dökümhane (klasik) belgeleri yerine yeni Microsoft Foundry belgelerinde içerik açabilir.

Anthropic Claude modelleri, Microsoft Foundry'ye gelişmiş konuşma yapay zekası özellikleri sunarak en son teknoloji dil anlama ve oluşturma ile akıllı uygulamalar oluşturmanıza olanak tanır. Claude modelleri, görüntü analizi de dahil olmak üzere karmaşık mantık, kod oluşturma ve çok modüllü görevlerde üstünlük sağlar.

Bu makalede şunların nasıl yapılacağını öğreneceksiniz:

  • Claude modellerini Microsoft Foundry'de dağıtma
  • Microsoft Entra ID veya API anahtarlarını kullanarak kimlik doğrulaması
  • Python, JavaScript veya REST'ten Claude İletileri API'sini çağırma

Kullanılabilir Claude modellerinin, model sürümlerinin, özelliklerin, kotaların ve faturalamanın tam listesi için bkz. Microsoft Foundry'de Claude modelleri.

Önemli

Bu makalede işaretlenen (önizleme) öğeler şu anda genel önizleme aşamasındadır. Bu önizleme, hizmet düzeyi sözleşmesi olmadan sağlanır ve üretim iş yükleri için önerilmez. Bazı özellikler desteklenmeyebilir veya kısıtlı özelliklere sahip olabilir. Daha fazla bilgi için bkz. Microsoft Azure Önizlemeleri için Ek Kullanım Koşulları.

Önkoşullar

Abonelik türü ve bölge desteği

Claude modellerini Microsoft Foundry'de kullanmak için, Anthropic satın alma için modelleri sunduğu bir ülkede veya bölgede ödeme hesabı olan ücretli bir Azure aboneliğiniz olmalıdır. Abonelikle ilgili yaygın hataların listesi için bkz. Yaygın hata iletileri ve çözümleri. Aşağıdaki abonelik türleri şu anda desteklenmiyor:

  • Güney Kore'de bulunan Kurumsal Hesaplar
  • Cloud Çözüm Sağlayıcı abonelikleri
  • Azure'da etkin bir kullandıkça öde faturalama yöntemine sahip olmayan abonelikler (örneğin, öğrenci, ücretsiz deneme veya başlangıç kredisi tabanlı hesaplar)
  • Yalnızca Azure kredi kullanan sponsorlu abonelikler. Not: Kredi kartınız kayıtlı olan bir hesabınız varsa, ücret kredi kartınızdan çekilir ve Azure Kredileri yerine kullanılır.

Desteklenen bölgelerin listesi için bkz. Desteklenen coğrafi konumlar. bölgenizdeki kullanılabilirlik için Anthropic "Desteklenen Bölgeler İlkesi" geçerli olabilir, ayrıntılar için supported regions adresine bakın.

Claude on Foundry başlangıç setini kullanma

Claude ile Foundry'de çalışmaya hemen başlamak için Claude on Foundry başlangıç setini kullanın. Başlangıç seti, Bicep veya Terraform kullanarak tek bir azd up komutuyla Foundry hesabı, proje ve seçtiğiniz Claude model dağıtımlarını oluşturur. Ardından Anthropic SDK’sını ve Claude Code CLI’yi, dağıtımınızı Microsoft Entra ID üzerinden API anahtarı yönetmeniz gerekmeden çağıracak şekilde entegre eder.

Claude modellerini dağıtma

Dökümhane portalında aşağıdaki adımları izleyerek Claude modelini dağıtın:

  1. Microsoft Foundry'ye giriş yapın. New Foundry anahtarının kapalı olduğundan emin olun. Bu adımlar Foundry (klasik) için geçerlidir.

  2. Dökümhane portalında Model kataloğu bölümüne gidin.

  3. Bir Claude modeli seçin ve model kartında ayrıntılarını gözden geçirin. Varsayılan olarak, model her iki sürümde de kullanılabiliyorsa modelin Azure’da barındırılan (sürüm 2) sürümüne yönlendirilirsiniz. Açık olan sürümü onaylamak için model kartının Hızlı bilgiler bölmesindeki Barındırılan bilgiler'i arayabilirsiniz.

    Tavsiye

    Seçtiğiniz Claude modeli her iki sürümde de kullanılabiliyorsa, model kartı sizi modelin alternatif sürümüne götüren bir bağlantı içerir.

  4. Bu modeli kullan'ı seçin.

  5. Azure Market koşullarını okuyun, bir sektör seçin ve kabul et ve Devam Et'i seçerek Azure Market abone olunan koşulları kabul edin.

  6. Dağıtım sayfasında Model sürümü2: Varsayılan olarak Azure üzerinde barındırılan sürüme ayarlanmıştır. İstenirse, bu seçimi 1: Anthropic altyapısında barındırılır olarak değiştirin.

  7. Diğer dağıtım ayarlarını yapılandırın:

    • Varsayılan olarak, dağıtım model adını kullanır. Dağıtmadan önce bu adı değiştirebilirsiniz. Çıkarım sırasında, istekleri bu dağıtıma yönlendirmek için parametresindeki model dağıtım adını kullanın.
    • Bölge kapsamını seçin: Genel (tüm Claude modelleri ve sürümleri için kullanılabilir) veya Veri Bölgesi (model ve sürüm birleşiminiz için kullanılabiliyorsa).
    • Foundry portalı, projeniz ile ilişkili olan Foundry kaynağını entegre edilmiş yapay zeka kaynağı olarak otomatik olarak seçer. Gerekirse bağlantıyı değiştirmek için Özelleştir'i seçin. Proje ve kaynak, model için desteklenen dağıtım bölgelerinden birinde olmalıdır.

  8. Dağıtımınızı oluşturmak için Dağıt'ı seçin. Dağıtım oluşturulurken modelin dağıtım ayrıntıları sayfası açılır.

  9. Dağıtım tamamlandığında model kullanıma hazırdır. Modeli etkileşimli olarak test etmek için Foundry Playgrounds'ı da kullanabilirsiniz.

Claude İletileri API'sini çağırma

Claude modelini dağıttığınızda metin yanıtları oluşturmak için modelle etkileşime geçin:

Desteklenen API'ler hakkında daha fazla bilgi edinmek için bkz. Microsoft Foundry'de Claude modelleri.

Kimlik doğrulaması ile ileti gönderme

Aşağıdaki örneklerde, Microsoft Entra ID veya API anahtarı kimlik doğrulaması kullanarak Claude Sonnet 4.6'ya istek gönderme gösterilmektedir. Dağıtılan modelinizle çalışmak için şunları yapmanız gerekir:

  • biçimindeki https://<resource name>.services.ai.azure.com/anthropictemel URL'niz.
  • Biçimindeki https://<resource name>.services.ai.azure.com/anthropic/v1/messagesdağıtım ayrıntılarınızdan hedef URI'niz.
  • Anahtarsız kimlik doğrulaması için Microsoft Entra ID veya API kimlik doğrulaması için dağıtımınızın API anahtarı.
  • Dağıtım oluşturma sırasında seçtiğiniz dağıtım adı. Bu ad model kimliğinden farklı olabilir.

Claude modellerinin gelişmiş özellikleri ve özellikleri için bkz. Microsoft Foundry'de Claude modelleri.

Microsoft Entra ID kimlik doğrulamayı kullanma

İletiler API'si uç noktaları için Microsoft Entra ID kimlik doğrulaması ile temel URL'nizi kullanın.

  1. Azure Identity istemci kitaplığını yükleyin: DefaultAzureCredential kullanmak için bu kitaplığı yükleyin. DefaultAzureCredential kullanıldığında, çalışma ortamında en iyi kimlik bilgilerini bulduğu için yetkilendirme en kolay hale gelir.

    pip install azure-identity

    Microsoft Entra ID uygulamasının istemci kimliği, kiracı kimliği ve istemci gizli dizisi değerlerini ortam değişkenleri olarak ayarlayın: 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. Bağımlılıkları yükleme: pip kullanarak Anthropic SDK'sını yükleyin (Python 3.8 veya üzeri gerekir).

    pip install -U "anthropic"

  3. Aşağıdaki görevleri tamamlamak için temel bir kod örneği çalıştırın:

    1. Microsoft Entra ID kimlik doğrulamasını kullanarak Anthropic SDK'sı ile bir istemci oluşturun.
    2. İletiler API'sine temel bir çağrı yapın. Çağrı eşzamanlı.
    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.cognitiveservices.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)

    Beklenen çıkış: Modelin metin tamamlamasını içeren ve üç Seattle önerisi içeren bir JSON yanıtı.

    Reference:Anthropic İstemci SDK, DefaultAzureCredential

API anahtarı kimlik doğrulamayı kullanma

Önemli

Claude Mythos 5 ve Mythos Preview yalnızca Microsoft Entra ID kimlik doğrulamayı destekler.

İletiler API'si uç noktaları için temel URL'nizi ve API anahtarınızı kullanarak hizmette kimlik doğrulaması yapın.

  1. Bağımlılıkları yükleme: pip kullanarak Anthropic SDK'sını yükleyin (Python 3.8 veya üzeri gerekir):

    pip install -U "anthropic"

  2. Aşağıdaki görevleri tamamlamak için temel bir kod örneği çalıştırın:

    1. API anahtarınızı SDK yapılandırmasına geçirerek Anthropic SDK ile bir istemci oluşturun. Bu kimlik doğrulama yöntemi, hizmetle sorunsuz bir şekilde etkileşim kurmanızı sağlar.
    2. İletiler API'sine temel bir çağrı yapın. Çağrı eşzamanlı.
    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)

    Beklenen çıkış: Modelin metin tamamlamasını içeren ve üç Seattle önerisi içeren bir JSON yanıtı.

    Referans:Anthropic İstemci SDK

Sorun giderme

Aşağıdaki tabloda, Foundry'de Claude modelleriyle çalışırken karşılaşılan yaygın hatalar ve bunların çözümleri listelenir:

Hata Neden Çözüm
401 Yetkisiz Geçersiz veya süresi dolmuş API anahtarı ya da yanlış Entra ID belirteç kapsamı. API anahtarınızın doğru olduğunu doğrulayın. Entra ID için kapsam https://ai.cognitiveservices.com/.default kullandığınızı onaylayın.
403 Yasak Kaynak veya abonelik üzerinde yetersiz izinler. Kaynak grubunda Katkıda Bulunan veya Sahip rolüne sahip olduğunuzu doğrulayın. Entra ID için Cognitive Services User rolünün atandığından emin olun.
404 Bulunamadı Yanlış uç nokta URL'si veya dağıtım adı. Temel URL'nizin desene https://<resource-name>.services.ai.azure.com/anthropic uygun olduğunu ve dağıtım adının yapılandırmanızla eşleştiğinden emin olun.
429 Çok Fazla İstek Var Abonelik katmanınız için hız sınırı aşıldı. Yeniden deneme mantığıyla üstel geri alma uygulayın. Talep sıklığını azaltmayı veya kota artırımı istemeyi göz önünde bulundurun.
Abonelik uygunluğu hatası Azure abonelik türünüz veya faturalama bölgeniz desteklenmez veya abonelik katmanınızın model için varsayılan kotası 0'dır. Aboneliğinizin etkin bir kullandıkça öde faturalama yöntemine ve desteklenen bir faturalama ülkesine/bölgesine sahip olduğunu onaylayın. Bkz. Abonelik türü ve bölge desteği. Katmana özgü varsayılan sınırlar için bkz. Kotalar, hız sınırları ve bölgeler.
Bölge mevcut değil Desteklenmeyen bir bölgede dağıtım denendi. Genel Standart dağıtımları için Doğu ABD2'ye veya Orta İsveç'e dağıtın. (claude-opus-4-8Azure üzerinde barındırılan) Veri Bölgesi Standardı (ABD) için desteklenen bir ABD veri bölgesi konumuna dağıtın.

İlgili içerik

  • Last updated on