Crear agentes de JavaScript en Visual Studio Code con el kit de herramientas de agentes de Microsoft 365

En este artículo, aprenderá cómo crear un nuevo proyecto del SDK de Agentes JavaScript en Visual Studio, utilizando el Microsoft 365 Agents Toolkit.

Requisitos previos

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

• Se requiere un modelo de Azure OpenAI del portal de Microsoft Foundry. Se requieren los siguientes datos del modelo:

  • Nombre
  • URI objetivo
  • Tecla

  Aprenda cómo agregar y configurar modelos en Modelos de Fundición de IA de Azure

Crear un nuevo proyecto

El Kit de Herramientas de Agentes proporciona una plantilla de proyecto para ayudarte a empezar a crear un agente. Puede partir de una plantilla en el Toolkit o de ejemplos en el SDK de Agents.

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

2. Para crear un nuevo proyecto de agente, seleccione Crear un nuevo agente/aplicación. Puede partir de una plantilla en el Toolkit o de ejemplos en el SDK de Agents. Esta guía abarca cómo empezar con Agents Toolkit.

1. Para empezar a crear un agente con el Agents SDK, seleccione Agente de motor personalizado:

Crear un nuevo agente

Con el agente del motor personalizado seleccionado como opción, le guían por una serie de pasos para agregar sus propios servicios de IA.

Tiene dos plantillas entre las que elegir:

• Agente de motor personalizado básico
• 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 Agente meteorológico para crear un agente que emplea LangChain y Fundición de IA de Azure, en función del lenguaje seleccionado.

Se le pedirá que seleccione un servicio LLM.

1. Seleccione Azure OpenAI para su modelo.

   

   Se le solicitará su Clave, URI de destino y el Nombre de su modelo de Azure OpenAI desde el portal de Microsoft Foundry. Puede encontrar esta información en Mis recursos y Modelos y puntos de conexión en el portal de Foundry.

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

   

3. Seleccione JavaScript o TypeScript, seleccione la Carpeta predeterminada e introduzca un Nombre de aplicación para almacenar la carpeta raíz de su proyecto en la ubicación predeterminada.

   Se abre el nuevo proyecto.

   

4. Confirme que ha iniciado sesión usando 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 su código con el nuevo Microsoft 365 Agent Playground disponible en el kit de herramientas. El área de juegos le ayuda a depurar su código fácilmente y sin tener que pasar por un ciclo completo de implementación.

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 lleva unos minutos.

   

2. Mientras espera la implementación, revise su carpeta para el código y revíselo para familiarizarse.

   

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 previamente creada con LangChain y Fundición de IA de Azure, puede preguntar "¿Qué tiempo hará mañana en {su ubicación}?" El agente responde con una tarjeta adaptable con el clima, usando el servicio de IA que haya elegido.

   

   

Depurar y probar el agente en Microsoft 365 Copilot

Cuando termine de probar localmente en Agents Playground, puede implementar el agente en Azure Bot Service y configurarlo para el canal de Microsoft 365 Copilot. Asegúrese de haber 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 probar. Se necesitan unos minutos de preparación para poner el agente a disposición de 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 inquilino junto con un manifiesto.

   

2. Una vez que su proyecto esté implementado, debería ver que Microsoft 365 Copilot se carga y podrá hacer preguntas, agregar puntos de interrupción y depurar, según sea necesario, directamente en Microsoft 365 Copilot:

   

Resumen

Ha logrado hacer lo siguiente:

• Inicio de un nuevo proyecto y agente de Agentes de Microsoft 365 mediante el Kit de herramientas de agentes
• Se ha probado el agente localmente usando Microsoft 365 Agents Playground
• Implementó el agente para la depuración directamente en el canal de Microsoft 365