Uso de la API de conectores de Copilot

Puede usar conectores de Microsoft 365 Copilot (anteriormente conectores de Microsoft Graph) para traer datos de servicios externos a Microsoft Graph. La API de conectores de Copilot permite indexar datos externos con el fin de potenciar experiencias inteligentes en Microsoft 365, como Copilot y Microsoft Search.

Las solicitudes a los datos de índice se realizan en nombre de una aplicación sin la presencia de un usuario que ha iniciado sesión a través de un token de acceso con permiso de aplicación.

Compilación de un conector de Copilot personalizado

La creación de un conector copilot personalizado implica cuatro pasos:

1. Cree un registro de aplicaciones de Entra ID (anteriormente conocido como Azure Active Directory). Junto con la solicitud a Microsoft Graph, envía el nombre del registro de la aplicación y los permisos de API que necesita la aplicación. Microsoft Graph responde con información sobre el registro de la aplicación recién creada.
2. Cree una conexión externa. Cada conexión requiere un identificador, un nombre y una descripción únicos.
3. Cree el esquema para la conexión externa. El esquema define la forma de contenido externo que se va a ingerir a través de esta conexión de Microsoft Graph. La creación del esquema es una operación de ejecución prolongada. Después de enviar el esquema para crear la conexión, Microsoft Graph responde con una dirección URL que puede usar para comprobar el estado de la operación. El esquema se aprovisiona siempre que el estado de la operación sea inprogress. Cuando se complete el aprovisionamiento, la operación devolverá un completed estado.
4. Ingerir contenido externo. Para cada elemento externo, extráigalo del repositorio de contenido de origen, transfórelo para que coincida con el esquema de la conexión externa y envíelo a Microsoft Graph como un elemento externo. Junto con el elemento, incluya información sobre quién puede acceder a él, también conocida como lista de control de acceso (ACL).

A continuación se muestra un diagrama de secuencia que muestra los cuatro pasos para crear un conector de Copilot.

Casos de uso comunes

En la tabla siguiente se enumeran los casos de uso comunes para la API de conectores de Copilot.

Limitaciones conocidas

A continuación las limitaciones conocidas actuales:

• Una aplicación está limitada a 25 operaciones simultáneas en una conexión.
• El tamaño máximo de un externalItem entidad es 4 MB.

Contenido relacionado

• Introducción a los conectores de Copilot