Creación de agentes de JavaScript en Visual Studio Code con el Kit de herramientas de agentes de Microsoft 365

En este artículo, aprenderá a crear un nuevo proyecto de JavaScript del SDK de agentes en Visual Studio mediante el Kit de herramientas de agentes de Microsoft 365.

Prerrequisitos

• Instale la extensión Agents Toolkit para Visual Studio Code.

• Necesita un modelo de Azure desde el portal de Azure AI Foundry. Necesita estos datos sobre el modelo:

  • Nombre
  • URI de destino
  • Key

  Aprenda a agregar y configurar modelos a modelos de Azure AI Foundry

Creación de un nuevo proyecto

Agents Toolkit proporciona una plantilla de proyecto que le ayudará a empezar a crear un agente. Puede empezar desde una plantilla en el kit de herramientas o desde ejemplos en el SDK de agentes.

Para compilar un nuevo proyecto de agente, seleccione Crear un nuevo agente o aplicación en el Kit de herramientas de agentes de Microsoft 365. Puede empezar desde una plantilla en el kit de herramientas o desde ejemplos en el SDK de agentes. En esta guía se explica el inicio del kit de herramientas de agentes.

Para empezar con la creación de un agente con el SDK de agentes, seleccione Agente de motor personalizado en el primer menú:

Crear un nuevo agente

Con el agente de motor personalizado seleccionado como opción, se le guiará por una serie de indicaciones para incorporar sus propios servicios de IA.

1. Tiene dos plantillas para seleccionar: Agente de motor personalizado básico o Agente meteorológico. El agente de motor personalizado básico es un agente sin nada preconfigurado. Debe agregar un orquestador de inteligencia artificial, como Semantic Kernel o LangChain, y sus conocimientos.

   

2. En este ejemplo, seleccione Weather Agent para crear un agente que use LangChain y Azure AI Foundry en función del idioma elegido.

3. Seleccione Azure OpenAI para el modelo.

   

   Se le pedirá la clave, el URI de destino y el nombre del modelo de Azure desde el portal de Azure AI Foundry. Puede encontrar estos fragmentos de información en Mis recursos y modelos y puntos de conexión en el portal de Foundry.

4. Escriba los detalles, empezando por la clave:

   

5. Seleccione JavaScript o TypeScript, seleccione la carpeta Predeterminada y escriba un nombre de aplicación para almacenar la carpeta raíz del proyecto en la ubicación predeterminada.

   Se abre tu nuevo proyecto.

   

6. Confirme que ha iniciado sesión con la extensión seleccionando el logotipo de Microsoft 365 en la barra de herramientas de Visual Studio Code. Asegúrese de que ha iniciado sesión en el inquilino al que desea conectarse.

   

Depure y pruebe su agente en el Entorno de Agentes

Puede depurar y probar el código con el nuevo área de juegos del agente de Microsoft 365 disponible en el kit de herramientas. El área de juegos le ayuda a depurar el código fácilmente y sin tener que pasar por un ciclo de implementación completo.

1. Seleccione Depuración en Microsoft 365 Agents Playground.

   Al seleccionar el entorno de pruebas, espere unos instantes mientras se prepara su máquina local con los componentes necesarios. La preparación tarda unos minutos.

   

2. Mientras espera la implementación, revise la carpeta del código para familiarizarse con él.

   

3. Una vez que el espacio de pruebas para depurar y probar finaliza la carga, se abre un navegador y puede interactuar con tu agente mediante el espacio de pruebas. Si ha seguido la guía y ha usado la plantilla predefinida con LangChain y Azure AI Foundry, puede preguntar "¿Cuál es el tiempo en {su ubicación} mañana?" El agente responde con una carta adaptativa con la información meteorológica, utilizando tu servicio de IA elegido.

   

   

Depura y prueba tu agente en Microsoft 365 Copilot

Cuando termine de probar localmente en la Plataforma de Agentes, puede implementar en Azure Bot Service y configurarlo para el canal de Microsoft 365 Copilot. Asegúrese de que ha iniciado sesión en un inquilino que tenga acceso a Microsoft 365 Copilot.

1. Cambie el destino de depuración a Copilot para que pueda depurar con Microsoft 365 Copilot. Seleccione F5 o Depurar para probar. La preparación tarda unos minutos en hacer que el agente esté disponible para Microsoft 365. En segundo plano, el kit de herramientas crea un registro de aplicaciones y un registro de Bot Service en Azure Bot Service e implementa el proyecto en el inquilino junto con un manifiesto.

   

2. Una vez hecho esto, debería ver la carga de Microsoft 365 Copilot y poder formular preguntas, agregar puntos de interrupción y depurar, según sea necesario, directamente en Microsoft 365 Copilot:

   

Resumen

Ahora lo has conseguido.

• Inicio de un nuevo proyecto y agente de Agentes de Microsoft 365 mediante el Kit de herramientas de agentes
• Prueba del agente localmente mediante el área de juegos de agentes de Microsoft 365
• Implementó el agente para la depuración directamente en el canal de Microsoft 365