Claude di Microsoft Foundry

​

Pratinjau

​

Prasyarat

• Langganan Azure yang aktif
• Akses ke Foundry
• Azure CLI terinstal (opsional, untuk manajemen sumber daya)

​

Instal SDK

# Python
pip install -U "anthropic"

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

​

Penyediaan

​

Penyediaan sumber daya Foundry

1. Navigasikan ke portal Foundry
2. Buat sumber daya Foundry baru atau pilih yang sudah ada
3. Konfigurasikan manajemen akses menggunakan kunci API yang dikeluarkan Azure atau Entra ID untuk kontrol akses berbasis peran
4. Secara opsional konfigurasikan sumber daya untuk menjadi bagian dari jaringan pribadi (Azure Virtual Network) untuk keamanan yang ditingkatkan
5. Catat nama sumber daya Anda—Anda akan menggunakannya sebagai {resource} di titik akhir API (misalnya, https://{resource}.services.ai.azure.com/anthropic/v1/*)

​

Membuat penyebaran Foundry

1. Di portal Foundry, navigasikan ke sumber daya Anda
2. Buka Models + endpoints dan pilih + Deploy model > Deploy base model
3. Cari dan pilih model Claude (misalnya, claude-sonnet-4-5)
4. Konfigurasikan pengaturan penyebaran:
   • Deployment name: Default ke ID model, tetapi Anda dapat menyesuaikannya (misalnya, my-claude-deployment). Nama penyebaran tidak dapat diubah setelah dibuat.
   • Deployment type: Pilih Global Standard (direkomendasikan untuk Claude)
5. Pilih Deploy dan tunggu penyediaan selesai
6. Setelah disebarkan, Anda dapat menemukan URL titik akhir dan kunci Anda di bawah Keys and Endpoint

​

Autentikasi

​

Autentikasi kunci API

1. Navigasikan ke sumber daya Anda di portal Foundry
2. Buka bagian Keys and Endpoint
3. Salin salah satu kunci API yang disediakan
4. Gunakan header api-key atau x-api-key dalam permintaan Anda

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)

​

Autentikasi Microsoft Entra

1. Aktifkan autentikasi Entra untuk sumber daya Foundry Anda
2. Dapatkan token akses dari Entra ID
3. Gunakan token di header Authorization: Bearer {TOKEN}

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_name="{resource}",  # Your Azure resource name
    azure_ad_token_provider=token_provider  # Use token provider for Entra ID auth
)

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

​

Instal SDK

# Python
pip install -U "anthropic"

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

​

Parameter model dan penyebaran

# If you've created a custom deployment named "my-claude-deployment"
message = client.messages.create(
    model="my-claude-deployment",  # Your custom deployment name
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}]
)

​

ID permintaan korelasi

​

Fitur yang didukung

​

Fitur yang tidak didukung

• Admin API (titik akhir /v1/organizations/*)
• Models API (/v1/models)
• Message Batch API (/v1/messages/batches)

​

Respons API

​

ID model API dan penyebaran

​

Pemantauan dan pencatatan

• Azure Monitor: Lacak penggunaan API, latensi, dan tingkat kesalahan
• Azure Log Analytics: Kueri dan analisis log permintaan/respons
• Cost Management: Pantau dan perkirakan biaya yang terkait dengan penggunaan Claude

​

Pemecahan masalah

​

Kesalahan autentikasi

• Solusi: Verifikasi kunci API Anda benar. Anda dapat memperoleh kunci API baru dari portal Azure di bawah Keys and Endpoint untuk sumber daya Claude Anda.
• Solusi: Jika menggunakan Azure Entra ID, pastikan token akses Anda valid dan belum kadaluarsa. Token biasanya kadaluarsa setelah 1 jam.

• Solusi: Akun Azure Anda mungkin kekurangan izin yang diperlukan. Pastikan Anda memiliki peran Azure RBAC yang sesuai ditugaskan (misalnya, “Cognitive Services OpenAI User”).

​

Pembatasan laju

• Solusi: Anda telah melampaui batas laju Anda. Implementasikan logika backoff eksponensial dan coba lagi dalam aplikasi Anda.
• Solusi: Pertimbangkan untuk meminta peningkatan batas laju melalui portal Azure atau dukungan Azure.

​

Header batas laju

​

Kesalahan model dan penyebaran

• Solusi: Verifikasi Anda menggunakan nama penyebaran yang benar. Jika Anda belum membuat penyebaran khusus, gunakan ID model default (misalnya, claude-sonnet-4-5).
• Solusi: Pastikan model/penyebaran tersedia di wilayah Azure Anda.

• Solusi: Parameter model harus berisi nama penyebaran Anda, yang dapat disesuaikan di portal Foundry. Verifikasi penyebaran ada dan dikonfigurasi dengan benar.

​

Sumber daya tambahan

• Dokumentasi Foundry: ai.azure.com/catalog
• Harga Azure: azure.microsoft.com/en-us/pricing
• Detail harga Anthropic: Dokumentasi Harga
• Panduan autentikasi: Lihat bagian autentikasi di atas
• Portal Azure: portal.azure.com