Resumen de configuración e infraestructura
Your Office AI es autoalojable. Esta sección es la lista de comprobación del operador con todos los servicios externos que hay que conectar para ejecutar la plataforma: para qué sirve cada uno, si es obligatorio y dónde vive su configuración. Síguelos en orden de arranque para que cada dependencia quede satisfecha antes de que la siguiente la necesite.
Casi todos los secretos del servidor residen en los archivos de configuración del servidor tenant, más un command_center_tenant_server/config/passwords.yaml excluido del control de versiones. El servidor de autenticación tiene su propio command_center_server/config/passwords.yaml para la base de datos de autenticación y el correo. Los ajustes de host/puerto no secretos viven en el correspondiente config/development.yaml / staging.yaml / production.yaml. Nunca confirmes passwords.yaml en el repositorio.
Orden de arranque
Cada servicio depende de los anteriores. Ponlos en marcha de izquierda a derecha: primero los almacenes de datos, luego la capa en tiempo real y de IA, y después las capas opcionales de integración y correo.
La lista de servicios
Todos los servicios externos que toca un operador, con la página que los documenta en detalle. Los servicios requeridos son necesarios para que el producto funcione; los servicios por función desbloquean una capacidad específica; los opcionales se recomiendan pero no son imprescindibles.
| Servicio | Para qué sirve | Necesidad | Configurado en |
|---|---|---|---|
| PostgreSQL (Supabase or managed) | Dos bases de datos: una para el servidor de autenticación y otra por tenant para el servidor tenant. | Obligatorio | config + passwords.yaml |
| Redis | Pub/sub para flujos en tiempo real; obligatorio en cuanto se ejecuta más de una réplica del servidor tenant. | Obligatorio | config + passwords.yaml |
| Object storage (Supabase Storage / MinIO) | Subidas de archivos, documentos de conocimiento y avatares. Compatible con S3: MinIO para autoalojamiento, Supabase Storage para entornos gestionados. | Obligatorio | App Flutter + políticas de bucket de almacenamiento |
| LiveKit | Vídeo, audio, compartición de pantalla en tiempo real y el transporte del asistente de voz. | Obligatorio | passwords.yaml del servidor tenant o interfaz de administración |
| LLM + embedding provider keys | Seis proveedores de LLM más un modelo de incrustación para la búsqueda semántica de conocimiento (pgvector). | Obligatorio | passwords.yaml del servidor tenant |
| Voice providers (Deepgram / Google Cloud) | STT + TTS para el puente de voz unificado. Sin dependencia de proveedor: tú eliges cuál configurar. | Por función | Ajustes de org → Voz y IA + entorno del agente |
| OAuth / integrations (Nango) | Intermediario de conexiones OAuth para el catálogo de integraciones (Google, Slack, Microsoft, …). | Por función | Instancia de Nango + passwords.yaml del servidor tenant |
| Transactional email (Resend) | Envía la verificación de registro, el restablecimiento de contraseña y los correos de invitación a la organización. | Obligatorio | passwords.yaml del servidor de autenticación |
| Observability (OpenTelemetry + ClickHouse) | Registros, trazas y métricas de la aplicación y ambos servidores, consultables para depuración. | Opcional | config/development.yaml → otel + Docker |
| Multi-instance scaling | Ejecuta múltiples réplicas del servidor tenant detrás de un balanceador de carga con Redis compartido. | Opcional | Balanceador de carga + Redis + entorno |
Guías detalladas
Cómo encajan las piezas
Your Office AI ejecuta un backend de dos servidores: un servidor de autenticación para la identidad y las organizaciones, y un servidor tenant por organización para el chat, el conocimiento, las integraciones y los tokens de LiveKit. Cada uno se conecta a su propia base de datos Postgres. Los agentes y flujos de trabajo de IA se ejecutan en un motor Python LangGraph detrás de un servidor de IA en Dart, y las respuestas de IA se fundamentan en tu base de conocimiento mediante búsqueda semántica con pgvector.
| Componente | Se comunica con |
|---|---|
| Servidor de autenticación | Auth Postgres, Resend (email) |
| Servidor tenant | Tenant Postgres, Redis, LiveKit, LLM/embedding providers, Nango, object storage, OTel collector |
| Motor de IA LangGraph | Tenant server (callbacks), LLM providers |
| Worker del puente de voz | LiveKit, tenant server, STT/TTS providers |
Solo PostgreSQL, Redis, almacenamiento de objetos, LiveKit, un proveedor de LLM, un modelo de incrustación y el correo son necesarios para ejecutar el producto. Los proveedores de voz, las integraciones vía Nango y la pila de observabilidad se añaden cuando activas esas funciones.
Configurado una vez, gobernado siempre
Una vez que un administrador configura un proveedor, su gasto se gestiona de forma centralizada: cada límite numérico en Your Office AI tiene un mínimo positivo fijo, y un valor de 0 deshabilita la función en lugar de eliminar el límite. No existe tal cosa como un presupuesto ilimitado.
Ve a Servicios principales y entorno para configurar las bases de datos, Redis, el almacenamiento de objetos y las claves de proveedor de las que depende todo lo demás.