Configuración de conectores de Microsoft Graph en el Centro de administración de Microsoft 365

En este artículo se muestra el proceso básico necesario para configurar conectores de Microsoft Graph en el Centro de administración de Microsoft 365. El proceso básico incluye los pasos siguientes: (Vamos a intentar que este contenido sea más dinámico).

Nota:

El proceso de instalación es similar para todos los conectores de Microsoft Graph, pero no es exactamente el mismo. Además de leer este artículo, asegúrese de leer la información específica del conector para el origen de datos.

Paso 1: Agregar un conector de Microsoft Graph en el Centro de administración de Microsoft 365

Complete los pasos siguientes para configurar cualquiera de los conectores de Microsoft Graph (o haga clic aquí para acceder directamente al catálogo de conectores):

1. Inicie sesión en la cuenta de administrador en el Centro de administración de Microsoft 365.

2. En el panel de navegación, seleccione Configuración y, a continuación, seleccione Buscar & inteligencia. Seleccione la pestaña Orígenes de datos.

3. Seleccione +Agregar y, a continuación, seleccione el origen de datos de su elección en el menú de opciones disponibles.

   

Nota:

Puede agregar un máximo de treinta (30) conexiones de Microsoft Graph a cada inquilino.

Sugerencia

Encuesta de productos

Para ayudarnos a comprender sus requisitos relacionados con la conexión de más orígenes de datos a Copilot o Microsoft Search, le pedimos que dedique unos minutos a rellenar este formulario de encuesta. En función de los resultados de la encuesta, Microsoft compilará conectores para los orígenes de datos más demandados.

Paso 2: Asignar un nombre a la conexión

Especifique estos atributos:

• Name (obligatorio)
• Identificador de conexión (obligatorio)
• Descripción (opcional)
• Active la casilla (obligatorio)

El identificador de conexión crea propiedades implícitas para el conector. Solo debe contener caracteres alfanuméricos y tener un máximo de 32 caracteres.

Para ayudar a administrar mejor la conexión y ayudar a Copilot a mejorar los resultados de la conexión para el usuario, la descripción debe responder brevemente a las siguientes preguntas:

• ¿Qué tipo de contenido tiene esta conexión?
• ¿Cómo hacen referencia los usuarios a este origen de contenido en sus respectivas organizaciones?
• ¿Qué parte del flujo de trabajo hacen referencia a este contenido en su trabajo diario?
• ¿Cuáles son algunas características del contenido?

Para obtener más información, consulte el artículo Mejora de la detección de Microsoft Copilot con el contenido del conector de Graph.

Paso 3: Configurar las opciones de conexión

El proceso para configurar las opciones de conexión varía en función del tipo de origen de datos. Para ver el tipo de origen de datos que se va a agregar al inquilino para completar este paso en el proceso de instalación, consulte la información específica del conector.

Para más información sobre cómo conectarse a un origen de datos local, consulte Configuración del agente del conector de Microsoft Graph.

Paso 4: Seleccionar propiedades

Puede elegir las propiedades indizadas por Microsoft Search.

Nota:

Para actualizar las propiedades rastreadas después de crear una conexión, consulte el artículo Administrar esquema de búsqueda .

Paso 5: Administrar permisos de búsqueda

Las listas de control de acceso (ACL) determinan qué usuarios de su organización pueden acceder a cada elemento.

Algunos conectores, como Microsoft SQL y Azure Data Lake Storage Gen2 admiten de forma nativa Microsoft Entra ID ACL.

Otros conectores como ServiceNow Knowledge, ServiceNow Catalog, Azure DevOps Work Items y Salesforce admiten la sincronización de usuarios y grupos que no son de Azure AD.

La selección de todos permite a todos los usuarios de su organización ver los resultados de búsqueda de este origen de datos.

Paso 6: Asignar etiquetas de propiedad

Puede asignar etiquetas semánticas a las propiedades de origen en la página "Asignar etiquetas de propiedad". Las etiquetas son etiquetas conocidas proporcionadas por Microsoft que proporcionan significado semántico. Permiten a Microsoft integrar los datos del conector en experiencias de Microsoft 365, como búsqueda mejorada, tarjetas de personas, detección inteligente, etc.

En la tabla siguiente se enumeran las etiquetas admitidas actualmente y sus descripciones.

Etiqueta	Descripción
title	Título del elemento que desea que se muestre en la búsqueda y otras experiencias
url	Dirección URL de destino del elemento en el sistema de origen
Creado por	Nombre de la persona que creó el elemento
Última modificación	Nombre de la persona que editó el elemento más recientemente
Authors	Nombre de las personas que participaron o colaboraron en el elemento
Fecha y hora de creación	Hora en que se creó el elemento
Fecha de la última modificación	Hora en que se editó el elemento más recientemente
Nombre de archivo	Nombre del elemento de archivo
Extensión de archivo	Tipo de elemento de archivo, como .pdf o .word

Las propiedades de esta página se seleccionan previamente en función del origen de datos, pero puede cambiar esta selección si hay una propiedad diferente que sea más adecuada para una etiqueta determinada.

El título de la etiqueta es la etiqueta más importante. Se recomienda encarecidamente que tenga una propiedad asignada a esta etiqueta para que la conexión participe en la experiencia del clúster de resultados.

La asignación incorrecta de etiquetas provoca una experiencia de búsqueda deteriorada. Está bien que algunas etiquetas no tengan una propiedad asignada.

Paso 7: Administrar esquema

Content (propiedad)

Se recomienda seleccionar una propiedad de contenido en el menú desplegable de opciones o mantener el valor predeterminado si está presente. Esta propiedad se usa para la indexación de texto completo del contenido, la generación de fragmentos de código de página de resultados de búsqueda, la participación del clúster de resultados , la detección de idioma, la compatibilidad con HTML/texto, la clasificación y la relevancia, y la formulación de consultas.

Si selecciona una propiedad de contenido, tiene la opción de usar la propiedad generada por el sistema ResultSnippet al crear el tipo de resultado. Esta propiedad actúa como marcador de posición para los fragmentos de código dinámicos que se generan a partir de la propiedad de contenido en tiempo de consulta. Si usa esta propiedad en el tipo de resultado, los fragmentos de código se generan en los resultados de la búsqueda.

Alias para propiedades de origen

Puede agregar alias a las propiedades en la columna "Alias" de la página "Administrar esquema". Los alias son nombres descriptivos para las propiedades. Se usan en consultas y en la creación de filtros. También se usan para normalizar las propiedades de origen de varias conexiones de modo que tengan el mismo nombre. De este modo, puede crear un único filtro para un vertical con varias conexiones. Para obtener más información, vea Personalizar la página de resultados de búsqueda.

Atributos de esquema de búsqueda

Puede establecer los atributos del esquema de búsqueda para controlar la funcionalidad de búsqueda de cada propiedad de origen. Un esquema de búsqueda ayuda a determinar qué resultados se muestran en la página de resultados de búsqueda y qué información pueden ver y acceder los usuarios finales.

Los atributos de esquema de búsqueda incluyen opciones para consultar, buscar, recuperar y refinar. En la tabla siguiente se enumeran cada uno de los atributos que admiten los conectores de Microsoft Graph y se explican sus funciones.

Atributo de esquema de búsqueda	Función	Ejemplo
BUSCAR	Hace que el contenido de texto de una propiedad pueda buscarse. El contenido de la propiedad se incluye en el índice de texto completo.	Si la propiedad es title, una consulta de Enterprise devuelve respuestas que contienen la palabra Enterprise en cualquier texto o título.
CONSULTA	Busca por consulta una coincidencia de una propiedad determinada. A continuación, el nombre de la propiedad se puede especificar en la consulta mediante programación o textual.	Si se puede consultar la propiedad Title , se admite la consulta Title: Enterprise .
RECUPERAR	Solo se pueden usar propiedades recuperables en el tipo de resultado y mostrarse en el resultado de la búsqueda.
REFINAR	La opción refinar se puede usar como en la página de resultados de Búsqueda de Microsoft.	Los usuarios de su organización pueden filtrar por dirección URL en la página de resultados de búsqueda si la propiedad refine está marcada durante la configuración de la conexión.

Para todos los conectores excepto el conector de recurso compartido de archivos, los tipos personalizados se deben establecer manualmente. Para activar las funcionalidades de búsqueda de cada campo, necesita un esquema de búsqueda asignado a una lista de propiedades. La configuración de conexión asistente selecciona automáticamente un esquema de búsqueda basado en el conjunto de propiedades de origen que elija. Para modificar este esquema, active las casillas de cada propiedad y atributo de la página de esquema de búsqueda.

Restricciones y recomendaciones para la configuración del esquema de búsqueda

• La propiedad de contenido solo se puede buscar. Después de seleccionarla en la lista desplegable, esta propiedad no se puede usar con las opciones recuperar o consultar.

• Se producen problemas de rendimiento significativos cuando los resultados de la búsqueda se representan con la propiedad de contenido . Un ejemplo es el campo Contenido de texto de un artículo de base de conocimiento de ServiceNow .

• Solo las propiedades marcadas como representación recuperable en los resultados de búsqueda y se pueden usar para crear tipos de resultados modernos (MRT).

• Solo las propiedades de cadena se pueden marcar como búsquedas.

Nota:

Para actualizar el esquema después de crear una conexión, consulte el artículo Administrar esquema de búsqueda .

Paso 8: Actualizar configuración

El intervalo de actualización determina la frecuencia con la que se sincronizan los datos entre el origen de datos y Microsoft Search. Cada tipo de origen de datos tiene un conjunto diferente de programaciones de actualización óptimas en función de la frecuencia con la que se modifican los datos y el tipo de modificaciones.

Hay dos tipos de intervalos de actualización: Actualización completa y Actualización incremental, pero las actualizaciones incrementales no están disponibles para algunos orígenes de datos.

Con una actualización completa, el motor de búsqueda procesa e indexa los elementos que han cambiado en el origen de contenido, independientemente de los rastreos anteriores. Una actualización completa funciona mejor para estas situaciones:

• Detección de eliminaciones de datos.
• La actualización incremental encontró errores y produjo un error.
• Se modificaron las ACL.
• Se modificaron las reglas de rastreo.
• Se ha actualizado el esquema de la conexión.

Con una actualización incremental, el motor de búsqueda puede procesar e indexar solo los elementos que se crearon o modificaron desde el último rastreo correcto. Como resultado, no todos los datos del origen de contenido se vuelven a indexar. Las actualizaciones incrementales funcionan mejor para detectar contenido, metadatos y otras actualizaciones.

Nota:

Los rastreos incrementales no admiten actualmente el procesamiento de actualizaciones de permisos.

Las actualizaciones incrementales son mucho más rápidas que las actualizaciones completas porque no se procesan los elementos sin cambios. Sin embargo, si decide ejecutar actualizaciones incrementales, deberá ejecutar actualizaciones completas periódicamente para mantener la sincronización de datos correcta entre el origen de contenido y el índice de búsqueda.

Programación de rastreo

Puede configurar rastreos completos e incrementales en función de las opciones avanzadas de programación presentes en la página Actualizar configuración. Algunos conectores no admiten rastreos incrementales y la opción para configurar rastreos incrementales no estará disponible para esos conectores. Para otros, el rastreo incremental es un rastreo opcional y está habilitado de forma predeterminada. De forma predeterminada, se selecciona una programación de rastreo en función del tipo de conector. Esta configuración predeterminada se puede cambiar durante la creación o edición de la conexión después de publicar una conexión desde el flujo "Editar" de una conexión. Puede elegir entre estos campos:

• Periodicidad: puede optar por ejecutar los rastreos cada día, semana, segunda o cuarta semana.
• Día(s): esta opción está habilitada cuando elige ejecutar rastreos solo en días específicos de la semana.
• La casilla Ejecutar una vez al día le permite elegir la hora de inicio del rastreo en un día. Si no está seleccionado, los rastreos se repetirán en un día de forma predeterminada. Puede elegir el intervalo de repetición en la lista desplegable.
• Frecuencia: seleccione esta opción si desea repetir rastreos en un día después de determinados intervalos de tiempo. La frecuencia de repetición más pequeña es de 15 minutos y la mayor es de 12 horas.
• Hora de inicio: seleccione la hora a la que desea que se inicie el rastreo.
• Restablecer: esto restablecerá la programación a la programación predeterminada del conector.

Estos son algunos puntos a tener en cuenta al configurar la programación de rastreo:

• Si deja alguno de los campos vacíos o no seleccionados, los conectores de Graph elegirán el mejor momento para iniciar un rastreo. Por ejemplo, si elige una periodicidad de rastreo como "Día" y no selecciona la hora de inicio, los conectores de Graph elegirán la hora en función del último rastreo para iniciar el nuevo rastreo. Si no desea especificar una hora de inicio del rastreo, se recomienda permitir que el conector decida cuándo iniciar el rastreo.
• Incluso si se menciona la hora de inicio, el inicio del rastreo puede retrasarse una hora. Esto puede deberse a motivos como la carga de red, etc.
• Si el rastreo anterior se satura a la hora del siguiente rastreo, no se detiene el rastreo en curso y se pone en cola el siguiente rastreo. Una vez completado el rastreo en curso, ejecutamos el rastreo en cola solo si es de un tipo diferente (completo o incremental) que el rastreo anterior. Por ejemplo, si un rastreo incremental satura el siguiente rastreo completo, no suspenderemos el rastreo incremental y poneremos en cola el rastreo completo. Después de completar el rastreo incremental, dado que el rastreo en cola es de otro tipo (completo), iniciaremos el rastreo completo inmediatamente.

Estos son algunos de los escenarios:

• Ejecución del rastreo incremental diario después de cada 15 minutos

Aquí, al seleccionar la casilla "Ejecutar una vez al día", podrá elegir la "Hora de inicio" para ejecutar el rastreo incremental solo una vez al día a partir de la hora especificada. Sin embargo, al anular la selección, podrá elegir la frecuencia de repeticiones de rastreo en un día. Si desea que los datos se actualicen continuamente, puede optar por ejecutar rastreos incrementales con frecuencia en un día. Pero si el número de elementos del origen de datos es grande y los rastreos tienden a ser más largos, o si no se necesitan actualizaciones frecuentes para el contenido, puede elegir el rastreo incremental para que se ejecute una vez al día.

• Ejecute el rastreo incremental cada semana los miércoles, sábados y domingos repitiendo cada 15 minutos y a partir de la 1:00 a.m.

• Ejecutar rastreo completo todos los días a la 1:00 AM

• Ejecutar rastreo completo cada semana el viernes a las 8:00 p.m.

Paso 9: Revisión de la conexión

Puede revisar toda la configuración y editar la configuración según sea necesario antes de completar la conexión. Asegúrese de leer la información específica del conector para el origen de datos si aún no lo ha hecho. Cuando esté listo para completar la conexión, seleccione Publicar.

Lanzamiento preconfigurado

El lanzamiento provisional es una característica que le permite introducir gradualmente conectores de Microsoft Graph a un grupo selecto de usuarios en el entorno de producción. Seleccione Publicar en usuarios limitados para implementar el conector en una audiencia limitada. Para obtener más información, vea Lanzamiento provisional para conectores de Microsoft Graph.

Paso 10: Administrar los resultados de la conexión

Los resultados de la conexión se incluirán en la vertical Todo de forma predeterminada después de su publicación. Si no desea que los resultados de la conexión estén disponibles inmediatamente en Todo después de que se haya publicado, puede optar por no participar en este paso.

Paso 11: Personalizar la página de resultados de búsqueda

Después de publicar la conexión, es posible que desee personalizar la página de resultados de búsqueda con verticales y tipos de resultados. Para obtener información sobre cómo personalizar los resultados de la búsqueda, revise cómo administrar los tipos de resultados y verticales.

Paso 12: Confirmar si la configuración de conexión funcionó

Vaya a la lista de las conexiones publicadas en la pestaña Conectores del Centro de administración. Para obtener información sobre cómo realizar actualizaciones y eliminaciones, consulte Supervisión de las conexiones.

Solución de problemas

Lea la información específica del conector para el origen de datos.

Nota:

Actualmente, no todos los artículos específicos del conector incluyen recomendaciones de solución de problemas.

Limitaciones

Para obtener información sobre las limitaciones que se aplican a todos los orígenes de datos, consulte el artículo Información general de los conectores de Microsoft Graph .

Consulte la información específica del conector del origen de datos para averiguar si se aplican otras limitaciones a ese conector de Microsoft Graph concreto.