Compartir a través de


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.

Nota:

Antes de empezar, debe instalar la extensión Agents Toolkit para Visual Studio.

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.

Nota:

El procedimiento siguiente solo funciona actualmente para .NET.

  1. Para compilar un nuevo proyecto de agente, abra Visual Studio y seleccione Crear un nuevo proyecto. Busque "agente" para buscar nuevas plantillas mediante microsoft 365 Agent Toolkit and Agents SDK (Sdk de agentes de Microsoft 365) Seleccione Microsoft 365 Agents>Next (Siguiente).

    Creación de un nuevo proyecto

    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.

  2. Cuando haya terminado, seleccione Siguiente.

    Configuración del nuevo proyecto

  3. El siguiente cuadro de diálogo le pide que elija el tipo de agente. Puede seleccionar algunas opciones diferentes que proporciona el kit de herramientas para crear agentes. Para usar el SDK de agentes de Microsoft 365, debe seleccionar el ejemplo de Agente meteorológico . Este ejemplo precompilado implementa kernel semántico para la orquestación con modelos de Azure AI Foundry o Azure OpenAI. También puede usar el ejemplo de agente vacío si desea empezar sin un modelo o una configuración de orquestador.

    Seleccione el tipo de aplicación que se va a crear.

    Selección del tipo llm que se va a usar para el modelo

  4. Para este tutorial, seleccione Azure AI Foundry y complete las entradas necesarias. Incluir la clave, el punto de conexión y el nombre de implementación. Esta información se puede encontrar en Azure AI Foundry en Modelos y puntos de conexión.

    Configuración de las opciones para conectarse al servicio LLM elegido

  5. Selecciona Crear. El kit de herramientas crea el proyecto a partir de una plantilla para usted, listo para empezar.

  6. En un breve período de tiempo, debe tener un nuevo proyecto creado que use el SDK de agentes.

    Código de aplicación en el editor

Prueba del agente en el área de juegos 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, seleccione el destino de depuración del proyecto para que sea El área de juegos de agentes de Microsoft 365".

El área de juegos se abre para probar en una nueva ventana del explorador con el host local y muestra el área de juegos con él listo para probar. Empiece a enviar mensajes al agente para probar su comportamiento.

Depurar y probar el 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. Seleccione una de las opciones de depuración como destino de depuración en la lista de destinos.

    Seleccione Microsoft Teams (explorador)

    Se tarda unos instantes en Microsoft Teams. Se le pedirá que agregue el agente en el cliente de Teams que se abre.

    Petición de Teams para agregar agente

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

    Agente agregado correctamente a Teams, símbolo del sistema para abrir

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

    Agente que se ejecuta en M365 Copilot

Resumen

Ahora tiene éxito:

  • 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 o Teams.