Creación de agentes de .NET en Visual Studio mediante el Kit de herramientas de agentes de Microsoft 365

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

Prerequisites

• Instalar la extensión Agents Toolkit para Visual Studio para Visual Studio.

• Un modelo Azure OpenAI desde el portal de Fundición de IA de Azure. Necesita los siguientes datos sobre el modelo:

  • Nombre
  • URI de destino
  • Clave

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. Este documento se centra en las plantillas disponibles en Agents Toolkit. Hay diferentes plantillas y opciones disponibles para crear proyectos del SDK de agentes con el kit de herramientas. Este tutorial se centra en la creación de un agente meteorológico mediante Kernel semántico y Fundición de IA de Azure.

1. Abra Visual Studio y seleccione Crear un nuevo proyecto.

2. Busca "agent" para encontrar nuevas plantillas que utilicen el Kit de Herramientas de Agentes y el SDK de Agentes de Microsoft 365.

3. Selecciona Microsoft 365 Agents y luego selecciona Siguiente.

   

   Aparece un cuadro de diálogo para que pueda asignar un nombre al agente. También puede cambiar la ubicación y el nombre de la solución si lo desea.

4. Cuando haya terminado, seleccione Crear.

   

   Puede seleccionar algunas opciones diferentes que proporciona el kit de herramientas para crear agentes.

5. Para este tutorial, seleccione Weather Agent>Next ejemplo para usar el SDK de agentes de Microsoft 365. Este ejemplo precompilado implementa kernel semántico para la orquestación con modelos de Fundición de IA de Azure o Azure OpenAI. También puede usar el ejemplo de agente Vacío si desea empezar sin un modelo U orquestador.

   

   Un diálogo te pregunta qué servicio de LLM quieres usar.

   

6. Para este tutorial, seleccione Azure OpenAI.

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

   

7. Rellene los datos necesarios: clave de servicio de Azure OpenAI, endpoint de Azure OpenAI y nombre de implementación de Azure OpenAI.

8. Selecciona Crear. El kit de herramientas crea el proyecto a partir de una plantilla automáticamente.

9. En un breve período de tiempo, tendrás un nuevo proyecto creado mediante el SDK de Agents.

   

Prueba tu agente en el entorno de prueba de agentes de Microsoft 365

Para empezar, puede probar localmente mediante el área de juegos de agentes de Microsoft 365 en el kit de herramientas.

Para iniciar las pruebas, establezca el destino de depuración en el proyecto para que sea 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. Empiece a enviar mensajes al agente para probar su comportamiento.

Depura y prueba tu agente en Microsoft Teams o Microsoft Copilot

También puedes establecer el objetivo de depuración para que esté directamente en Microsoft Teams o Microsoft Copilot.

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

   

   Se tarda unos instantes en cambiar a Microsoft Teams. Se le solicita que agregue su agente en el cliente de Teams que se abre.

   

2. Seleccione Agregar. Aparece un panel de notificaciones que indica que el agente se ha agregado correctamente.

   

3. Seleccione Abrir en el nuevo agente para abrirlo en Teams. Puede hacer preguntas al 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

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