Tutorial 28: Configuración del Proveedor

Tutorial 28: Configuración del Proveedor

¡Bienvenido de nuevo! En este tutorial, nos adentramos en cómo Hermes decide qué modelo de IA hace qué. Si alguna vez te has preguntado por qué algunas tareas se sienten más rápidas que otras, o cómo hacer que tu agente sea más barato de ejecutar, esto es para ti.

Dos Tipos de Ranuras de Modelo

Piensa en Hermes como un equipo. Tienes tu modelo principal — la estrella que maneja cada mensaje del usuario, cada llamada a herramienta y cada respuesta en streaming. Este es el cerebro de tu agente.

Pero la estrella no hace todo. Hermes descarga trabajos más pequeños y repetitivos a modelos auxiliares. Estos son los compañeros de reparto: compresión de contexto, análisis de imágenes, resumen de páginas web, puntuación de aprobaciones, enrutamiento de herramientas MCP, generación de títulos de sesión y búsqueda de habilidades. Cada una de estas 11 tareas tiene su propia ranura, y puedes sobrescribir cada una de forma independiente.

El Camino Más Rápido: Nous Portal

Antes de entrar en detalle, aquí tienes un atajo. Nous Portal te da acceso a más de 300 modelos con una sola suscripción. En una instalación nueva, solo ejecuta:

hermes setup --portal

Eso te inicia sesión y configura Nous como tu proveedor en un solo comando. ¿Curioso por saber qué está conectado? Compruébalo con hermes portal info. Los suscriptores de Portal también obtienen un 10% de descuento en proveedores facturados por tokens, que es un buen extra.

La Página de Modelos

Abre tu panel de control y haz clic en Modelos en la barra lateral. Verás dos secciones:

1. Configuración de modelos — el panel superior donde asignas modelos a las ranuras.
2. Analíticas de uso — tarjetas clasificadas que muestran cada modelo que ha ejecutado una sesión, con recuentos de tokens, coste e insignias de capacidades.

La fila principal muestra lo que tu agente usará para nuevas sesiones. Haz clic en Cambiar para abrir el selector.

Configuración del Modelo Principal

El selector tiene dos columnas:

• Izquierda — tus proveedores autenticados. Solo los proveedores que has configurado (clave API, OAuth o endpoint personalizado) aparecen aquí. ¿Falta alguno? Ve a Claves y añade la credencial.
• Derecha — la lista curada de modelos para ese proveedor. Estos son los modelos agénticos que Hermes recomienda, no el volcado crudo de /models (que en OpenRouter incluye más de 400 modelos, incluidos TTS y generadores de imágenes).

Elige un modelo, pulsa Cambiar, y Hermes lo escribe en ~/.hermes/config.yaml. Importante: esto se aplica solo a sesiones nuevas. Tus pestañas de chat abiertas siguen ejecutando su modelo original. Para cambiar en caliente el chat actual, usa el comando de barra /model dentro de él.

Cambios a Mitad de Sesión: Lo Que Debes Saber

¿Cambiar de modelo a mitad de conversación? Hermes estimará si tu próximo mensaje activa la compresión de contexto con la ventana del nuevo modelo. Si estás cerca del umbral, verás una advertencia — pero el cambio se aplica igualmente de inmediato.

Gran advertencia: los cambios a mitad de sesión restablecen la caché de prompt. Las cachés están vinculadas al modelo que sirve la solicitud, así que cualquier cambio significa que el siguiente mensaje relee toda la conversación al precio completo de tokens de entrada en lugar de la tarifa cacheada (con descuento de ~75–90%). En una sesión larga, esa relectura única puede costar más que la diferencia por token entre modelos. Cambia cuando lo necesites, pero prefiere hacerlo al principio de una conversación.

Niveles de Entrenamiento de Datos No Supervisado

Algunos modelos (como muse-spark-1.2-contributor) tienen descuento porque el proveedor puede entrenar con tus datos. La selección interactiva siempre muestra un aviso de confirmación. Pero las rutas no interactivas — como los trabajadores de Kanban y los agentes cron — fallan de forma segura porque no pueden preguntar.

Si te parece bien para cargas de trabajo no supervisadas, registra un reconocimiento persistente:

hermes config set security.allow_data_training_tiers_noninteractive true

Hermes sigue imprimiendo la advertencia completa de política de datos en cada inicio no supervisado, así que los registros conservan un rastro de auditoría. Revócalo con:

hermes config unset security.allow_data_training_tiers_noninteractive

Configuración de Modelos Auxiliares

Haz clic en Mostrar auxiliares para revelar las 11 ranuras de tareas. Cada tarea auxiliar tiene como valor predeterminado auto — lo que significa que Hermes intenta usar tu modelo principal también para ese trabajo. Si esa ruta falla, auto sigue cadenas de respaldo específicas de la tarea, luego tus fallback_providers principales, y luego la cadena de descubrimiento integrada de Hermes.

Sobrescribe una tarea específica cuando quieras un modelo más barato o más rápido para un trabajo secundario. Es una gran manera de ahorrar tokens en trabajos repetitivos.

Una Última Nota sobre el Esquema model:

En una instalación completamente nueva, tu configuración tiene model: "" — una cadena vacía que significa “aún no configurado”. La primera vez que ejecutes hermes setup o hermes model, esa clave se actualiza a un mapeo con las subclaves provider, default, base_url y api_mode. Si alguna vez ves una cadena vacía en config.yaml, solo ejecuta hermes model (o haz clic en Cambiar en el panel) y Hermes escribirá la forma de diccionario adecuada por ti.

¡Eso es todo! Ahora sabes cómo configurar tanto tu modelo principal como los auxiliares. La próxima vez, exploraremos los proveedores de respaldo — para que tu agente nunca se caiga.