Bereitstellen und Verwenden von Claude-Modellen in Microsoft Foundry

Verwenden der Microsoft Entra ID-Authentifizierung

Verwenden Sie für Nachrichten-API-Endpunkte Ihre Basis-URL mit der Microsoft Entra ID-Authentifizierung.

1. Installieren Sie die Azure Identity-Clientbibliothek: Installieren Sie diese Bibliothek, um DefaultAzureCredential zu verwenden. Die Autorisierung ist am einfachsten, wenn Sie DefaultAzureCredential verwenden, da dadurch die besten Anmeldeinformationen für die jeweilige Ausführungsumgebung gefunden werden.

   pip install azure-identity
   

   Legen Sie die Werte der Client-ID, der Mandanten-ID und des geheimen Clientschlüssels der Microsoft Entra ID-Anwendung als Umgebungsvariablen fest: AZURE_CLIENT_ID, , AZURE_TENANT_IDAZURE_CLIENT_SECRET.

   export AZURE_CLIENT_ID="<AZURE_CLIENT_ID>"
   export AZURE_TENANT_ID="<AZURE_TENANT_ID>"
   export AZURE_CLIENT_SECRET="<AZURE_CLIENT_SECRET>"
   

2. Installieren von Abhängigkeiten: Installieren Sie das Anthropic SDK mithilfe von Pip (erfordert Python 3.8 oder höher).

   pip install -U "anthropic"
   

3. Führen Sie ein einfaches Codebeispiel aus, um die folgenden Aufgaben auszuführen:

   1. Erstellen Sie einen Client mit dem Anthropic SDK mit der Microsoft Entra ID-Authentifizierung.
   2. Führen Sie einen einfachen Aufruf der Nachrichten-API durch. Der Aufruf ist synchron.

   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.azure.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)
   

   Erwartete Ausgabe: Eine JSON-Antwort, die den Textabschluss des Modells mit drei Seattle-Empfehlungen enthält.

   Reference:Anthropic Client SDK, DefaultAzureCredential

Verwenden der API-Schlüsselauthentifizierung

Verwenden Sie für Nachrichten-API-Endpunkte Ihre Basis-URL und Ihren API-Schlüssel, um sich bei dem Dienst zu authentifizieren.

1. Installieren von Abhängigkeiten: Installieren Sie das Anthropic SDK mithilfe von Pip (erfordert Python 3.8 oder höher):

   pip install -U "anthropic"
   

2. Führen Sie ein einfaches Codebeispiel aus, um die folgenden Aufgaben auszuführen:

   1. Erstellen Sie einen Client mit dem Anthropic SDK, indem Sie Ihren API-Schlüssel an die Konfiguration des SDK übergeben. Mit dieser Authentifizierungsmethode können Sie nahtlos mit dem Dienst interagieren.
   2. Führen Sie einen einfachen Aufruf der Nachrichten-API durch. Der Aufruf ist synchron.

   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)
   

   Erwartete Ausgabe: Eine JSON-Antwort, die den Textabschluss des Modells mit drei Seattle-Empfehlungen enthält.

   Reference:Anthropic Client SDK

Verwenden der Microsoft Entra ID-Authentifizierung

Verwenden Sie für Nachrichten-API-Endpunkte Ihre Basis-URL mit der Microsoft Entra ID-Authentifizierung.

1. Installieren Sie die Azure Identity-Clientbibliothek: Installieren Sie das @azure/identity Paket, um DefaultAzureCredential verwenden zu können. Die Autorisierung ist am einfachsten, wenn Sie DefaultAzureCredential verwenden, da dadurch die besten Anmeldeinformationen für die jeweilige Ausführungsumgebung gefunden werden.

   npm install @azure/identity
   

   Legen Sie die Werte der Client-ID, der Mandanten-ID und des geheimen Clientschlüssels der Microsoft Entra ID-Anwendung als Umgebungsvariablen fest: AZURE_CLIENT_ID, , AZURE_TENANT_IDAZURE_CLIENT_SECRET.

   export AZURE_CLIENT_ID="<AZURE_CLIENT_ID>"
   export AZURE_TENANT_ID="<AZURE_TENANT_ID>"
   export AZURE_CLIENT_SECRET="<AZURE_CLIENT_SECRET>"
   

2. Installieren von Abhängigkeiten

   1. Installieren Sie Node.js 20 LTS oder höher (nicht EOL)-Versionen.

   2. Kopieren Sie die folgenden Textzeilen, und speichern Sie sie als Datei package.json in Ihrem Ordner.

      {
        "type": "module",
        "dependencies": {
          "@anthropic-ai/foundry-sdk": "latest",
          "@azure/identity": "latest"
        }
      }
      

   3. Öffnen Sie ein Terminalfenster in diesem Ordner und führen Sie npm install aus.

   4. Kopieren Sie bei den folgenden Codeausschnitten den Inhalt in eine Datei sample.js und führen Sie sie mit node sample.js aus.

3. Führen Sie ein einfaches Codebeispiel aus, um die folgenden Aufgaben auszuführen:

   1. Erstellt einen Client mit dem Anthropic SDK mit der Microsoft Entra ID-Authentifizierung.
   2. Führt einen einfachen Aufruf der Nachrichten-API durch. Der Aufruf ist synchron.

   import AnthropicFoundry from '@anthropic-ai/foundry-sdk';
   import { getBearerTokenProvider, DefaultAzureCredential } from "@azure/identity";
   
   const baseURL = "https://<resource-name>.services.ai.azure.com/anthropic"; // Your base URL. Replace <resource-name> with your resource name
   const deploymentName = "claude-sonnet-4-6" // Replace with your deployment name
   
   // Create token provider for Entra ID authentication
   const tokenProvider = getBearerTokenProvider(
       new DefaultAzureCredential(),
       'https://ai.azure.com/.default');
   
   // Create client with Entra ID authentication
   const client = new AnthropicFoundry({
       azureADTokenProvider: tokenProvider,
       baseURL: baseURL,
       apiVersion: "2023-06-01"
   });
   
   // Send request
   const message = await 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
   });
   console.log(message);
   

   Erwartete Ausgabe: Eine JSON-Antwort, die den Textabschluss des Modells mit drei Seattle-Empfehlungen enthält.

   Reference:Anthropic Client SDK, DefaultAzureCredential

Verwenden der API-Schlüsselauthentifizierung

Verwenden Sie für Nachrichten-API-Endpunkte Ihre Basis-URL und Ihren API-Schlüssel, um sich bei dem Dienst zu authentifizieren.

1. Installieren von Abhängigkeiten

   1. Installieren Sie Node.js 20 LTS oder höher (nicht EOL)-Versionen.

   2. Kopieren Sie die folgenden Textzeilen, und speichern Sie sie als Datei package.json in Ihrem Ordner.

      {
        "type": "module",
        "dependencies": {
          "@anthropic-ai/foundry-sdk": "latest"
        }
      }
      

   3. Öffnen Sie ein Terminalfenster in diesem Ordner und führen Sie npm install aus.

   4. Kopieren Sie bei den folgenden Codeausschnitten den Inhalt in eine Datei sample.js und führen Sie sie mit node sample.js aus.

2. Führen Sie ein einfaches Codebeispiel aus. In diesem Beispiel werden die folgenden Aufgaben ausgeführt:

   1. Erstellt einen Client mit dem Anthropic SDK, indem Sie Ihren API-Schlüssel an die SDK-Konfiguration übergeben. Mit dieser Authentifizierungsmethode können Sie nahtlos mit dem Dienst interagieren.
   2. Führt einen einfachen Aufruf der Nachrichten-API durch. Der Aufruf ist synchron.

   import AnthropicFoundry from '@anthropic-ai/foundry-sdk';
   
   const baseURL = "https://<resource-name>.services.ai.azure.com/anthropic"; // Your base URL. Replace <resource-name> with your resource name
   const deploymentName = "claude-sonnet-4-6" // Replace with your deployment name
   const apiKey = "<your-api-key>"; // Your API key
   
   // Create client with API key
   const client = new AnthropicFoundry({
       apiKey: apiKey,
       baseURL: baseURL,
       apiVersion: "2023-06-01"
   });
   
   // Send request
   const message = await 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
   });
   console.log(message);
   

   Erwartete Ausgabe: Eine JSON-Antwort, die den Textabschluss des Modells mit drei Seattle-Empfehlungen enthält.

   Reference:AnthropicFoundry SDK

Eine Liste der unterstützten Laufzeiten finden Sie unter "Anforderungen für die Verwendung der Anthropic TypeScript API Library".

Verwenden der Microsoft Entra ID-Authentifizierung

Verwenden Sie für Nachrichten-API-Endpunkte den Endpunkt-URI https://<resource-name>.services.ai.azure.com/anthropic/v1/messages des bereitgestellten Modells mit der Microsoft Entra ID-Authentifizierung.

Wenn Sie die Ressource mit Microsoft Entra ID-Unterstützung konfigurieren, übergeben Sie Ihr Token im Autorisierungsheader mit dem Format Bearer $AZURE_AUTH_TOKEN. Verwenden Sie den Bereich https://ai.azure.com/.default. Die Verwendung der Microsoft Entra-ID erfordert möglicherweise zusätzliche Konfiguration in Ihrer Ressource, um Zugriff zu gewähren. Weitere Informationen finden Sie unter Konfigurieren der Authentifizierung mit der Microsoft Entra-ID.

1. Exportieren Sie Ihr Microsoft Entra ID-Token in eine Umgebungsvariable:

   Wenn Sie Bash verwenden:

   export AZURE_AUTH_TOKEN="<your-entra-id-key>"
   

   Wenn Sie sich in PowerShell befinden:

   $Env:AZURE_AUTH_TOKEN = "<your-entra-id-key>"
   

   Wenn Sie die Windows-Eingabeaufforderung verwenden:

   set AZURE_AUTH_TOKEN = <your-entra-id-key>
   

2. Führen Sie den folgenden cURL-Befehl aus. Verwenden Sie für cURL den Ziel-URI Ihrer Bereitstellung https://<resource-name>.services.ai.azure.com/anthropic/v1/messages.

   curl -X POST https://<resource-name>.services.ai.azure.com/anthropic/v1/messages \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer $AZURE_AUTH_TOKEN" \
     -H "anthropic-version: 2023-06-01" \
     -d '{
       "messages": [
         {
           "role": "user", "content": "You are a helpful assistant."
         },
         {
           "role": "user", "content": "What are 3 things to visit in Seattle?"
         }
       ],
       "max_tokens": 1048,
       "temperature": 1,
       "model": "claude-sonnet-4-6",
       "thinking": {"type":"adaptive"},
       "output_config": {"effort": "max"},
       "stream": false
       }'
   

   Erwartete Ausgabe: Eine JSON-Antwort, die den Textabschluss des Modells mit drei Seattle-Empfehlungen enthält.

   Referenz:Claude Messages API

Verwenden der API-Schlüsselauthentifizierung

Verwenden Sie für Nachrichten-API-Endpunkte den Endpunkt-URI https://<resource-name>.services.ai.azure.com/anthropic/v1/messages und den API-Schlüssel des bereitgestellten Modells, um sich bei dem Dienst zu authentifizieren.

1. Exportieren Sie Ihren API-Schlüssel in eine Umgebungsvariable:

   Wenn Sie Bash verwenden:

   export AZURE_API_KEY="<your-api-key>"
   

   Wenn Sie sich in PowerShell befinden:

   $Env:AZURE_API_KEY = "<your-api-key>"
   

   Wenn Sie die Windows-Eingabeaufforderung verwenden:

   set AZURE_API_KEY = <your-api-key>
   

2. Führen Sie den folgenden cURL-Befehl aus:

   curl -X POST https://<resource-name>.services.ai.azure.com/anthropic/v1/messages \
     -H "Content-Type: application/json" \
     -H "x-api-key: $AZURE_API_KEY" \
     -H "anthropic-version: 2023-06-01" \
     -d '{
       "messages": [
         {
           "role": "user", "content": "You are a helpful assistant."
         },
         {
           "role": "user", "content": "What are 3 things to visit in Seattle?"
         }
       ],
       "max_tokens": 1048,
       "temperature": 1,
       "model": "claude-sonnet-4-6",
       "thinking": {"type":"adaptive"},
       "output_config": {"effort": "max"},
       "stream": false
       }'
   

   Erwartete Ausgabe: Eine JSON-Antwort, die den Textabschluss des Modells mit drei Seattle-Empfehlungen enthält.

   Referenz:Claude Messages API