Saltearse al contenido

Configurar el modelo IA

Futuh apoya su capa IA en gomlo_ai_agent y usa LiteLLM como conmutador. Defines uno principal y uno o varios de respaldo, y el sistema elige cuando el primero falla. Default canon: Mistral Large 2512 vía OpenRouter.

Decidir quién paga el coste IA

Section titled “Decidir quién paga el coste IA”

Va antes de la configuración técnica porque condiciona la clave que vas a meter.

  • Federado: tu instancia consume el modelo IA del Hub Central sin claves propias. La factura llega a ACPP, que la repercute en la cuota anual federada. Recomendado salvo motivo en contrario.
  • Local: tu instancia trae su propia cuenta OpenRouter. La factura te llega directamente. Útil si tienes presupuesto IA específico o restricciones de proveedor.

La elección vive en el campo Modo de facturación IA. Cambiarla más adelante requiere coordinar con el Hub Central. [VERIFY: nombre exacto del campo en UI v0.1]

Configurar el proveedor principal

Section titled “Configurar el proveedor principal”
  1. Abre Ajustes → Futuh → IA → Proveedores y haz clic en Nuevo.
  2. Rellena Nombre (por ejemplo, OpenRouter principal).
  3. En Proveedor, elige openrouter. Otros valores: openai, anthropic, mistral, ollama.
  4. En URL base, deja https://openrouter.ai/api/v1.
  5. Pega tu Clave API. Queda cifrada y solo visible para administradores.
  6. Marca Activo y guarda.

Registrar los modelos disponibles

Section titled “Registrar los modelos disponibles”
  1. Abre Ajustes → Futuh → IA → Modelos y haz clic en Nuevo.
  2. Pon como Nombre algo legible (por ejemplo, Mistral Large 2512).
  3. En Identificador, mete el slug exacto del proveedor: mistralai/mistral-large-2512, anthropic/claude-sonnet-4, openai/gpt-4o.
  4. Asocia el Proveedor que creaste antes.
  5. Si quieres usarlo para tareas con imagen, marca Soporta visión.
  6. Guarda. Repite para cada modelo disponible.

Montar el fallback automático

Section titled “Montar el fallback automático”

Si el principal falla (error de red, cuota agotada, rate limit), el sistema intenta con el siguiente. Se configura en el agente.

  1. Abre Ajustes → Futuh → IA → Agentes y selecciona el agente (por ejemplo, Silvio).
  2. En Modelo principal, elige el modelo a usar de primero (canon Futuh: Mistral Large 2512).
  3. En Modelos de respaldo, añade en orden los modelos a los que recurrir. Recomendación canon: GPT-4o segundo, Claude Sonnet 4 tercero. La diversidad de proveedores reduce el riesgo de caída simultánea.
  4. Ajusta Temperatura y Tokens máximos si tienes preferencia. Defaults 0,3 y 2048.
  5. Guarda.

Verificar que todo funciona

Section titled “Verificar que todo funciona”
  1. Abre Discuss y entra en el canal del agente configurado.
  2. Escribe una pregunta corta: «¿Qué módulos Futuh tengo activos?».
  3. Verifica que la respuesta llega en menos de diez segundos y cita correctamente los módulos.
  4. Para comprobar el fallback, desactiva temporalmente el proveedor principal y repite. La respuesta debería llegar igual con un retraso de 2-3 segundos.

Solución de problemas frecuentes

Section titled “Solución de problemas frecuentes”
  • «No active provider». Ningún proveedor está activo. Vuelve a Proveedores y marca al menos uno.
  • «I cannot help with that» en inglés. El modelo rechaza el contenido por política propia. Revisa el system_prompt del agente: probablemente le falta contexto Futuh.
  • Coste IA mensual más alto de lo esperado. Abre Ajustes → Futuh → IA → Registro de invocaciones y filtra por modelo. Causa típica: un agente con max_tokens muy alto generando respuestas largas.

Próximos pasos

Section titled “Próximos pasos”