Claude no Microsoft Foundry

​

Visualização

​

Pré-requisitos

• Uma assinatura ativa do Azure
• Acesso ao Foundry
• A CLI do Azure instalada (opcional, para gerenciamento de recursos)

​

Instalar um SDK

# Python
pip install -U "anthropic"

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

​

Provisionamento

​

Provisionando recursos Foundry

1. Navegue até o portal Foundry
2. Crie um novo recurso Foundry ou selecione um existente
3. Configure o gerenciamento de acesso usando chaves de API emitidas pelo Azure ou Entra ID para controle de acesso baseado em função
4. Opcionalmente, configure o recurso para fazer parte de uma rede privada (Rede Virtual do Azure) para segurança aprimorada
5. Anote o nome do seu recurso — você o usará como {resource} nos endpoints da API (por exemplo, https://{resource}.services.ai.azure.com/anthropic/v1/*)

​

Criando implantações Foundry

1. No portal Foundry, navegue até seu recurso
2. Vá para Modelos + endpoints e selecione + Implantar modelo > Implantar modelo base
3. Procure e selecione um modelo Claude (por exemplo, claude-sonnet-4-5)
4. Configure as configurações de implantação:
   • Nome da implantação: Padrão para o ID do modelo, mas você pode personalizá-lo (por exemplo, my-claude-deployment). O nome da implantação não pode ser alterado após sua criação.
   • Tipo de implantação: Selecione Global Standard (recomendado para Claude)
5. Selecione Implantar e aguarde a conclusão do provisionamento
6. Uma vez implantado, você pode encontrar sua URL de endpoint e chaves em Chaves e Endpoint

​

Autenticação

​

Autenticação por chave de API

1. Navegue até seu recurso no portal Foundry
2. Vá para a seção Chaves e Endpoint
3. Copie uma das chaves de API fornecidas
4. Use o cabeçalho api-key ou x-api-key em suas solicitações

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)

​

Autenticação Microsoft Entra

1. Ative a autenticação Entra para seu recurso Foundry
2. Obtenha um token de acesso do Entra ID
3. Use o token no cabeçalho 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)

​

Instalar um SDK

# Python
pip install -U "anthropic"

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

​

Parâmetro de modelo e implantações

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

​

IDs de solicitação de correlação

​

Recursos suportados

​

Recursos não suportados

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

​

Respostas de API

​

IDs de modelo de API e implantações

​

Monitoramento e registro

• Azure Monitor: Rastreie uso de API, latência e taxas de erro
• Azure Log Analytics: Consulte e analise logs de solicitação/resposta
• Gerenciamento de Custos: Monitore e preveja custos associados ao uso de Claude

​

Solução de problemas

​

Erros de autenticação

• Solução: Verifique se sua chave de API está correta. Você pode obter uma nova chave de API no portal do Azure em Chaves e Endpoint para seu recurso Claude.
• Solução: Se estiver usando Azure Entra ID, certifique-se de que seu token de acesso é válido e não expirou. Os tokens normalmente expiram após 1 hora.

• Solução: Sua conta do Azure pode não ter as permissões necessárias. Certifique-se de que você tem a função Azure RBAC apropriada atribuída (por exemplo, “Cognitive Services OpenAI User”).

​

Limitação de taxa

• Solução: Você excedeu seu limite de taxa. Implemente lógica de backoff exponencial e retry em sua aplicação.
• Solução: Considere solicitar aumentos de limite de taxa através do portal do Azure ou suporte do Azure.

​

Cabeçalhos de limite de taxa

​

Erros de modelo e implantação

• Solução: Verifique se você está usando o nome de implantação correto. Se você não criou uma implantação personalizada, use o ID do modelo padrão (por exemplo, claude-sonnet-4-5).
• Solução: Certifique-se de que o modelo/implantação está disponível em sua região do Azure.

• Solução: O parâmetro de modelo deve conter o nome da sua implantação, que pode ser personalizado no portal Foundry. Verifique se a implantação existe e está configurada corretamente.

​

Recursos adicionais

• Documentação do Foundry: ai.azure.com/catalog
• Preços do Azure: azure.microsoft.com/en-us/pricing
• Detalhes de preços do Anthropic: Documentação de preços
• Guia de autenticação: Veja a seção de autenticação acima
• Portal do Azure: portal.azure.com