Configuración

El script de bootstrap escribe deploy/.env. Utiliza deploy/.env.example como la referencia de variable actual.

Orígenes públicos

Establece PUBLIC_URL como el origen público de la aplicación. Establece SUPABASE_PUBLIC_URL como el origen de la pasarela de base de datos accesible desde el navegador.

Vuelve a compilar la aplicación después de cambiar SUPABASE_PUBLIC_URL. El paquete del navegador contiene este valor en tiempo de compilación.

docker compose -f deploy/docker-compose.yml up -d --build app

Secretos generados

La pila requiere Postgres, JSON Web Token, un rol de servicio, cifrado de la aplicación y secretos de cron. Deja que el script de bootstrap los genere.

No cambies JWT_SECRET, ANON_KEY ni SERVICE_ROLE_KEY de forma independiente. Forman una única configuración de firma.

Cuentas y correo electrónico

La primera cuenta se convierte en la propietaria de la organización. Establece DISABLE_SIGNUP=true una vez que existan las cuentas necesarias.

Sin la configuración de SMTP, MAILER_AUTOCONFIRM=true confirma automáticamente las nuevas cuentas.

Las acciones de correo electrónico en tiempo de ejecución utilizan RESEND_API_KEY y EMAIL_FROM. Informan de un resultado no configurado cuando falta alguno de los dos valores.

Endpoints de modelos

Configura las claves de los proveedores Anthropic, OpenAI o Google. También puedes configurar un endpoint de chat y de «embedding» compatible con OpenAI. Establece OPENAI_COMPATIBLE_CONTEXT_WINDOW en el tamaño de contexto configurado del servidor de chat, con un mínimo de 8192 tokens. Ciele comprueba toda la solicitud antes de llamar al modelo. Si el contenido necesario supera esta ventana, utiliza un modelo más grande o reduce la solicitud.

La búsqueda de conocimiento utiliza la coincidencia léxica cuando no hay ningún modelo de embedding disponible.

Capacidad de chat

Cada turno de chat que llama a un modelo ocupa un slot antes de su primera llamada al modelo. Los slots están en la base de datos, por lo que todas las instancias de la aplicación comparten un único contador.

Establece un límite en 0 o off para eliminarlo. Deja la variable vacía para usar el valor predeterminado.

Un turno que no consigue una ranura durante el tiempo de espera no se ejecuta. El widget le indica al visitante que lo intente de nuevo dentro de unos segundos.

Cuando un proveedor rechaza una solicitud debido a su límite de tasa, la aplicación vuelve a intentar la solicitud tras un retraso aleatorio. El widget muestra el mismo mensaje si todos los intentos fallan.

El widget también limita a cada Visitor a 12 mensajes por minuto. Una única dirección de red puede enviar 300 mensajes por minuto a un único asistente. Muchos Visitantes pueden compartir una misma dirección, por ejemplo, en una red de oficina.

La aplicación lee la dirección de red del encabezado X-Forwarded-For. De forma predeterminada, utiliza la primera dirección del encabezado. Esto es correcto sin proxy y con la superposición TLS incluida, porque Caddy elimina el valor que envió el cliente.

Algunos proxies añaden su elemento caller al final del encabezado y conservan el valor del cliente. Algunos ejemplos son nginx con $proxy_add_x_forwarded_for y la mayoría de los balanceadores de carga en la nube. Cuando haya tales proxies, establece CIELE_TRUSTED_PROXY_HOPS al número de esos proxies. A continuación, la aplicación utiliza la dirección que añadió el proxy más externo, y un cliente no puede cambiarla.

Las suscripciones personales activadas no ocupan una plaza.

Endpoint MCP alojado

Establece CIELE_MCP_READ_ONLY=1 en deploy/.env para que el endpoint MCP alojado, /api/mcp, rechace todas las acciones de mutación. El ajuste se aplica a todas las claves API. Se aplica cuando la aplicación responde al endpoint y cuando el servicio Rust responde a él.

Servicio de API de Rust

El servicio Rust opcional ejecuta algunas operaciones en lugar de la aplicación. También responde directamente a algunos endpoints de /api/v1. Está desactivado de forma predeterminada. La pila lee su archivo Compose, deploy/docker-compose.rust.yml, únicamente cuando COMPOSE_FILE lo incluye en su lista.

Ejecuta el script de arranque con la opción --rust:

./deploy/bootstrap.sh --rust

El script añade el archivo a COMPOSE_FILE en deploy/.env y genera el secreto compartido. El servicio se compila desde el código fuente, también en modo imagen.

El servicio responde a estos endpoints cuando su operación está en CIELE_RUST_OPERATIONS:

• GET /api/v1/alerts y POST /api/v1/alerts/{id}/resolve
• GET /api/v1/improvements
• GET /api/v1/task-labels y POST /api/v1/task-labels
• PATCH /api/v1/task-labels/{id} y DELETE /api/v1/task-labels/{id}

El servicio comprueba la propia clave de API. Las respuestas son las mismas que las respuestas de la aplicación. Todos los demás endpoints van a la aplicación.

El servicio también responde al endpoint MCP alojado, /api/mcp, con las mismas herramientas. En el servicio se ejecuta una herramienta para uno de los endpoints mencionados anteriormente. Otras herramientas invocan a la aplicación con la clave API del llamante.

Un cambio realizado a través del servicio no actualiza la consola. Las páginas Alerts, Projects y Tasks pueden mostrar datos antiguos hasta que las vuelvas a cargar. La paleta de búsqueda puede mostrar el nombre anterior de una etiqueta durante un máximo de 30 segundos.

Si el servicio se detiene, la aplicación no responde a estos endpoints en su nombre. Las solicitudes fallan hasta que el servicio se reinicia. Para recuperarte de inmediato, elimina docker-compose.rust.yml de COMPOSE_FILE y reinicia la pila.

Puntos de conexión de widgets

El servicio también puede responder a algunos endpoints públicos de widgets. Esta opción está desactivada de forma predeterminada. Para activarlo, establece CIELE_RUST_WIDGET_ROUTES en deploy/.env y, a continuación, reinicia la pila. Por ejemplo:

CIELE_RUST_WIDGET_ROUTES=config,session

El servicio puede responder a estos endpoints de widgets: config, session, feedback, conversation-feedback, conversations, help-desks, memories y sources. El endpoint sources es la descarga de un archivo Source. Todos los demás endpoints de widgets van a la aplicación.

La pila proporciona al servicio la clave de cifrado, las claves del modelo y el almacenamiento de archivos de la aplicación. Por este motivo, un Visitor que inicia sesión permanece conectado, y la lista de modelos en el widget es la misma.

Si el servicio se detiene, falla uno de los endpoints del widget incluidos en la lista. El widget muestra un error hasta que el servicio se reinicie. Para recuperarte inmediatamente, establece CIELE_RUST_WIDGET_ROUTES con un valor vacío y reinicia la pila.

Para detener el servicio, elimina docker-compose.rust.yml de COMPOSE_FILE. A continuación, reinicia la pila. A continuación, todas las operaciones se ejecutan de nuevo en la aplicación.

TLS

Termina TLS en un proxy inverso. A continuación, establece ambas variables de origen público con sus direcciones HTTPS y vuelve a compilar la aplicación.