Configuración¶

La mayoría de las opciones cotidianas de la plataforma se encuentran en IA ‣ Configuración. Los valores predeterminados globales, que corresponden a parámetros del sistema, están en la página Ajustes (solo para usuarios con acceso a Ajustes).

Ajustes¶

Abra IA ‣ Configuración ‣ Ajustes (o la sección de IA en la aplicación principal de Ajustes).

Configuración guiada del sistema¶

Iniciar asistente de configuración — abre el chat con la habilidad de configuración guiada para administradores del sistema. La instalación de módulos nunca es libre: cuando se utilizan planes de configuración, la instalación pasa por un plan que debe confirmarse (el MVP puede limitarse a proponer).

Salvaguardas contra el abuso¶

Ajustes	Significado
Ai Max Strikes	Infracciones dentro de la ventana antes de una prohibición temporal (3 de forma predeterminada).
Ai Strike Window Hours	Horas durante las cuales se acumulan las faltas (24 de forma predeterminada).
Ai Ban Minutes	Duración de la prohibición (60 de forma predeterminada).

Límites de frecuencia y uso¶

Ajustes	Significado
Ai Rate Limit Rpm	Número máximo de solicitudes por minuto y por usuario (20 de forma predeterminada).
Ai Max Daily Calls	0 = sin límite.
Ai Max Daily Cost Usd	Límite de coste flexible basado en los precios unitarios del modelo; 0 = sin límite. Los modelos sin precio definido pueden no aplicar bien el control de coste.
Ai Max Conversations Per Day	0 = sin límite.
Ai Max Successive Calls	Límite de turnos encadenados del modelo (10 de forma predeterminada).
Ai Max Tool Calls	Límite de invocaciones de herramientas por ciclo de turno (10 de forma predeterminada).
Ai Write Mode	Solo para el chat interactivo — auto / confirm / hybrid. Las ejecuciones de agentes utilizan en su lugar el Write Mode propio de cada tarea (confirm de forma predeterminada). Consulte Uso del asistente y Modo de escritura de la tarea (solo ejecuciones de agente).
Chat write-proposal lifetime (minutes)	Minutos hasta que caduca una propuesta del chat; 0 = nunca.
Agent write-proposal lifetime (minutes)	Minutos hasta que caduca una propuesta de un agente (1440 de forma predeterminada); 0 = nunca.

Registro¶

Ai Log Level — Metadata only (predeterminado, recomendado) o Full payload (almacena el contenido de los mensajes/herramientas; alta sensibilidad).
Run Step Retention (Days) — horizonte de purga para las filas del diario ai.agent.run.step (90 de forma predeterminada; 0 la desactiva). No purga automáticamente ai.log ni las cabeceras de las ejecuciones.

Modelo¶

AI Model — el modelo utilizado por el asistente interactivo. Su proveedor se usa automáticamente.

Este ajuste solo afecta al asistente interactivo. El límite de finalización por agente se establece en el propio agente (Agentes) y depende del registro del modelo — consulte Límites de la respuesta generada.

Valores predeterminados de la política de acceso¶

Se aplican cuando ninguna ai.access.rule más específica decide:

Lectura predeterminada: Allow
Creación/escritura/eliminación predeterminadas: Deny

Consulte Política de acceso para conocer las reglas y los grupos.

Introspección en tiempo de ejecución¶

Publish Installed Modules — indica si los datos del entorno pueden incluir la lista de módulos instalados (sigue sujeto a la ACL ir.module.module del usuario). Denegarlo hace que el asistente sea más prudente, no mágicamente más preciso. Los datos de versión, edición, compañía y usuario se mantienen.

Acceso web y archivos¶

Requiere que la capacidad Web access esté habilitada para que se ofrezcan las herramientas.

Ajustes	Significado
Backend de búsqueda	`ai.web.provider` utilizado por `web_search`. Vacío = búsqueda desactivada.
Backend de obtención	Proveedor de `web_fetch`; si está vacío, se recurre a la obtención directa integrada.
Dominios permitidos	Lista de permitidos separada por comas; vacío = cualquier host público (las protecciones contra SSRF siguen aplicándose a los rangos privados).
Límite diario	Número máximo de llamadas web por usuario y por compañía; 0 = sin límite.
Texto máximo de página	Caracteres conservados de una página obtenida.
Longitud máxima de consulta	Límite del tamaño de la consulta de búsqueda.
Tipos de imagen permitidos, Tipos de documento permitidos	Listas de tipos MIME permitidos para la ingesta.
Tamaño máximo de archivo	Bytes (el valor predeterminado es 10 MiB).

Parámetros del sistema y acciones programadas¶

Algunos interruptores de la plataforma no tienen un campo en la página de Ajustes. Se encuentran en los menús Técnicos, que requieren el modo de desarrollador.

Parámetros del sistema¶

Ajustes ‣ Técnico ‣ Parámetros ‣ Parámetros del sistema

ai.triage_enabled — interruptor global para desactivar el triaje de la etapa 1, que abarca tanto la verificación de entrada como el Triaje al despachar de una tarea (el valor predeterminado es True). Si lo establece en False, cada instrucción se ejecuta sin evaluar.
ai.waiting_approval_ttl_minutes — cuánto tiempo puede esperar una ejecución la respuesta de un supervisor antes de fallar (el valor predeterminado es 1440; 0 significa que nunca expira por antigüedad).
ai.run_reaper_grace_seconds — cuánto tiempo, más allá del límite de tiempo propio de la tarea, espera el recolector de ejecuciones bloqueadas antes de declarar una ejecución como abandonada (el valor predeterminado es 600, es decir, 10 minutos). Esto no es un interruptor de apagado: para detener por completo la recolección, desactive la acción programada.

Acciones programadas¶

Ajustes ‣ Técnico ‣ Automatización ‣ Acciones programadas

El módulo incluye siete acciones programadas, todas activas después de la instalación:

AI: Expire user bans (cada hora) — levanta las suspensiones temporales cuya hora de finalización ya pasó.
AI: Expire pending writes (cada 15 minutos) — hace expirar las propuestas de escritura más antiguas que su tiempo de vida configurado. Primero libera las propuestas dejadas por una ejecución que ya finalizó, por lo que un tiempo de vida de 0 no desactiva también esa limpieza.
AI: dispatch scheduled agent tasks (cada 5 minutos) — inicia las tareas de agente que están pendientes. Esto solo indica con qué frecuencia se activa el propio despachador; el intervalo propio de cada tarea decide su cadencia, por lo que el cron debe activarse al menos con la misma frecuencia que el intervalo más corto configurado en una tarea.
AI: drain inbound addressing requests (cada minuto) — inicia las ejecuciones puestas en cola cuando alguien se dirige a un agente mediante un mensaje de Conversaciones, una mención en el chatter, una actividad o una asignación. Es deliberadamente más frecuente que el despachador, porque alguien está esperando la respuesta.
AI: expire waiting-approval agent runs (cada 15 minutos) — hace fallar las ejecuciones que han esperado la respuesta de un supervisor durante más tiempo que ai.waiting_approval_ttl_minutes, y hace expirar las propuestas que estaban esperando.
AI: reap stuck agent runs (cada 15 minutos) — cierra las ejecuciones cuyo proceso trabajador murió, y también libera las ejecuciones estacionadas a la espera de aprobación cuando ya no queda nada que aprobar. Ambas tareas, su cadencia y su límite por lote se describen en Ejecuciones cuyo proceso ha muerto.
AI: memory maintenance (cada 6 horas) — archiva las memorias de trabajo que superaron su fecha de expiración, permite que la relevancia de las entradas no utilizadas disminuya, y marca las entradas personales de alta relevancia como candidatas a promoción para un administrador.

Proveedores y modelos LLM¶

IA ‣ Configuración ‣ Proveedores ‣ Proveedores LLM

Campos de interés:

Tipo de proveedor y clave de API (almacenados como parámetros del sistema).
Base Url — modifique este valor solo si comprende el límite de confianza (una URL base modificable puede suponer un riesgo de SSRF si se apunta a servicios internos).
Tiempo de espera, Número máximo de reintentos, Plazo de la llamada — presupuesto de tiempo real para una llamada al proveedor, incluidos los reintentos.

IA ‣ Configuración ‣ Proveedores ‣ Modelos

Modelo — el id exacto del proveedor.
Ventana de contexto, Número máximo de tokens de salida, indicadores de compatibilidad con herramientas y con temperatura.
Precios unitarios del prompt y de la respuesta generada, y origen del precio (API del proveedor, catálogo revisado o manual; el valor manual no se sobrescribe con la actualización).

Límites de la respuesta generada¶

El Número máximo de tokens de salida del modelo es el límite con el que el asistente recorta sus respuestas, y también es la condición previa para un límite por agente. Solo los proveedores que publican un límite de finalización lo completan; 0 significa desconocido.

El propio Número máximo de tokens (0 = sin anulación) de un agente (Agentes) llega a todos los proveedores (OpenAI, OpenRouter, xAI, Google Gemini y Anthropic), cada uno bajo el nombre de parámetro que espera su API. Solo se envía en la llamada si el modelo publica su propio Número máximo de tokens de salida. Si asigna a un agente un modelo que todavía indica 0, el valor del agente se descarta: el modelo se ajusta a su propio límite, y nada en el formulario del agente explica el motivo. Complete el Número máximo de tokens de salida en el modelo si quiere que el límite por agente surta efecto.

0 en el agente (el valor predeterminado) significa sin anulación: se aplica el límite de salida propio del modelo, tal como ocurre en un turno sin ningún agente. Establezca un valor positivo solo cuando quiera deliberadamente que ese agente sea más conciso o económico, y recuerde que en los modelos de razonamiento el límite también cuenta los tokens de pensamiento, por lo que un valor bajo trunca las respuestas.

Nota

Anthropic es la excepción, en sentido contrario: su API siempre exige este parámetro. Por ello, un modelo de Anthropic cuyo Número máximo de tokens de salida todavía sea 0 recurre a un valor conservador integrado de 1024 tokens, y no al límite real del modelo.

Advertencia

El Número máximo de tokens de salida de una fila del catálogo suele ser casi toda la Ventana de contexto (por ejemplo, 450 000 de 500 000). Proveedores como OpenRouter rechazan la llamada cuando prompt + herramientas + max_tokens supera la ventana, incluso si el prompt en sí todavía cabe. Por ello, la plataforma recorta el límite de la respuesta en cada llamada a lo que aún quepa tras una sobreestimación del prompt. Un primer turno pequeño sigue obteniendo el límite de salida publicado; una ronda de herramientas grande obtiene un remanente menor. Esto no ayuda cuando el prompt por sí solo ya supera la ventana; en ese caso, divida el trabajo (consulte Elementos de trabajo por registro).

Advertencia

Actualizar desde una versión anterior cambia el comportamiento de los agentes que ya están configurados.

Un límite que un administrador ya había escrito en un agente antes solo llegaba a Anthropic. Ahora se aplica a todos los proveedores, por lo que un valor bajo que antes era inofensivo en OpenAI, OpenRouter, xAI o Gemini empieza a truncar las respuestas también ahí.
La actualización restablece a 0 el antiguo valor predeterminado de fábrica 2048 en todos los agentes que todavía lo conservan, para que ninguna base de datos mantenga un límite que nadie eligió. En un modelo de Anthropic que publica su propio límite, ese 2048 realmente estaba en vigor: esos agentes ahora pueden escribir hasta el Número máximo de tokens de salida completo del modelo; más tokens, más costo y más tiempo, y una respuesta lo bastante larga como para agotar el Plazo de la llamada del proveedor fallará con un error en lugar de detenerse en los 2048 tokens.

Cualquier otro valor que haya escrito se conserva. Vuelva a introducir un límite en cada agente que quisiera limitar, incluido uno que hubiera establecido deliberadamente en 2048.

Proveedores web¶

IA ‣ Configuración ‣ Proveedores ‣ Proveedores web

Configure los backends de búsqueda/obtención de páginas (pueden incluirse filas de fábrica para motores comunes). Asígnelos en Ajustes como backends de búsqueda/obtención de páginas.

Servidores MCP¶

IA ‣ Configuración ‣ Proveedores ‣ Servidores MCP

Los servidores del Protocolo de contexto de modelo (Model Context Protocol) exponen herramientas externas al asistente cuando la capacidad herramientas MCP está habilitada. Las definiciones MCP de fábrica pueden incluirse inactivas o sin secretos configurados.

Por cada servidor, normalmente se configura:

endpoint / transporte;
secretos de autenticación (nunca los incluya en la documentación ni en git);
qué usuarios/grupos pueden usar las herramientas del servidor;
activar/desactivar.

Cada llamada MCP vuelve a verificar la capacidad y la audiencia del servidor. Trate MCP como si instalara complementos no confiables: aplique el mínimo privilegio y evite incluir secretos de producción en las respuestas de herramientas que no necesita.

Capas de prompt¶

IA ‣ Configuración ‣ Comportamiento ‣ Capas de prompt

Los prompts de sistema organizados en capas (núcleo, global, módulo, …) determinan el comportamiento. Las capas de seguridad del núcleo no están pensadas para editarse a la ligera. Los administradores de IA pueden ajustar las capas operativas globales; las migraciones solo actualizan el contenido de fábrica cuando sigue intacto.

Importante

El Cuerpo de una capa está solo en inglés y no es traducible. Estos son los rieles que guían al modelo, no texto orientado al usuario: unos rieles que cambiaran de idioma junto con la interfaz dejarían las instrucciones en un idioma y los nombres de las herramientas en otro. El asistente sigue respondiendo en el idioma de la conversación, algo que decide los mensajes del usuario, nunca este texto.

En una base de datos actualizada desde una versión anterior, cada capa conserva su cuerpo en inglés y se descarta cualquier cuerpo traducido. Vuelva a revisar cada capa global y por módulo cuyo cuerpo hubiera editado en una interfaz traducida.

Patrones bloqueados¶

IA ‣ Configuración ‣ Seguridad ‣ Patrones bloqueados

Reglas de expresiones regulares (o patrones) sobre la entrada/salida que generan infracciones cuando coinciden (por ejemplo, las clásicas pruebas de «ignora las instrucciones anteriores»). Amplíelas con cuidado: los patrones demasiado amplios generan falsos positivos y ruido de sanciones.

Acciones permitidas¶

IA ‣ Configuración ‣ Seguridad ‣ Acciones permitidas

Lista de permitidos de métodos de negocio que la capacidad Action puede invocar mediante call_action (por ejemplo, marcar una actividad como hecha). Los métodos que no están en la lista no se pueden invocar a través de la IA, aunque la escritura (Write) esté activada. Para las transiciones de ciclo de vida, prefiera las acciones incluidas en la lista de permitidos en lugar de escrituras directas de campos.

Registro de personalizaciones¶

IA ‣ Configuración ‣ Personalizaciones

Cuando se usa Customize UI & schema, los cambios quedan registrados en un libro con opciones de importación/exportación para su recuperación. La experiencia principal sigue siendo las herramientas de chat para administradores; el registro es la vía de recuperación para el administrador.

Planes de configuración¶

IA ‣ Configuración ‣ Planes de configuración (usuarios de Ajustes)

Planes propuestos por el flujo de configuración guiada para pasos de instalación/configuración de módulos que requieren confirmación explícita.