Implementación y uso de modelos de Claude en Microsoft Foundry (versión preliminar)

los modelos de Claude de Anthropic aportan funcionalidades avanzadas de inteligencia artificial conversacional a Microsoft Foundry, lo que le permite crear aplicaciones inteligentes con conocimientos y generación de lenguajes de última generación. Los modelos de Claude se destacan en tareas complejas de razonamiento, generación de código y tareas multimodales, incluido el análisis de imágenes.

En este artículo, aprenderá a:

  • Implementación de modelos de Claude en Microsoft Foundry
  • Autenticación mediante claves de API o Microsoft Entra ID
  • Llamada a la API de mensajes de Claude desde Python, JavaScript o REST

Para obtener la lista completa de modelos, capacidades, cuotas y facturación de Claude disponibles, consulte Modelos de Claude en Microsoft Foundry.

Requisitos previos

Soporte para tipos de suscripción y regiones

Para usar modelos de Claude en Microsoft Foundry, debe tener una suscripción de pago Azure con una cuenta de facturación en un país o región donde Anthropic ofrezca los modelos para su compra. Para obtener una lista de errores comunes relacionados con la suscripción, consulte Mensajes y soluciones de error comunes. Actualmente no se admiten los siguientes tipos de suscripción:

  • Cuentas empresariales ubicadas en Corea del Sur
  • suscripciones de Proveedor de soluciones en la nube
  • Las suscripciones de Azure que no tienen un método de facturación de pago por uso activo (por ejemplo, cuentas de estudiante, de evaluación gratuita o basadas en crédito para startups).
  • Suscripciones patrocinadas que solo usan créditos de Azure. Nota: Si tiene una cuenta con una tarjeta de crédito registrada, el cargo se realizará en dicha tarjeta en lugar de en los créditos de Azure.

Para obtener una lista de las regiones admitidas, consulte ubicaciones geográficas admitidas. Tenga en cuenta que, la "Política de regiones admitidas" de Anthropic puede ser aplicada a la disponibilidad de su región, compruebe regiones admitidas para obtener más información.

Usa el kit de inicio de Claude en Foundry

Para empezar a trabajar con Claude en Foundry rápidamente, use el kit de inicio Claude on Foundry. El kit de inicio utiliza un único comando azd up para aprovisionar una cuenta de Foundry, un proyecto y las implementaciones del modelo Claude que elijas, utilizando Bicep o Terraform. A continuación, integra el SDK de Anthropic y la CLI de Claude Code para invocar tu implementación a través de Microsoft Entra ID, sin claves de API que gestionar.

Implementación de modelos de Claude

Los modelos de Claude en Foundry están disponibles para la implementación estándar global. Para implementar un modelo de Claude, siga las instrucciones de Deploy Microsoft Foundry Models en el portal de Foundry.

Después de la implementación, use el área de juegos de Foundry para probar interactivamente el modelo.

Realizar una llamada a la API de Mensajes de Claude

Después de implementar un modelo de Claude, interactúe con él para generar respuestas de texto:

  • Use los SDK de Anthropic y las siguientes API de Claude:

    • API de mensajes: envíe una lista estructurada de mensajes de entrada con contenido de texto o imagen. El modelo genera el siguiente mensaje en la conversación.
    • API de recuento de tokens: cuente el número de tokens de un mensaje.
    • API de archivos: cargue y administre archivos para su uso con la API de Claude sin volver a cargar contenido con cada solicitud.
    • Skills API: cree aptitudes personalizadas para Claude AI.

Envío de mensajes con autenticación

En los ejemplos siguientes se muestra cómo enviar solicitudes a Claude Sonnet 4.6 mediante la autenticación de clave de API o Microsoft Entra ID. Para trabajar con el modelo implementado, necesita lo siguiente:

  • La dirección URL base, que tiene el formato https://<resource name>.services.ai.azure.com/anthropic.
  • Su URI de destino de los detalles de su implementación, que tiene el formato https://<resource name>.services.ai.azure.com/anthropic/v1/messages.
  • Microsoft Entra ID para la autenticación sin necesidad de clave o la clave de API de la implementación para la autenticación mediante API.
  • Nombre de implementación que eligió durante la creación de la implementación. Este nombre puede ser diferente del identificador del modelo.

Para conocer las características y funcionalidades avanzadas de los modelos de Claude, consulte Modelos de Claude en Microsoft Foundry.

Uso de la autenticación de Microsoft Entra ID

En el caso de los puntos de conexión de la API de Mensajes, use la dirección URL base con la autenticación de Microsoft Entra ID.

  1. Instalar la biblioteca cliente de Azure Identity: instale esta biblioteca para usar el DefaultAzureCredential. La autorización es más fácil cuando se usa DefaultAzureCredential porque encuentra la mejor credencial para usar en su entorno en ejecución.

    pip install azure-identity

    Establezca los valores del identificador de cliente, el identificador de inquilino y el secreto de cliente de la aplicación de Microsoft Entra ID como variables de entorno: 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 dependencias: instale el SDK de Anthropic mediante pip (requiere Python 3.8 o posterior).

    pip install -U "anthropic"

  3. Ejecute un ejemplo de código básico para completar las siguientes tareas:

    1. Cree un cliente con el SDK de Anthropic mediante la autenticación Microsoft Entra ID.
    2. Haga una llamada básica a la API de Mensajes. La llamada es sincrónica.
    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)

    Salida esperada: Respuesta JSON que contiene la finalización del texto del modelo con tres recomendaciones de Seattle.

    Reference:SDK de cliente Anthropic, DefaultAzureCredential

Uso de la autenticación de clave de API

Importante

Claude Mythos 5 y Mythos Preview solo admiten Microsoft Entra ID autenticación.

En el caso de los puntos de conexión de la API de mensajes, use la dirección URL base y la clave de API para autenticarse en el servicio.

  1. Instalar dependencias: instale el SDK de Anthropic mediante pip (requiere Python 3.8 o posterior):

    pip install -U "anthropic"

  2. Ejecute un ejemplo de código básico para completar las siguientes tareas:

    1. Cree un cliente con el SDK de Anthropic pasando la clave de API a la configuración del SDK. Este método de autenticación le permite interactuar sin problemas con el servicio.
    2. Haga una llamada básica a la API de Mensajes. La llamada es sincrónica.
    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)

    Salida esperada: Respuesta JSON que contiene la finalización del texto del modelo con tres recomendaciones de Seattle.

    Referencia:SDK de Cliente de Anthropic

Solución de problemas

En la tabla siguiente se enumeran los errores comunes al trabajar con modelos de Claude en Foundry y sus soluciones:

Error Causa Solución
401 No autorizado Clave de API no válida o expirada, o ámbito de token incorrecto de Entra ID. Compruebe que la clave de API es correcta. Para Entra ID, confirme que usa el ámbito https://ai.azure.com/.default.
403 Prohibido Permisos insuficientes en el recurso o la suscripción. Compruebe que tiene el rol Colaborador o Propietario en el grupo de recursos. Para Entra ID, asegúrese de que se asigna el rol Usuario de Servicios Cognitivos.
404 No encontrado Dirección URL o nombre de implementación incorrectos del punto de conexión. Confirme que la dirección URL base sigue el patrón https://<resource-name>.services.ai.azure.com/anthropic y el nombre de implementación coincide con la configuración.
429 Demasiadas solicitudes Se ha superado el límite de solicitudes para su nivel de suscripción. Implementación de retroceso exponencial con lógica de reintentos. Considere la posibilidad de reducir la frecuencia de solicitud o solicitar un aumento de la cuota.
Error de idoneidad de la suscripción No se admite el tipo de suscripción Azure o la región de facturación, o el nivel de suscripción tiene una cuota predeterminada de 0 para el modelo. Confirme que la suscripción tiene un método de facturación de pago por uso activo y un país o región de facturación admitidos. Consulte Compatibilidad con el tipo de suscripción y la región. Para conocer los límites predeterminados específicos del nivel, consulte Cuotas, límites de velocidad y regiones.
Región no disponible Implementación intentada en una región no admitida. Implemente en Este de EE. UU. 2 o Centro de Suecia, las regiones admitidas para los modelos de Claude.

Contenido relacionado

  • Last updated on