Implantar e usar modelos Claude no Microsoft Foundry

os modelos Claude da Anthropic trazem recursos avançados de IA de conversa para Microsoft Foundry, permitindo que você crie aplicativos inteligentes com a compreensão e geração de linguagem de última geração. Os modelos Claude se destacam em tarefas complexas de raciocínio, geração de código e tarefas multimodais, incluindo análise de imagens.

Neste artigo, você aprenderá a:

  • Implantar modelos Claude no Microsoft Foundry
  • Autenticar usando Microsoft Entra ID ou chaves de API
  • Chamar a API de Mensagens Claude a partir do Python, JavaScript ou REST

Para obter a lista completa de modelos claude disponíveis, versões de modelo, funcionalidades, cotas e cobrança, consulte modelos claude em Microsoft Foundry.

Importante

Os itens marcados (versão prévia) neste artigo estão atualmente em versão prévia pública. Essa versão prévia é fornecida sem um contrato de nível de serviço e não recomendamos isso para cargas de trabalho de produção. Alguns recursos podem não ter suporte ou podem ter restrição de recursos. Para obter mais informações, consulte Termos de Uso Complementares para Versões Prévias do Microsoft Azure.

Pré-requisitos

Tipo de assinatura e suporte à região

Para usar modelos Claude no Microsoft Foundry, você deve ter uma assinatura paga do Azure com uma conta de cobrança em um país ou região onde a Anthropic oferece os modelos para compra. Para obter uma lista de erros comuns relacionados à assinatura, consulte mensagens de erro comuns e soluções. Atualmente, não há suporte para os seguintes tipos de assinatura:

  • Contas corporativas localizadas na Coreia do Sul
  • Provedor de Soluções na Nuvem assinaturas
  • As assinaturas do Azure que não têm um método de cobrança ativa pago conforme o uso (por exemplo, estudante, teste gratuito ou contas baseadas em crédito inicial)
  • Assinaturas patrocinadas que usam somente os créditos do Azure. Nota: se você tiver uma conta com um cartão de crédito cadastrado, o cartão de crédito será cobrado em vez dos créditos do Azure.

Para obter uma lista de regiões com suporte, consulte as localizações geográficas com suporte. Observe que a "Política de Regiões Com Suporte" do Anthropic pode se aplicar à disponibilidade em sua região, verifique regiões com suporte para obter detalhes.

Use o kit inicial do Claude on Foundry

Para implantar modelos claude no Microsoft Foundry usando ferramentas de infraestrutura como código, consulte Implantar modelos claude em Microsoft Foundry usando Bicep ou Terraform. O artigo é baseado no kit de início do Claude on Foundry e aborda como provisionar uma conta e um projeto do Foundry, implantar seu modelo Claude escolhido e configurar a autenticação com Microsoft Entra ID ou chaves de API usando Bicep ou automação do Terraform.

Implantar Modelos Claude

Implante um modelo claude seguindo estas etapas no portal do Foundry:

  1. Entre no Microsoft Foundry. Verifique se o botão New Foundry está ativado. Essas etapas referem-se ao Foundry (versão nova).

  2. Na home page do portal do Foundry, selecione Descobrir na navegação superior direita e selecione Modelos no painel esquerdo.

  3. Selecione um modelo claude e examine seus detalhes no cartão de modelo. Se o modelo estiver disponível em ambas as versões, você entrará na versão Hospedada no Azure (versão 2) do modelo por padrão. Você pode confirmar a versão aberta procurando as informações de Hospedado em no painel Informações rápidas do cartão do modelo.

    Tip

    Se o modelo claude selecionado estiver disponível em ambas as versões, o cartão de modelo conterá um link que o levará para a versão alternativa do modelo.

  4. Selecione Implantar>Configurações personalizadas para personalizar sua implantação.

  5. Leia os termos Azure Marketplace, selecione um setor e selecione Concordar e Continuar para aceitar os termos para assinar Azure Marketplace.

  6. Se ambas as versões estiverem disponíveis, a página de implantação terá a versão do Modelo definida como versão 2: hospedada no Azure por padrão. Altere esta seleção para 1: Hospedado na infraestrutura da Anthropic, se desejar.

    Nota

    Se você selecionar a opção Implantar>Configurações Padrão, sua implantação será definida automaticamente como versão 2: hospedada no Azure.

  7. Defina outras configurações de implantação:

    • Por padrão, a implantação usa o nome do modelo. Você pode modificar esse nome antes de implantar. Durante a inferência, use o nome da implantação no parâmetro model para rotear as solicitações para esta implantação específica.
    • Selecione o escopo Região: Global (disponível para todos os modelos e versões de Claude) ou Zona de Dados (se disponível para sua combinação de modelo e versão).

  8. Selecione Implantar para criar sua implantação.

  9. Quando a implantação for concluída, você chegará nos Foundry Playgrounds, onde poderá testar o modelo interativamente. Seu projeto e recurso devem estar em uma das regiões de implantação com suporte para o modelo.

  10. Selecione a guia Detalhes para verificar os detalhes da implantação e verificar se o status da implantação mostra êxito.

Chamar a API de Mensagens Claude

Depois de implantar um modelo claude, interaja com ele para gerar respostas de texto:

Para saber mais sobre as APIs com suporte, consulte os modelos de Claude no Microsoft Foundry.

Enviar mensagens com autenticação

Os exemplos a seguir mostram como enviar solicitações ao Claude Sonnet 4.6 usando Microsoft Entra ID ou autenticação de chave de API. Para trabalhar com seu modelo implantado, você precisa:

  • Sua URL base, que está no formato https://<resource name>.services.ai.azure.com/anthropic.
  • O URI de destino dos detalhes da implantação, que é do formulário https://<resource name>.services.ai.azure.com/anthropic/v1/messages.
  • Microsoft Entra ID para autenticação sem chave ou a chave de API da implantação para autenticação de API.
  • Nome da implantação que você escolheu durante a criação da implantação. Esse nome pode ser diferente da ID do modelo.

Para obter recursos avançados e funcionalidades de modelos claude, consulte modelos claude em Microsoft Foundry.

Usar a autenticação Microsoft Entra ID

Para pontos de extremidade da API de Mensagens, use a URL base com a autenticação do Microsoft Entra ID.

  1. Instale a biblioteca de clientes do Azure Identity: instale essa biblioteca para usar o DefaultAzureCredential. A autorização é mais fácil quando você usa DefaultAzureCredential porque encontra a melhor credencial a ser usada em seu ambiente em execução.

    pip install azure-identity

    Defina os valores da ID do cliente, da ID do locatário e do segredo do cliente do aplicativo Microsoft Entra ID como variáveis de ambiente: 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. Instalar dependências: instale o SDK do Anthropic usando pip (requer Python 3.8 ou posterior).

    pip install -U "anthropic"

  3. Execute um exemplo de código básico para concluir as seguintes tarefas:

    1. Crie um cliente com o SDK Anthropic, usando a autenticação do Microsoft Entra ID.
    2. Faça uma chamada básica para a API de Mensagens. A chamada é síncrona.
    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)

    Saída esperada: Uma resposta JSON que contém a conclusão do texto do modelo com três recomendações de Seattle.

    Referência:SDK de cliente da Anthropic, DefaultAzureCredential

Usar autenticação de chave de API

Importante

Claude Mythos 5 e Mythos Preview dão suporte apenas à autenticação Microsoft Entra ID.

Para pontos de extremidade da API de Mensagens, use a URL base e a chave de API para se autenticar no serviço.

  1. Instalar dependências: instale o SDK do Anthropic usando pip (requer Python 3.8 ou posterior):

    pip install -U "anthropic"

  2. Execute um exemplo de código básico para concluir as seguintes tarefas:

    1. Crie um cliente com o SDK Anthropic passando sua chave de API para a configuração do SDK. Esse método de autenticação permite que você interaja perfeitamente com o serviço.
    2. Faça uma chamada básica para a API de Mensagens. A chamada é síncrona.
    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)

    Saída esperada: Uma resposta JSON que contém a conclusão do texto do modelo com três recomendações de Seattle.

    Referência:SDK do cliente da Anthropic

Solucionando problemas

A tabela a seguir lista erros comuns quando se trabalha com modelos Claude no Foundry e suas soluções.

Erro Causa Solução
401 Não autorizado Chave de API inválida ou expirada ou escopo de token de Entra ID incorreto. Verifique se a chave de API está correta. Confirme que você está usando o escopo https://ai.azure.com/.default para o Entra ID.
403 Proibido Permissões insuficientes no recurso ou na assinatura. Verifique se você tem a função Colaborador ou Proprietário no grupo de recursos. Para Entra ID, verifique se a função Cognitive Services User está atribuída.
404 Não Encontrado URL do endpoint ou nome da implantação incorreto. Confirme se a URL base segue o padrão https://<resource-name>.services.ai.azure.com/anthropic e o nome da implantação corresponde à sua configuração.
429 Solicitações demais Limite de taxa excedido para a camada de assinatura. Implementar a retirada exponencial com lógica de repetição. Considere reduzir a frequência da solicitação ou solicitar um aumento de cota.
Retenção de dados necessária (400 invalid_request_error) O modelo é um modelo coberto designado por Anthropic que requer retenção de dados, mas sua assinatura não tem nenhuma retenção de dados (ZDR) habilitada. A mensagem de Anthropic upstream diz que sua "organização ou workspace deve ter a retenção de dados habilitada", mas na Foundry essa configuração se aplica à sua assinatura. Anthropic gerencia independentemente a retenção de dados para Claude no Azure, portanto, Microsoft não pode alterar essa configuração para você. Para usar o modelo, trabalhe diretamente com Anthropic para desabilitar o ZDR para sua assinatura ou crie uma nova assinatura (já que a retenção de dados é habilitada por padrão em novas assinaturas) e implante o modelo lá. Para obter informações em segundo plano, consulte as práticas de retenção de dados para modelos cobertos.
Erro de qualificação da assinatura Seu tipo de assinatura ou sua região de cobrança do Azure não é compatível, ou o nível da sua assinatura tem uma cota padrão de 0 para o modelo. Confirme se sua assinatura tem um método de cobrança pago conforme o uso ativo e um país/região de cobrança com suporte. Consulte o tipo de assinatura e o suporte à região. Para limites padrão específicos do nível, consulte Cotas, limites de taxa e regiões.
Região não disponível A tentativa de implantação foi feita em uma região não suportada. Implante nas regiões de Azure com suporte para os modelos específicos do Claude que você está usando. Para ver as regiões exatas do Azure em que os modelos estão disponíveis, consulte Disponibilidade de regiões por tipo de implantação.

Conteúdo relacionado

  • Last updated on