Las páginas sin traducir se abren en inglés y se indican como inglés.
Esta página es una traducción automática de la página en inglés, que prevalece. Machine-translated from the English page, which is authoritative.
Ajustes en tiempo de ejecución
Cada ajuste es una variable de entorno LOOM_<FIELD> que se lee al arrancar, y también puede ir en el archivo de ajustes YAML (referencia de configuración). Un ajuste que la referencia marca como live admite además una sobrescritura para todo el despliegue mientras Loom está en ejecución (entre ellos la recuperación y el ranking, memory_search_*; la síntesis de respuestas, memory_ask_*; el ajuste de la extracción, del contexto y del conocimiento; y el agrupamiento de inserciones en ClickHouse, ch_batched_insert*). Todos los demás ajustes se leen una sola vez al arrancar y cambian con un reinicio. Los umbrales de similitud que la calibración reemplaza
(memory_search_min_similarity, memory_search_abstain_threshold,
memory_search_hyde_fallback_threshold, memory_search_query_rewrite_threshold) no son
live: con LOOM_ADAPTIVE_THRESHOLDS activado se aplican solo cuando no hay calibración.
Ver qué está en vigor
loom settings list --changed # off its default, or overridden
loom settings list --prefix memory_ask_ # one area
loom settings list --json
Cada línea muestra el valor, de dónde viene y si es live:
memory_ask_recency_weight = 0.35 (override, live)
ch_host = "clickhouse" (env)
| Origen | Significado |
|---|---|
override |
establecido con loom settings set o /v1/admin/settings.set |
dashboard |
la configuración de modelos guardada en Settings → Models & keys |
env |
el entorno del proceso |
env_file |
el archivo dotenv (LOOM_ENV_FILE, por defecto .env), también cuando se copia al entorno |
settings_file |
el archivo de ajustes YAML (LOOM_SETTINGS_FILE), también cuando scripts/serve.sh lo exporta |
inferred |
rellenado al arrancar a partir de otros ajustes (el proveedor de LLM, la dimensión de un modelo local) |
default |
el valor predeterminado incorporado |
Un secreto muestra solo su longitud.
Sobrescribir un ajuste live
loom settings set memory_ask_recency_weight 0.35
loom settings reset memory_ask_recency_weight
El valor se escribe como lo haría su variable de entorno y se valida de la misma forma: un valor fuera de rango, o un ajuste que no es live, se rechaza y no se guarda nada. La sobrescritura es una fila de loom.runtime_overrides. El proceso que la guarda la aplica de inmediato; todos los demás procesos, incluidos los workers, la aplican en un plazo de LOOM_RUNTIME_OVERRIDES_REFRESH_SECONDS (por defecto 10). Sobrevive a un reinicio y prevalece sobre el entorno y el archivo de ajustes hasta que se restablece; al restablecer, cada proceso recupera su propio valor o el predeterminado. reset rechaza un ajuste sin sobrescritura guardada, y elimina la sobrescritura de un ajuste que una compilación posterior ya no tiene. Cada cambio escribe una fila de auditoría setting.changed con el valor anterior y el posterior.
--expect <value> (expected por HTTP) no cambia nada a menos que ese sea el valor en vigor tras una lectura nueva de las sobrescrituras guardadas, y responde 409 PRECONDITION_FAILED con el valor que encontró: un cambio hecho entretanto desde otra réplica o desde la CLI no se sobrescribe sin que se vea. Dos cambios enviados en el mismo instante aún pueden pasar ambos.
Ver y deshacer cambios anteriores
loom settings history memory_ask_recency_weight
loom settings history --limit 20 # every setting
Cada línea es un cambio registrado, del más reciente al más antiguo: cuándo, quién (cli:<user> o el sujeto del token) y el valor anterior y el posterior. Un valor anterior que era una sobrescritura es el del despliegue: se deshace volviendo a establecerlo con loom settings set. Cualquier otro era el valor del proceso que hizo el cambio (su entorno o un valor predeterminado), marcado con (undo: reset): se deshace con loom settings reset, que restaura el valor propio de cada réplica. Un cambio sin valor anterior (el restablecimiento de un ajuste que esta compilación ya no tiene) no tiene nada que deshacer.
Una sobrescritura es el valor predeterminado del despliegue, de modo que lo que establece un espacio de nombres o una solicitud sigue prevaleciendo sobre ella: los retrieval_defaults de un espacio de nombres (top_k, min_similarity, reinforcement_weight y los demás parámetros de búsqueda que acepta namespace.register) y los campos propios de una solicitud.
Las mismas operaciones por HTTP, con un token de administrador de la plataforma. Con la autenticación desactivada, un cambio solo se acepta desde una dirección de loopback (localhost): de lo contrario, una página web podría alcanzarlo mediante DNS rebinding.
curl -s "$LOOM_BASE_URL/v1/admin/settings.list" -H "Authorization: Bearer $TOKEN" \
-H 'content-type: application/json' -d '{"changed": true}'
curl -s "$LOOM_BASE_URL/v1/admin/settings.set" -H "Authorization: Bearer $TOKEN" \
-H 'content-type: application/json' -d '{"name": "memory_ask_recency_weight", "value": 0.35}'
curl -s "$LOOM_BASE_URL/v1/admin/settings.set" -H "Authorization: Bearer $TOKEN" \
-H 'content-type: application/json' -d '{"name": "memory_ask_recency_weight", "clear": true}'
POST /v1/admin/settings.history acepta {"name": "...", "limit": 50}. El SDK de Python tiene agent.deployment.settings(), set_setting(name, value, expected=...), reset_setting(name, expected=...) y setting_history(name).
Durante una actualización progresiva
Una compilación que no tiene un ajuste, que no lo lee en vivo, o cuyo campo rechaza el valor guardado, registra la sobrescritura guardada una sola vez y la ignora; los demás procesos siguen aplicándola. Una compilación anterior a la existencia de los ajustes en tiempo de ejecución ignora las sobrescrituras guardadas sin avisar, así que mientras una siga en servicio, una sobrescritura se aplica solo en las réplicas más nuevas. Los ajustes de ranking cambian lo que devuelve memory.search: mide un cambio con un benchmark antes de conservarlo (ejecutar un benchmark).