Extensión de la extensión de mensajes basada en bots como complemento para Copilot para Microsoft 365

Nota:

• Asegúrese de que Copilot para Microsoft 365 está disponible para su organización. Tiene dos maneras de obtener un entorno de desarrollador para Copilot:
  • Un inquilino de Espacio aislado de Microsoft 365 con Copilot (disponible en versión preliminar limitada mediante la pertenencia a TAP).
  • Un entorno de producción de Microsoft 365 u Office 365 apto con una licencia de Copilot para Microsoft 365.
• El complemento de extensión de mensaje 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 complementos para Copilot para Microsoft 365.

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

Vea el vídeo para obtener más información sobre la extensión de Copilot para Microsoft 365 mediante extensiones de mensajes de Teams:

¿Qué es un complemento?

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

• 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 complemento de extensión de mensaje. 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 complemento 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 Copilot para Microsoft 365 a generar contenido proporcionando una comprensión conceptual de las funcionalidades y escenarios del complemento, donde puede ayudar a lograr los objetivos del usuario y a hacer coincidir la intención del usuario con las funcionalidades del complemento.

Para obtener más información, vea Definir descripciones.

Todas las extensiones de mensajes de búsqueda basadas en bots son aptas para el soporte de complementos, sujetas a validación para garantizar que el complemento 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 complemento en Copilot para Microsoft 365.

Requisitos previos

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

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

• Directrices para crear o actualizar un complemento de extensión de mensaje para Copilot para Microsoft 365.

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

Importante

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

Vamos a crear una extensión de mensaje de búsqueda basada en bots que pueda buscar registros npm en Teams y Copilot y compartir resultados a través del área de redacción de mensajes 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 complemento 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 extensión de mensaje en Copilot para Microsoft 365

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

1. Seleccione Aplicaciones.

2. Busque Copilot y abra la aplicación Copilot para Microsoft 365 .

3. Seleccione Complementos.

4. En la lista de complementos, active el botón de alternancia de la extensión del mensaje.

   

5. Desde el área de redacción de mensajes, envíe un mensaje a Copilot para Microsoft 365 para buscar información del paquete npm en Teams y Copilot. Por ejemplo, busque la información del paquete npm en teamsfx-react en npm-searchlocal.

   

Nota:

Es posible que este mensaje no siempre haga que Copilot para Microsoft 365 incluya una respuesta de la extensión de mensaje. Si sucede, pruebe con otras solicitudes o deje comentarios a nosotros mediante la desactivación de la respuesta de Copilot para Microsoft 365 y deje un mensaje.

Visual Studio

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

• Instale visual Studio Enterprise 2022 Preview versión 17.9.0 Preview 1.0 o posterior e instale las herramientas de desarrollo de Microsoft Teams en ASP.NET y la carga de trabajo 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 Características en versión preliminar, active la casilla Kit de herramientas de Teams: Desarrollar complemento copilot .

Para crear un complemento 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. Seleccione Resultados de búsqueda personalizados.

   

5. Seleccione Crear. El proyecto está scaffolding.

6. 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).

7. Vaya al Explorador de soluciones y seleccione el proyecto.

8. 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.

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

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

    

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

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

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

    

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

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

    

Desencadenar extensión de mensaje en Copilot para Microsoft 365

Para desencadenar la extensión de mensaje como complemento en Copilot para Microsoft 365, 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 para Microsoft 365 y abra la aplicación Copilot para Microsoft 365 .

5. Seleccione Complementos.

6. En la lista de complementos, active el botón de alternancia de la aplicación.

   

7. Desde el área de redacción de mensajes, envíe un mensaje a Copilot para Microsoft 365 para buscar información del paquete npm en Teams y Copilot. Por ejemplo, busque la información del paquete npm en teamsfx-react en npmsearchlocal.

   

Nota:

Es posible que este mensaje no siempre haga que Copilot para Microsoft 365 incluya una respuesta de la extensión de mensaje. Si sucede, pruebe con otras solicitudes o deje comentarios a nosotros mediante la desactivación de la respuesta de Copilot para Microsoft 365 y deje 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 complemento 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/teamsfx-cli@beta
   

3. Escriba teamsfx 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:

    teamsfx 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:

     teamsfx 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 extensión de mensaje en Copilot para Microsoft 365

Para desencadenar la extensión de mensaje a través de Copilot para Microsoft 365, siga estos pasos:

1. Seleccione Aplicaciones.

2. Busque Copilot para Microsoft 365 y abra la aplicación Copilot para Microsoft 365 .

3. Seleccione Complementos.

4. En la lista de complementos, active el botón de alternancia de la aplicación.

   

5. Desde el área de redacción de mensajes, envíe un mensaje a Copilot para Microsoft 365 para buscar información del paquete npm en Teams y Copilot. Por ejemplo, busque la información del paquete npm en teamsfx-react en npm-searchlocal.

   

Nota:

Es posible que este mensaje no siempre haga que Copilot para Microsoft 365 incluya una respuesta de la extensión de mensaje. Si sucede, pruebe con otras solicitudes o deje comentarios en nosotros mediante la desactivación de la respuesta de Copilot para Microsoft 365 y deje un mensaje etiquetado con [MessageExtension].

Portal para desarrolladores de Teams

Para crear un complemento de extensión de mensaje de búsqueda basado en bots mediante el portal para desarrolladores de Teams, siga estos pasos:

1. Vaya al Portal para desarrolladores de Teams.

2. Vaya a Aplicaciones.

3. Seleccione + Nuevas aplicaciones.

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

5. Seleccione Extensión de mensajería.

   

6. 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.

   

7. 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.

   

8. Haga clic en Guardar.

9. En Comando, seleccione + Agregar un comando.

   Aparece la página Agregar un comando.

10. 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

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

12. 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 más información sobre cómo probar el complemento en Copilot para Microsoft 365, consulte Selección del complemento de depuración.

Habilitación de la extensión de mensaje como complemento para Copilot para reuniones

Asegúrese de que ha creado una extensión de mensaje basada en bots y la ha ampliado como complemento para Copilot para Microsoft 365. Antes de empezar, le recomendamos que siga las directrices que se indican en Copilot para las directrices de extensión de Microsoft 365 para ampliar el complemento para Copilot para reuniones.

Para habilitar la extensión de mensaje como complemento para las reuniones de Copilot para Teams, siga estos pasos:

1. Vaya a una reunión de Teams.

2. Seleccione Unirse.

3. En la ventana de reunión, seleccione Copilot.

4. Seleccione Iniciar transcripción.

   

5. Seleccione el idioma hablado y seleccione Confirmar. Aparece el panel Copilot para Teams.

   

6. En el panel Copilot for Teams, en la esquina inferior derecha, seleccione el botón De complemento de Copilot.

   

7. Busque el complemento y active el botón de alternancia del complemento.

8. En el área de redacción, seleccione Más mensajes para enviar una solicitud estática o puede escribir su propia solicitud y seleccionar Enviar.

   

Meeting Copilot ayuda a sus reuniones a ser mejores y más productivos. Puede hacer que las reuniones sean más interactivas, lo que ayuda a los usuarios proporcionándoles una experiencia más fluida e interesante.

Guía paso a paso

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

Vea también

• Compilación de extensiones de mensaje mediante la API
• Definir comandos de acción de extensión de mensajería
• Extensión de Microsoft Copilot para Microsoft 365