🛠️ Infraestructura

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.

ℹ️
Dónde vive la configuración

Almost all server secrets live in the tenant server's config files plus a gitignored command_center_tenant_server/config/passwords.yaml. The Auth server has its own command_center_server/config/passwords.yaml for the auth database and email. Non-secret host/port settings live in the matching config/development.yaml / staging.yaml / production.yaml. Never commit passwords.yaml.

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.

🗄️Bases de datosPostgres de auth + tenant
RedisPub/sub + escalado
📦Almacenamiento de objetosMinIO / Supabase
📡LiveKitTransporte de vídeo + voz
🧠LLM + incrustacionesProveedores + pgvector
🔌IntegracionesNango + correo
Primero los almacenes de datos, luego la capa en tiempo real y de IA, y después las integraciones y el correo.

La lista de servicios

Every external service an operator touches, with the page that documents it in detail. Required services are needed for the core product to run; per-feature services unlock a specific capability; optional ones are recommended but not load-bearing.

ServicioPara qué sirveNecesidadConfigurado en
PostgreSQL (Supabase or managed)Dos bases de datos: una para el servidor de autenticación y otra por tenant para el servidor tenant.Obligatorioconfig + passwords.yaml
RedisPub/sub para flujos en tiempo real; obligatorio en cuanto se ejecuta más de una réplica del servidor tenant.Obligatorioconfig + 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.ObligatorioApp Flutter + políticas de bucket de almacenamiento
LiveKitVídeo, audio, compartición de pantalla en tiempo real y el transporte del asistente de voz.Obligatoriopasswords.yaml del servidor tenant o interfaz de administración
LLM + embedding provider keysSeis proveedores de LLM más un modelo de incrustación para la búsqueda semántica de conocimiento (pgvector).Obligatoriopasswords.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ónAjustes 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ónInstancia 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.Obligatoriopasswords.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.Opcionalconfig/development.yaml → otel + Docker
Multi-instance scalingEjecuta múltiples réplicas del servidor tenant detrás de un balanceador de carga con Redis compartido.OpcionalBalanceador de carga + Redis + entorno

Guías detalladas

Cómo encajan las piezas

Your Office AI runs a dual-server backend: an Auth server for identity and organisations, and a Tenant server per organisation for chat, knowledge, integrations, and LiveKit tokens. Each connects to its own Postgres database. AI agents and workflows execute on a Python LangGraph engine behind a Dart AI server, and AI answers are grounded in your Knowledge through pgvector semantic search.

ComponenteSe comunica con
Servidor de autenticaciónAuth Postgres, Resend (email)
Servidor tenantTenant Postgres, Redis, LiveKit, LLM/embedding providers, Nango, object storage, OTel collector
Motor de IA LangGraphTenant server (callbacks), LLM providers
Worker del puente de vozLiveKit, tenant server, STT/TTS providers
💡
Empieza con lo mínimo y añade según avances

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

Once an admin configures a provider, its spend is governed centrally: every numeric cap in Your Office AI has a hard positive minimum, and a value of 0 disables the feature rather than removing the limit. There is no such thing as an unlimited budget.

6
proveedores de LLM, una organización
4
niveles de compartición × ver / editar
0 unlimited budgets
0 significa desactivado, nunca ilimitado

ℹ️
Siguiente

Head to Servicios principales y entorno to set up the databases, Redis, object storage, and provider keys that everything else depends on.