Claude in Microsoft Foundry

​

Vorschau

​

Voraussetzungen

• Ein aktives Azure-Abonnement
• Zugriff auf Foundry
• Die Azure CLI installiert (optional, für die Ressourcenverwaltung)

​

Installieren Sie ein SDK

# Python
pip install -U "anthropic"

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

​

Bereitstellung

​

Bereitstellung von Foundry-Ressourcen

1. Navigieren Sie zum Foundry-Portal
2. Erstellen Sie eine neue Foundry-Ressource oder wählen Sie eine vorhandene aus
3. Konfigurieren Sie die Zugriffsverwaltung mit von Azure ausgegebenen API-Schlüsseln oder Entra ID für rollenbasierte Zugriffskontrolle
4. Konfigurieren Sie optional die Ressource so, dass sie Teil eines privaten Netzwerks (Azure Virtual Network) ist, um die Sicherheit zu erhöhen
5. Notieren Sie sich Ihren Ressourcennamen – Sie werden ihn als {resource} in API-Endpunkten verwenden (z. B. https://{resource}.services.ai.azure.com/anthropic/v1/*)

​

Erstellen von Foundry-Bereitstellungen

1. Navigieren Sie im Foundry-Portal zu Ihrer Ressource
2. Gehen Sie zu Modelle + Endpunkte und wählen Sie + Modell bereitstellen > Basismodell bereitstellen
3. Suchen Sie nach einem Claude-Modell und wählen Sie es aus (z. B. claude-sonnet-4-5)
4. Konfigurieren Sie die Bereitstellungseinstellungen:
   • Bereitstellungsname: Standardmäßig die Modell-ID, aber Sie können ihn anpassen (z. B. my-claude-deployment). Der Bereitstellungsname kann nach der Erstellung nicht mehr geändert werden.
   • Bereitstellungstyp: Wählen Sie Global Standard (empfohlen für Claude)
5. Wählen Sie Bereitstellen und warten Sie, bis die Bereitstellung abgeschlossen ist
6. Nach der Bereitstellung finden Sie Ihre Endpunkt-URL und Schlüssel unter Schlüssel und Endpunkt

​

Authentifizierung

​

API-Schlüssel-Authentifizierung

1. Navigieren Sie zu Ihrer Ressource im Foundry-Portal
2. Gehen Sie zum Abschnitt Schlüssel und Endpunkt
3. Kopieren Sie einen der bereitgestellten API-Schlüssel
4. Verwenden Sie entweder den api-key- oder x-api-key-Header in Ihren Anfragen

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-Authentifizierung

1. Aktivieren Sie die Entra-Authentifizierung für Ihre Foundry-Ressource
2. Rufen Sie ein Zugriffstoken von Entra ID ab
3. Verwenden Sie das Token im Authorization: Bearer {TOKEN}-Header

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)

​

Installieren Sie ein SDK

# Python
pip install -U "anthropic"

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

​

Modellparameter und Bereitstellungen

# 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!"}]
)

​

Korrelations-Request-IDs

​

Unterstützte Funktionen

​

Nicht unterstützte Funktionen

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

​

API-Antworten

​

API-Modell-IDs und Bereitstellungen

​

Überwachung und Protokollierung

• Azure Monitor: Verfolgen Sie API-Nutzung, Latenz und Fehlerquoten
• Azure Log Analytics: Abfragen und Analyse von Request/Response-Protokollen
• Cost Management: Überwachen und prognostizieren Sie Kosten im Zusammenhang mit Claude-Nutzung

​

Fehlerbehebung

​

Authentifizierungsfehler

• Lösung: Überprüfen Sie, ob Ihr API-Schlüssel korrekt ist. Sie können einen neuen API-Schlüssel aus dem Azure-Portal unter Schlüssel und Endpunkt für Ihre Claude-Ressource abrufen.
• Lösung: Wenn Sie Azure Entra ID verwenden, stellen Sie sicher, dass Ihr Zugriffstoken gültig ist und nicht abgelaufen ist. Token laufen normalerweise nach 1 Stunde ab.

• Lösung: Ihr Azure-Konto verfügt möglicherweise nicht über die erforderlichen Berechtigungen. Stellen Sie sicher, dass Ihnen die entsprechende Azure RBAC-Rolle zugewiesen ist (z. B. „Cognitive Services OpenAI User”).

​

Ratenlimitierung

• Lösung: Sie haben Ihr Ratenlimit überschritten. Implementieren Sie exponentielle Backoff- und Wiederholungslogik in Ihrer Anwendung.
• Lösung: Erwägen Sie, Ratenlimiterhöhungen über das Azure-Portal oder den Azure-Support anzufordern.

​

Ratenlimit-Header

​

Modell- und Bereitstellungsfehler

• Lösung: Überprüfen Sie, ob Sie den korrekten Bereitstellungsnamen verwenden. Wenn Sie keine benutzerdefinierte Bereitstellung erstellt haben, verwenden Sie die Standard-Modell-ID (z. B. claude-sonnet-4-5).
• Lösung: Stellen Sie sicher, dass das Modell/die Bereitstellung in Ihrer Azure-Region verfügbar ist.

• Lösung: Der Modellparameter sollte Ihren Bereitstellungsnamen enthalten, der im Foundry-Portal angepasst werden kann. Überprüfen Sie, ob die Bereitstellung vorhanden ist und ordnungsgemäß konfiguriert ist.

​

Zusätzliche Ressourcen

• Foundry-Dokumentation: ai.azure.com/catalog
• Azure-Preisgestaltung: azure.microsoft.com/en-us/pricing
• Anthropic-Preisdetails: Preisdokumentation
• Authentifizierungsleitfaden: Siehe den Authentifizierungsabschnitt oben
• Azure-Portal: portal.azure.com