Extensión de mensajes basada en bots como agente para Microsoft 365 Copilot

Nota:

• Asegúrese de que Microsoft 365 Copilot está disponible para su organización. Tiene dos maneras de obtener un entorno de desarrollador para Microsoft 365 Copilot:
  • Un inquilino de Espacio aislado de Microsoft 365 con Microsoft 365 Copilot (disponible en versión preliminar limitada mediante la pertenencia a TAP).
  • Un entorno de producción de Microsoft 365 o Office 365 apto con una licencia de Microsoft 365 Copilot.
• El agente de extensión de mensajes de búsqueda basado en bots está disponible en versión preliminar para desarrolladores públicos.
• Solo las extensiones de mensajes basadas en bots con comandos de búsqueda se pueden ampliar como agentes para Microsoft 365 Copilot.

Microsoft 365 Copilot, con tecnología de un motor de procesamiento y orquestación avanzado, integra aplicaciones de Microsoft 365, Microsoft Graph y modelos de lenguaje grande (LLM) para transformar sus palabras en una potente herramienta de productividad. Aunque Microsoft 365 Copilot pueden usar aplicaciones y datos dentro del ecosistema de Microsoft 365, muchos usuarios dependen de diversas herramientas y servicios externos para la administración y colaboración del trabajo. Al ampliar la extensión de mensaje como agente en Microsoft 365 Copilot, puede permitir que los usuarios interactúen con herramientas y servicios de terceros, lo que les permite lograr más con Microsoft 365 Copilot. Para lograr esta extensión, puede desarrollar un agente o conectarse a un origen de datos externo.

¿Qué es un agente?

Un agente permite a Microsoft 365 Copilot interactuar directamente con datos, aplicaciones y servicios de terceros, mejorar sus funcionalidades y ampliar su gama de funcionalidades. Los agentes permiten Microsoft 365 Copilot para:

• Captura información en tiempo real, como la última cobertura de noticias en un lanzamiento de producto.
• Recupere información basada en conocimientos, como los archivos de diseño de un equipo en Figma.

Las descripciones mejoran la facilidad de uso y la eficacia de un agente de extensión de mensajes. La siguiente descripción ofrece un resumen claro y conciso de las características de la aplicación:

• Descripción de la aplicación: la descripción de la aplicación ayuda a mejorar la detectabilidad de la aplicación en la Tienda Teams.
• Descripción del comando: la descripción del comando asigna la intención y la expresión del usuario al comando de búsqueda dentro de un agente y debe compilarse en función del análisis de la intención del usuario y las palabras clave.
• Descripción del parámetro: la descripción del parámetro explica los requisitos del sistema en un lenguaje natural con formato de salida.
• Descripción semántica: la descripción semántica ayuda a Microsoft 365 Copilot generar contenido proporcionando una comprensión conceptual de las funcionalidades y escenarios del agente, donde puede ayudar a lograr los objetivos del usuario y a hacer coincidir la intención del usuario con las capacidades del agente.

Para obtener más información, consulte directrices para crear y actualizar agentes.

Todas las extensiones de mensajes de búsqueda basadas en bots que son aptas para el soporte técnico del agente deben cumplir los requisitos de la directiva y están sujetas a validación para asegurarse de que el agente cumple las expectativas de calidad, seguridad, privacidad y utilidad. Puede crear una extensión de mensaje de búsqueda basada en bots mediante Teams Toolkit for Visual Studio Code, Visual Studio, la interfaz de línea de comandos (CLI) de Teams Toolkit o el Portal para desarrolladores de Teams y ampliar la extensión de mensaje para que funcione como agente en Microsoft 365 Copilot.

Requisitos previos

Antes de empezar, asegúrese de que está familiarizado con los siguientes estándares y directrices para crear agentes de extensión de mensajes para Microsoft 365 Copilot:

• Estándares de cumplimiento, rendimiento, seguridad y experiencia del usuario descritos en las directrices de validación de la Tienda Teams.

• Instrucciones para crear o actualizar un agente de extensión de mensajes para Microsoft 365 Copilot.

Creación de una extensión de mensaje basada en bots

Importante

Los agentes para Microsoft 365 Copilot están en versión preliminar y solo funcionan en Microsoft 365 Copilot en Teams.

Vamos a crear un agente de extensión de mensajes de búsqueda basado en bots para Teams y Microsoft 365 Copilot y compartir los resultados a través del área de redacción del mensaje del cliente de Microsoft Teams.

Visual Studio Code

Antes de empezar, asegúrese de instalar las siguientes herramientas para compilar e implementar la extensión de mensaje:

• Instale la versión preliminar más reciente del kit de herramientas de Teams.
• Asegúrese de que la marca De desarrollo de características del complemento Copilot esté habilitada. Para habilitar la marca de característica, siga estos pasos:
  1. Abra Visual Studio Code.
  2. Vaya a Administrar>configuración.
  3. Escriba Teams Toolkit en el cuadro de búsqueda Configuración de búsqueda.
  4. En Extensiones, active la casilla Fx-extension: Develop Copilot Plugin (Fx-extension: Desarrollar complemento copilot ).

Para crear un agente de extensión de mensaje de búsqueda basado en bots mediante Visual Studio Code, siga estos pasos:

1. Abra Visual Studio Code.

2. En el panel izquierdo, seleccione Kit de herramientas de Teams.

3. Seleccione Crear una nueva aplicación.

4. Seleccione Extensión de mensaje.

5. Seleccione Resultados de búsqueda personalizados.

6. Seleccione Iniciar con un bot.

   

7. Seleccione un lenguaje de programación.

8. Seleccione Carpeta predeterminada.

9. Escriba el nombre de la aplicación y seleccione Entrar. El kit de herramientas de Teams aplica scaffolding a la aplicación y crea una extensión de mensaje.

Para ejecutar la extensión de mensaje en Teams, siga estos pasos:

1. En el panel izquierdo, seleccione Kit de herramientas de Teams.

2. En CUENTAS, realice los pasos siguientes:

   1. Seleccione Iniciar sesión en Microsoft 365 y escriba sus credenciales de Microsoft 365.

   2. Seleccione Iniciar sesión en Azure y escriba sus credenciales de Azure.

      

3. En el panel izquierdo, seleccione Ejecutar y depurar (Ctrl+Mayús+D).

4. Seleccione Depurar en Teams (Edge) o Depurar en Teams (Chrome). Teams Toolkit inicia la aplicación en Teams mediante un explorador web.

5. Seleccione Agregar. La aplicación está instalada en Teams.

6. Vaya a un chat y seleccione Acciones y aplicaciones.

7. En el menú desplegable extensión de mensaje, escriba el nombre de la extensión de mensaje en el cuadro de búsqueda.

8. Seleccione la extensión de mensaje y escriba la consulta de búsqueda.

9. Seleccione un producto de la lista. Teams desplegó el producto como una tarjeta adaptable en el área de redacción del mensaje.

10. Seleccione Enviar.

Desencadenar la extensión de mensaje en Microsoft 365 Copilot

Para desencadenar la extensión de mensaje como agente en Microsoft 365 Copilot en Teams, siga estos pasos:

1. Seleccione Aplicaciones.

2. Busque Copilot y abra Microsoft 365 Copilot.

3. Seleccione Panel en la esquina superior derecha.

4. Seleccione el agente necesario en el panel derecho.

   

5. Desde el área de redacción de mensajes, envíe un mensaje a Microsoft 365 Copilot para buscar la actualización más reciente de Teams y Microsoft 365 Copilot.

   

Nota:

Es posible que este mensaje no siempre garantice una respuesta de la extensión de mensaje en Microsoft 365 Copilot. Si esto ocurre, pruebe diferentes mensajes o envíe comentarios mediante la reducción de la respuesta Microsoft 365 Copilot y la salida de un mensaje.

Visual Studio

Antes de empezar, asegúrese de instalar las siguientes herramientas para compilar e implementar la extensión de mensaje:

• Instale la versión preliminar 17.9.0 preview 1.0 o posterior de Visual Studio Enterprise 2022 e instale las herramientas de desarrollo de Microsoft Teams en ASP.NET y carga de trabajo de desarrollo web.
• Asegúrese de que la marca de características de Copilot está habilitada. Para habilitar la marca de característica, siga estos pasos:
  1. Abra Visual Studio.
  2. Vaya a Opciones de herramientas>.
  3. Escriba Teams Toolkit en el cuadro de búsqueda Configuración de búsqueda.
  4. En la sección Características de la versión preliminar , active la casilla Kit de herramientas de Teams: Desarrollo del complemento Copilot .
• Asegúrese de que el perfil de inicio de varios proyectos está habilitado. Para habilitar el perfil, siga estos pasos:
  1. Abra Visual Studio.
  2. Vaya a Opciones de herramientas>.
  3. En la sección Características de vista previa , seleccione la casilla Habilitar perfiles de inicio de varios proyectos .

Para crear un agente de extensión de mensaje de búsqueda basado en bots mediante Visual Studio, siga estos pasos:

1. Abra Visual Studio.

2. Vaya a Archivo>nuevo>proyecto... o Crear un nuevo proyecto.

3. Busque Teams y seleccione Aplicación de Microsoft Teams.

4. Escriba los detalles del proyecto. Asegúrese de que la casilla Colocar solución y proyecto en el mismo directorio no está seleccionada.

5. Seleccione Crear.

6. Seleccione Resultados de búsqueda personalizados.

   

7. Seleccione Crear. El proyecto está scaffolding.

8. En el menú desplegable de depuración, seleccione Túneles> de desarrolloCrear un túnel.

   
   

   1. Seleccione la cuenta para crear el túnel. Azure, Microsoft Account (MSA) y GitHub son los tipos de cuenta que se admiten.
   2. Nombre: escriba un nombre para el túnel.
   3. Tipo de túnel: seleccione Persistente o Temporal.
   4. Acceso: seleccione Público.
   5. Seleccione Aceptar. Visual Studio muestra un mensaje de confirmación de que se crea un túnel.

   El túnel que ha creado aparece en Túneles > de desarrollo (nombre del túnel).

9. Vaya a Explorador de soluciones y seleccione el proyecto.

10. Haga clic con el botón derecho en el menú del proyecto y seleccione Kit de herramientas> de TeamsPreparar dependencias de aplicaciones de Teams.

    

    Si se le solicita, inicie sesión con una cuenta de Microsoft 365.

11. En el menú desplegable de depuración, seleccione Microsoft Teams (explorador). Visual Studio inicia el cliente web de Teams.

12. Seleccione Agregar. La extensión de mensaje se agrega a Teams.

    

13. Vaya a un chat y seleccione Acciones y aplicaciones.

14. En el menú desplegable extensión de mensaje, escriba el nombre de la extensión de mensaje en el cuadro de búsqueda.

15. Seleccione la extensión de mensaje y escriba la consulta de búsqueda.

    

16. Seleccione un producto de la lista. Teams desplegó el producto en una tarjeta adaptable en el área de redacción del mensaje.

17. Seleccione Enviar. La tarjeta adaptable se envía al chat.

    

Desencadenar la extensión de mensaje en Microsoft 365 Copilot

Para desencadenar la extensión de mensaje como agente en Microsoft 365 Copilot, siga estos pasos:

1. Vaya a Visual Studio.

2. En la lista desplegable de depuración, seleccione Copilot (explorador). Visual Studio inicia el cliente web de Teams.

   

3. Vaya a Aplicaciones cliente> web de Teams.

4. Busque Copilot y abra Microsoft 365 Copilot.

5. Seleccione Panel en la esquina superior derecha.

6. Seleccione el agente necesario en el panel derecho.

   

7. Desde el área de redacción de mensajes, envíe un mensaje a Microsoft 365 Copilot para buscar la actualización más reciente de Teams y Microsoft 365 Copilot.

   

Nota:

Es posible que este mensaje no siempre garantice una respuesta de la extensión de mensaje en Microsoft 365 Copilot. Si esto ocurre, pruebe diferentes mensajes o envíe comentarios mediante la reducción de la respuesta Microsoft 365 Copilot y la salida de un mensaje.

CLI del kit de herramientas

Antes de empezar, asegúrese de establecer la variable de entorno DEVELOP_COPILOT_PLUGIN entrue. Para establecer las variables de entorno, siga estos pasos:

1. En el equipo, seleccione la tecla Windows + X .

2. Seleccione Sistema.

3. En Acerca>de las especificaciones del dispositivo, seleccione Configuración avanzada del sistema.

4. En Propiedades del sistema, seleccione Variables de entorno...

5. En Variables de usuario, seleccione Nuevo... Se abre un cuadro de diálogo Nueva variable de usuario .

6. Actualice los campos siguientes:

   1. Nombre de variable: DEVELOP_COPILOT_PLUGIN
   2. Valor de variable: true

7. Seleccione Aceptar.

   

Para crear un agente de extensión de mensaje de búsqueda basado en bots mediante la CLI del kit de herramientas de Teams, siga estos pasos:

1. Vaya al símbolo del sistema.

2. Escriba el siguiente comando:

   npm install -g @microsoft/teamsapp-cli
   

3. Escriba teamsapp new en el terminal.

4. Seleccione Extensión de mensaje. Use las teclas de dirección para cambiar entre opciones.

   

5. Seleccione Resultados de búsqueda personalizados.

6. Seleccione Iniciar con un bot.

   

7. Escriba la ubicación del proyecto y seleccione Entrar.

8. Escriba el nombre de la aplicación y seleccione Entrar.

   Teams Toolkit aplica scaffolding y crea un proyecto en la ubicación especificada.

9. Vaya a la ruta de acceso de la carpeta donde se crea el proyecto y escriba el siguiente comando para aprovisionar la aplicación en Azure:

    teamsapp provision --env dev
   

   La CLI del kit de herramientas de Teams abre una ventana del explorador y le pide que inicie sesión en su cuenta microsoft.

10. Inicie sesión en su cuenta de Microsoft. La CLI del kit de herramientas de Teams ejecuta la validación y aprovisiona la aplicación en Azure.

11. En la lista, seleccione una suscripción.

    

12. En la lista, seleccione un grupo de recursos.

13. Si recibe un mensaje, que lee Costo puede incurrir en función del uso. ¿Desea aprovisionar recursos en el entorno de desarrollo mediante las cuentas enumeradas anteriormente?, escriba Y.

    

    Teams Toolkit valida el manifiesto de la aplicación y aprovisiona la aplicación en Azure.

14. En la ventana del símbolo del sistema, escriba el siguiente comando para obtener una vista previa de la aplicación en Teams:

     teamsapp preview --env dev
    

    Se abre una nueva ventana del explorador con el cliente web de Teams. Puede agregar la aplicación a Teams.

15. Seleccione Agregar. La extensión de mensaje se agrega a Teams.

16. Vaya a un chat y seleccione Acciones y aplicaciones.

17. En el menú desplegable extensión de mensaje, escriba el nombre de la extensión de mensaje en el cuadro de búsqueda.

18. Seleccione la extensión de mensaje y escriba la consulta de búsqueda.

Desencadenar la extensión de mensaje en Microsoft 365 Copilot

Para desencadenar la extensión de mensaje como agente en Microsoft 365 Copilot en Teams, siga estos pasos:

1. Seleccione Aplicaciones.

2. Busque Copilot y abra Microsoft 365 Copilot.

3. Seleccione Panel en la esquina superior derecha.

4. Seleccione el agente necesario en el panel derecho.

   

5. Desde el área de redacción de mensajes, envíe un mensaje a Microsoft 365 Copilot para buscar la actualización más reciente de Teams y Microsoft 365 Copilot.

   

Nota:

Es posible que este mensaje no siempre garantice una respuesta de la extensión de mensaje en Microsoft 365 Copilot. Si esto ocurre, pruebe diferentes mensajes o envíe comentarios mediante la reducción de la respuesta Microsoft 365 Copilot y la salida de un mensaje.

Portal para desarrolladores de Teams

Para crear una extensión de mensaje basada en bots mediante el Portal para desarrolladores para Teams, siga estos pasos:

1. Vaya al Portal para desarrolladores de Teams.

2. Vaya a Aplicaciones.

3. Seleccione + Nuevas aplicaciones.

4. En la página Agregar aplicaciones, actualice el nombre y seleccione la versión del manifiesto como Versión preliminar del desarrollador público (devPreview).

   

5. En Configurar, seleccione Características de la aplicación.

6. Seleccione Extensión de mensajería.

7. En Tipo de extensión de mensaje, seleccione Bot.

   1. Si obtiene una declinación de responsabilidades, que lee la extensión de mensaje de API ya está en uso por parte de los usuarios. ¿Desea cambiar el tipo de extensión de mensaje a bot?. Seleccione Sí, cambie.

      

8. Si tiene un bot existente, seleccione Bot existente o, si tiene un identificador de bot, seleccione Entrar id. de bot.

   1. Si no tiene un identificador de bot, puede seleccionar Crear un bot nuevo para crear un bot y escribir el identificador del bot nuevo que ha creado.

      

9. Haga clic en Guardar.

10. En Comando, seleccione + Agregar un comando.

    Aparece la página Agregar un comando.

11. En la página Agregar un comando , seleccione buscar como tipo de comando y actualice los campos siguientes:

    • Identificador de comando
    • Título del comando
    • Descripción del comando
    • Contexto en el que funciona el comando
    • Nombre del parámetro
    • Título del parámetro
    • Descripción del parámetro

12. Haga clic en Guardar. El comando se agrega a la extensión de mensaje.

13. Haga clic en Guardar.

Se crea una extensión de mensaje de búsqueda basada en bots.

Para probar la extensión de mensaje basada en bots creada en el Portal para desarrolladores de Teams, puede usar los métodos siguientes:

• Versión preliminar en Teams: en el Portal para desarrolladores, abra la extensión de mensaje y seleccione Vista previa en Teams en la esquina superior derecha. Se le redirigirá a Teams, donde puede agregar la aplicación a Teams para obtener una vista previa de la aplicación.

• Descargar paquete de aplicación: en la página de extensión del mensaje, seleccione Paquete de aplicación en el panel izquierdo y, a continuación, en la esquina superior izquierda de la ventana, seleccione Descargar paquete de aplicación. El paquete de la aplicación se descarga en la máquina local en un archivo .zip. Puede cargar el paquete de la aplicación en los equipos y probar la extensión del mensaje.

Para obtener más información sobre cómo probar el agente en Microsoft 365 Copilot, consulte selección del agente de depuración.

Guía paso a paso

Siga la guía paso a paso para crear un agente de extensión de mensaje de búsqueda basado en bots para Microsoft 365 Copilot.

Recursos adicionales

• Compilación de extensiones de mensaje mediante la API
• Definir comandos de acción de extensión de mensajería
• Ampliar Microsoft 365 Copilot
• Preguntas más frecuentes sobre el agente para Microsoft 365 Copilot