Directrices de validación para agentes de Copilot

Importante

• Los complementos para Microsoft 365 Copilot están en versión preliminar y solo funcionan en Microsoft 365 Copilot.
• Los complementos de extensiones de mensaje de Microsoft 365 Copilot están en versión preliminar pública para Microsoft Word y Microsoft PowerPoint.
• La compatibilidad con las aplicaciones cliente de Excel y OneNote estará disponible pronto.
• 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 clientes empresariales con licencias de Microsoft 365 Copilot.
• Si desea configurar un conector de Graph personalizado para Microsoft 365 Copilot, asegúrese de cumplir las directrices para crear o actualizar conectores de Graph.

Esta sección está en línea con el número de directiva de Marketplace comercial de Microsoft 1140.9.

Las aplicaciones deben ser coherentes con las comprobaciones de inteligencia artificial responsables.

Descripción

Una buena descripción ofrece un resumen claro y conciso de las características del agente de Copilot. Mejora el reconocimiento del usuario y permite Microsoft 365 Copilot detectar y ejecutar operaciones de búsqueda de forma eficaz.

Debe asegurarse de cumplir las siguientes directrices para los agentes de Copilot:

• Se aplican las directrices de validación de la Tienda Teams relacionadas con la descripción de la aplicación para aplicaciones de Microsoft 365. Para obtener más información, consulte descripciones de aplicaciones.

• La descripción breve del agente de Copilot, el parámetro, la descripción del comando, la descripción semántica y el identificador de operación no deben incluir:

  • Frases de instrucciones, por ejemplo, "si el usuario dice X", "ignore", "delete", "reset", "new instructions", "Answer in Bold" o "Do not print anything". [Se debe corregir]
  • Direcciones URL, emojis o caracteres ocultos, como símbolos hexadecimales, binarios o no convencionales. [Se debe corregir]
  • Errores de gramática y puntuación. [Se debe corregir]
  • Lenguaje excesivamente detallado, floral o de marketing. [Buena solución]
  • Notificaciones superlativas como "#1", "increíble" o "mejor". [Buena solución]

  Nota:

  • En el caso de los agentes declarativos, las instrucciones de descripción breves también se aplican a los instructions campos y conversation_starters .
  • En el caso de los complementos basados en API, estas directrices se aplican a description_for_human, description_for_model, capabilities, conversation_starters (tanto el título como el texto), states\reasoning\description en functions los campos, si se proporcionan. [Se debe corregir]
  • Al usar los formatos de archivo Swagger o OpenAPI, siga estas directrices para el path contenido asociado a las claves y el description campo de las API GET, POST, PUT o DELETE. [Se debe corregir]

• La descripción larga de la aplicación debe indicar claramente que el agente de Copilot funciona en Microsoft 365 Copilot. Por ejemplo, use Contoso en Microsoft 365 Copilot para buscar y resumir las tareas. [Se debe corregir]

  

  

• La semanticDescription propiedad no es un campo obligatorio. Sin embargo, si agrega semanticDescription en el manifiesto de la aplicación, las comprobaciones de validación existentes para obtener descripciones breves, de parámetros y de comandos también se aplican a las descripciones semánticas.

Volver al principio

Capturas de pantalla

Debe asegurarse de cumplir las siguientes directrices para los agentes de Copilot:

• Las directrices de validación de la Tienda Teams relacionadas con las capturas de pantalla de las aplicaciones de Microsoft 365 son aplicables. Para obtener más información, vea capturas de pantalla.
• Las aplicaciones con la funcionalidad del agente de Copilot deben tener al menos una captura de pantalla relacionada con la funcionalidad de Microsoft 365 Copilot. [Se debe corregir]

Volver al principio

Nombre del agente de Copilot

Debe asegurarse de cumplir las siguientes directrices para los agentes de Copilot:

• Se aplican las directrices de validación de la Tienda Teams relacionadas con el nombre de la aplicación para aplicaciones de Microsoft 365. Para obtener más información, vea Nombre de la aplicación.
• Para el agente declarativo, asegúrese de que los parámetros siguientes son idénticos: [Debe corregir]
  • name en el manifiesto de la aplicación
  • name en declarativeAgent1.json
  • name_for_human en archivos plugin.json

Volver al principio

Expresiones compuestas

Los agentes de Copilot deben admitir al menos tres expresiones compuestas únicas mediante el control de tres o más parámetros.

Volver al principio

Consultas

Debe asegurarse de las siguientes directrices para los avisos de ejemplo y los inicios de avisos.

Solicitudes de ejemplo

La samplePrompts propiedad proporciona instrucciones a los usuarios sobre cómo usar los distintos complementos de Microsoft 365 Copilot.

Las solicitudes de ejemplo se especifican mediante samplePrompts la propiedad en el manifiesto de la aplicación. Estos avisos deben cumplir los siguientes requisitos:

• Un complemento debe tener al menos tres mensajes y un máximo de cinco mensajes para cada comando. [Se debe corregir]
• Cada mensaje no debe superar los 128 caracteres. [Se debe corregir]
• Dos comandos dentro del mismo complemento no deben tener mensajes idénticos. [Se debe corregir]
• Todas las solicitudes de ejemplo deben ser funcionales y devolver respuestas. [Se debe corregir]
• El símbolo del sistema debe ser relevante para los comandos. [Se debe corregir]

Inicios de aviso

Los inicios de aviso guían a los usuarios sobre cómo empezar a usar agentes declarativos. Debe asegurarse de las siguientes directrices para los inicios de aviso:

• Un agente declarativo debe tener al menos tres mensajes y un máximo de seis mensajes. [Se debe corregir]
• Todos los inicios de aviso deben ser funcionales y devolver respuestas. [Se debe corregir]

Volver al principio

Respuesta de tarjeta adaptable

Las respuestas del agente de Copilot proporcionadas como tarjeta adaptable deben cumplir los siguientes requisitos:

• La respuesta de tarjeta adaptable debe incluir contenido de tarjeta adaptable e información de la tarjeta de vista previa como parte de la misma plantilla. [Se debe corregir]

  

• Además del logotipo del agente de Copilot, el título, la miniatura y el título de la información, los datos de la tarjeta adaptable deben representar al menos dos fragmentos de información. Puede identificar los campos de los atributos buscados con más frecuencia, como los datos modificados, el autor, el estado y las marcas. [Se debe corregir]

  

• La tarjeta adaptable debe tener un formato adecuado para los clientes de escritorio, web y móvil (iOS y Android). [Se debe corregir]

• Las tarjetas adaptables deben incluir una dirección URL como parte de los metadatos, lo que permite que las tarjetas se copien fácilmente de un centro a otro. [Se debe corregir]

Volver al principio

Compatibilidad

Los agentes de Copilot deben ser totalmente dinámicos y funcionales en las versiones más recientes de estos clientes: [Se debe corregir]

• Microsoft Teams en escritorio y web
• copilot.microsoft.com en la web
• Microsoft 365 Copilot en Word

Asegúrese de que los complementos de Copilot funcionan en reuniones de Teams

Debe implementar lo siguiente:

• Las tarjetas adaptables no deben mostrar un desplazamiento horizontal. Para evitar desplazamientos horizontales, no especifique un ancho fijo: [Se debe corregir]

  • Conjuntos de columnas

    • No defina ColumnSets con más de tres columnas.
    • No use el ancho de píxel explícito en más de una columna del conjunto.
    • Asegúrese de que la columna no supere un cuarto del ancho de tarjeta más estrecho, como en un chat de reunión o Microsoft 365 Copilot.
    • Por lo general, un ancho explícito no debe superar los 48 píxeles, aunque algunos escenarios podrían permitir excepciones.

  • Ajustar el tamaño de las imágenes

    • Al usar una imagen dentro de una ColumnSet con más de una columna, especifique el tamaño de la columna que contiene una imagen en lugar de la propia imagen.
    • Si la imagen no está en , ColumnSetse recomienda establecer su tamaño auto en o stretch.
    • Si desea definir un ancho explícito en píxeles, asegúrese de que no supere las tres cuartas partes del ancho de la tarjeta más estrecho.
    • Si desea definir el tamaño explícito en píxeles, defínelo para el ancho o el alto. Al establecer el tamaño explícito para cualquier parámetro, se conserva la relación de aspecto de la imagen.
    • Se recomienda establecer el ancho de la imagen, aunque algunos escenarios podrían permitir excepciones.

Para obtener más información sobre cómo crear complementos para reuniones de teams, consulte Habilitación de la extensión de mensajes como complemento para Copilot para reuniones.

Volver al principio

Asegúrese de que los agentes de Copilot funcionan con Microsoft 365- Word, Excel, PowerPoint, OneNote, Office y Copilots de Outlook

Debe asegurarse de cumplir las siguientes directrices para los agentes de Copilot:

1. Si usa una aplicación habilitada para SSO, actualice Microsoft Entra registro de la aplicación: [Se debe corregir]

   Microsoft Entra inicio de sesión único (SSO) para la extensión de mensaje funciona de la misma manera que en Teams o Outlook. Si ha habilitado el inicio de sesión único para la aplicación, agregue el identificador de la aplicación cliente de Copilot de la aplicación de Office al registro de la aplicación Microsoft Entra del bot en el portal de Registros de aplicaciones del inquilino.

   1. Inicie sesión en Azure Portal con su cuenta empresarial de espacio aislado.

   2. Abra Registros de aplicaciones.

   3. Seleccione el nombre de la aplicación para abrir el registro de la aplicación.

   4. En la sección Administrar , seleccione Exponer una API.

   5. En la sección Aplicaciones cliente autorizadas , asegúrese de que aparecen los siguientes valores de identificador de cliente:

      Microsoft 365 aplicación cliente	Id. de cliente
      Word, PowerPoint, Excel (web, escritorio)	3068386c-7a16-4f6a-a664-043b6b232816
      Escritorio de Teams, móvil	1fec8e78-bli4-4aaf-ab1b-5451cc387264
      Web de Teams	5e3ce6c0-2b1f-4285-8d4b-75ee78787346
      Web de Microsoft 365	4765445b-32c6-49b0-83e6-1d93765276ca
      Escritorio de Microsoft 365	0ec893e0-5785-4de6-99da-4ed124e5296c
      Microsoft 365 mobile	d3590ed6-52b3-4102-aeff-aad2292ab01c
      Versión de escritorio de Outlook	d3590ed6-52b3-4102-aeff-aad2292ab01c
      Outlook web	bc59ab01-8403-45c6-8796-ac3ef710b3e3
      Outlook para dispositivos móviles	27922004-5251-4030-b22d-91ecd9a37ea4
      Bing	9ea1ad79-fdb6-4f9a-8bc3-2b70f96e34c7

      Nota:

      Para obtener más información sobre cómo funciona el inicio de sesión único para las extensiones de mensaje, consulte Habilitación del inicio de sesión único para la aplicación.

2. Asegúrese de que el bot registrado está conectado a Microsoft 365 y al canal de Microsoft Teams: [Se debe corregir]

   1. Inicie sesión en Azure Portal con su cuenta empresarial de espacio aislado.
   2. Abra Bot Services.
   3. Seleccione el nombre del bot para actualizar sus canales.
   4. En la sección Configuración , seleccione Canales.
   5. En Canales disponibles, seleccione Microsoft 365 & Microsoft Teams y, a continuación, seleccione Aplicar.

3. Configurar encabezados de directiva de seguridad de contenido [Debe corregir]

   Si el agente de Copilot usa encabezados de directiva de seguridad de contenido (CSP), asegúrese de que todos los siguientes antecesores de marco se incluyen en los encabezados de CSP:

   Aplicación de Microsoft 365	frame-ancestors permiso
   Todos los hosts (nuevo)	*.cloud.microsoft
   Word	fa000000125.resources.office.net
   PowerPoint	fa000000129.resources.office.net
   Excel	fa000000124.resources.office.net
   OneNote	fa000000128.resources.office.net
   Microsoft 365 Copilot y Bing	edgeservices.bing.com, www.bing.com, copilot.microsoft.com
   Aplicación de Microsoft 365	*.microsoft365.com, *.office.com
   Outlook	outlook.office.com, outlook.office365.com, outlook-sdf.office.com, outlook-sdf.office365.com
   Office.com	Office.com/copilot Office.com/chat
   Microsoft365.com	Microsoft365.com/copilot Microsoft365.com/chat
   M365.cloud.microsoft	M365.cloud.microsoft/chat M365.cloud.microsoft/copilot
   Copilot.cloud.microsoft	Copilot.cloud.microsoft

4. Actualización de la versión de Teams JS a la compilación 2.22.0 [Se debe corregir]

   Si usa la versión 2.22 o anterior de Teams JS, actualícela a la versión 2.22 o posterior. 

   Para obtener más información, vea Teams JS Repository @microsoft/teams-js - npm (npmjs.com).

Volver al principio

Requisitos técnicos

Para que un agente de Copilot se valide, invoque y funcione sin problemas, asegúrese de que cumple los siguientes criterios: [Debe corregir]

Criterios	Cumplimiento
Versión del manifiesto	La versión del manifiesto de la aplicación debe ser 1.13 o posterior. [Se debe corregir] Si usa un agente declarativo, debe usar el esquema de manifiesto de aplicación de versión preliminar para desarrolladores públicos. [Se debe corregir]
Tiempo respuesta	El tiempo de respuesta no debe superar los nueve segundos para el 99 por ciento, cinco segundos para el 75 por ciento y dos segundos para el 50 por ciento. [Se debe corregir]
Confiabilidad	Las aplicaciones deben mantener una disponibilidad del 99,9 %. Por ejemplo, si Microsoft 365 Copilot llama a un complemento 1000 veces, debe proporcionar una respuesta significativa 999 veces. [Se debe corregir]
Regresiones cero	Si necesita volver a enviar el agente de Copilot para la validación, la funcionalidad de extensión de mensaje existente que funcionaba anteriormente no debe interrumpirse. Este requisito solo se aplica a aplicaciones de proveedor de software independientes (ISV) y no a aplicaciones creadas para su organización. [Se debe corregir]
Canal de Microsoft 365	Para que los usuarios interactúen con la extensión de mensaje desde Outlook, debe agregar el canal de Microsoft 365 al bot. Para obtener más información, vea Agregar canal de Microsoft 365 para la aplicación. [Se debe corregir]
Inicio de sesión único (SSO)	Si procede, actualice el registro de Microsoft Entra aplicación para el inicio de sesión único. [Se debe corregir]
Directiva de seguridad de contenido (CSP)	Si procede, modifique los encabezados csp y X-Frame-Options de acuerdo con la configuración de los encabezados de directiva de seguridad de contenido. [Se debe corregir]

Volver al principio

Divulgación y confirmación del usuario para escenarios de acción

En escenarios de acción, los agentes de Copilot deben compartir la divulgación del usuario y buscar confirmación del usuario:

• Los datos mostrados en el servicio de terceros (a través del diálogo) deben reflejar la confirmación proporcionada por el usuario. [Se debe corregir]

• El complemento debe compartir una confirmación de la finalización de la acción en forma de tarjeta. [Se debe corregir]

• La acción realizada por un usuario debe reflejarse correctamente en el servicio de terceros. [Se debe corregir]

• Las solicitudes de modificación realizadas por el usuario antes de la confirmación de la acción deben cumplirse. [Se debe corregir]

• No se deben admitir tareas muy consecuentes, como la eliminación masiva. [Buena solución]

• El agente declarativo debe proporcionar mensajes de confirmación alineados con acciones iniciadas por el usuario, con un lenguaje claro que busque explícitamente el permiso del usuario. [Se debe corregir]

  La solicitud de confirmación se puede establecer mediante body la propiedad en el Confirmation objeto del objeto Function capabilities de la función en el manifiesto. Para obtener más información, consulte Personalización del texto de confirmación.

  Ejemplo de paso	Ejemplo de error
  Para una función que busca vales: "¿Desea permitir la búsqueda en Contoso?" "¿Desea permitir la búsqueda de entradas?"	¿Desea continuar?" --> No indica lo que hace la función.
  Para una función que crea un nuevo pedido "¿Desea continuar con la creación de un nuevo pedido?"	Busca vales" -> No busca permiso
  Para una función que crea un nuevo vale: "¿Desea continuar con la creación de un nuevo vale?"	"Crea vales":> no busca permiso

• Para los agentes declarativos, cualquier acción con consecuencias en el sistema externo no debe tener isConsequential la marca establecida como "False". [Se debe corregir]

  Para obtener más información, vea Invalidar el comportamiento de la solicitud.

  Tipo de operación	Acciones	Valor esperado para la isConsequential marca
  Crear	Consiguiente	Verdadero
  Lectura	No consecuente	False o True
  Actualizar	Consiguiente	Verdadero
  Delete	Consiguiente	Verdadero

  Descripción del comando	¿Función consecuente?	Valor esperado para la isConsequential marca
  Devuelve una lista de recomendaciones de búsqueda basadas en el interés del usuario. Si no hay recomendaciones de comillas, cree una nueva.	Yes	Verdadero
  Devuelve una lista de recomendaciones de meditación basadas en las preferencias del usuario.	No	False o True
  Devuelve una lista de recomendaciones de búsqueda basadas en el interés del usuario. Si no hay recomendaciones de comillas, cree una nueva.	Yes	Verdadero

Volver al principio

Requisitos de bot para agentes de motor personalizados

Un agente de motor personalizado es un bot conversacional de Teams que debe cumplir los siguientes requisitos:

1. Un agente de motor personalizado siempre debe contener un bot de conversación basado en modelos de lenguaje grande (LLM) para una interacción fluida del usuario. [Se debe corregir]

2. La declaración de id. de bot como nodo de agente de motor personalizado debe ser la misma que el identificador de bot definido en el nodo bot en el manifiesto de la aplicación. [Se debe corregir]

3. El usuario debe poder hacer referencia al agente de motor personalizado en Microsoft 365 Copilot y experiencia de chat de entrega en Teams. [Buena solución]

4. El bot debe incluir los siguientes componentes de diseño de experiencia de usuario:

   1. Etiqueta de inteligencia artificial que permite a un usuario identificar que el mensaje se generó mediante IA. [Se debe corregir]

   2. Botón de comentarios que permite a un usuario proporcionar comentarios positivos o negativos a los mensajes del agente. [Se debe corregir]

   3. Cita que permite a un usuario hacer referencia al origen del mensaje del bot a través de citas y referencias en texto. [Se debe corregir]

   4. Etiqueta de confidencialidad que permite a un usuario comprender la confidencialidad del mensaje del bot. [Buena solución]

   5. Un agente debe transmitir sus respuestas al usuario. [Se debe corregir]

   6. Un agente debe incluir al menos tres inicios de aviso o un mensaje de bienvenida. [Se debe corregir]

      Para obtener más información, consulte mensajes de bienvenida del bot.

   7. Un bot debe ofrecer al menos dos sugerencias o avisos específicos del contexto al usuario, en lugar de sugerencias genéricas o fijas. [Se debe corregir]

Volver al principio

El agente de Copilot debe tener una acción o un origen de conocimiento

El agente de Copilot debe tener nodos definidos como acciones o conectores de Graph en el manifiesto de la aplicación. Esto garantiza que las respuestas del agente de Copilot se basen en un origen de datos. [Se debe corregir]

Volver al principio

Control de errores correcto

Todos los agentes de Copilot deben controlar correctamente los siguientes escenarios, es decir, el agente debe rechazar la solicitud de usuario y proporcionar una manera de avanzar: [Debe corregir]

• Para parámetros de búsqueda incorrectos

• Por mal uso o lenguaje inadecuado

• Para temas en los que el agente de Copilot no se especializa

  Por ejemplo, un mensaje de error correcto con una forma de avanzar para el agente declarativo:

  

Volver al principio

Requisitos de seguridad para la dirección URL de especificación de OpenAPI

Los agentes de Copilot que usan especificaciones de OpenAPI deben garantizar los siguientes estándares de seguridad:

• Todas las llamadas API deben usar HTTPS con TLS 1.2 o posterior. [Se debe corregir]
• Las llamadas API no deben llevar a ningún redireccionamiento de direcciones URL. Las llamadas API reales se deben atender desde el mismo dominio o subdominio que el dominio raíz comprobado para el desarrollador. [Se debe corregir]

Volver al principio

Vea también

• Directrices de validación de la tienda de Teams
• Directrices para crear y actualizar agentes de Copilot
• Extensión de mensajes basada en bots como complemento para Microsoft 365 Copilot
• Ampliar Microsoft 365 Copilot