Cambiar el modelo de un agente del flujo

Cada paso de agente de un flujo elige su propio modelo, algo totalmente independiente de la configuración de Ajustes de cuenta → Asistente de IA. Dentro del mismo flujo es habitual que un paso clasifique con un modelo barato y otro redacte el informe con uno potente.

Dónde se cambia

1. Abre el editor de flujos y selecciona ese paso de agente en el lienzo.
2. Abre el diálogo de configuración del agente.
3. Mira primero el modo de configuración arriba: plantilla preajustada o personalizado. El modelo está en un sitio distinto en cada modo.

Modo preajuste: basta con sobrescribir dos campos

Al elegir un preajuste (universal, coder, researcher, etc.), todos los campos siguientes funcionan como sobrescrituras: si los dejas vacíos, se aplica el valor del preajuste. Para cambiar el modelo solo hacen falta dos:

• Provider — Elige el proveedor. Al cambiarlo, la lista de modelos se vuelve a cargar para el nuevo proveedor.
• LLM modelo — Elige de la lista o escribe el ID del modelo. Si lo dejas vacío, sigue el modelo por defecto del preajuste.

Modo personalizado: primero el enrutamiento, después el modelo

El modo personalizado añade una capa más, el bloque de enrutamiento External Agent, con tres opciones que deciden quién ejecuta este paso:

Los tres enrutamientos también tratan el prompt de sistema de forma distinta: el agente estándar lo usa tal cual; Claude Code lo añade con --append-system-prompt; Codex no tiene parámetro propio de prompt de sistema, así que ese texto se antepone al prompt de la tarea y se envía junto.

¿No encuentras el modelo que quieres en la lista?

Mira primero el selector de tipo de modelo en la parte superior del diálogo: texto, vídeo o imagen:

• Si eliges vídeo o imagen, la lista solo muestra modelos compatibles con ese tipo y no deja escribir el ID a mano;
• Solo con el tipo texto puedes escribir directamente cualquier ID de modelo.

Así que una lista de modelos vacía suele deberse a dos cosas: el tipo de modelo está en imagen o vídeo, o acabas de cambiar de proveedor y la lista no se ha recargado. Cerrar y reabrir el desplegable fuerza la recarga.

Cómo se localiza la credencial

• En ejecución busca en el centro de credenciales una del mismo proveedor, en orden personal → equipo → sistema. El archivo del flujo nunca guarda la clave en texto plano.
• La sección plegable «centro de credenciales» del diálogo enumera qué proveedores usa la configuración actual; solo tienes que completar los que falten.
• Los flujos antiguos pueden llevar aún una clave en texto plano dentro de las sobrescrituras del preajuste; la página te invita a migrarla al centro de credenciales y luego limpiarla.

Ver instrucciones completas para la gestión de credenciales

Alias de modelos personalizados

El diálogo permite registrar un modelo personalizado: das un alias a una pareja proveedor + ID de modelo y aparece en el desplegable. Útil para pasarelas proxy internas, modelos autoalojados o novedades que la lista oficial aún no recoge.

Cómo se ve en YAML

Cada cambio en el lienzo se sincroniza con el YAML. Si escribes YAML directamente, la configuración del modelo va en la definición del agente:

agents:
  - name: summarizer
    preset: universal
    llm:
      provider: openrouter
      model: anthropic/claude-sonnet-4.5

  - name: classifier
    preset: lightweight
    llm:
      provider: deepseek
      model: deepseek-chat

provider lleva el identificador del servicio (openai, openrouter…), no la etiqueta que le pusiste a la credencial. Es el error más frecuente.

Algunos consejos prácticos

• Usa un modelo pequeño para pasos deterministas como clasificar o extraer, y reserva el modelo potente para redactar y razonar: mezclar modelos en un mismo flujo es totalmente normal.
• Tras cambiar de modelo, haz un dry-run o una ejecución paso a paso para comprobar que el formato de salida no cambió antes de programarlo.
• En los flujos compartidos con el equipo, apunta a credenciales de equipo; si no, tus compañeros no resolverán ninguna clave al ejecutarlos.

Sigue leyendo

• Explicación detallada de la configuración del Agente — Preajustes, conjuntos de herramientas, iteraciones máximas y los demás campos.
• Cambiar la identidad y el modelo del asistente — El modelo del asistente de IA de la plataforma es un ajuste aparte.
• BYOK viene con llave — Dónde conseguir la clave de cada proveedor y en qué factura cae el coste.