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 Azure OpenAI desde el portal de Microsoft Foundry. Necesita los siguientes datos sobre el modelo:

  • Nombre
  • URI de destino
  • Clave

  Aprenda a agregar y configurar modelos a modelos de Fundición de IA de Azure

Crear un proyecto nuevo

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.

1. En Visual Studio Code, abra el panel lateral de extensión Microsoft 365 Agents Toolkit seleccionando el icono agentes de Microsoft 365 en la barra lateral.

2. Para compilar un nuevo proyecto de agente, seleccione Crear un nuevo agente o aplicación. 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.

1. Para empezar con la compilación de un agente con el SDK de agentes, seleccione Agente de motor personalizado:

Creación de un 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.

Tiene dos plantillas para seleccionar entre:

• Agente de motor básico personalizado
• Agente meteorológico.

El agente de motor personalizado básico es un agente sin nada preconfigurado. Necesita agregar un orquestador de IA, como Kernel semántico o LangChain, y su conocimiento, para que el agente sea útil.

1. En este ejemplo, seleccione Weather Agent para crear un agente que use LangChain y Fundición de IA de Azure, en función del idioma elegido.

Se le pedirá que seleccione un servicio LLM.

1. Seleccione Azure OpenAI para el modelo.

   

   Se le pedirá su Key, Target URI y el Name de su modelo OpenAI de Azure desde el portal de Microsoft Foundry. Puede encontrar estos fragmentos de información en Mis recursos y modelos y puntos de conexión en el portal de Foundry.

2. Escriba los detalles del modelo, empezando por la clave de servicio de OpenAI de Azure.

   

3. 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.

   

4. 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 sigue la guía y usa la plantilla predefinida con LangChain y Fundición de IA de Azure, puede preguntar "¿Cuál es el clima en {su ubicación} mañana?". El agente responde con una tarjeta adaptable con el clima, utilizando su 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 en el teclado o Depurar para probarlo. 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 aplicación y un registro en Azure Bot Service e implementa tu proyecto en el arrendatario junto con un manifiesto.

   

2. Una vez que su proyecto esté implementado, debería ver que Microsoft 365 Copilot cargue y ser capaz de formular preguntas, agregar puntos de interrupción y depurar según sea necesario, directamente en Microsoft 365 Copilot.

   

Resumen

Ahora lo has conseguido.

• Inició un nuevo proyecto de Microsoft 365 Agents y un agente utilizando el Agents Toolkit.
• 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