Desarrollo de una aplicación cliente para un agente de IA

  • 5 minutos

Tip

Consulte la pestaña Texto e imágenes para obtener más detalles.

Un agente de Microsoft Foundry encapsula el modelo, las instrucciones y las herramientas que necesita para realizar tareas. Para que el agente esté disponible para los usuarios, puede crear una aplicación cliente que envíe mensajes al agente y procese sus respuestas.

Conexión a un agente

Un agente en ejecución en Foundry proporciona un punto de conexión que admite el protocolo de respuestas de OpenAI. Las aplicaciones pueden conectarse a este punto de conexión mediante el SDK de OpenAI y los usuarios o identidades de aplicación con los permisos adecuados pueden autenticarse mediante Microsoft Entra ID.

Por ejemplo, puede desarrollar una aplicación web para el agente de historial informático; que permite a los usuarios enviar mensajes al agente.

Captura de pantalla de una aplicación cliente del agente en Visual Studio Code.

La aplicación cliente puede incluir cualquier experiencia de usuario o lógica de aplicación que requiera su escenario. Independientemente de su diseño, la interacción principal con el agente sigue el mismo patrón:

  1. Autentíquese y cree un cliente para el punto de conexión del agente.
  2. Envíe el mensaje del usuario mediante la API de respuestas.
  3. Procese la respuesta y actualícela al usuario u otro componente de la aplicación.

Uso del SDK de OpenAI

En el ejemplo de Python siguiente se usa DefaultAzureCredential para obtener un token de acceso de Microsoft Entra y se crea un OpenAI cliente configurado para el punto de conexión del agente. A continuación, envía una instrucción a través de client.responses.create e imprime la respuesta de texto del agente.

from azure.identity import DefaultAzureCredential, get_bearer_token_provider
from openai import OpenAI

# Get an OpenAI client for the agent
token = get_bearer_token_provider(
    DefaultAzureCredential(), 
    "https://ai.azure.com/.default")

client = OpenAI(
    api_key=token,
    base_url="https://ai-resrce.services.ai.azure.com/api/projects/ai-project/agents/computinghistorycode/endpoint/protocols/openai",
    default_query={"api-version": "v1"}) 

# Submit a prompt to the agent and print the response
response = client.responses.create(
    input="Who was Grace Hopper?")

print(response.output_text)

DefaultAzureCredential admite varios orígenes de credenciales, lo que permite que el mismo código de aplicación se autentique en el desarrollo local y en un entorno hospedado. La identidad autenticada debe tener permiso para usar el proyecto y el agente de Foundry.

La API de respuestas proporciona una manera coherente de que las aplicaciones y los servicios interactúen con modelos y agentes. Al exponer agentes a través de un punto de conexión compatible con OpenAI, Foundry permite usar patrones conocidos del SDK mientras el modelo, las instrucciones y las herramientas del agente permanecen administrados en Foundry.