Compartir a través de


Creación de complementos de alta calidad para Microsoft 365 Copilot

Al compilar un complemento, permite que los usuarios interactúen con el servicio web mediante lenguaje natural a través de Microsoft 365 Copilot. Los complementos amplían las aptitudes de Copilot para realizar tareas en nombre de los usuarios. Son especialmente buenos en:

  • Acceso a información en tiempo real
  • Recuperación de datos relacionales
  • Realizar acciones entre aplicaciones

Importante

  • Actualmente, los complementos de API solo se admiten como acciones dentro de agentes declarativos. No se habilitan en Microsoft 365 Copilot. Para obtener un ejemplo que muestra cómo agregar un complemento de API a un agente declarativo, consulte Agregar un complemento.
  • La funcionalidad está habilitada de forma predeterminada en todos los inquilinos con licencia de Microsoft 365 Copilot. Los administradores pueden deshabilitar esta funcionalidad en función del usuario y del grupo y controlar cómo se aprueban los complementos individuales para su uso y qué complementos están habilitados. Para obtener más información, consulte Administración de agentes de Copilot en aplicaciones integradas.

Cualidades de un buen complemento

Una descripción clara y concisa del complemento es esencial para que Copilot reconozca sus capacidades y coincida con las tareas de usuario adecuadas. Puede asegurarse de que el complemento proporciona la mejor experiencia de usuario posible en tiempo de ejecución mediante el diseño del complemento con las siguientes características.

Imagen que representa

Búsqueda de soporte técnico

Anticipe y admita las búsquedas más comunes que realizarán los usuarios.

Imagen que representa

Recuperar contenido profundo

Asegúrese de que la búsqueda coincide con el párrafo circundante. Proporcione una respuesta de tarjeta adaptable con información adicional.

Imagen que representa

Presentación de resultados accionables

Incluya una manera de que el usuario realice acciones, como un vínculo profundo a su sitio web o un diálogo modal.

Imagen que representa

Proporcionar una vista previa

Guía al usuario a través de las vistas previas de contenido.

Optimización del complemento para el orquestador de Copilot

Microsoft 365 Copilot puede elegir de forma única la aptitud adecuada entre las muchas aptitudes de su repertorio. Pero, ¿cómo puedes asegurarte de que Copilot elegirá tu complemento para proporcionar la aptitud adecuada?

La respuesta radica en cómo se describe el complemento, sus aptitudes y los parámetros para iniciar las aptitudes. Especifique descripciones concisas y precisas en el manifiesto del complemento para asegurarse de que el orquestador de Copilot sabe cuándo y cómo invocar el complemento.

La forma en que describa el complemento en el orquestador depende del tipo de complemento que compile, como se describe en la tabla siguiente.

Tipo de complemento Descrito por Más información
Complementos de API. Descripción de OpenAPI Cómo hacer que un documento de OpenAPI sea eficaz para ampliar Copilot
Acciones de Copilot Studio Nombres y descripciones en Copilot Studio mapa de conversación Orquestación de temas y acciones de copiloto con inteligencia artificial generativa
Complementos de extensiones de mensaje Manifiesto de la aplicación Directrices para complementos de extensión de mensajes

Procedimientos recomendados del complemento

En esta sección se describen los procedimientos recomendados para crear complementos de alta calidad.

Creación de inteligencia artificial responsable y seguridad

  • Anti-Compete: evite usar el nombre de cualquier otro complemento en descripciones cortas y completas.
  • IA responsable: evite el uso de palabras clave inapropiadas o ofensivas.
  • Inyección de mensajes: asegúrese de que el texto no conduce a inyecciones rápidas. Además, las descripciones no deben contener símbolos ni texto que indiquen que se pueden usar como código para la inyección de mensajes. Evite usar frases, funciones y códigos que llamen a una aplicación de forma recursiva.

Compatibilidad con consultas de búsqueda de varios parámetros

Para admitir solicitudes complejas, expanda el ámbito de la compatibilidad con la búsqueda para controlar tres o más consultas parameters de búsqueda simultáneamente habilitando la compatibilidad con varios parámetros en el manifiesto de aplicación del complemento.

Asegúrese de que los parámetros de búsqueda tengan buenas descripciones y tipos de entrada explícitos y formatos de salida.

Evite descripciones genéricas del complemento, sus aptitudes y parámetros

Sea preciso en la descripción de lo que hace y no hace el complemento. Aunque es tentador agregar información adicional para intentar aumentar la probabilidad de que Copilot use un complemento, esto puede dar lugar a las siguientes consecuencias no deseadas:

  • Una descripción genérica del complemento impide que se seleccione el complemento adecuado para el trabajo y, si esto ocurre con frecuencia, el usuario podría deshabilitar el complemento.

  • Cuando se selecciona incorrectamente, es probable que los errores en la ejecución o la respuesta del complemento sean resultados probables. Copilot no mostrará complementos que tengan altas tasas de error, lo que puede afectar a la confianza del usuario.

No suponga que Copilot puede adivinar las entradas necesarias.

Solo en escenarios limitados, Copilot puede adivinar una entrada a un mensaje del usuario. La mayoría de las veces, las entradas necesarias para las consultas de complemento deben indicarse explícitamente en el mensaje del usuario a Copilot. Como procedimiento recomendado, pruebe el complemento con diferentes avisos a Copilot para anticipar el comportamiento esperado.

Validar las operaciones que Copilot puede realizar en términos de razonamiento sobre la respuesta del complemento

Aunque Copilot proporciona funcionalidades básicas para razonar sobre la salida de una respuesta del complemento, los resultados varían en función del escenario. Como procedimiento recomendado, pruebe el complemento con diferentes mensajes que requieren procesamiento posterior para anticipar el comportamiento esperado.

Proporcionar respuestas visualmente enriquecidas a las consultas del usuario

Responda a la entrada del usuario con tarjetas adaptables estructuradas, accionables y visualmente enriquecidas. Asegúrese de que las respuestas de la tarjeta adaptable proporcionan información enriquecida e incluyen al menos un botón de acción y dos elementos adicionales de información (además del logotipo de la aplicación, el título, la miniatura y el título de la información). Puede ser útil proporcionar los atributos buscados con más frecuencia, como el estado, la fecha o la asignación a campos.