Información general de Microsoft 365 Copilot Search API (versión preliminar)

Las API de Microsoft 365 Copilot proporcionan acceso a los componentes que alimentan las experiencias de Copilot. Con estas API, puede mejorar los agentes de motor personalizados y las soluciones de IA generativas con las funcionalidades de Copilot. Copilot Search API permite a los desarrolladores realizar búsqueda híbrida (semántica y léxica) en OneDrive para contenido profesional o educativo mediante consultas de lenguaje natural que entienden el contexto y la intención para devolver documentos y archivos pertinentes. Otros orígenes de datos, como SharePoint, conectores de Copilot, etc., no son compatibles actualmente con Search API, pero se agregarán en futuras versiones. Para obtener más información sobre la indexación semántica, consulte Microsoft 365 Copilot índice semántico.

Search API ofrece una solución simplificada para la detección semántica de documentos sin necesidad de replicar, indexar o administrar los datos en una infraestructura de búsqueda independiente. La API aplica el procesamiento de lenguaje natural para comprender la intención de consulta y realiza una clasificación de resultados inteligente para producir los documentos más relevantes. Lograr esta relevancia es más difícil con los enfoques de búsqueda tradicionales basados en palabras clave.

La búsqueda semántica es esencial cuando se crean soluciones de detección de conocimiento inteligentes y se quiere exponer contenido de Microsoft 365. Al implementar la búsqueda semántica, las soluciones pueden proporcionar una detección de documentos más precisa y contextualmente relevante en el vasto repositorio de datos de la organización. Para ello, search API proporciona archivos pertinentes, vistas previas de archivos y metadatos de archivos de OneDrive para el contenido profesional o educativo. Search API mantiene los datos en su lugar y mantiene los controles de acceso y gobernanza. Search API garantiza que los resultados de la búsqueda estén informados por el contenido más reciente y más relevante. Este proceso mejora la confiabilidad y la utilidad de las aplicaciones de búsqueda personalizadas con tecnología de inteligencia artificial.

Pruebe la primera consulta de Search API en Graph Explorer.

¿Por qué usar Search API?

Search API ofrece una manera segura y compatible de realizar búsqueda híbrida (semántica y léxica) en OneDrive para el contenido profesional o educativo, a la vez que optimiza la relevancia contextual y la comprensión de la intención del usuario. Por lo tanto, no es necesario salir de datos, interrumpir permisos ni poner en peligro la seguridad y el cumplimiento.

Las aplicaciones de búsqueda personalizadas con tecnología de inteligencia artificial pueden usar Search API para detectar documentos almacenados en OneDrive. En lugar de compilar y mantener índices de búsqueda independientes, estas aplicaciones pueden aplicar en su lugar funcionalidades de búsqueda híbrida al contenido de OneDrive para exponer el contenido pertinente de la misma manera que Microsoft 365 Copilot Búsqueda.

Las aplicaciones de conocimiento empresarial que requieren la detección inteligente de documentos pueden usar las funcionalidades de filtrado de la API para limitar las búsquedas a rutas de acceso o carpetas específicas de OneDrive. Este enfoque garantiza que los resultados solo incluyan orígenes aprobados, a la vez que se respetan las barreras de información y los controles de acceso.

Las aplicaciones centradas en documentos pueden combinar la comprensión semántica con el filtrado basado en rutas de acceso para crear experiencias de búsqueda intuitivas que ayuden a los usuarios a encontrar rápidamente los documentos adecuados en función de las descripciones del lenguaje natural en lugar de coincidencias exactas de palabras clave.

Administración de riesgos de cumplimiento y seguridad

Search API usa las características integradas de seguridad y cumplimiento de Microsoft 365 para asegurarse de que se conservan los permisos del origen de datos y la configuración de cumplimiento. Al buscar datos en su lugar, evita las pérdidas de datos y garantiza que la información confidencial solo sea accesible para los usuarios autorizados. Esta funcionalidad es esencial para mantener estándares estrictos de seguridad y cumplimiento. Dentro de una organización, el modelo de permisos de Microsoft 365 garantiza que los usuarios solo puedan obtener resultados del contenido al que pueden acceder.

Solución por relevancia y frescura

Dado que Search API realiza la búsqueda híbrida directamente en el contenido de OneDrive sin duplicación de datos, sus resultados se mantienen actualizados y pertinentes. Elimina la necesidad de mantener infraestructuras de búsqueda independientes y costosas.

Menor costo de propiedad y esfuerzo de desarrollo

Search API elimina la necesidad de crear una canalización segura de exportación de datos e indexación de búsqueda que pueda suponer costos significativos para las organizaciones. La API admite las siguientes funcionalidades necesarias, entre las que se incluyen:

• Búsqueda híbrida (semántica y léxica)
• Procesamiento del lenguaje natural
• Indexación de contenido
• Almacenamiento de datos
• Filtrado basado en rutas de acceso mediante Lenguaje de consulta por palabra clave (KQL)
• Seguridad y cumplimiento

Use estas características integradas para evitar gastos y complejidades, y mantener estrictos controles de acceso y cumplimiento dentro de Microsoft 365.

Licencias

Search API está disponible sin costo adicional para los usuarios con un complemento de licencia de Microsoft 365 Copilot. La compatibilidad con usuarios sin una licencia de complemento de Microsoft 365 Copilot no está disponible actualmente.

Al acceder o usar Microsoft 365 Copilot Search API, acepta los términos de uso de las API de Microsoft 365 Copilot (versión preliminar).

Procedimientos recomendados

Los siguientes procedimientos recomendados se aplican tanto a consultas sin filtrar (consultas sin filterExpressionun ) como a consultas filtradas (consultas con un filterExpressionobjeto ):

• Search API devuelve los resultados ordenados por relevancia.
• Use todos los resultados de búsqueda devueltos por Search API para la detección completa de documentos.
• Evite consultas excesivamente genéricas que puedan aplicarse a una amplia variedad de contenido.
• Proporcione tanto contexto en la consulta como sea posible para una mejor comprensión semántica.
• Haga que su query lenguaje descriptivo y natural se base en.
• Evite errores ortográficos en palabras clave importantes al construir query.

Aplique el procedimiento recomendado siguiente a las consultas filtradas (consultas con ):filterExpression

• Para el path parámetro , use la ruta de acceso completa de OneDrive como se muestra en el panel de detalles del archivo o carpeta (no un vínculo de uso compartido o una dirección del explorador). Por ejemplo: https://contoso-my.sharepoint.com/personal/username_domain_com/Documents/Project/Report.docx.

Ámbito y restricciones actuales

Las siguientes restricciones se aplican actualmente a Search API:

• El query parámetro de solicitud tiene un límite de 1500 caracteres.
• Solo se admite OneDrive para el trabajo o la escuela como origen de datos.
• Solo path se admiten expresiones en filterExpression. Es posible que se admitan más propiedades de Lenguaje de consulta por palabra clave (KQL) en futuras versiones.
• El pageSize parámetro request tiene un valor máximo de 100.
• Se admiten hasta 200 solicitudes por usuario y hora.
• No se admite la búsqueda semántica en contenido notextual, incluidas tablas, imágenes y gráficos.
• No se admite la búsqueda semántica en archivos con extensiones de .docx, .pptx y .pdf de más de 512 MB. No se admite la búsqueda semántica en archivos con cualquier otra extensión de más de 150 MB.
• La búsqueda semántica está disponible en un conjunto de datos personalizado para el contenido de OneDrive, que no incluye todo el contenido en OneDrive del usuario.
• La búsqueda semántica solo está disponible en las siguientes extensiones de archivo: .aspx, .docx, .pptx, .pdf, .onepart, .doc, .html, .eml, .mp4, .loop, .one, .fluid, .png, .jpg, .json, .csv, .xml, .ppt.
• Search API está sujeta a todas las limitaciones del índice semántico Microsoft 365 Copilot.
• Si searchHits en la carga de respuesta está vacía, no se encontraron resultados relevantes.

Paso siguiente

Contenido relacionado

• Pruebe con el Explorador de Graph