Ejercicio: Configuración de conocimientos personalizados

  • 10 minutos

Actualice el agente declarativo con conocimientos personalizados.

Preparación de los datos de puesta a tierra

Vamos a cargar los documentos en Microsoft 365 que el agente declarativo usa como datos de puesta a tierra.

En este ejercicio, usará OneDrive como sustituto de SharePoint Online. Al cargar documentos en un nuevo sitio de SharePoint Online, hay un retraso antes de que copilot indexe los documentos y estén disponibles para su uso. El uso de OneDrive le permite probar el agente inmediatamente.

Nota:

Si desea usar SharePoint Online, cargue los documentos en un sitio existente. Los documentos serán indexados y disponibles para su uso por Copilot sin demora. Si decide usar un nuevo sitio de SharePoint Online, los documentos tardarán más en indexarse y estarán disponibles para su uso en Copilot. En los ejercicios siguientes, reemplace la dirección URL de OneDrive por una dirección URL de SharePoint Online.

En un explorador web:

  1. Vaya a Microsoft365.com

  2. En la barra de conjuntos de aplicaciones, abra el iniciador de aplicaciones y seleccione OneDrive.

    Captura de pantalla de Microsoft Edge que muestra Microsoft 365. El iniciador de aplicaciones se muestra abierto y OneDrive está resaltado.

  3. En el menú de la izquierda, seleccione Agregar nuevo y, a continuación, seleccione Carpeta.

    Captura de pantalla de Microsoft Edge en la que se muestra OneDrive. El menú Agregar nuevo está expandido. La opción de menú Carpeta está resaltada.

  4. En el cuadro de diálogo Crear una carpeta , escriba Productos y seleccione Crear.

    Captura de pantalla de Microsoft Edge en la que se muestra OneDrive. Se muestra el cuadro de diálogo Crear una carpeta y Productos en el campo Texto de nombre.

  5. En el menú de la izquierda, seleccione Mis archivos y seleccione la carpeta Productos .

    Captura de pantalla del menú izquierdo de OneDrive en la que se muestran las carpetas de la vista Mis archivos

  6. En el menú de la izquierda, seleccione Agregar nuevo y, a continuación, seleccione Carga de archivos.

    Captura de pantalla de Microsoft Edge en la que se muestra OneDrive. El menú Agregar nuevo está expandido. La opción de menú Carga de archivos está resaltada.

  7. En el cuadro de diálogo selector de archivos, vaya a la carpeta /assets del repositorio del proyecto que descargó anteriormente en el equipo. Seleccione todos los archivos de la carpeta y seleccione Abrir.

    Captura de pantalla de Microsoft Edge en la que se muestra OneDrive. Un selector de archivos de Windows muestra los archivos de la carpeta assets. La ruta de acceso de la carpeta y el botón Abrir están resaltados.

    Captura de pantalla de Microsoft Edge en la que se muestra OneDrive. Los documentos cargados se muestran en la carpeta Productos.

A continuación, vamos a obtener la dirección URL directa a la carpeta de OneDrive para usarla en el manifiesto del agente declarativo.

  1. Expanda el panel de detalles seleccionando el icono Detalles en la parte superior derecha de la página. En el panel, seleccione Más detalles.

    Captura de pantalla de Microsoft Edge en la que se muestra OneDrive. El panel Detalles se expande. Los botones Detalles y Más detalles están resaltados.

  2. Seleccione el icono Copiar para copiar la dirección URL directa a la carpeta en el Portapapeles.

    Captura de pantalla de Microsoft Edge en la que se muestra OneDrive. Los detalles de la carpeta se muestran en el panel Detalles. El icono Copiar está resaltado.

  3. Pegue la dirección URL en un editor de texto del Portapapeles para usarlo más adelante.

Configuración de datos de puesta a tierra

Configure la carpeta de OneDrive como origen de datos de conexión a tierra en el manifiesto del agente declarativo.

En Visual Studio Code:

  1. En la carpeta appPackage , abra declarativeAgent.json archivo.

  2. Agregue el siguiente fragmento de código al archivo y reemplace {URL} por la dirección URL directa a la carpeta Products de OneDrive que copió y almacenó anteriormente en un editor de texto:

    "capabilities": [
    {
        "name": "OneDriveAndSharePoint",
        "items_by_url": [
            {
                "url": "{URL}"
            }
        ]
    }
]

  3. Guarde los cambios.

El archivo declarativeAgent.json debe tener este aspecto:

{
    "$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')]",
    "capabilities": [
        {
            "name": "OneDriveAndSharePoint",
            "items_by_url": [
                {
                    "url": "https://{tenant}-my.sharepoint.com/personal/{user}/Documents/Products"
                }
            ]
        }
    ]
}

Actualizar instrucciones personalizadas

Actualice las instrucciones del manifiesto del agente declarativo para proporcionar a nuestro agente contexto adicional y ayudarle a guiarlo al responder a las consultas del cliente.

En Visual Studio Code:

  1. Abra el archivo appPackage/instruction.txt y actualice el contenido con:

    You are Product Support, an intelligent assistant designed to answer customer queries about Contoso Electronics products, repairs, returns, and warranties. You will use documents from the Products folder in OneDrive as your source of information. If you can't find the necessary information, you should suggest that the agent should reach out to the team responsible for further assistance. Your responses should be concise and always include a cited source.

  2. Guarde los cambios.

Carga del agente declarativo en Microsoft 365

Cargue los cambios en Microsoft 365 e inicie una sesión de depuración.

En Visual Studio Code:

  1. En la barra de actividad, abra la extensión Microsoft 365 Agents Toolkit .
  2. En la sección Ciclo de vida , seleccione Aprovisionar.
  3. Espere a que se complete la carga.
  4. En la barra de actividad, cambie a la vista Ejecutar y depurar .
  5. 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.

Prueba del agente declarativo en Microsoft 365 Copilot

Pruebe el agente declarativo en Microsoft 365 y valide los resultados.

En primer lugar, vamos a probar las instrucciones:

Continuando en el explorador web:

  1. En Microsoft 365 Copilot, seleccione el icono de la parte superior derecha para expandir el panel lateral de Copilot.
  2. Busque Compatibilidad con productos en la lista de agentes y selecciónela para entrar en la experiencia inmersiva para chatear directamente con el agente.
  3. Seleccione el símbolo del sistema de ejemplo con el título Más información y envíe el mensaje.
  4. Espere la respuesta. Observe cómo la respuesta es diferente de las instrucciones anteriores y refleja las nuevas instrucciones.

Captura de pantalla de Microsoft Edge que muestra Microsoft 365 Copilot. Se muestra una respuesta del agente de soporte técnico del producto que muestra que el agente se puede usar para responder a las consultas del producto sobre los productos de Contoso Electronics.

A continuación, vamos a probar los datos de puesta a tierra.

  1. En el cuadro de mensaje, escriba Cuéntame sobre Eagle Air y envía el mensaje.
  2. Espere la respuesta. Observe que la respuesta contiene información sobre el dron eagle air. La respuesta contiene citas y referencias al documento de Eagle Air almacenado en OneDrive.

Captura de pantalla de Microsoft Edge que muestra Microsoft 365 Copilot. Se muestra una respuesta del agente de soporte técnico del producto que muestra los detalles del producto para Eagle Air. Se cita un documento y se hace referencia a él en la respuesta como origen de datos de puesta a tierra.

Vamos a probar algunos avisos más:

  1. En el cuadro de mensaje, escriba Recomendar un producto adecuado para un agricultor y envíe el mensaje.

  2. Espere la respuesta. Observe que la respuesta contiene información sobre Eagle Air y algún contexto adicional sobre por qué se recomienda Eagle Air. La respuesta contiene citas y referencias al documento de Eagle Air almacenado en OneDrive.

    Captura de pantalla de Microsoft Edge que muestra Microsoft 365 Copilot. Se muestra una respuesta del agente de soporte técnico del producto que muestra los detalles del producto para Eagle Air como recomendación del producto. Se cita un documento y se hace referencia a él en la respuesta como origen de datos de puesta a tierra.

  3. En el cuadro de mensaje, escriba Explicar por qué Eagle Air es más adecuado que Contoso Quad y envíe el mensaje.

  4. Espere la respuesta. Tenga en cuenta que la respuesta explica con más detalle por qué Eagle Air es más adecuado que el Contoso Quad para su uso por parte de los agricultores.

    Captura de pantalla de Microsoft Edge que muestra Microsoft 365 Copilot. Se muestra una respuesta del agente de soporte técnico del producto con una explicación de por qué el águila es aire es más adecuado para su uso por parte de los agricultores.

Por último, vamos a probar la respuesta de reserva haciendo una pregunta que el agente no puede responder:

  1. En el cuadro de mensaje, escriba ¿Cuándo se publicó Mark8? y envíe el mensaje.
  2. Espere la respuesta. Tenga en cuenta que la respuesta sugiere que el agente debe ponerse en contacto con el equipo responsable de más ayuda, tal como se define en las instrucciones.

Captura de pantalla de Microsoft Edge que muestra Microsoft 365 Copilot. Se muestra una respuesta del agente de soporte técnico del producto. El agente no puede responder a la pregunta, por lo que realiza una sugerencia para buscar información de otro origen.

Cierre el explorador para detener la sesión de depuración en Visual Studio Code.