Trabajar con el servicio Foundry Agent en Visual Studio Code (versión preliminar)

Después de empezar a trabajar con la extensión Microsoft Foundry para Visual Studio Code, use Foundry Agent Service para compilar agentes. Los agentes son microservicios que:

• Responda preguntas utilizando sus datos de entrenamiento o busque otras fuentes con generación aumentada por recuperación (RAG).
• Realizar acciones específicas.
• Automatización de flujos de trabajo completos.

Los agentes combinan modelos de inteligencia artificial con herramientas para acceder a los datos e interactuar con ellos.

Los desarrolladores de foundry pueden seguir siendo productivos mediante el desarrollo, las pruebas y la implementación de agentes en el entorno familiar de Visual Studio Code (VS Code).

Creación y edición de un agente de Azure AI en la vista del diseñador

Siga estos pasos para crear un agente de Azure AI:

1. Inicie sesión en los recursos de Azure.

2. Establezca el proyecto predeterminado.

3. Implemente un modelo para usarlo con el agente.

4. En la vista Extensión Foundry, busque la sección Recursos.

5. Seleccione el icono más (+) situado junto a la subsección Agentes para crear un nuevo agente de IA.

   

Interactúa con tu agente en el diseñador

Después de elegir la ubicación de guardado, se abrirán el archivo YAML del agente y la vista del diseñador para permitir la edición del agente de IA. Realice las siguientes tareas en el diseñador del agente:

1. En el campo de entrada, escriba un nombre para su agente.

2. En la lista desplegable, seleccione el nombre de la implementación del modelo. El nombre de implementación es lo que eligió al implementar un modelo existente.

3. La extensión genera el valor id . Configure los campos siguientes:

   • Agregue una descripción para su agente.
   • Establezca las instrucciones del sistema.
   • Configure las herramientas para el uso del agente.

   

4. Para guardar el archivo .yaml, seleccione Guardar archivo> en la barra de menús de VS Code.

Explora la definición .yaml del agente de Azure AI

El archivo .yaml del agente de IA se abrió al mismo tiempo que el diseñador. Este archivo contiene los detalles y la información de configuración del agente. Es similar al siguiente ejemplo de archivo .yaml:

# yaml-language-server: $schema=https://aka.ms/ai-foundry-vsc/agent/1.0.0
version: 1.0.0
name: my-agent
description: Description of the agent
id: ''
metadata:
  authors:
    - author1
    - author2
  tags:
    - tag1
    - tag2
model:
  id: 'gpt-4o-1'
  options:
    temperature: 1
    top_p: 1
instructions: Instructions for the agent
tools: []

Incorporación de herramientas al agente de Azure AI

Agent Service tiene el siguiente conjunto de herramientas que puede usar para interactuar con los orígenes de datos. Estas herramientas están disponibles en la extensión Foundry para Visual Studio Code.

• Fundamento con Búsqueda de Bing
• Búsqueda de archivo
• Intérprete de código
• Herramientas especificadas de OpenAPI
• Protocolo de contexto de modelo (MCP)

Para obtener más información sobre el uso de herramientas de MCP, vea Trabajar con herramientas de servidor de Agente y MCP en Visual Studio Code (versión preliminar).

Añade una herramienta al agente de IA

1. En el diseñador, en la esquina superior derecha de la sección TOOL , seleccione Agregar herramienta. En la lista desplegable, seleccione la herramienta que desea agregar.

   

2. El diseñador muestra el panel adecuado para configurar la herramienta, como se muestra en las imágenes siguientes:

   • Base sólida con la búsqueda de Bing

     

   • Búsqueda de archivos:

     

   • Intérprete de código:

     

   • Herramientas especificadas de OpenAPI 3.0:

     

3. Después de escribir la información necesaria, seleccione Crear y conectar, Cargar y guardar o Crear herramienta. El botón varía según el panel.

Al agregar una herramienta, también puede agregar los nuevos recursos que necesite. Por ejemplo, si agrega una herramienta de búsqueda de archivos, puede usar un recurso de almacén de vectores existente o crear un nuevo recurso para el almacén de vectores para hospedar los archivos cargados.

Creación de un agente de Azure AI en Foundry

Cree el agente directamente en Foundry mediante los pasos siguientes:

1. En el diseñador, seleccione el botón Crear agente en Foundry .

   

2. En VS Code, actualice la vista Recursos de Azure. El agente implementado aparece en la subsección Agentes .

   

Visualización de los detalles del agente de IA implementado

Al seleccionar el agente implementado, se abre el panel PREFERENCIAS DEL AGENTE en modo de solo vista. Ustedes pueden:

• Seleccione el botón Editar agente para ver el diseñador del agente y la definición .yaml del agente para su edición.
• Seleccione el botón Abrir archivo de código para crear un archivo de código de ejemplo que use el agente.
• Seleccione el botón Abrir área de juegos para abrir el área de juegos del agente.

Edición y actualización del agente de IA implementado

1. En el panel PREFERENCIAS DEL AGENTE , seleccione el botón Editar agente . El diseñador del agente se abre con el archivo .yaml del agente.

2. Edite la configuración del agente, como el modelo, las herramientas y las instrucciones.

3. Después de finalizar la edición, seleccione el botón Actualizar agente en Foundry para guardar los cambios.

Creación de un archivo de código de ejemplo

1. Haga clic con el botón derecho en el agente implementado y seleccione la opción Abrir archivo de código . O bien, en el panel PREFERENCIAS DEL AGENTE , seleccione el botón Abrir archivo de código .

   

2. En la lista desplegable Elegir el SDK preferido , seleccione el SDK preferido para el archivo de código del agente y, a continuación, seleccione la tecla Entrar .

   

3. En la lista desplegable Elegir un idioma , seleccione su idioma preferido para el archivo de código del agente y, a continuación, seleccione la tecla Entrar .

   

4. En la lista desplegable Elegir un método de autenticación , seleccione el método de autenticación preferido para el archivo de código del agente y, a continuación, seleccione la tecla Entrar .

   

Exploración del archivo de código de ejemplo

El siguiente archivo de código de ejemplo de Python muestra una llamada básica para interactuar con el agente a través de foundry Projects API.

Interacción con agentes mediante el área de juegos del agente

1. Haga clic con el botón derecho en el agente implementado y seleccione la opción Abrir área de juegos .

   Como alternativa, seleccione el vínculo Área de juegos del agente en la subsección Herramientas y, a continuación, seleccione el agente en la lista desplegable.

   Este paso abre el panel Sitio de prueba del agente e inicia una conversación con el agente para que pueda enviar mensajes.

   

2. Ingrese su consulta y vea los resultados.

   En este ejemplo se usa Bing Grounding para ilustrar una búsqueda web de información. El agente usa el modelo y las herramientas que configuró en el diseñador del agente. El origen de la información aparece en la sección para las anotaciones del agente.

   

Exploración de conversaciones

La subsección Subprocesos muestra los subprocesos creados durante una ejecución con el agente. En la vista Recursos de Azure, expanda la subsección Conversaciones para ver la lista.

Tenga en cuenta estos términos al explorar los hilos:

• Una conversación es una sesión de conversación entre un agente y un usuario. Los hilos almacenan mensajes y gestionan automáticamente el truncamiento para encajar el contenido dentro del contexto de un modelo.

• Un mensaje es una única interacción entre el agente y el usuario. Los mensajes pueden incluir texto, imágenes y otros archivos. Los mensajes se almacenan como una lista en el hilo.

• Una ejecución es una sola ejecución de un agente. Cada ejecución puede tener varios subprocesos y cada subproceso puede tener varios mensajes. El agente usa su configuración y los mensajes de un subproceso para realizar tareas llamando a modelos y herramientas. Como parte de una ejecución, el agente anexa mensajes al subproceso.

Ver detalles del hilo

Para visualizar el panel DETALLES DEL SUBPROCESO, seleccione un subproceso.

Visualización de los detalles de la ejecución

Para ver la información de ejecución en un archivo JSON, seleccione el botón Ver información de ejecución en el panel DETALLES DEL SUBPROCESO . En la captura de pantalla siguiente se muestra un archivo JSON de ejemplo.

Limpieza de recursos

Los recursos de Azure que creó en este artículo se facturan a la suscripción de Azure. Si no espera necesitar estos recursos en el futuro, elimínelos para evitar incurrir en más gastos.

Eliminación de los agentes

1. En VS Code, actualice la vista Recursos de Azure. Expanda la subsección Agentes para mostrar la lista de agentes implementados.
2. Haga clic con el botón derecho en el agente implementado que desea eliminar y, a continuación, seleccione Eliminar.

Elimina tus modelos

1. En VS Code, actualice la vista Recursos de Azure. Expanda la subsección Modelos para mostrar la lista de modelos implementados.

2. Haga clic con el botón derecho en el modelo implementado que desea eliminar y, a continuación, seleccione Eliminar.

   

Eliminación de las herramientas conectadas

1. Abra Azure Portal.

2. Seleccione el grupo de recursos de Azure que contiene la herramienta.

3. Seleccione el botón Eliminar .

Contenido relacionado

• Obtenga información sobre las herramientas que puede usar con agentes de Azure AI, como la búsqueda de archivos o el intérprete de código.