Claude-modellen implementeren en gebruiken in Microsoft Foundry

Anthropic's Claude-modellen brengen geavanceerde AI-mogelijkheden voor gesprekken naar Microsoft Foundry, zodat u intelligente toepassingen kunt creëren met geavanceerd taalbegrip en -generatie. Claude modellen excelleren bij complexe redenering, het genereren van code en multimodale taken, waaronder afbeeldingsanalyse.

In dit artikel leert u het volgende:

  • Claude-modellen implementeren in Microsoft Foundry
  • Verifiëren met behulp van Microsoft Entra ID of API-sleutels
  • De Claude Messages-API aanroepen vanuit Python, JavaScript of REST

Zie Claude-modellen in Microsoft Foundry voor beschikbare modellen, modelversies en mogelijkheden. Zie Claude-modelquota en frequentielimieten voor standaardquota per abonnementstype.

Belangrijk

Items die zijn gemarkeerd als voorbeeld in dit artikel, zijn momenteel beschikbaar als preview-versie. Deze preview wordt aangeboden zonder een service level agreement en Microsoft raadt dit niet aan voor productieworkloads. Bepaalde functies worden mogelijk niet ondersteund of hebben mogelijk beperkte mogelijkheden. Zie Aanvullende gebruiksvoorwaarden voor Microsoft Azure Previews voor meer informatie.

Voorwaarden

Ondersteuning voor abonnementstypen en regio's

Als u Claude-modellen in Microsoft Foundry wilt gebruiken, moet u een betaald Azure abonnement hebben met een factureringsrekening in een land of regio waar Anthropic de modellen voor aankoop aanbiedt. Zie Veelvoorkomende foutberichten en oplossingen voor een lijst met veelvoorkomende fouten met betrekking tot abonnementen. De volgende abonnementstypen worden momenteel niet ondersteund:

  • Bedrijfsaccounts in Zuid-Korea
  • Cloud Solution Provider abonnementen
  • Azure abonnementen die geen actieve factureringsmethode voor betalen per gebruik hebben (bijvoorbeeld accounts voor studenten, gratis proefversie of op opstarttegoed gebaseerde accounts)
  • Gesponsorde abonnementen die alleen Azure-tegoeden gebruiken. Note: Als u een account met een creditcard in het bestand hebt, wordt de creditcard in rekening gebracht in plaats van Azure Tegoed.

Zie ondersteunde geografische locaties voor een lijst met ondersteunde regio's. Houd er rekening mee dat Anthropic beleid voor ondersteunde regio's mogelijk van toepassing is op de beschikbaarheid in uw regio, controleert u ondersteunde regio's voor meer informatie.

De Claude on Foundry starterkit gebruiken

Als u Claude-modellen in Microsoft Foundry wilt implementeren met behulp van hulpprogramma's voor infrastructuur als code, raadpleegt u Claude-modellen implementeren in Microsoft Foundry met behulp van Bicep of Terraform. Het artikel is gebaseerd op de Claude on Foundry starter kit, en hierin wordt beschreven hoe u een Foundry-account en -project inricht, uw gekozen Claude-model implementeert en verificatie configureert met Microsoft Entra ID- of API-sleutels met behulp van Bicep of Terraform-automatisering.

Claude-modellen implementeren

Implementeer een Claude-model door deze stappen te volgen in de Foundry-portal:

  1. Meld u aan bij Microsoft Foundry. Zorg ervoor dat de wisselknop New Foundry is ingeschakeld. Deze stappen verwijzen naar Foundry (nieuw).

  2. Selecteer Op de startpagina van de Foundry-portal ontdekken in de navigatie rechtsboven en selecteer vervolgens Modellen in het linkerdeelvenster.

  3. Selecteer een Claude-model en bekijk de details in de modelkaart. Als het model beschikbaar is in beide versies, komt u standaard op de gehoste versie van Azure (versie 2) van het model terecht. U kunt controleren welke versie is geopend door in het deelvenster Snelle feiten van de modelkaart te zoeken naar de informatie onder Gehost op.

    Tip

    Als uw geselecteerde Claude-model beschikbaar is in beide versies, bevat de modelkaart een koppeling waarmee u naar de alternatieve versie van het model gaat.

  4. SelecteerAangepaste instellingen> om uw implementatie aan te passen.

  5. Lees de Azure Marketplace voorwaarden, selecteer een branche en selecteer Akkoord en Ga door om de voorwaarden te accepteren die u wilt abonneren op Azure Marketplace.

  6. Als beide versies beschikbaar zijn, is op de implementatiepagina de modelversie ingesteld op versie 2: standaard gehost op Azure. Wijzig deze selectie naar 1: Gehost op de infrastructuur van Anthropic, indien gewenst.

    Note

    Als u de optieStandaardinstellingen> selecteert, wordt uw implementatie automatisch ingesteld op versie 2: Gehost op Azure.

  7. Andere implementatie-instellingen configureren:

    • De implementatie maakt standaard gebruik van de modelnaam. U kunt deze naam wijzigen voordat u implementeert. Gebruik tijdens deductie de implementatienaam in de model parameter om aanvragen naar deze specifieke implementatie te routeren.
    • Selecteer het bereik Regio: Globaal (beschikbaar voor alle Claude-modellen en -versies) of Data Zone (indien beschikbaar voor uw combinatie van modellen en versies).

  8. Selecteer Implementeren om uw implementatie te maken.

  9. Wanneer de implementatie is voltooid, gaat u naar de Foundry Playgrounds , waar u het model interactief kunt testen. Uw project en resource moeten zich in een van de ondersteunde implementatieregio's voor het model bevinden.

  10. Selecteer het tabblad Details om uw implementatiedetails te controleren en controleer of de implementatiestatus Geslaagd wordt weergegeven.

De Api voor Claude Messages aanroepen

Nadat u een Claude-model hebt geïmplementeerd, kunt u ermee werken om tekstreacties te genereren:

  • Gebruik de Anthropic SDK's en de Claude-API's, zoals:

    • Berichten-API: Een gestructureerde lijst met invoerberichten met tekst- of afbeeldingsinhoud verzenden. Het model genereert het volgende bericht in het gesprek.
    • Token count-API: het aantal tokens in een bericht tellen.

Zie Claude-modellen in Microsoft Foundry voor meer informatie over de ondersteunde API's.

Berichten verzenden met verificatie

In de volgende voorbeelden ziet u hoe u aanvragen verzendt naar Claude Sonnet 4.6 met behulp van Microsoft Entra ID- of API-sleutelverificatie. Als u wilt werken met uw geïmplementeerde model, hebt u het volgende nodig:

  • Uw basis-URL, die van het formulier https://<resource name>.services.ai.azure.com/anthropicis.
  • Uw doel-URI van uw implementatiegegevens, die van het formulier https://<resource name>.services.ai.azure.com/anthropic/v1/messagesis.
  • Microsoft Entra ID voor sleutelloze verificatie of de API-sleutel van uw implementatie voor API-verificatie.
  • De implementatienaam die u hebt gekozen tijdens het maken van de implementatie. Deze naam kan afwijken van de model-id.

Zie Claude-modellen in Microsoft Foundry voor geavanceerde functies en mogelijkheden van Claude-modellen.

Microsoft Entra ID-verificatie gebruiken

Gebruik voor Berichten-API-eindpunten uw basis-URL met Microsoft Entra ID-verificatie.

  1. Installeer de Azure Identity-clientbibliotheek: Installeer deze bibliotheek om de DefaultAzureCredential te gebruiken. Autorisatie is het eenvoudigst wanneer u DefaultAzureCredential gebruikt, omdat hiermee het beste referentiepunt wordt gevonden voor gebruik in de uitvoeringsomgeving.

    pip install azure-identity

    Stel de waarden van de client-id, tenant-id en clientgeheim van de Microsoft Entra ID-toepassing in als omgevingsvariabelen: 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. Afhankelijkheden installeren: Installeer de Anthropic SDK met behulp van pip (hiervoor is Python 3.8 of hoger vereist).

    pip install -U "anthropic"

  3. Voer een basiscodevoorbeeld uit om de volgende taken uit te voeren:

    1. Maak een client met de Anthropic SDK met behulp van Microsoft Entra ID-verificatie.
    2. Maak een eenvoudige aanroep naar de Berichten-API. De aanroep is synchroon.
    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)

    Verwachte uitvoer: Een JSON-antwoord met de tekstvoltooiing van het model met drie aanbevelingen voor Seattle.

    Naslaginformatie:Anthropic Client SDK, DefaultAzureCredential

API-sleutelverificatie gebruiken

Belangrijk

Claude Mythos 5-1, Mythos 5 en Mythos Preview ondersteunen alleen Microsoft Entra ID verificatie.

Gebruik uw basis-URL en API-sleutel voor berichten-API-eindpunten om te verifiëren bij de service.

  1. Afhankelijkheden installeren: Installeer de Anthropic SDK met behulp van pip (hiervoor is Python 3.8 of hoger vereist):

    pip install -U "anthropic"

  2. Voer een basiscodevoorbeeld uit om de volgende taken uit te voeren:

    1. Maak een client met de Anthropic SDK door uw API-sleutel door te geven aan de configuratie van de SDK. Met deze verificatiemethode kunt u naadloos communiceren met de service.
    2. Maak een eenvoudige aanroep naar de Berichten-API. De aanroep is synchroon.
    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)

    Verwachte uitvoer: Een JSON-antwoord met de tekstvoltooiing van het model met drie aanbevelingen voor Seattle.

    Naslaginformatie:Anthropic Client SDK

Probleemoplossing

De volgende tabel bevat veelvoorkomende fouten wanneer u met Claude-modellen in Foundry en hun oplossingen werkt:

Fout Oorzaak Oplossing
401 Niet geautoriseerd Ongeldige of verlopen API-sleutel of onjuist Entra ID tokenbereik. Controleer of uw API-sleutel juist is. Controleer voor Entra ID of u het bereik https://ai.azure.com/.default gebruikt.
403 Verboden Onvoldoende machtigingen voor de resource of het abonnement. Controleer of u de rol Inzender of Eigenaar hebt voor de resourcegroep. Zorg ervoor dat voor Entra ID de rol Cognitive Services User is toegewezen.
404 niet gevonden Onjuiste eindpunt-URL of implementatienaam. Controleer of uw basis-URL het patroon https://<resource-name>.services.ai.azure.com/anthropic volgt en dat de implementatienaam overeenkomt met uw configuratie.
429 Te veel aanvragen De frequentielimiet is overschreden voor uw abonnementslaag. Implementeer exponentieel uitstel met logica voor opnieuw proberen. Overweeg de aanvraagfrequentie te verminderen of een quotumverhoging aan te vragen.
Gegevensretentie vereist (400 invalid_request_error) Het model is een Anthropic-aangewezen gedekt model waarvoor gegevensretentie is vereist, maar uw abonnement heeft geen gegevensretentie (ZDR) ingeschakeld. In het upstream-Anthropic bericht staat dat uw organisatie of werkruimte gegevensretentie moet hebben ingeschakeld, maar in Foundry is deze instelling van toepassing op uw abonnement. Anthropic beheert onafhankelijk gegevensretentie voor Claude op Azure, zodat Microsoft deze instelling niet voor u kan wijzigen. Als u het model wilt gebruiken, werkt u rechtstreeks met Anthropic om ZDR voor uw abonnement uit te schakelen of maakt u een nieuw abonnement (omdat gegevensretentie standaard is ingeschakeld voor nieuwe abonnementen) en implementeert u het model daar. Zie de procedures voor het bewaren van gegevens voor gedekte modellen voor achtergrondinformatie.
Foutbericht: abonneerbaarheid fout Uw Azure abonnementstype of factureringsregio wordt niet ondersteund of uw abonnementslaag heeft een standaardquotum van 0 voor het model. Controleer of uw abonnement een actieve factureringsmethode voor betalen per gebruik heeft en een ondersteund land/regio voor facturering. Zie Type abonnement en ondersteuning per regio. Zie quota en ratelimieten voor Claude-modellen voor tierspecifieke standaardlimieten.
Regio niet beschikbaar Implementatie geprobeerd in een niet-ondersteunde regio. Implementeer in de ondersteunde Azure regio's voor de specifieke Claude-modellen die u gebruikt. Zie Regio-beschikbaarheid per implementatietype voor de exacte Azure regio's waar de modellen beschikbaar zijn.
Aanvragen aan Claude Sonnet 4.5 mislukken wanneer de context-1m-2025-08-07 bèta-header wordt opgenomen en meer dan 200K-tokens worden aangevraagd De 1M context beta op Claude Sonnet 4.5 werd op 30 april 2026 buiten gebruik gesteld. Vanaf 1 mei 2026 worden aanvragen die groter zijn dan 200.000 tokens met de context-1m-2025-08-07 bètaheader geweigerd. Verwijder de context-1m-2025-08-07 bèta-header uit uw aanvragen. Voor workloads waarvoor 1M-context is vereist, migreert u naar Claude Sonnet 4.6 (waarbij 1M-context algemeen beschikbaar is) of naar Claude Opus 4.6 of Claude Opus 5 voor workloads met een hogere intelligentie. Aanvragen met 200.000 tokens of minder aan Claude Sonnet 4.5 blijven ongewijzigd, zelfs als de koptekst aanwezig is.

Verwante inhoud

  • Laatst bijgewerkt om