Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Las API de Microsoft 365 Copilot proporcionan acceso a los componentes que impulsan las experiencias de Copilot, lo que desbloquea la capacidad de mejorar los agentes de motor personalizados y las soluciones de IA generativas con capacidades de Microsoft 365 Copilot. La API de recuperación de Microsoft 365 Copilot le permite basar sus soluciones de inteligencia artificial generativas con su conocimiento de Microsoft 365 y que no son de Microsoft devolviendo fragmentos de texto pertinentes del índice híbrido que impulsa Microsoft 365 Copilot.
La API de recuperación ofrece una solución simplificada para la generación aumentada de recuperación (RAG) sin necesidad de replicar, indexar, fragmentar y proteger los datos en un índice independiente. La API entiende el contexto y la intención del usuario y realiza transformaciones de consulta para producir los resultados más relevantes, lo que es más difícil de lograr con la búsqueda léxica o incluso con rag básico de orígenes alternativos.
RAG es esencial cuando se crean soluciones de inteligencia artificial generativas y se quiere usar el conocimiento de Microsoft 365. Al implementar RAG, las soluciones pueden proporcionar respuestas más precisas y contextualmente relevantes que se basen en el vasto repositorio de datos de la organización. La API de recuperación logra RAG mediante la extracción de fragmentos de texto actualizados y pertinentes de conectores de SharePoint y Copilot. La API de recuperación mantiene los datos en su lugar y mantiene los controles de acceso y gobernanza. La API de recuperación garantiza que los datos más recientes y más relevantes informan a las respuestas sintetizadas. Este proceso mejora la confiabilidad y la utilidad de las soluciones de IA generativas.
Pruebe la primera consulta de la API de recuperación en el Explorador de Graph.
¿Por qué usar la API de recuperación?
La API de recuperación ofrece una manera segura y compatible de recuperar fragmentos de texto pertinentes de los conectores de SharePoint y Copilot al tiempo que optimiza la recuperación del contexto. Por lo tanto, no es necesario salir de datos, interrumpir permisos ni poner en peligro la seguridad y el cumplimiento.
Las aplicaciones de conocimiento personalizadas pueden usar la API de recuperación para establecer respuestas sobre la información específica de la organización almacenada en conectores de SharePoint y Copilot. En lugar de compilar y mantener índices vectoriales independientes, estas aplicaciones pueden recuperar en su lugar el contexto pertinente de orígenes de datos de Microsoft 365 para poner en marcha respuestas de modelo de lenguaje grande (LLM) de la misma manera que Microsoft 365 Copilot lo hace.
Las aplicaciones financieras y legales que requieren alta precisión en la recuperación de información pueden usar las capacidades de filtrado de la API para limitar las búsquedas a bibliotecas de documentos o tipos de contenido específicos, lo que garantiza que las respuestas solo incluyan orígenes aprobados y respeten las barreras de información y los controles de acceso.
Las aplicaciones de origen múltiple pueden combinar contenido de SharePoint con información de conectores de Microsoft 365 Copilot (anteriormente conectores de Microsoft Graph), creando un knowledge base unificado que abarca tanto microsoft 365 como repositorios de terceros, a la vez que se mantienen controles de seguridad y cumplimiento coherentes.
Imagine una empresa de consultoría especializada en proporcionar soluciones personalizadas para sus clientes, con una parte significativa de su trabajo centrado en los datos almacenados en SharePoint. La firma está desarrollando un agente de motor personalizado para ayudar a sus consultores a preparar reuniones de clientes importantes. Este agente debe tener acceso a la información precisa y actualizada de SharePoint y recuperarla. La firma trabaja con dos clientes principales que son competidores directos en el mercado. Por lo tanto, la empresa tiene una necesidad fundamental de mantener rigurosos estándares de seguridad y cumplimiento para garantizar que los documentos y datos de un cliente nunca sean accesibles para el otro. La API de recuperación ayuda a la empresa a administrar los riesgos de cumplimiento y seguridad y a garantizar la relevancia y la actualización de los datos y, a su vez, simplifica el esfuerzo de desarrollo general.
Administración de riesgos de cumplimiento y seguridad
La API de recuperación 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 recuperar los datos en su lugar, evita las fugas de datos y garantiza que la información confidencial de un cliente nunca sea accesible para otro, lo que 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 la API de recuperación recupera el contexto pertinente sin duplicación de datos, sus resultados se mantienen actualizados y pertinentes, y elimina la necesidad de mantener canalizaciones de datos independientes y costosas.
Menor costo de propiedad y esfuerzo de desarrollo
La API de recuperación elimina la necesidad de crear una canalización segura de exportación e indexación de datos que pueda incurrir en costos significativos para las organizaciones. La API incluye todas las funcionalidades necesarias, entre las que se incluyen:
- Administración del proveedor de búsqueda
- Rastreadores
- Conectores de datos
- Almacenamiento de datos
- Analizadores de contenido
- Indización
- Seguridad
Las organizaciones pueden usar estas características integradas para evitar gastos y complejidades, y mantener estrictos controles de acceso y cumplimiento dentro de Microsoft 365.
Funcionalidades de la API de recuperación
Actualmente, la API de recuperación permite recuperar datos de los siguientes orígenes de datos:
- SharePoint
- Conectores de Copilot
La API admite consultas de lenguaje natural y usa la pila de Microsoft 365 Copilot para recuperar el contexto de conexión a tierra pertinente dentro del límite de confianza de Microsoft 365. Puede usar la API para limitar la recuperación mediante lenguaje de consulta de palabras clave (KQL) para recuperar del contenido más importante para su caso de uso. Con KQL, puede filtrar por direcciones URL, intervalos de fechas, tipos de archivo, etc.
Licencias
La API de recuperación está disponible sin costo adicional para los usuarios con una licencia de Microsoft 365 Copilot. La compatibilidad con usuarios sin una licencia de Microsoft 365 Copilot no está disponible actualmente.
Procedimientos recomendados
Los siguientes procedimientos recomendados son aplicables tanto a consultas sin filtrar (consultas sin filterExpression) como a consultas filtradas (consultas con filterExpression):
- Los resultados y los extractos devueltos por la API de recuperación no están ordenados. Por este motivo, se recomienda no limitar el valor maximumNumberOfResults a menos que tenga requisitos estrictos para cuántos tokens puede consumir el LLM.
- Envíe todos los extractos devueltos por la API de recuperación a su LLM/orchestrator para la generación de respuestas.
- Evite consultas genéricas que puedan aplicarse a una amplia variedad de contenido.
- Proporcione tanto contexto en la consulta como sea posible.
- QueryString debe ser una sola oración.
- Evite errores ortográficos en palabras clave enriquecidas en contexto al construir queryString.
Aplique el procedimiento recomendado siguiente a las consultas filtradas (consultas con filterExpression):
- Si desea filtrar con el parámetro path en SharePoint, no use un vínculo de uso compartido ni copie la dirección URL de la barra de direcciones. En su lugar, vaya a la ubicación de la carpeta o archivo en SharePoint y elija los tres puntos para abrir Más acciones. Desplácese hacia abajo en el panel y elija Detalles. Desde allí, puede desplazarse hacia abajo por el riel derecho para buscar y copiar la ruta de acceso.
Limitaciones conocidas
A continuación se muestran las limitaciones actuales y otras limitaciones de la API de recuperación:
- Necesita los permisos Files.Read.All y Sites.Read.All para recuperar contenido de SharePoint mediante la API de recuperación.
- Necesita el permiso ExternalItem.Read.All para recuperar el contenido de los conectores de Copilot mediante la API de recuperación.
- La API de recuperación está optimizada para la recuperación de contexto.
- El parámetro de solicitud queryString tiene un límite de 1500 caracteres.
- Debe recuperar de un origen de datos a la vez mediante el parámetro de solicitud dataSource . No se admiten los resultados intercalados.
- Si el parámetro de solicitud filterExpression tiene una sintaxis KQL incorrecta, la consulta se ejecuta correctamente sin ámbito.
- No todas las propiedades de SharePoint se admiten en filterExpression. Consulte la referencia de API para ver la lista completa de propiedades admitidas.
- El parámetro de solicitud maximumNumberOfResults tiene un valor máximo de 25.
- Se admiten hasta 200 solicitudes por usuario y hora.
- No se admite la recuperación de contenido notextual, incluidas tablas, imágenes y gráficos.
- No se admiten los resultados de archivos con extensiones de .docx, .pptx y .pdf de más de 512 MB. No se admiten los resultados de archivos con cualquier otra extensión de más de 150 MB.
- Si retrievalHits en la carga de respuesta está vacío, no se encontraron resultados relevantes.