# Arquitectura de la aplicación

> Comprende las responsabilidades de Web SDK, Server SDK y AI SDK y cómo combinarlos en una aplicación.

- Human documentation: [https://docs.univer.ai/es-ES/server/architecture](https://docs.univer.ai/es-ES/server/architecture)

- Agent Markdown: [https://docs.univer.ai/es-ES/server/architecture.md](https://docs.univer.ai/es-ES/server/architecture.md)

- Requested language: `es-ES`

- Content language: `es-ES`

- Documentation version: `1.2.0`

- Source: [architecture.es-ES.mdx](https://github.com/dream-num/documentation/blob/dev/content/server/architecture.es-ES.mdx)

---

Univer Office SDK incluye [Web SDK](https://docs.univer.ai/es-ES/guides/sheets.md) para editores integrados y procesamiento de contenido sin interfaz[^headless-mode], [Server SDK](https://docs.univer.ai/es-ES/server.md) para colaboración e importación y exportación de archivos, y [AI SDK](https://docs.univer.ai/es-ES/ai.md) para flujos de trabajo de agentes.

**Univer** es un conjunto de herramientas para crear aplicaciones Office donde personas y AI Agents operan el mismo contenido. Puede ofrecer Web para personas, CLI para AI Agents y un Server compartido, o usar solo los componentes necesarios.

## Composición de los SDK

```mermaid
%%{init: {"themeVariables": {"fontSize": "14px"}, "flowchart": {"nodeSpacing": 24, "rankSpacing": 32, "padding": 16, "curve": "monotoneX"}}}%%
flowchart LR
    Human(["Usuario humano"]) --> Web["<b>Web SDK</b><br/>Navegador · Web"]
    Agent(["AI Agent"]) --> CLI["<b>AI SDK</b><br/>CLI"]
    Web --> Server["<b>Server SDK</b><br/>Colaboración · Archivos<br/>+ código de aplicación"]
    CLI --> Server
    classDef default rx:8,ry:8,stroke-width:1px
    classDef actor fill:transparent,stroke:none
    class Human,Agent actor
```

| Componente | Entorno   | SDK principal                        | Proporciona                                   | Responsabilidad de la aplicación                             |
| ---------- | --------- | ------------------------------------ | --------------------------------------------- | ------------------------------------------------------------ |
| Web        | Navegador | Web SDK                              | Visualización y edición interactiva de Office | UI, interacción del producto e integración con el navegador  |
| CLI        | Node.js   | AI SDK                               | Inspección y edición para AI Agent            | Flujos AI Agent, llamadas a herramientas y límites de tareas |
| Server     | Node.js   | Server SDK (Collaboration, Exchange) | Colaboración autoalojada e intercambio Office | API de negocio, identidad, permisos, archivos y despliegue   |

La documentación se organiza en [Web SDK](https://docs.univer.ai/es-ES/guides/sheets.md), [Server SDK](https://docs.univer.ai/es-ES/server.md) y [AI SDK](https://docs.univer.ai/es-ES/ai.md), para editores, servicios de colaboración y archivos y operaciones de contenido de AI Agents.

AI SDK reutiliza las capacidades sin interfaz de Web SDK. Los componentes indican entradas de desarrollo y ubicaciones de ejecución, no tres pilas independientes ni productos completos desplegables sin código de aplicación.

## Integrar importación y exportación

`@univerjs-pro/exchange-node` de Server SDK convierte archivos Office y datos Univer. La aplicación integra el módulo y ofrece API de subida, conversión y descarga. Web SDK gestiona la interacción del navegador y una CLI puede llamar al módulo en Node.js. La configuración del navegador sigue en la documentación Web SDK de cada producto.

* **Sin colaboración:** convierte el archivo en una instantánea, ábrela y edítala en el navegador. Para exportar, envía la instantánea más reciente al módulo. Requiere conversión en servidor, pero no colaboración.
* **Con colaboración:** guarda lo importado como documento colaborativo. Web y AI SDK operan el mismo contenido mediante su ID. Antes de exportar, sincroniza las ediciones, lee los datos actuales y conviértelos.

Para convertir únicamente archivos, usa Exchange en Node.js local o en un servicio remoto; no se requiere AI SDK ni colaboración. Consulta [Integración de intercambio](https://docs.univer.ai/es-ES/server/import-export.md) para el flujo e [Importación y exportación de Office](https://docs.univer.ai/es-ES/server/import-export/node.md) para el módulo.

## Formas de despliegue

| Forma            | Web                              | CLI                                      | Server          | Uso                                         |
| ---------------- | -------------------------------- | ---------------------------------------- | --------------- | ------------------------------------------- |
| Aplicación local | Navegador local/UI de escritorio | Proceso local                            | Proceso local   | Office de escritorio con AI Agent local     |
| SaaS             | Navegador                        | Dispositivo del usuario/AI Agent en nube | Servicio remoto | Varios usuarios y operación centralizada    |
| Web + Server     | Navegador                        | —                                        | Local o remoto  | Sin entrada AI Agent todavía                |
| Solo Web         | Navegador/UI de escritorio       | —                                        | —               | Edición local, individual y no colaborativa |

Los componentes pueden ejecutarse en una máquina o repartirse entre clientes y nube. La ubicación no cambia sus responsabilidades. Si existe Server, Web y CLI acceden al contenido compartido y funciones mediante él.

## Elegir un punto de entrada

| Objetivo                                       | Empieza aquí                                                   |
| ---------------------------------------------- | -------------------------------------------------------------- |
| Insertar un editor Office en Web               | [Documentación Web SDK](https://docs.univer.ai/es-ES/guides/sheets.md)                        |
| Añadir intercambio Office al editor            | [Integración de intercambio](https://docs.univer.ai/es-ES/server/import-export.md)            |
| Convertir Office en Node.js                    | [Importación y exportación Office](https://docs.univer.ai/es-ES/server/import-export/node.md) |
| Añadir colaboración autoalojada en tiempo real | [Resumen de Collaboration SDK](https://docs.univer.ai/es-ES/server/collaboration/overview.md) |
| Permitir que AI Agents lean y editen Office    | [Resumen de AI SDK](https://docs.univer.ai/es-ES/ai.md)                                       |
| Comprender el Runtime CLI sin interfaz         | [Reutilización del Runtime y Daemon](https://docs.univer.ai/es-ES/ai/runtime-architecture.md) |
| Aislar cambios para revisión humana            | [Worktree](https://docs.univer.ai/es-ES/ai/worktree.md)                                       |

Si no sabes qué ruta elegir, empieza por [Primeros pasos](https://docs.univer.ai/es-ES/guides/sheets.md).

[^headless-mode]: Headless significa operar sobre el contenido sin montar una interfaz de edición interactiva. No implica que se incluyan servicios de colaboración, persistencia o conversión de archivos.