Compartir a través de

Introducción al SDK de conectores de Microsoft Graph

  • Artículo

El SDK de conectores de Microsoft Graph simplifica el proceso de creación de conectores resistentes, eficientes y de alta calidad para un origen de datos que no tiene un conector precompilado, pero que desea indexar en Microsoft Graph.

El SDK incluye los componentes de marco y contrato para ayudarle a escribir el código y las herramientas para probar el código.

El SDK de conectores permite crear conectores personalizados de Microsoft Graph directamente en el entorno de desarrollo integrado (IDE) de Visual Studio. Proporciona todo lo necesario para compilar, depurar e implementar el conector personalizado.

Los elementos ingeridos a través de conexiones compiladas con el SDK consumen la cuota de elementos. Para obtener más información sobre cómo determinar la cuota de artículos que tiene y cómo comprar más cuota, consulte Requisitos y precios de licencias.

Componentes

El SDK de conectores incluye los siguientes componentes:

  • Plantilla de conector personalizada: si desea desarrollar el conector personalizado en C#, puede descargar la plantilla de Visual Studio Marketplace y empezar a trabajar rápidamente. También puede elegir desarrollar el conector personalizado en cualquiera de los idiomas de esta lista.

  • Contratos: los contratos son archivos de búfer de protocolo gRPC que contienen los contratos para la interacción entre la plataforma microsoft (agente del conector de Microsoft Graph) y el código del conector personalizado.

  • Agente del conector de Microsoft Graph: componente de software ligero que administra las capacidades del conector y las coordenadas entre el Centro de administración de Microsoft 365 y el código del conector personalizado.

    Descargue la versión más reciente del agente del conector y ejecute la configuración de instalación asistente. Para obtener más información, consulte Agente del conector de Microsoft Graph.

  • Utilidad de prueba del SDK de conectores: incluye escenarios de prueba precompilados que puede usar para probar el código de conector personalizado y comunicarse con la plataforma del agente del conector.

Funcionalidades del agente del conector de Microsoft Graph

El agente del conector se basa en la misma plataforma de conector sólida que se usa para ejecutar los conectores integrados de Microsoft.

Incluye las siguientes funcionalidades:

  • Obtener datos del conector: el agente puede conectarse al conector personalizado para obtener datos del origen mediante la lógica implementada por el conector.

  • Centro de administración de Microsoft 365 integración: el agente le permite configurar, administrar y supervisar los conectores personalizados a través de la Centro de administración de Microsoft 365.

  • Programación y administración de rastreo: el agente es capaz de rastrear el origen de datos a través de rastreos completos y rastreos incrementales. Los rastreos completos (basados en listas o basados en Microsoft Graph) recorren todos los datos periódicamente en un intervalo definido por usted. Los rastreos incrementales son más frecuentes y rastrean el origen de datos de la marca de tiempo o punto de comprobación anterior en un intervalo definido por usted.

  • Eliminación, diferencia y detección de ciclo: el agente es capaz de detectar elementos eliminados del origen de datos en función de los elementos enviados por el conector durante rastreos completos periódicos. A continuación, el agente se encarga de eliminar el elemento del índice de Microsoft.

    El agente también detecta elementos que han cambiado desde el último rastreo calculando un hash del elemento y comparándolo con el hash del elemento visto anteriormente. Para que los rastreos sean más rápidos, el agente envía los datos que se van a indexar solo cuando cambia el elemento.

    El agente también detecta elementos duplicados que surgen de orígenes de datos que tienen elementos vinculados (como sitios web) y omite el rastreo de estos elementos.

  • Asignación de identidades: el agente del conector permite la marcación de Access Control Listas (ACL) en los datos para habilitar el recorte de seguridad. Puede habilitar el recorte de seguridad en función de Microsoft Entra ID o ACL del origen de datos.

  • Ingesta de Microsoft Graph: el agente ingiere los datos en Microsoft Graph después de recibirlos desde el conector personalizado.

Nota:

Las siguientes funcionalidades no están disponibles actualmente:

  • Recorrido del origen de datos basado en grafos durante los rastreos; por ejemplo, recorrer las estructuras de carpetas.
  • La capacidad de administrar los permisos de búsqueda en función del control de acceso desde el origen de datos.

Puede empezar a trabajar en C# con nuestros conectores de ejemplo o en otros lenguajes admitidos mediante los contratos de la página del SDK de conectores de Microsoft Graph en GitHub.

Pasos siguientes