Crear agentes de .NET en Visual Studio con el kit de herramientas de agentes de Microsoft 365

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

Requisitos previos

• Instale la extensión Kit de herramientas de agentes para Visual Studio para Visual Studio.

• Un modelo de Azure OpenAI disponible en el portal de Fundición de IA de Azure. Se requieren los siguientes datos del modelo:

  • Nombre
  • URI objetivo
  • Tecla

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. Este documento se centra en las plantillas disponibles en Agents Toolkit. Existen diferentes plantillas y opciones disponibles para crear proyectos del SDK de Agentes con el kit de herramientas. Este recorrido se centra en crear un Agente Meteorológico usando Kernel semántico y Fundición de IA de Azure.

1. Abra Visual Studio y seleccione Crear un proyecto. Busca "agente" para encontrar nuevas plantillas con el Kit de herramientas de agentes de Microsoft 365 y SDK de agentes. Seleccione Microsoft 365 Agents>Siguiente.

   

   Aparece un diálogo para que puedas nombrar al agente. También puedes cambiar la ubicación y el nombre de la solución si quieres.

2. Cuando haya acabado, seleccione Crear

   

   Puedes elegir entre varias opciones que ofrece el Toolkit para crear agentes.

3. Para esta guía, seleccione Agente meteorológico>Siguiente ejemplo para usar el SDK de Agentes de Microsoft 365. Esta muestra predefinida implementa Kernel semántico para la orquestación con Fundición de IA de Azure o modelos de Azure OpenAI. También puede usar el ejemplo de agente Vacío si desea empezar sin un modelo U orquestador.

   

   

   Un cuadro de diálogo solicita que selecciones el servicio LLM que deseas usar.

4. En este tutorial seleccione Azure OpenAI.

   Esta información se puede encontrar en Fundición de IA de Azure bajo Modelos y puntos de conexión.

   

5. Completa los datos requeridos: clave de servicio de Azure OpenAI, punto de conexión de Azure OpenAI y nombre de despliegue de Azure OpenAI.

6. Seleccione Crear. El toolkit crea el proyecto a partir de una plantilla.

7. En breve deberías tener un nuevo proyecto creado usando el Agents SDK.

   

Probar el agente en el área de juegos de agentes de Microsoft 365

Para empezar, puedes probar localmente usando el Microsoft 365 Agents Playground en el Toolkit.

Para comenzar las pruebas, configura el objetivo de depuración en tu proyecto como Microsoft 365 Agents Playground.

El entorno de prueba se abre para que pueda probar en una nueva ventana del navegador con su host local y lo muestra listo para probar. Empieza a enviar mensajes a tu agente para probar su comportamiento.

Depura y prueba tu agente en Microsoft Teams o Microsoft 365 Copilot

También puede establecer el destino de depuración para que esté directamente en Microsoft Teams o Microsoft 365 Copilot.

1. Selecciona una de las opciones de depuración como destino de depuración de la lista de destinos.

   

   Tarda unos momentos en cambiar a Microsoft Teams. Se te pide añadir tu agente en el cliente de Teams que se abre.

   

2. Seleccione Añadir. Aparecerá un panel de notificaciones que indica que el agente ha sido añadido correctamente.

   

3. Selecciona Abrir en tu nuevo agente para abrirlo en Teams. Puedes hacerle preguntas a tu agente directamente en Teams. Puede establecer puntos de interrupción para que funcionen a través de la depuración de la experiencia cuando sea necesario.

   

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 Teams o Microsoft 365