Saltar al contenido principal

Usar un agente de programación instalado como modelo de chat

Si ya pagas por un agente y ha iniciado sesión en la máquina que ejecuta Libre WebUI, puedes hablar con él desde un chat normal sin añadir otra clave API. Libre WebUI detecta su CLI y la ofrece en el selector.

Qué se detecta​

En cada solicitud de modelos, Libre WebUI busca estos comandos en el PATH del servidor:

ModeloComandoProveedor
Claude CodeclaudeAnthropic
CodexcodexOpenAI
OpenCodeopencodeSST
PipiMario Zechner

Lo encontrado aparece en Agentes. No se instala nada ni hace falta configuración: si el comando funciona en el shell del servidor, aparece.

Configuración → Chat → Predeterminados también identifica estas entradas como Agente, incluido Strands cuando tu cuenta puede usarlo. Los modelos de plugins conservan el nombre del proveedor; solo los de Ollama llevan esa etiqueta. Desactivar Ollama no oculta agentes ni plugins configurados. La tarjeta muestra el nombre y proveedor de la entrada seleccionada, con tamaño, familia y formato solo si el catálogo los proporciona.

Elegir un modelo, no solo una CLI​

Cada CLI puede exponer varias entradas en el grupo Agentes:

  • Claude Code ofrece el predeterminado y Sonnet, Opus y Haiku, además de las opciones explícitas Sonnet 5.5 (claude-sonnet-5-5) y Opus 5.5 (claude-opus-5-5). Sonnet 5.5 requiere Claude Code 2.1.284 o posterior y Opus 5.5 requiere Claude Code 2.1.280 o posterior, ambos con acceso mediante la cuenta con sesión iniciada; ejecute claude update para actualizar la CLI. Los alias Sonnet y Opus existentes siguen usando la asignación de modelos actual de la CLI.
  • Codex ofrece el predeterminado y GPT-6 Astra, GPT-6.1 Sol (gpt-6.1-sol), GPT-6 Sol, GPT-6 Luna, GPT-5.6 Sol, Terra, Luna, GPT-5.5 y GPT-5.3 Codex Spark. La disponibilidad depende de la sesión de la CLI y del acceso de la cuenta.
  • Pi usa el modelo configurado en su CLI.
  • OpenCode lista los modelos de los proveedores autenticados (opencode models) y exige una selección explícita.

El motor Strands integrado también aparece en el grupo Agentes cuando tu cuenta puede usarlo. No es un CLI: se ejecuta dentro del backend y usa tus modelos de Ollama y de plugins de proveedores. La entrada simple Strands (strands) usa tu modelo de chat predeterminado. Las demás entradas (strands:<route>) muestran una opción por cada modelo disponible, por ejemplo Strands · gpt-5.6-sol (Codex (ChatGPT)), y fijan tanto el modelo como su proveedor para esa conversación; otro proveedor disponible no puede sustituirlo durante una caída. Listar las opciones no inicia el motor.

Las mismas entradas Strands sirven como modelo de tareas en Configuración → Chat → Predeterminados para títulos automáticos y resúmenes de razonamiento. Usar el modelo en ejecución utiliza la selección Strands guardada de la conversación. Estas solicitudes breves de texto llaman directamente al modelo subyacente del proveedor; no ejecutan las herramientas del agente ni crean una sesión de agente. Los demás perfiles CLI necesitan un modelo de tareas de Ollama, de plugin o de Strands para estas solicitudes auxiliares.

Pi ejecuta cada turno sin estado (--no-session), sin herramientas locales y con un mensaje neutro, por lo que no toca la configuración personal del usuario del servidor.

Uso​

  1. Inicia sesión como administrador.
  2. Abre un chat y el selector.
  3. Elige una entrada de Agentes.
  4. Envía mensajes normalmente; las respuestas fluyen token a token.

La conversación se guarda como cualquier chat. Cada turno envía una transcripción reciente al agente.

Quién puede usarlo y a qué accede​

Esta función es exclusiva de administradores, por un motivo importante. El agente se ejecuta en el host con el mismo usuario del sistema que el backend Libre WebUI, no dentro de un contenedor Work. Hereda las credenciales de agentes de ese usuario y su acceso habitual, incluida la capacidad de leer archivos y ejecutar comandos en el servidor si lo decide.

Considera la activación equivalente a conceder acceso shell al agente. Por eso se distribuye desactivada: un administrador debe habilitarla en Configuración → Gestión de usuarios → Acceso y políticas → Modelos de agentes CLI. El ajuste se guarda y entra en vigor inmediatamente, sin reiniciar.

Cambiar este control actualiza el catálogo de modelos inmediatamente; la categoría Agentes contiene las entradas CLI directas, mientras que Modelos de plugins contiene integraciones API de proveedores como Codex (ChatGPT). Strands aparece en la misma categoría, pero sigue su propio ajuste de acceso Motor Strands y no este interruptor, así que puede aparecer aunque los modelos de agentes CLI estén desactivados. Su detección de modelos no puede bloquear la detección de los agentes CLI instalados.

Las instalaciones existentes heredan su decisión anterior de Agentes hasta guardar un ajuste CLI independiente.

Para fijar la decisión en el despliegue:

AGENT_CLI_MODELS_ENABLED=false   # or true

Para actuar sobre archivos dentro de un sandbox, usa Work.

Seguimiento del uso​

Abre Uso del proveedor (/usage) y busca Agentes cerca de la parte superior. Claude Code, Codex, OpenCode, Pi y Strands tienen entradas explícitas, incluido un mensaje claro si no hay llamadas registradas en el período.

Las llamadas CLI realizadas desde LWUI registran resultado, duración y tokens reportados. Cada invocación crea un evento; las instantáneas repetidas y los informes por paso no duplican eventos ni contadores. Los contadores ausentes quedan sin reportar. Detener una respuesta registra cancelación, y una salida CLI fallida no pasa a ser correcta solo porque produjo texto parcial. No se importa el uso de llamadas CLI externas a LWUI.

Las llamadas de Strands se atribuyen al agente Strands. Consulta Uso de agentes para el desglose y los límites.

Configuración​

VariablePredeterminadoPropósito
AGENT_CLI_MODELS_ENABLEDsin definirFijar true/false; sin valor usa el interruptor de administración
AGENT_CLI_TIMEOUT_MS600000Duración máxima de un turno antes de terminarlo

Solución de problemas​

No aparece el grupo Agentes. Comprueba que la función esté activada en Configuración → Gestión de usuarios → Acceso y políticas → Modelos de agentes CLI (está desactivada por defecto) y que hayas iniciado sesión como administrador. Después verifica que el comando esté en el PATH del proceso backend, no solo en el shell interactivo. Un servicio, contenedor Docker o lanzador de escritorio suele tener un PATH mucho menor que un terminal de inicio de sesión.

La respuesta falla de inmediato. Ejecuta el comando como usuario del servidor (claude -p "hello" o codex exec "hello"). Suele ser una sesión caducada o un límite del abono. Para OpenCode, repite opencode auth login como usuario del servidor.

La respuesta se detiene. Puede haber alcanzado AGENT_CLI_TIMEOUT_MS; auméntalo o divide la petición.