Definición de comandos de búsqueda de extensión de mensaje

El comando de búsqueda se invoca desde cualquiera de las siguientes ubicaciones o desde ambas:

• Área redactar mensaje: los botones de la parte inferior del área de redacción del mensaje.
• Cuadro de comandos: mediante / en el cuadro de comandos. Por ejemplo, /your-app-name. Si usa la versión clásica de Teams, el comando de búsqueda se invoca @mentioning en el cuadro de comandos. Por ejemplo, @your-app-name.

Cuando se invoca un comando de búsqueda desde el área del mensaje de redacción, el usuario envía los resultados a la conversación. Cuando un comando de búsqueda se invoca desde el cuadro de comandos, el usuario interactúa con la tarjeta resultante o la copia para usarla en otro lugar.

En la imagen siguiente se muestran las ubicaciones de invocación del comando de búsqueda:

Agregar el comando de búsqueda al manifiesto de la aplicación

Para agregar el comando de búsqueda al manifiesto de la aplicación (anteriormente denominado manifiesto de aplicación de Teams), debe agregar un nuevo composeExtensions objeto al nivel superior del JSON del manifiesto de la aplicación. Puede agregar el comando de búsqueda con la ayuda del Portal para desarrolladores o manualmente.

Creación de una extensión de mensaje de búsqueda con Bot Framework

Puede crear una extensión de mensaje de búsqueda mediante el Kit de herramientas de Teams y el Portal para desarrolladores para Teams.

Requisitos previos

Antes de empezar, asegúrese de cumplir los siguientes requisitos:

• Node.js. Las versiones admitidas son 16, 18.
• Cuenta de Microsoft 365 para el desarrollo
• Configure el entorno de desarrollo para ampliar las aplicaciones de Teams en Microsoft 365. Después de inscribir el inquilino del desarrollador en Office 365 versión dirigida, la inscripción puede tardar un par de días en surtir efecto.
• Kit de herramientas de Teams Visual Studio Code versión 5.2.0 y posteriores o la CLI del kit de herramientas de Teams.

Kit de herramientas de Teams

Para crear una extensión de mensaje basada en búsqueda mediante teams Toolkit, 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 un lenguaje de programación.

7. Seleccione Carpeta predeterminada.

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

   El kit de herramientas de Teams aplica scaffolding al proyecto y crea una extensión de mensaje de búsqueda.

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, inicie sesión con su cuenta de Microsoft 365 y la cuenta de Azure si aún no lo ha hecho.

   

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

4. En la lista desplegable de configuración de inicio, seleccione Preview in Teams (Edge) o Preview in Teams (Chrome). Teams Toolkit inicia el cliente web de Teams en una ventana del explorador.

5. Vaya a un mensaje de chat y seleccione el icono Acciones y aplicaciones . En el menú flotante, busque la aplicación.

6. Seleccione la extensión de mensaje de la lista y escriba un comando de búsqueda en el cuadro de búsqueda.

7. Seleccione un elemento de la lista. El elemento se desplegó en una tarjeta adaptable en el área de redacción del mensaje.

8. Seleccione Enviar. Teams envía el resultado de la búsqueda como una tarjeta adaptable en el mensaje de chat.

Portal para desarrolladores de Teams

1. Vaya al Portal para desarrolladores de Teams.

2. Vaya a Aplicaciones.

3. Seleccione Crear una nueva aplicación.

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 existente, seleccione Crear un bot para crear un bot y escriba el identificador de bot del nuevo bot que creó.

8. Haga clic en Guardar.

9. Seleccione los ámbitos necesarios.

10. En Comando, seleccione + Agregar un comando.

    Aparece una página de detalles del comando.

11. En la página Detalles del 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
    • Seleccionar el tipo de entrada

12. Haga clic en Guardar. Una extensión de mensaje de búsqueda con bot framework creado.

13. En la esquina superior derecha, seleccione Vista previa en Teams. La aplicación se abre en el cliente web o de escritorio de Teams.

Extensión de mensajes basada en bots como agente

Importante

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

Los agentes de Microsoft 365 proporcionan integración con varios productos de Microsoft 365, como Teams y Outlook. La integración ayuda a los usuarios a buscar o crear contenido en sistemas externos. Los agentes de extensión de mensajes permiten que Microsoft 365 Copilot interactúen con las API de otros servicios y software a través de un bot. Se recomienda compilar o actualizar las extensiones de mensaje existentes para maximizar su utilidad y facilidad de uso en Microsoft 365 Copilot. Para obtener más información, consulte Extensión de mensajes basada en bots como agente para Microsoft 365 Copilot.

Fragmentos de código

El código siguiente proporciona un ejemplo de extensiones de mensaje basadas en búsquedas:

C#

• Referencia del SDK
• Referencia de código de ejemplo

protected override async Task<MessagingExtensionResponse> OnTeamsMessagingExtensionQueryAsync(ITurnContext<IInvokeActivity> turnContext, MessagingExtensionQuery query, CancellationToken cancellationToken)
        {
            var text = query?.Parameters?[0]?.Value as string ?? string.Empty;

            var packages = new[] {
            new { title = "A very extensive set of extension methods", value = "FluentAssertions" },
            new { title = "Fluent UI Library", value = "FluentUI" }};

            // We take every row of the results and wrap them in cards wrapped in MessagingExtensionAttachment objects.
            // The Preview is optional, if it includes a Tap, that will trigger the OnTeamsMessagingExtensionSelectItemAsync event back on this bot.
            var attachments = packages.Select(package =>
            {
                var previewCard = new ThumbnailCard { Title = package.title, Tap = new CardAction { Type = "invoke", Value = package } };
                if (!string.IsNullOrEmpty(package.title))
                {
                    previewCard.Images = new List<CardImage>() { new CardImage(package.title, "Icon") };
                }

                var attachment = new MessagingExtensionAttachment
                {
                    ContentType = HeroCard.ContentType,
                    Content = new HeroCard { Title = package.title },
                    Preview = previewCard.ToAttachment()
                };

                return attachment;
            }).ToList();

            // The list of MessagingExtensionAttachments must we wrapped in a MessagingExtensionResult wrapped in a MessagingExtensionResponse.
            return new MessagingExtensionResponse
            {
                ComposeExtension = new MessagingExtensionResult
                {
                    Type = "result",
                    AttachmentLayout = "list",
                    Attachments = attachments
                }
            };
        }

Node.js

Referencia de código de ejemplo

async handleTeamsMessagingExtensionQuery(context, query) {
        const searchQuery = query.parameters[0].value;     
        const attachments = [];
                const response = await axios.get(`http://registry.npmjs.com/-/v1/search?${ querystring.stringify({ text: searchQuery, size: 8 }) }`);
                
                response.data.objects.forEach(obj => {
                        const heroCard = CardFactory.heroCard(obj.package.name);
                        const preview = CardFactory.heroCard(obj.package.name);
                        preview.content.tap = { type: 'invoke', value: { description: obj.package.description } };
                        const attachment = { ...heroCard, preview };
                        attachments.push(attachment);
                });
    
                return {
                    composeExtension:  {
                           type: 'result',
                           attachmentLayout: 'list',
                           attachments: attachments
                    }
                };
            }       
        }

Ejemplo de código

Ejemplo de nombre	Descripción	.NET	Node.js	Manifiesto
Búsqueda de extensión de mensaje de Teams	En este ejemplo se muestra cómo crear una extensión de mensaje basada en búsqueda. Busca paquetes NuGet y muestra los resultados en la extensión de mensajería basada en búsquedas.	View	View	View

Guía paso a paso

Siga la guía paso a paso para crear una extensión de mensaje basada en búsquedas.

Paso siguiente

Responder a los comandos de búsqueda.

Recursos adicionales

• Portal para desarrolladores de Teams
• Extensiones de mensajes