Workspace

Univer Workspace convierte Univer Office SDK en un espacio de trabajo de código abierto para personas y agentes. Reúne contenido Office editable y Web Apps vinculadas a datos en Spaces personales y de equipo, con uso compartido, colaboración, versiones y revisión de cambios. El repositorio incluye la aplicación, el despliegue, la CLI y el cliente de escritorio.

Puedes desplegarlo en tu infraestructura o empezar con la prueba en la nube. Tu agente se conecta mediante Workspace CLI; Workspace Desktop integra la conversación y el mismo espacio en una aplicación local. Son formas de trabajar con el mismo servicio y los mismos archivos.

Prueba en línea · Conecta tu agente · Alojamiento propio · Experiencia Desktop · Código y personalización

Empieza con Workspace en la nube

Abre la prueba en la nube, inicia sesión y entra en tu Space personal o en uno de equipo al que tengas acceso. Crea, edita, organiza y comparte documentos. También puedes conectar un agente a este servicio mediante la CLI que se explica a continuación. Usa datos de ejemplo: los datos de prueba pueden restablecerse.

Workspace Server gestiona identidad, Spaces, permisos, almacenamiento, colaboración y versiones. Web ofrece la interfaz de edición y revisión en el navegador. El despliegue privado utiliza esta misma aplicación Server y Web.

Conecta tu agente al Workspace en la nube

Instala la CLI y la Skill de descubrimiento donde se ejecuta tu agente. Se requiere Node.js 22.12 o posterior; se recomienda 24. Un agente que ejecuta comandos puede utilizar estas herramientas manteniendo su modelo y conversación. Configura el servicio de nube para trabajar con el mismo Workspace desde el navegador y el agente:

npm install --global univer-workspace-cli@latestnpx skills add dream-num/univer-workspace --skill univer-workspace-cli -guvw --versionuvw config set workspace.origin https://space.univer.ai

uvw auth login

uvw auth login --complete

Tras la primera autorización en el navegador, la CLI reutiliza la sesión. No necesitas crear una integración de inicio de sesión para cada agente. Pídele una tarea, abre el enlace que devuelve y revisa el mismo contenido y los cambios Office antes de fusionarlos.

Empieza con un documento que puedas calcular y revisar

Crea una hoja de gastos mensuales en inglés en mi espacio personal Workspace con fechas, categorías, importes y cinco filas de ejemplo. Añade una fórmula de total y un gráfico por categoría.Trabaja en un borrador aislado, verifica datos, fórmulas y aspecto, y dame un enlace de vista previa o revisión. No integres antes de mi confirmación.

Envía la tarea a un agente conectado o úsala en Desktop. El agente crea y verifica; tú pides cambios, revisas y decides si integrar. Puedes abrir el mismo contenido desde la edición en línea.

Lleva el mismo flujo a tu propio despliegue

El repositorio incluye Server y Web. Sigue la guía de despliegue y configura dominio, acceso, almacenamiento persistente y entorno. El desarrollo utiliza Node.js 24 y pnpm 11.

Apunta la misma CLI a tu servicio y autoriza una cuenta allí. Sustituye esta dirección de ejemplo por la dirección real:

uvw config set workspace.origin https://workspace.example.comuvw auth login

El agente conserva herramientas y Skills, pero opera sobre los archivos y permisos de tu servicio. Desktop también puede conectarse. Consulta la guía de conexión del Agent para registrar el cliente y configurar las devoluciones de llamada.

Lleva Workspace a un cliente Desktop local

Workspace Desktop combina Workspace, un entorno de agente, herramientas Office y vistas previas en un cliente local. Ofrece una experiencia de trabajo similar a Codex o Cowork: describe el objetivo, inspecciona el documento o Web App junto a la conversación, pide cambios y revisa el resultado.

Conecta Desktop a la nube, a tu despliegue privado o a un servicio Workspace local. El host del agente proporciona modelo y conversación; Workspace gestiona archivos y acceso. Los siguientes ejemplos reales muestran creación, gestión y colaboración.

Instalar y conectar · Primera tarea: revisar un presupuesto con dos documentos

El flujo del agente en el trabajo Office diario

Los resultados Office necesitan edición continua, fórmulas, colaboración y revisión de cambios. Desktop conecta estos pasos en el mismo entorno para trabajar sobre contenido editable y compartido.

• Mantén el contexto: conversaciones, archivos, fuentes Workspace y referencias locales.
• Crea contenido Office y Web Apps: genera hojas, documentos, presentaciones, Relational Table y Canvases editables, además de páginas interactivas basadas en sus datos.
• Mira y ajusta: abre el contenido junto al chat, comprueba fórmulas y diseño y pide cambios concretos.
• Entrega tras revisión: conserva los cambios Office en un Worktree hasta que una persona revise y fusione.

De la petición al resultado revisable

Genera y modifica documentos Office y Web Apps en conversaciones normales; después, gestiónalos y compártelos en Space. Los cambios Office nativos se revisan en Worktree antes de fusionarlos. La publicación HTML y las escrituras enlazadas usan sus propios procesos de guardado y autorización. Las siguientes conversaciones pueden consultar los mismos archivos y datos.

Lo que reúne el escritorio

Workspace + agente en la práctica

Las capturas y la secuencia siguientes proceden de la aplicación de escritorio instalada en macOS, conectada a un Workspace local nuevo. La cuenta, el Space, los nombres, el contenido y la conversación del agente usan datos ficticios en inglés.

Crear y previsualizar en una conversación normal

Build Five-File Launch Demo es una conversación normal del agente que creó una hoja, un documento, una presentación, una Relational Table y un lienzo. La imagen muestra la entrega real junto a 02 Launch Brief, editable en el panel del navegador de Desktop. Pide más cambios en la conversación y gestiona y comparte los archivos generados desde Space.

El agente también crea informes interactivos, páginas de negocio y paneles en una conversación normal. En una sesión posterior creó 06 Launch Dashboard a partir del presupuesto publicado: tres tarjetas muestran presupuesto, gasto real y diferencia, y un gráfico sigue las seis áreas mediante enlaces en vivo de HTML View. Este ejemplo solo lee la misma hoja nativa, sin escribir datos. La vinculación bidireccional es experimental y puede cambiar.

Gestionar, compartir y colaborar en Space

Aurora Launch Studio reúne los cinco archivos nativos y 06 Launch Dashboard creados en las conversaciones. Organiza presupuesto, informe, presentación de tres diapositivas, tareas, lienzo y Web App en un Space; gestiona el acceso y compártelos con el equipo. Las personas siguen coeditando el contenido Office nativo mientras la página vinculada refleja sus datos. Web y Desktop usan los mismos archivos; las revisiones posteriores del agente esperan en un Worktree aislado.

Explora contenido y revisa borradores en Desktop

La secuencia muestra interacciones reales de Desktop: explorar los archivos del Space local, abrir sus editores nativos y volver a la conversación real del agente. El contenido sigue siendo editable en la aplicación.

Colabora en contenido compartido desde Desktop

Web y Desktop abren 01 Launch Budget con la misma cuenta local. Una nota introducida en Web aparece en el editor real de Desktop, y una confirmación de Desktop vuelve a Web. La captura muestra ambas notas y el estado sincronizado. Es una prueba entre clientes con la misma cuenta; los borradores del agente siguen aislados en Worktrees.

Genera, revisa y entrega mediante una conversación

El agente revisa 02 Launch Brief en un Worktree aislado: añade una aprobación de dos semanas y acciones por responsable, eleva el objetivo de retorno del 40% al 45% y registra un riesgo con su mitigación. La captura muestra la conversación real y la vista nativa del documento. El original compartido no cambia.

Worktree y Compare: revisa el borrador en Desktop

Abre Review changes desde el documento para comparar el contenido compartido con la propuesta del Worktree en vistas nativas. Desplázate por el contenido y examina las diferencias antes de decidir qué aceptar. La vista previa de integración mostrada es de solo lectura; el ejemplo mantiene el borrador sin fusionar.

Consulta los ajustes de uso compartido en Desktop

El panel Compartir Space de Desktop muestra los roles de los miembros y el acceso mediante enlaces de este Space de equipo. Los miembros acceden al contenido compartido según su rol; copiar un enlace no concede acceso. No se cambiaron los permisos para la captura.

Cinco tipos de contenido nativo en un escritorio

El proyecto Aurora utiliza datos ficticios en inglés para conectar presupuesto, informe, presentación, tareas y diagrama de proceso. Son editores Office nativos dentro de Desktop; las personas pueden seguir editando el contenido que utiliza el agente.

Las capturas muestran una vista previa de integración con la marca Univer aplicada mediante los puntos de extensión del anfitrión. Combina un anfitrión de agentes extensible y el complemento Space; la distribución del complemento de prueba depende de las publicaciones del proyecto.

Sheets: un modelo de negocio calculable

El presupuesto calcula Budget, Actual y Variance para seis áreas, con fórmulas y un gráfico comparativo nativo. Los totales son USD 102,000 de presupuesto, USD 100,000 reales y USD 2,000 de margen favorable. El agente verifica los resultados mediante Facade API.

Docs: convertir evidencia en decisiones

Títulos, estilos de párrafo, listas y una tabla nativa organizan el propósito, el plan, los indicadores y los responsables. Una conversación posterior puede modificar una parte de este mismo documento editable en un Worktree.

Slides: presentar la lógica del negocio

Las tres diapositivas combinan texto y formas editables con un estilo coherente: propuesta de lanzamiento, plan de cuatro etapas e indicadores con responsables. Se pueden ajustar y presentar en la misma aplicación.

Relational Table: coordinar la ejecución

Seis tareas usan campos tipados de estado, prioridad, responsable, fecha y notas. Las opciones de color muestran el progreso y las prioridades en el registro compartido.

Canvases: conectar estrategia y entrega

Formas, texto y conectores nativos muestran cuatro etapas: Align → Activate → Share → Learn. Las notas enlazan cada etapa con acciones y evidencias.

Instalar y conectar

Si ya tienes un escritorio de agentes extensible, puedes instalar y habilitar Space, conectar el servicio desde Space, configurar el modelo y añadir la marca. Las capturas usan esta composición. La aplicación Desktop completa y el complemento de prueba tienen vías de distribución distintas; sigue la publicación o las instrucciones del repositorio correspondientes a tu versión.

1. Elige Desktop en GitHub Releases, con etiquetas agent-v, para Windows x64, macOS Apple Silicon o Linux x64. La distribución es experimental; consulta las versiones publicadas.

2. En Settings → Workspace, elige el servicio, inicia sesión en el navegador y autoriza. Usa un servicio desplegado o la configuración local.

3. Configura un proveedor, modelo y credenciales compatibles en Models. Es independiente del inicio de sesión Workspace: consulta configuración de modelos.

4. Añade un Space personal o de equipo accesible, abre una conversación y usa @ para aportar fuentes. Prueba la tarea siguiente y abre vista previa y revisión.

El instalador incluye la aplicación agente y las herramientas Office. El servicio Workspace funciona por separado, localmente o en un servidor; configura el acceso al modelo.

Primera tarea: revisar un presupuesto con dos documentos

En el Space actual, crea una hoja inglesa Budget Review con ocho departamentos: Department, Budget, Actual y Variance. Usa fórmulas para diferencias y totales y añade un gráfico de presupuesto frente a gasto real.Crea también un documento breve que resuma los excesos y enlace a la hoja. Mantén los cambios Office en un Worktree, verifica datos, fórmulas y resultado, abre vista previa y revisión y espera mi aprobación antes de fusionar.

Continúa con «Reduce el presupuesto de Marketing un 10 % y actualiza el resumen»; revisa los valores y cambios antes de aceptar.

Sesión real: del modelo al informe de decisión

La sesión de Aurora en Desktop conecta la lectura de archivos fuente, la revisión de documentos nativos y una solicitud posterior de revisión. El agente mantiene el borrador existente en Ready para la aprobación humana. Consulta la conversación real de Desktop y la comparación nativa del Worktree.

Construye tu propio Workspace desde el repositorio

La aplicación que acabas de explorar es una composición de Office SDK. Parte del repositorio de Workspace, reutiliza el motor de contenido y la colaboración, y adapta flujos, Skills, herramientas e interfaz a tu equipo.

Encuentra la parte que quieres adaptar

Skills: entender el espacio y completar tareas

Skills para tu agente

El Skill univer-workspace-cli instalado en tu agente es el punto de descubrimiento: explica la conexión, la localización del objetivo y la carga de guías. Los Skills completos se distribuyen con la CLI y corresponden a sus comandos y API Facade. El complemento integrado de Desktop también proporciona guías y herramientas por tarea.

uvw skills listuvw skills get coreuvw skills get sheetuvw skills get html-view

Carga primero core y después el producto o tema necesario. skills get enumera referencias; uvw skills read <name> <path> lee una concreta y --full las incluye juntas. Los agentes existentes acceden mediante la CLI; Desktop integra herramientas y guías en la conversación.

Guías integradas en Desktop

El plugin incluye el Skill univer y sus referencias: localizar Spaces y documentos, usar las API y crear, verificar y entregar Worktrees. El agente consulta una API, la ejecuta sobre contenido nativo e inspecciona el resultado.

El complemento de capacidades conecta búsqueda de archivos, edición Headless Facade, inspección estructurada, importación/exportación y gestión de Worktrees. Esta versión prepara borradores para revisión; la publicación utiliza el flujo de revisión y fusión de la aplicación desplegada. Puedes añadir Skills, plantillas y herramientas de negocio sobre el mismo runtime Office.

El complemento de prueba incluye nueve Skills. La guía común explica descubrimiento, identidad y entrega; las guías por producto aportan API y verificación. El agente consulta lo necesario para la tarea actual.

Separar el bucle del agente de las capacidades Office

Las Skills orientan al agente, las herramientas operan contenido estructurado mediante Headless y los editores nativos lo muestran a las personas. Workspace aporta archivos y contexto colaborativo. Puedes cambiar el modelo, añadir herramientas de negocio o sustituir la marca sin reconstruir el motor Office.

Reutiliza petición → herramientas → contenido editable → vista previa → revisión → entrega compartida. Office SDK aporta la capa Office; el anfitrión, conversación y ejecución. Amplía la aplicación y sus plugins o conecta tu propio anfitrión.

Adapta el flujo a tu negocio

Explorar la implementación

Compilación y distribución Desktop · Aplicación agente y configuración · Todos los ejemplos

Office Lab