Introducción a las API de Microsoft 365 Copilot

Las API de Microsoft 365 Copilot le permiten acceder de forma segura a las funcionalidades de Microsoft 365 Copilot en sus propias aplicaciones y agentes de motor personalizados, a la vez que se alinean con los estándares de cumplimiento de Microsoft 365. Tanto si está creando un agente de motor personalizado para Microsoft 365 Copilot con sus propios modelos u orquestador o una experiencia conversacional en sus propias aplicaciones, las API de Copilot proporcionan acceso a los componentes que impulsan las experiencias de Microsoft 365 Copilot.

Los desarrolladores empresariales se enfrentan a un desafío crítico hoy en día: cómo aprovechar el poder de la IA mientras se mantiene un acceso seguro al conocimiento de la organización, sin comprometer el cumplimiento o la gobernanza. Los enfoques tradicionales le obligan a crear sistemas de IA complejos desde cero y extraer datos confidenciales en fuentes externas. Las API de Microsoft 365 Copilot ofrecen acceso a funcionalidades de inteligencia artificial listas para producción que funcionan directamente con sus datos de Microsoft 365.

Al obtener acceso o usar las API de Microsoft 365 Copilot, acepta los Términos de uso de las API de Microsoft 365 Copilot (versión preliminar).

Sugerencia

¿Quiere explorar las API antes de escribir código? Pruebe la demostración interactiva para ver solicitudes y respuestas de API en directo con sus datos de Microsoft 365.

Funcionalidades de la API de Copilot

Las API de Copilot proporcionan un conjunto completo de funcionalidades que le permiten crear aplicaciones con tecnología de IA basadas en datos empresariales.

En la tabla siguiente se enumeran las API y se describen sus funcionalidades y escenarios.

API Úselo para Escenario de ejemplo
API de recuperación Recupere información relevante del contenido de Microsoft 365 de forma segura y compatible. Conecte sus propios modelos de IA al contenido de Microsoft 365 sin extraer datos. Cree asistentes especializados que respondan en función de la documentación, las directivas y las bases de conocimiento actualizadas de su organización. Estas aplicaciones pueden proporcionar información contextualmente relevante a los usuarios de todos los departamentos respetando los controles de acceso a documentos y las etiquetas de confidencialidad.
Buscar API (versión preliminar) Realice una búsqueda híbrida (semántica y léxica) en todo el contenido profesional o educativo de OneDrive mediante consultas de lenguaje natural con comprensión contextual y resultados inteligentes. Cree aplicaciones de búsqueda con tecnología de IA que ayuden a los usuarios a descubrir documentos y archivos relevantes mediante consultas en lenguaje natural en lugar de coincidencias exactas de palabras clave, a la vez que mantiene la seguridad y el cumplimiento.
API de exportación de interacción Habilite las soluciones de cumplimiento para capturar y archivar las interacciones de los usuarios con Copilot en las aplicaciones de Microsoft 365. Desarrolle sistemas que mantengan registros completos de las interacciones de IA, permitan la supervisión del uso de IA y garanticen el cumplimiento de las directivas organizativas y los requisitos normativos. Estas soluciones son valiosas para las industrias reguladas donde es necesario documentar y revisar la generación de contenido asistido por IA.
API de notificaciones de cambio de interacciones de IA (versión preliminar) Suscríbase para cambiar las notificaciones de las interacciones de Copilot en Microsoft 365. Cree aplicaciones que supervisen y registren las interacciones de IA en tiempo real, lo que permite realizar comprobaciones proactivas de cumplimiento, detección de anomalías y auditorías.
API de conclusiones de la reunión Extraiga notas de reunión, elementos de acción y temas de debate generados por IA para las reuniones de Teams. Cree aplicaciones que extraigan y organicen automáticamente elementos de acción, decisiones y resúmenes de las reuniones de Teams. Vincúlalos con herramientas de administración de proyectos, sistemas CRM o flujos de trabajo personalizados. Estos sistemas pueden transformar las reuniones del tiempo dedicado al valor creado mediante la captura, organización y activación automática de los resultados de las reuniones.
Conclusiones de IA API de notificaciones de cambio (versión preliminar) Suscríbase a las notificaciones de cambios para las Conclusiones de IA de Copilot sobre las reuniones de Teams. Cree aplicaciones que usen reuniones de Teams con Conclusiones de IA, lo que garantiza una captura coherente de detalles clave y promueve la alineación.
API de chat (versión preliminar) Habilite experiencias conversacionales con tecnología de Microsoft 365 Copilot en sus aplicaciones personalizadas. Integre Microsoft 365 Copilot en sus aplicaciones empresariales que puedan responder preguntas, realizar tareas y proporcionar instrucciones basadas en los datos de Microsoft 365 y el contexto del usuario. Estas interfaces pueden mejorar la productividad del usuario al incorporar las capacidades de IA directamente en las herramientas que usan todos los días, desde portales personalizados hasta aplicaciones móviles.
API de informes de uso de Copilot Consulte los recuentos de usuarios y los datos de uso de Microsoft 365 Copilot en su organización. Cree informes para realizar un seguimiento de la adopción de Microsoft 365 Copilot por parte de los usuarios.
API de administración de paquetes Ver y administrar agentes en toda la organización. Cree un inventario de todos los agentes de su organización.

Nota:

La API de Chat devuelve respuestas textuales; responde preguntas y proporciona instrucciones, pero no realiza acciones como crear archivos, enviar correos electrónicos o programar reuniones. Para obtener más información, consulte las limitaciones conocidas de la API de Chat.

Ventajas principales

Las API de Copilot proporcionan las siguientes ventajas para sus aplicaciones:

  • Conexión a tierra, gobernanza y cumplimiento seguros: acceda directamente al índice de conocimiento de Microsoft 365. Todos los permisos, etiquetas de confidencialidad, controles de cumplimiento, auditoría, registro, supervisión y aplicación de directivas existentes se respetan automáticamente. Para obtener más información sobre el modelo de seguridad y autenticación, consulte Seguridad y autenticación para las API de Microsoft 365 Copilot.
  • IA lista para producción: acelere el desarrollo de sus canalizaciones de recuperación personalizadas de generación aumentada (RAG) y el procesamiento de transcripción de reuniones mediante las mismas capacidades de IA de nivel de producción que impulsan Microsoft 365 Copilot. Tanto si desarrolla sus soluciones con Fundición de IA de Azure, Microsoft Copilot Studio o el SDK de Microsoft Agents, las API de Copilot están perfectamente integradas en la plataforma.
  • IA responsable : al usar Copilot y estas experiencias inteligentes, estará protegido contra contenido perjudicial mediante comprobaciones de validación RAI.

Requisitos

Para integrar y desbloquear todo el potencial de las API de Copilot en sus aplicaciones y agentes de motor personalizados, necesita acceso a lo siguiente:

  • Licencia de Microsoft 365 Copilot: necesaria para cada usuario que accede a la funcionalidad de Microsoft 365 Copilot a través de estas API. Esta licencia proporciona acceso a las capacidades de inteligencia artificial que impulsan las API.

  • Suscripción a Microsoft 365: una suscripción al plan E3 o E5 (o equivalente) es la base de Microsoft 365 Copilot. Esta suscripción proporciona acceso a los servicios y datos de Microsoft 365 en los que se basa Copilot.

Del registro de la aplicación al cliente de API

La compilación de un agente o una aplicación para Microsoft 365 sigue una cadena que conecta el modelo de aplicación a las API de Copilot:

  1. Cree un paquete de aplicación : el conjunto de manifiestos, iconos y metadatos definidos por el modelo de aplicación de Microsoft 365.
  2. Como parte de ese paquete, realiza el registro de una aplicación en Microsoft Entra ID, que genera un identificador de aplicación (cliente).
  3. En tiempo de ejecución, debe proporcionar ese identificador de aplicación (cliente) a un proveedor de autenticación (como MSAL) para adquirir tokens de acceso en nombre del usuario que ha iniciado sesión.
  4. El token resultante se pasa al llamar a las API de Copilot (por ejemplo, la API de recuperación).

El registro de la aplicación es el puente entre el modelo de empaquetado y el modelo de consumo de API: es donde la identidad del paquete de la aplicación se convierte en la credencial que autoriza las llamadas a la API de Copilot.

El id campo en el manifiesto de la aplicación y el ID de aplicación (cliente) de Entra son identificadores diferentes que sirven para diferentes propósitos. El manifiesto id identifica la aplicación dentro del sistema de empaquetado y distribución de Microsoft 365 y se usa para la administración del ciclo de vida de la aplicación (publicación, actualización, instalación de prueba). El id. de aplicación (cliente) de Entra se usa para la autenticación OAuth cuando la aplicación llama a las API de Copilot.

Para obtener más información sobre el paquete de la aplicación, los campos de manifiesto y la distribución, consulte Los agentes son aplicaciones para Microsoft 365. Para obtener una explicación completa de cómo se aplican la autenticación y las directivas organizativas a las llamadas API de Copilot, consulte Seguridad y autenticación para las API de Microsoft 365 Copilot.

Nota:

Herramientas de desarrollo de Work IQ (versión preliminar): si está compilando un agente declarativo, wiqd puede reducir este paso de configuración: con entornos con nombre, wiqd agent provision realiza el registro de la aplicación de Microsoft 365 para el agente y vuelve a escribir los identificadores resultantes en el archivo de entorno, por lo que el registro de la aplicación no es un primer paso manual. Este proceso se aplica al aprovisionamiento de agentes declarativos, no a los clientes de API de Copilot en general. Para obtener más información, consulte la documentación de Dev Tools de Work IQ.

Integración de API de REST

Las API de Copilot están disponibles como API REST estándar en el espacio de nombres Microsoft Graph (graph.microsoft.com/v1.0/copilot y graph.microsoft.com/beta/copilot). Esta integración hace que las API sean accesibles desde cualquier lenguaje de programación o plataforma que admita solicitudes HTTP. Las API usan el mismo proceso de autenticación y autorización que otras API de Microsoft Graph. Todas las API de Copilot respetan las directivas existentes de su organización, incluido el acceso a identidades, el acceso condicional, las etiquetas de confidencialidad y el recorte de permisos, de forma predeterminada.

API de Copilot frente a API de Microsoft Graph

Las API de Microsoft Graph generalmente proporcionan operaciones CRUD en datos de Microsoft 365. Las API de Copilot ofrecen capacidades con tecnología de IA basadas en datos de Microsoft 365. Use las API de Microsoft Graph cuando necesite manipular datos y acceder a ellos; use las API de Copilot cuando necesite que la IA razone sobre esos datos. Esta diferencia fundamental se refleja en el modelo de licencias: las API de Microsoft Graph están disponibles bajo los términos de licencia estándar de Microsoft 365; las API de Copilot requieren una licencia de Microsoft 365 Copilot. Este modelo de licencias ofrece capacidades de IA de mayor valor más allá del acceso a datos estándar.

Contenido relacionado

  • Last updated on