Inicio rápido de Microsoft Foundry

En esta guía rápida, empezarás a usar modelos y agentes en Foundry.

Hará lo siguiente:

  • Generación de una respuesta a partir de un modelo
  • Creación de un agente con un mensaje definido
  • Tener una conversación de múltiples interacciones con el agente

Requisitos previos

Establecimiento de variables de entorno y obtención del código

Almacene el punto de conexión del proyecto como una variable de entorno. Establezca también estos valores para usarlos en los scripts.

PROJECT_ENDPOINT=<endpoint copied from welcome screen>
AGENT_NAME="MyAgent"

Siga estos pasos a continuación o obtenga el código:

Inicia sesión usando el comando az login de la CLI para autenticarse antes de ejecutar tus scripts de Python.

Instalación y autenticación

Asegúrese de instalar la versión correcta de los paquetes como se muestra aquí.

  1. Instale la versión actual de azure-ai-projects. Esta versión usa el API (nuevo) de Foundry projects.

    pip install azure-ai-projects>=2.0.0
    
  2. Inicia sesión usando el comando az login de la CLI para autenticarse antes de ejecutar tus scripts de Python.

Propina

El código usa Azure AI Projects 2.x y no es compatible con Azure AI Projects 1.x. Consulte la documentación de Foundry (clásico) para la versión de Azure AI Projects 1.x.

Chatear con un modelo

La interacción con un modelo es el bloque de creación básico de las aplicaciones de inteligencia artificial. Envíe una entrada y reciba una respuesta del modelo:

from azure.identity import DefaultAzureCredential
from azure.ai.projects import AIProjectClient

# Format: "https://resource_name.ai.azure.com/api/projects/project_name"
PROJECT_ENDPOINT = "your_project_endpoint"

# Create project and openai clients to call Foundry API
project = AIProjectClient(
    endpoint=PROJECT_ENDPOINT,
    credential=DefaultAzureCredential(),
)
openai = project.get_openai_client()

# Run a responses API call
response = openai.responses.create(
    model="gpt-5-mini",  # supports all Foundry direct models
    input="What is the size of France in square miles?",
)
print(f"Response output: {response.output_text}")

Después de ejecutar el código, verá una respuesta generada por el modelo en la consola (por ejemplo, un poema corto o una respuesta al mensaje). Esto confirma que el punto de conexión del proyecto, la autenticación y la implementación del modelo funcionan correctamente.

Propina

El código usa Azure AI Projects 2.x y no es compatible con Azure AI Projects 1.x. Consulte la documentación de Foundry (clásico) para la versión de Azure AI Projects 1.x.

Creación de un agente

Cree un agente mediante el modelo implementado.

Un agente define el comportamiento principal. Una vez creado, garantiza respuestas coherentes en las interacciones del usuario sin repetir instrucciones cada vez. Puede actualizar o eliminar agentes en cualquier momento.

from azure.identity import DefaultAzureCredential
from azure.ai.projects import AIProjectClient
from azure.ai.projects.models import PromptAgentDefinition

# Format: "https://resource_name.ai.azure.com/api/projects/project_name"
PROJECT_ENDPOINT = "your_project_endpoint"
AGENT_NAME = "your_agent_name"

# Create project client to call Foundry API
project = AIProjectClient(
    endpoint=PROJECT_ENDPOINT,
    credential=DefaultAzureCredential(),
)

# Create an agent with a model and instructions
agent = project.agents.create_version(
    agent_name=AGENT_NAME,
    definition=PromptAgentDefinition(
        model="gpt-5-mini",  # supports all Foundry direct models"
        instructions="You are a helpful assistant that answers general questions",
    ),
)
print(f"Agent created (id: {agent.id}, name: {agent.name}, version: {agent.version})")

El resultado confirma que se creó el agente. En el caso de las pestañas del SDK, verá el nombre del agente y el identificador impresos en la consola.

Propina

El código usa Azure AI Projects 2.x y no es compatible con Azure AI Projects 1.x. Consulte la documentación de Foundry (clásico) para la versión de Azure AI Projects 1.x.

Chatear con un agente

Use el agente creado anteriormente denominado "MyAgent" para interactuar mediante la formulación de una pregunta y un seguimiento relacionado. La conversación mantiene el historial a lo largo de estas interacciones.

from azure.identity import DefaultAzureCredential
from azure.ai.projects import AIProjectClient

# Format: "https://resource_name.ai.azure.com/api/projects/project_name"
PROJECT_ENDPOINT = "your_project_endpoint"
AGENT_NAME = "your_agent_name"

# Create project and openai clients to call Foundry API
project = AIProjectClient(
    endpoint=PROJECT_ENDPOINT,
    credential=DefaultAzureCredential(),
)
openai = project.get_openai_client()

# Create a conversation for multi-turn chat
conversation = openai.conversations.create()

# Chat with the agent to answer questions
response = openai.responses.create(
    conversation=conversation.id,
    extra_body={"agent_reference": {"name": AGENT_NAME, "type": "agent_reference"}},
    input="What is the size of France in square miles?",
)
print(response.output_text)

# Ask a follow-up question in the same conversation
response = openai.responses.create(
    conversation=conversation.id,
    extra_body={"agent_reference": {"name": AGENT_NAME, "type": "agent_reference"}},
    input="And what is the capital city?",
)
print(response.output_text)

Verá las respuestas del agente a ambas solicitudes. La respuesta de seguimiento muestra que el agente mantiene el historial de conversaciones entre turnos.

Propina

El código usa Azure AI Projects 2.x y no es compatible con Azure AI Projects 1.x. Consulte la documentación de Foundry (clásico) para la versión de Azure AI Projects 1.x.

Limpieza de recursos

Si ya no necesita ninguno de los recursos que ha creado, elimine el grupo de recursos asociado al proyecto.

  • En el portal Azure, seleccione el grupo de recursos y, a continuación, seleccione Delete. Confirme que desea eliminar el grupo de recursos.

Paso siguiente