Claude en Microsoft Foundry

​

Vista previa

​

Requisitos previos

• Una suscripción activa de Azure
• Acceso a Foundry
• La CLI de Azure instalada (opcional, para la gestión de recursos)

​

Instalar un SDK

# Python
pip install -U "anthropic"

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

​

Aprovisionamiento

​

Aprovisionamiento de recursos de Foundry

1. Navega al portal de Foundry
2. Crea un nuevo recurso de Foundry o selecciona uno existente
3. Configura la gestión de acceso usando claves API emitidas por Azure o Entra ID para control de acceso basado en roles
4. Opcionalmente, configura el recurso para que sea parte de una red privada (Red Virtual de Azure) para mayor seguridad
5. Anota el nombre de tu recurso: lo usarás como {resource} en los puntos finales de API (por ejemplo, https://{resource}.services.ai.azure.com/anthropic/v1/*)

​

Creación de implementaciones de Foundry

1. En el portal de Foundry, navega a tu recurso
2. Ve a Modelos + puntos finales y selecciona + Implementar modelo > Implementar modelo base
3. Busca y selecciona un modelo de Claude (por ejemplo, claude-sonnet-4-5)
4. Configura los ajustes de implementación:
   • Nombre de implementación: Por defecto es el ID del modelo, pero puedes personalizarlo (por ejemplo, my-claude-deployment). El nombre de implementación no se puede cambiar después de haber sido creado.
   • Tipo de implementación: Selecciona Global Standard (recomendado para Claude)
5. Selecciona Implementar y espera a que se complete el aprovisionamiento
6. Una vez implementado, puedes encontrar tu URL de punto final y claves en Claves y Punto final

​

Autenticación

​

Autenticación con clave API

1. Navega a tu recurso en el portal de Foundry
2. Ve a la sección Claves y Punto final
3. Copia una de las claves API proporcionadas
4. Usa el encabezado api-key o x-api-key en tus solicitudes

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)

​

Autenticación de Microsoft Entra

1. Habilita la autenticación de Entra para tu recurso de Foundry
2. Obtén un token de acceso de Entra ID
3. Usa el token en el encabezado Authorization: Bearer {TOKEN}

import os
from anthropic import AnthropicFoundry
from azure.identity import DefaultAzureCredential, get_bearer_token_provider

# Obtén el token de Entra ID de Azure usando el patrón de proveedor de tokens
token_provider = get_bearer_token_provider(
    DefaultAzureCredential(),
    "https://cognitiveservices.azure.com/.default"
)

# Crea cliente con autenticación de Entra ID
client = AnthropicFoundry(
    resource_name="{resource}",  # Tu nombre de recurso de Azure
    azure_ad_token_provider=token_provider  # Usa proveedor de tokens para autenticación de Entra ID
)

# Realiza solicitud
message = client.messages.create(
    model="claude-sonnet-4-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}]
)
print(message.content)

​

Instalar un SDK

# Python
pip install -U "anthropic"

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

​

Parámetro de modelo e implementaciones

# Si has creado una implementación personalizada llamada "my-claude-deployment"
message = client.messages.create(
    model="my-claude-deployment",  # Tu nombre de implementación personalizado
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}]
)

​

IDs de solicitud de correlación

​

Características admitidas

​

Características no admitidas

• API de administración (puntos finales /v1/organizations/*)
• API de modelos (/v1/models)
• API de lotes de mensajes (/v1/messages/batches)

​

Respuestas de API

​

IDs de modelo de API e implementaciones

​

Monitoreo y registro

• Azure Monitor: Rastrea el uso de API, latencia y tasas de error
• Azure Log Analytics: Consulta y analiza registros de solicitud/respuesta
• Gestión de costos: Monitorea y pronostica costos asociados con el uso de Claude

​

Solución de problemas

​

Errores de autenticación

• Solución: Verifica que tu clave API sea correcta. Puedes obtener una nueva clave API desde el portal de Azure en Claves y Punto final para tu recurso de Claude.
• Solución: Si usas Entra ID de Azure, asegúrate de que tu token de acceso sea válido y no haya expirado. Los tokens típicamente expiran después de 1 hora.

• Solución: Tu cuenta de Azure puede carecer de los permisos necesarios. Asegúrate de tener el rol de Azure RBAC apropiado asignado (por ejemplo, “Cognitive Services OpenAI User”).

​

Limitación de velocidad

• Solución: Has excedido tu límite de velocidad. Implementa lógica de retroceso exponencial y reintento en tu aplicación.
• Solución: Considera solicitar aumentos de límite de velocidad a través del portal de Azure o soporte de Azure.

​

Encabezados de límite de velocidad

​

Errores de modelo e implementación

• Solución: Verifica que estés usando el nombre de implementación correcto. Si no has creado una implementación personalizada, usa el ID del modelo predeterminado (por ejemplo, claude-sonnet-4-5).
• Solución: Asegúrate de que el modelo/implementación esté disponible en tu región de Azure.

• Solución: El parámetro de modelo debe contener tu nombre de implementación, que se puede personalizar en el portal de Foundry. Verifica que la implementación exista y esté configurada correctamente.

​

Recursos adicionales

• Documentación de Foundry: ai.azure.com/catalog
• Precios de Azure: azure.microsoft.com/en-us/pricing
• Detalles de precios de Anthropic: Documentación de precios
• Guía de autenticación: Consulta la sección de autenticación arriba
• Portal de Azure: portal.azure.com