Uso de puntos de conexión de Microsoft Foundry

En Foundry, puede definir los modelos y agentes que desea usar en aplicaciones de inteligencia artificial personalizadas. Dado que los recursos de Foundry están basados en la nube, puede consumirlos como interfaces de programación de aplicaciones (APIs) a través de conexiones a Internet mediante interfaces programáticas.

Entender los puntos de conexión

Al igual que la mayoría de los servicios en la nube, se accede a los recursos de Microsoft Foundry a través de un punto de conexión de API, que representa un punto de entrada de servicio. El punto de conexión tiene una dirección HTTP única, como un sitio web, pero es para el código de aplicación cliente en lugar de los usuarios humanos con un explorador web. Al ver el punto de conexión del modelo, tiene un aspecto similar al siguiente:

https://<foundry-project>-resource.cognitiveservices.azure.com/openai/deployments/gpt-4o/chat/completions?api-version=2024-05-01-preview

Las interfaces proporcionadas en el punto de conexión se conocen como Interfaces de transferencia de estado representacional o interfaces REST para abreviar .

Para proteger los recursos de Foundry, el punto de conexión está protegido. Las aplicaciones solo pueden acceder a ella si presentan la clave de API correcta o un token que confirma que las credenciales de id. de Microsoft Entra son válidas. El punto de conexión y la clave del modelo se pueden encontrar en la página de detalles de Foundry Playground.

Entre los dos tipos comunes de puntos de conexión de Foundry se incluyen:

• Puntos de conexión a nivel de proyecto: para trabajar con el proyecto Foundry y sus recursos
• Puntos de conexión del modelo: para enviar mensajes a modelos implementados

Uso de puntos de conexión

Las aplicaciones se comunican con el punto de conexión mediante el envío de solicitudes REST. Las solicitudes REST constan de encabezados que contienen metadatos, como la información de formato de datos y autenticación, y un cuerpo que consta de datos en formato JSON. Por ejemplo, una solicitud podría incluir un mensaje introducido por un usuario en una aplicación de chat, como "¿Qué es una aplicación de IA?".

curl -X POST https://YOUR-FOUNDRY-RESOURCE-NAME.services.ai.azure.com/api/projects/YOUR-PROJECT-NAME/openai/responses?api-version=2025-11-15-preview \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $AUTH_TOKEN" \
-d '{
        "model": "gpt-4.1-mini",
        "input": "What is an AI application?"
}'

Los resultados de la solicitud se devuelven como respuesta, también con encabezados y un cuerpo. Por ejemplo, la respuesta podría incluir la respuesta generada por un modelo a partir del indicador. La respuesta vuelve a tener un formato JSON. Una sección de ese JSON puede ser similar a la siguiente:

{
    "metadata": {},
    "temperature": 1,
    "model": "gpt-4.1-mini",
    "object": "response",
    "status": "completed",
    "output": [
        {
            "type": "message",
            "status": "completed",
            "role": "assistant",
            "content": [
                {
                    "type": "output_text",
                    "text": "An AI application is a software program or system that utilizes artificial intelligence technologies to perform tasks that typically require human intelligence. These tasks can include recognizing speech, understanding natural language, making decisions, learning from data, recognizing images, and solving complex problems. AI applications are used in various fields such as healthcare, finance, customer service, autonomous vehicles, and more to enhance efficiency, accuracy, and user experience."
                }
            ]
        }
    ]
}

Aunque los desarrolladores pueden escribir código que funcione directamente con las interfaces REST, la mayoría de los desarrolladores prefieren trabajar con kits de desarrollo de software (SDK) que abstraen las interfaces REST con bibliotecas de código para su lenguaje de programación preferido, como Python, JavaScript o C#. Estos asistentes específicos del lenguaje crean llamadas REST para ti.

El punto de conexión de los recursos de Foundry es el punto central de servicio para las aplicaciones cliente, lo que le permite crear soluciones personalizadas respaldadas por la seguridad, escalabilidad y confiabilidad de la plataforma en la nube de Azure.

A continuación, vamos a intentar crear un recurso Foundry y usar su punto de conexión.