Ejercicio: Creación de un agente declarativo

  • 5 minutos

Cree un proyecto de agente declarativo a partir de una plantilla, actualice el manifiesto, cargue el agente en Microsoft 365 y pruebe el agente en Microsoft 365 Copilot.

Descarga del proyecto de inicio

Para empezar, descargue el proyecto de ejemplo.

En un explorador web:

  1. Vaya al repositorio de https://github.com/microsoft/learn-declarative-agent-vscode plantillas.
  2. Si tiene una cuenta de GitHub:
    1. Siga los pasos para crear un nuevo repositorio a partir de una plantilla. Asigne al repositorio el nombre da-product-support.
    2. Siga los pasos para clonar el repositorio en el equipo.
  3. Si no tiene una cuenta de GitHub:
    1. Siga los pasos para descargar el código fuente del repositorio en el equipo.
    2. Extraiga el contenido del archivo ZIP descargado en una carpeta del equipo.

El proyecto de inicio contiene un proyecto de Microsoft 365 Agents Toolkit que incluye un agente declarativo.

  1. Abra la carpeta del proyecto en Visual Studio Code.
  2. En la carpeta raíz del proyecto, abra README.md archivo. Examine el contenido para obtener más información sobre la estructura del proyecto.

Captura de pantalla de Visual Studio Code que muestra el archivo léame del proyecto de inicio y la estructura de carpetas en la vista Explorador.

Examen del manifiesto del agente declarativo

Vamos a examinar el archivo de manifiesto del agente declarativo.

  • Abra el archivo appPackage/declarativeAgent.json y examine el contenido:

    {
    "$schema": "https://developer.microsoft.com/json-schemas/copilot/declarative-agent/v1.3/schema.json",
    "version": "v1.3",
    "name": "da-product-support",
    "description": "Declarative agent created with Microsoft 365 Agents Toolkit",
    "instructions": "$[file('instruction.txt')]"
}

El valor de la propiedad instructions contiene una referencia a un archivo denominado instruction.txt. La función $[file(path)] la proporciona Microsoft 365 Agents Toolkit. El contenido de la instruction.txt se incluye en el archivo de manifiesto del agente declarativo cuando se aprovisiona en Microsoft 365.

  • En la carpeta appPackage , abra instruction.txt archivo y revise el contenido:

    You are a declarative agent and were created with Team Toolkit. You should start every response and answer to the user with "Thanks for using Microsoft 365 Agents Toolkit to create your declarative agent!\n\n" and then answer the questions and help the user.

Actualización del manifiesto del agente declarativo

Vamos a actualizar las propiedades de nombre y descripción para que sean más relevantes para nuestro escenario.

  1. En la carpeta appPackage , abra declarativeAgent.json archivo.
  2. Actualice el valor de la propiedad name a La compatibilidad con productos.
  3. Actualice el valor de la propiedad description al agente de soporte técnico del producto que puede ayudar a responder a las consultas de los clientes sobre los productos de Contoso Electronics.
  4. Save your changes

El archivo actualizado debe tener el siguiente contenido:

{
    "$schema": "https://developer.microsoft.com/json-schemas/copilot/declarative-agent/v1.3/schema.json",
    "version": "v1.3",
    "name": "Product support",
    "description": "Product support agent that can help answer customer queries about Contoso Electronics products",
    "instructions": "$[file('instruction.txt')]"
}

Carga del agente declarativo en Microsoft 365

Importante

Antes de empezar, asegúrese de que tiene instalada la extensión Microsoft 365 Agents Toolkit en Visual Studio Code. Si aún no ha instalado la extensión desde Marketplace, hágalo ahora.

A continuación, cargue el agente declarativo en el inquilino de Microsoft 365.

En Visual Studio Code:

  1. En la barra de actividad, abra la extensión Microsoft 365 Agents Toolkit .

    Captura de pantalla de Visual Studio Code. El icono de Microsoft 365 Agents Toolkit está resaltado en la barra de actividad.

  2. En la sección Ciclo de vida , seleccione Aprovisionar.

    Captura de pantalla de Visual Studio Code que muestra la vista microsoft 365 Agents Toolkit. La función

  3. En el símbolo del sistema, seleccione Iniciar sesión y siga las indicaciones para iniciar sesión en el inquilino de Microsoft 365 mediante microsoft 365 Agents Toolkit. El proceso de aprovisionamiento se inicia automáticamente después de iniciar sesión.

    Captura de pantalla de un mensaje de Visual Studio Code pedir al usuario que inicie sesión en Microsoft 365. El botón Iniciar sesión está resaltado.

    Captura de pantalla de Visual Studio Code que muestra el proceso de aprovisionamiento en curso. El mensaje de aprovisionamiento en curso está resaltado.

  4. Espere a que se complete la carga antes de continuar.

    Captura de pantalla de Visual Studio Code que muestra una notificación del sistema que confirma que el proceso de aprovisionamiento se ha completado. La notificación del sistema está resaltada.

A continuación, revise la salida del proceso de aprovisionamiento.

  • En la carpeta appPackage/build , abra declarativeAgent.dev.json archivo.

Observe que el valor de la propiedad instructions contiene el contenido del archivo instruction.txt . El archivo declarativeAgent.dev.json se incluye en el archivo appPackage.dev.zip junto con los archivos manifest.dev.json, color.pngy outline.png . El archivo appPackage.dev.zip se carga en Microsoft 365.

Prueba del agente declarativo en Microsoft 365 Copilot

A continuación, vamos a ejecutar el agente declarativo en Microsoft 365 Copilot y validar su funcionalidad en las experiencias en contexto y envolventes.

En Visual Studio Code:

  1. En la barra de actividad, cambie a la vista Ejecutar y depurar .

    Captura de pantalla de Visual Studio Code. El icono Ejecutar y depurar de la barra de actividad está resaltado.

  2. Seleccione el botón Iniciar depuración situado junto a la lista desplegable de la configuración o presione F5. Se inicia una nueva ventana del explorador y navega a Microsoft 365 Copilot.

    Captura de pantalla de Visual Studio Code que muestra la vista Ejecutar y depurar. El icono Iniciar depuración está resaltado.

    Captura de pantalla de Visual Studio Code que muestra una sesión de depuración en curso.

    Captura de pantalla de Microsoft Edge que muestra Microsoft 365 Copilot.

Continuando en el explorador, vamos a probar la experiencia en contexto .

  1. En Microsoft 365 Copilot, en el cuadro de mensaje, escriba el @ símbolo. El control flotante aparece con una lista de agentes disponibles.

    Captura de pantalla de Microsoft Edge que muestra el control flotante del agente en Microsoft 365 Copilot. El agente de soporte técnico del producto está resaltado.

  2. En el control flotante, seleccione Compatibilidad con productos. Observe el mensaje de estado encima del cuadro de mensaje. Muestra Chatting with Product support (Chatting con compatibilidad con productos), lo que significa que usa la experiencia en contexto del agente.

    Captura de pantalla de Microsoft Edge que muestra Microsoft 365 Copilot. El mensaje de estado

  3. En el cuadro de texto, escriba ¿Qué puede hacer? y envíe el mensaje.

    Captura de pantalla de Microsoft Edge que muestra Microsoft 365 Copilot. El texto '¿Qué puede hacer?' está resaltado en el cuadro de mensaje.

  4. Espere la respuesta. Observe cómo la respuesta comienza con el texto "Gracias por usar Microsoft 365 Agents Toolkit para crear el agente declarativo" como se define en las instrucciones que ha revisado anteriormente.

    Captura de pantalla de Microsoft Edge que muestra Microsoft 365 Copilot. Se muestra una respuesta del agente de soporte técnico del producto.

  5. Para salir de la experiencia en contexto, seleccione la cruz (X) en el mensaje de estado. Observe que el mensaje de estado se ha quitado y se muestra un mensaje en la ventana de chat que indica que ya no está chateando con el agente.

    Captura de pantalla de Microsoft Edge que muestra Microsoft 365 Copilot. El icono cruzado del mensaje de estado del agente está resaltado.

    Captura de pantalla de Microsoft Edge que muestra Microsoft 365 Copilot. El mensaje que confirma que el agente declarativo no responde está resaltado.

Por último, vamos a probar la experiencia inmersiva .

Continuando en el explorador:

  1. En Microsoft 365 Copilot, seleccione el icono de la parte superior derecha para expandir el panel lateral de Copilot. Observe que el panel muestra los chats recientes y los agentes disponibles.

    Captura de pantalla de Microsoft Edge que muestra Microsoft 365 Copilot. El icono para abrir el panel lateral y el agente de soporte técnico del producto en el panel están resaltados.

  2. En el panel lateral, seleccione Compatibilidad con productos para entrar en la experiencia inmersiva y chatear directamente con el agente.

  3. En el cuadro de texto, escriba ¿Qué puede hacer? y envíe el mensaje.

  4. Envíe el mensaje y espere la respuesta. Observe cómo la respuesta comienza con el texto "Gracias por usar Microsoft 365 Agents Toolkit para crear el agente declarativo" como se define en las instrucciones que ha revisado anteriormente.

    Captura de pantalla de Microsoft Edge que muestra Microsoft 365 Copilot. Se muestra una respuesta del agente de soporte técnico del producto.

Por último, cierre el explorador para detener la sesión de depuración en Visual Studio Code.