Descripción de Office SDK
Obtenga información sobre las tres partes de Office SDK: Web SDK, Server SDK y AI SDK, y cómo funcionan juntas en una aplicación de Office.
Univer Office SDK incluye Web SDK, Server SDK y AI SDK. Admite hojas de cálculo, documentos, presentaciones, tablas relacionales, lienzos y PDF.
Web SDK proporciona el motor de contenido compartido, que ejecuta editores de navegador y procesamiento de contenido sin cabeza. Server SDK y AI SDK dependen de este tiempo de ejecución sin cabeza. Server SDK agrega colaboración y procesamiento de archivos, mientras que AI SDK agrega operaciones de contenido y verificación para agentes.
Explorar características
Explore catálogo de características por producto y categoría, incluidos los niveles de soporte, la disponibilidad de código abierto y el alcance de la integración. Las capacidades compartidas incluyen gráficos, conversión de archivos, colaboración, Worktree e incrustación.
Primeros pasos: comience con una plantilla de requisitos y tres ejemplos ejecutables, luego conecte, cree e implemente su aplicación.
Arquitectura y responsabilidades de los SDK
Web SDK: el motor de contenidos compartidos
Para desarrolladores que muestran, editan o procesan contenido de Office en su aplicación. Utilice Facade APIs para trabajar con contenido, datos y UI en editores de navegador o aplicaciones Node.js sin cabeza.
Web SDK utiliza una arquitectura de complemento: las capacidades del producto, el editor UI y funciones individuales como buscar y reemplazar se pueden componer a través de complementos. Comience con un ajuste preestablecido o seleccione los complementos de funciones y productos que su aplicación necesita y ensamblelos con sus dependencias.
También puede desarrollar complementos personalizados para funciones específicas de la empresa sin modificar el código principal de Univer. Diferentes combinaciones de complementos adaptan el mismo motor de contenido a cada entorno: las aplicaciones del navegador cargan el editor UI, mientras que las aplicaciones sin cabeza omiten los complementos del navegador UI. Consulte Arquitectura Univer: diseño de complemento.
Representación de Canvas compartido. El contenido de Office utiliza una arquitectura de representación compartida basada en Canvas, lo que permite que los tipos de contenido reutilicen capacidades de diseño y dibujo y admitan contenido anidado. Por ejemplo, el texto de las celdas de una hoja de cálculo reutiliza el diseño y la representación del documento para lograr una presentación coherente del contenido. Ver Arquitectura del motor de renderizado.
Cómputo híbrido. El motor de fórmulas admite un modelo de cálculo híbrido en el que el cálculo frontal funciona con un motor Rust del lado del servidor, combinando edición responsiva con rendimiento para grandes cargas de trabajo de fórmulas. Explore capacidades de fórmula y cálculo del lado del servidor.
Comience con hojas de cálculo o elija documentos, diapositivas, tablas relacionales, lienzos y PDF.
Server SDK: conecta colaboración y archivos
Para desarrolladores que agregan edición compartida, conversión de archivos y extensiones de backend. Aproveche las capacidades de contenido headless de Web SDK, integre los módulos en su propio backend y utilice la identidad, los permisos y el almacenamiento de su aplicación.
Colaboración en tiempo real. OT (Transformación operativa) maneja operaciones simultáneas, como cambios de filas/columnas y ediciones de contenido. Las ediciones se aplican primero localmente y luego convergen entre las réplicas, preservando al mismo tiempo la intención del usuario siempre que sea posible. Agregue historial, comentarios y Worktree según sea necesario. Consulte diseño de edición colaborativa y inicio rápido de colaboración.
Conversión de archivos. Convierta entre archivos de Office y datos de documentos Univer para conectar la importación, edición y exportación, con o sin colaboración. Consulte Importación y exportación de archivos de Office para las API de conversión y integración de intercambio de archivos para cargas, tareas y descargas.
Implementación y escalado. Ensamble los módulos en su propia aplicación Node.js. Comience en una máquina, separe la conversión de archivos a medida que aumenta la carga y luego escale a múltiples nodos de colaboración. Consulte arquitectura de aplicaciones y guía de implementación.
AI SDK: proporcione a los agentes un punto de entrada
Para desarrolladores que agregan capacidades de Office a agentes existentes, automatización y CLI específicas de aplicaciones. Utilice el tiempo de ejecución sin cabeza de Web SDK y Facade APIs para operaciones, cálculos e inspección de contenido.
Conecte su pila de agentes existente. Exponga las herramientas de Office a través de las API TypeScript o una aplicación CLI ensamblada a partir de SDK. Su aplicación posee selección de modelos, orquestación de tareas y habilidades. Los agentes reciben resultados de ejecución y comentarios de inspección y luego continúan con sus flujos de trabajo.
Cree contenido que siga siendo editable. Los agentes leen la estructura del documento, ubican rangos o párrafos y luego usan Facade APIs para crear y modificar hojas de cálculo, documentos, diapositivas y otro contenido, incluido el cálculo de fórmulas. Los resultados conservan su estructura de contenido y capacidades de edición para que las personas puedan seguir perfeccionándolos. Ver operaciones de contenido.
Inspeccione y luego revise. Vuelva a leer los valores y los resultados de las fórmulas, e inspeccione las capturas de pantalla de la página real. Para las diapositivas, las comprobaciones de diseño también identifican texto fuera de página, desbordado y superpuesto. Los agentes utilizan la retroalimentación para revisar y verificar nuevamente, formando un ciclo de lectura → edición y cálculo → inspección → revisión. Consulte inspección visual.
Conéctese a Server SDK y use Worktree para aislar los cambios del agente intermedio antes de la revisión humana y la fusión en la aplicación web. Explorar AI SDK.
Flujo de trabajo de la aplicación
- editor integrado: utilice Web SDK para mostrar y editar contenido en su aplicación.
- Aplicación colaborativa: combine Web SDK y Server SDK para que los usuarios puedan editar documentos compartidos juntos.
- Colaboración humana y de agentes: los agentes editan y verifican borradores a través de AI SDK, Server SDK administra las versiones y las fusiones, y la aplicación web proporciona interacciones de visualización, comparación y revisión humana. Los tres contribuyen al flujo de trabajo de revisión completo.
Relational Table compartida y dependencias
Web SDK puede ejecutarse de forma independiente como editor o motor de contenido sin cabeza. Server SDK y AI SDK dependen de las capacidades sin cabeza de Web SDK: ejecutar UI sin navegador aún requiere el tiempo de ejecución del contenido. Habilite los servicios y módulos que su aplicación necesita; un flujo de trabajo completo entre humanos y agentes normalmente combina los tres SDK.
Comience con su caso de uso
| quiero | Empieza aquí |
|---|---|
| Insertar un editor de hojas de cálculo | Web SDK inicio rápido |
| Elija otro editor de Office | Documentos, diapositivas, tablas relacionales, tableros, o PDF |
| Permitir que varios usuarios editen el mismo documento | Inicio rápido de colaboración |
| Importar o exportar archivos de Office | Conversión de archivos Server SDK |
| Operar documentos a través de un agente o CLI | Descripción general de AI SDK |
| Revisar los cambios de un agente en un documento compartido | AI SDK Worktree |
Próximos pasos
Comience con el tiempo de ejecución de contenido de Web SDK, combínelo con Server SDK y AI SDK para completar el primer flujo de trabajo de su aplicación y luego agregue módulos de forma incremental. Mantenga alineadas las versiones del paquete Univer relacionadas y prepare el entorno, la autorización y las licencias requeridas por los módulos elegidos.
Explore Ejemplos para aplicaciones de código abierto, integraciones de agentes, demostraciones y repositorios. También puede probar los productos de Office en escaparate en línea.
¿Cómo es esta guía?