Claude in Microsoft Foundry

Diese Anleitung führt Sie durch den Prozess der Einrichtung und der Durchführung von API-Aufrufen an Claude in Foundry in Python, TypeScript oder mit direkten HTTP-Anfragen. Wenn Sie auf Claude in Foundry zugreifen können, werden Sie für die Claude-Nutzung im Microsoft Marketplace mit Ihrem Azure-Abonnement abgerechnet, was Ihnen ermöglicht, auf Claudes neueste Funktionen zuzugreifen und gleichzeitig die Kosten über Ihr Azure-Abonnement zu verwalten.

Regionale Verfügbarkeit: Bei der Einführung ist Claude als Global Standard-Bereitstellungstyp in Foundry-Ressourcen verfügbar (US DataZone kommt bald). Die Preisgestaltung für Claude im Microsoft Marketplace verwendet Anthropics Standard-API-Preisgestaltung. Besuchen Sie die Preisseite für Details.

Vorschau

In dieser Vorschau-Plattformintegration werden Claude-Modelle auf Anthropics Infrastruktur ausgeführt. Dies ist eine kommerzielle Integration für die Abrechnung und den Zugriff über Azure. Als unabhängiger Verarbeiter für Microsoft unterliegen Kunden, die Claude über Microsoft Foundry nutzen, Anthropics Datenutzungsbedingungen. Anthropic setzt sich weiterhin für seine branchenführenden Sicherheits- und Datenverpflichtungen ein, einschließlich der Verfügbarkeit von Null-Datenspeicherung.

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie über Folgendes verfügen:

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

Installieren Sie ein SDK

Anthropics Client SDKs unterstützen Foundry durch plattformspezifische Pakete.

Bereitstellung

Foundry verwendet eine zweistufige Hierarchie: Ressourcen enthalten Ihre Sicherheits- und Abrechnungskonfiguration, während Bereitstellungen die Modellinstanzen sind, die Sie über API aufrufen. Sie erstellen zunächst eine Foundry-Ressource und dann eine oder mehrere Claude-Bereitstellungen darin.

Bereitstellung von Foundry-Ressourcen

Erstellen Sie eine Foundry-Ressource, die erforderlich ist, um Dienste in Azure zu nutzen und zu verwalten. Sie können diese Anweisungen befolgen, um eine Foundry-Ressource zu erstellen. Alternativ können Sie mit der Erstellung eines Foundry-Projekts beginnen, was die Erstellung einer Foundry-Ressource beinhaltet.

So stellen Sie Ihre Ressource bereit:

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

Nach der Erstellung Ihrer Ressource stellen Sie ein Claude-Modell bereit, um es für API-Aufrufe verfügbar zu machen:

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-6)
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 auf den Abschluss der Bereitstellung
6. Nach der Bereitstellung können Sie Ihre Endpunkt-URL und Schlüssel unter Schlüssel und Endpunkt finden

Authentifizierung

Claude on Foundry unterstützt zwei Authentifizierungsmethoden: API-Schlüssel und Entra ID-Token. Beide Methoden verwenden Azure-gehostete Endpunkte im Format https://{resource}.services.ai.azure.com/anthropic/v1/*.

API-Schlüssel-Authentifizierung

Nach der Bereitstellung Ihrer Foundry Claude-Ressource können Sie einen API-Schlüssel aus dem Foundry-Portal abrufen:

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 Header api-key oder x-api-key in Ihren Anfragen, oder geben Sie ihn dem SDK

Die Python- und TypeScript-SDKs erfordern einen API-Schlüssel und entweder einen Ressourcennamen oder eine Basis-URL. Die SDKs lesen diese automatisch aus den folgenden Umgebungsvariablen, falls definiert:

• ANTHROPIC_FOUNDRY_API_KEY - Ihr API-Schlüssel
• ANTHROPIC_FOUNDRY_RESOURCE - Ihr Ressourcenname (z. B. example-resource)
• ANTHROPIC_FOUNDRY_BASE_URL - Alternative zum Ressourcennamen; die vollständige Basis-URL (z. B. https://example-resource.services.ai.azure.com/anthropic/)

Beispiel mit API-Schlüssel:

Microsoft Entra-Authentifizierung

Für erhöhte Sicherheit und zentralisierte Zugriffsverwaltung können Sie Entra ID-Token (ehemals Azure Active Directory) verwenden:

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 Header Authorization: Bearer {TOKEN}

Beispiel mit Entra ID:

Korrelations-Request-IDs

Foundry enthält Request-Identifikatoren in HTTP-Antwortheadern zum Debuggen und Tracing. Wenn Sie den Support kontaktieren, geben Sie sowohl die Werte request-id als auch apim-request-id an, um Teams dabei zu helfen, Ihre Anfrage schnell über beide Anthropic- und Azure-Systeme zu lokalisieren und zu untersuchen.

Unterstützte Funktionen

Claude on Foundry unterstützt die meisten leistungsstarken Funktionen von Claude. Alle derzeit unterstützten Funktionen finden Sie in der Übersichtsdokumentation.

Kontextfenster

Claude Opus 4.7, Claude Opus 4.6 und Claude Sonnet 4.6 haben ein 1M-Token-Kontextfenster auf Microsoft Foundry. Andere Claude-Modelle, einschließlich Sonnet 4.5, haben ein 200k-Token-Kontextfenster.

Nicht unterstützte Funktionen

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

API-Antworten

API-Antworten von Claude on Foundry folgen dem Standard-Claude API-Antwortformat. Dies umfasst das usage-Objekt in Antworttexten, das detaillierte Informationen zum Token-Verbrauch für Ihre Anfragen liefert. Das usage-Objekt ist über alle Plattformen hinweg konsistent (First-Party-API, Foundry, Amazon Bedrock und Google Vertex AI).

Für Details zu Antwortheadern, die spezifisch für Foundry sind, siehe den Abschnitt Korrelations-Request-IDs.

API-Modell-IDs und Bereitstellungen

Die folgenden Claude-Modelle sind über Foundry verfügbar. Die neuesten Generationsmodelle (Opus 4.7, Opus 4.6, Sonnet 4.6 und Haiku 4.5) bieten die fortschrittlichsten Funktionen:

Standardmäßig entsprechen Bereitstellungsnamen den oben gezeigten Modell-IDs. Sie können jedoch benutzerdefinierte Bereitstellungen mit unterschiedlichen Namen im Foundry-Portal erstellen, um verschiedene Konfigurationen, Versionen oder Ratenlimits zu verwalten. Verwenden Sie den Bereitstellungsnamen (nicht unbedingt die Modell-ID) in Ihren API-Anfragen.

Überwachung und Protokollierung

Azure bietet umfassende Überwachungs- und Protokollierungsfunktionen für Ihre Claude-Nutzung durch Standard-Azure-Muster:

• 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

Anthropic empfiehlt, Ihre Aktivität mindestens auf einer 30-Tage-Rollbasis zu protokollieren, um Nutzungsmuster zu verstehen und mögliche Probleme zu untersuchen.

Fehlerbehebung

Authentifizierungsfehler

Fehler: 401 Unauthorized oder Invalid API key

• Lösung: Überprüfen Sie, dass 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.

Fehler: 403 Forbidden

• 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

Fehler: 429 Too Many Requests

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

Ratenlimit-Header

Foundry enthält nicht Anthropics Standard-Ratenlimit-Header (anthropic-ratelimit-tokens-limit, anthropic-ratelimit-tokens-remaining, anthropic-ratelimit-tokens-reset, anthropic-ratelimit-input-tokens-limit, anthropic-ratelimit-input-tokens-remaining, anthropic-ratelimit-input-tokens-reset, anthropic-ratelimit-output-tokens-limit, anthropic-ratelimit-output-tokens-remaining und anthropic-ratelimit-output-tokens-reset) in Antworten. Verwalten Sie die Ratenlimitierung stattdessen über Azures Überwachungstools.

Modell- und Bereitstellungsfehler

Fehler: Model not found oder Deployment not found

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

Fehler: Invalid model parameter

• Lösung: Der model-Parameter sollte Ihren Bereitstellungsnamen enthalten, der im Foundry-Portal angepasst werden kann. Überprüfen Sie, dass 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 Abschnitt Authentifizierung oben
• Azure-Portal: portal.azure.com