Ampliar la extensión de mensajes basados en bots como agente para Microsoft 365 Copilot

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

• Instale la versión preliminar más reciente del kit de herramientas de agentes.
• Asegúrese de que la marca de característica Desarrollar complemento de 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 Kit de herramientas de agentes de Microsoft 365 en el cuadro de búsqueda de la configuración de búsqueda.
  4. En Extensiones, seleccione la casilla fx-extension: desarrollar complemento de Copilot .

Para crear un agente de extensión de mensajes 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 agentes de Microsoft 365.

3. Seleccione Crear un nuevo agente o aplicación.

4. Seleccione la extensión de mensaje.

5. Seleccione Resultados de búsqueda personalizados.

6. Seleccione Empezar con un bot.

   

7. Seleccione un lenguaje de programación.

8. Seleccione la carpeta predeterminada.

9. Escriba el nombre de la aplicación y seleccione Entrar. Kit de herramientas de agentes 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 agentes de Microsoft 365.

2. En CUENTAS, siga estos pasos:

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

   2. Seleccione Iniciar sesión en Azure e introduzca sus credenciales de Azure.

      

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

4. Seleccione Depurar en Teams (Edge) o Depurar en Teams (Chrome). Kit de herramientas de agentes inicia la aplicación en Teams con 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 de la extensión de mensaje, escriba el nombre de la extensión de mensaje en el cuadro de búsqueda.

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

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

10. Seleccione Enviar.

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

   

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

• Instale la versión preliminar 17.9.0 de Visual Studio Enterprise 2022 o posterior 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ística Copilot está habilitada. Para habilitar la marca de característica, siga estos pasos:
  1. Abra Visual Studio.
  2. Vaya a Opciones deherramientas>.
  3. Escriba Kit de herramientas de agentes de Microsoft 365 en el cuadro de búsqueda de la configuración de búsqueda.
  4. En la sección Características en versión preliminar , seleccione la casilla Kit de herramientas de agentes de Microsoft 365: desarrollar complemento de 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 deherramientas>.
  3. En la sección Características en versión preliminar , selecciona la casilla Habilitar perfiles de inicio de varios proyectos .

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

1. Abra Visual Studio.

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

3. Busque Teams y seleccione la aplicación de Microsoft Teams.

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

5. Seleccione Crear.

6. Seleccione Resultados de búsqueda personalizados.

   

7. Seleccione Crear. El proyecto está andamiado.

8. En el menú desplegable de depuración, selecciona Dev Tunnels>Create a Tunnel.

   
   

   1. Seleccione la cuenta para crear el túnel. Azure, cuenta Microsoft (MSA) y GitHub son los tipos de cuenta que se admiten.
   2. Nombre: introduzca 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 ha creado un túnel.

   El túnel que creó aparece en Dev Tunnels > (nombre del túnel).

9. Vaya al 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 agentes de Microsoft365. Seleccione Cuenta de Microsoft 365.

    

    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 de la extensión de mensaje, escriba el nombre de la extensión de mensaje en el cuadro de búsqueda.

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

    

16. Seleccione un producto de la lista. Teams muestra el producto en una tarjeta adaptable en el área de redacción de mensajes.

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

    

Desencadenar 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 las aplicaciones del 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.

   

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

1. En el equipo, selecciona la teclaX de Windows + .

2. Seleccione Sistema.

3. En Acercadelas 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. Actualiza los siguientes campos:

   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 agentes, siga estos pasos:

1. Ir al símbolo del sistema.

2. Escriba el comando siguiente:

   npm install -g @microsoft/atk-cli
   

3. Ingrese atk new en el terminal.

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

   

5. Seleccione Resultados de búsqueda personalizados.

6. Seleccione Empezar con un bot.

   

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

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

   Kit de herramientas de agentes crea un proyecto en la ubicación especificada.

9. Vaya a la ruta de acceso de la carpeta donde se creó 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 agente abre una ventana del explorador y le solicita que inicie sesión en su cuenta de Microsoft.

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

11. Selecciona una suscripción en la lista.

    

12. Seleccione un grupo de recursos en la lista.

13. Si recibe un mensaje en el que se lee Puede incurrir en costos según el uso. ¿Desea aprovisionar recursos en el entorno de desarrollo con las cuentas enumeradas anteriormente?, escriba Y.

    

    Kit de herramientas de agentes 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 abrirá una nueva ventana del explorador con el cliente web de Teams. Puede agregar su 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 de la extensión de mensaje, escriba el nombre de la extensión de mensaje en el cuadro de búsqueda.

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

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

   

Para crear una extensión de mensajería basada en bots mediante el portal para desarrolladores de Teams, siga estos pasos:

1. Vaya al portal para desarrolladores de Teams.

2. Ve a Aplicaciones.

3. Seleccione + Nuevas aplicaciones.

4. En la página Agregar aplicaciones, actualiza el nombre y selecciona la versión del manifiesto como Versión preliminar pública para desarrolladores (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 un aviso de declinación de responsabilidades, que dice Los usuarios ya están usando la extensión de mensaje de API. ¿Desea cambiar el tipo de extensión de mensaje a bot?. Seleccione Sí, cambiar.

      

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

   1. Si no tiene un id. de bot, puede seleccionar Crear un nuevo bot para crear un nuevo bot y escribir el id. 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 la búsqueda como tipo de comando y actualice los campos siguientes:

    • Id. 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 agregará 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:

• Vista previa 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 la aplicación: En la página de extensión de mensaje, seleccione Paquete de la aplicación en el panel izquierdo y, a continuación, en la esquina superior izquierda de la ventana, seleccione Descargar paquete de la aplicación. El paquete de la aplicación se descarga en el equipo local en un archivo .zip. Puede cargar el paquete de la aplicación en Teams y probar la extensión de mensajería.