Modelos y Proveedores

Los agentes de HeroMate funcionan con HeroMate Managed AI y proveedores directos como OpenAI, Anthropic y Google Gemini. Cambiar es tocar un solo campo — sin reescribir código, sin boilerplate de adaptadores. Tus tools, memoria y prompts son agnósticos del modelo.

Proveedores soportados

La lista completa de modelos disponibles se carga dinámicamente en el dashboard cuando eliges proveedor — siempre verás lo que está soportado en ese momento. En HeroMate Managed AI, qué modelos puedes elegir está limitado por tu plan y se gestiona a nivel de organización en la página de AI Models (/{org}/ai-models).

HeroMate Managed (sin credencial)

El camino más rápido no necesita ninguna API key. Pon el proveedor en HeroMate Managed y elige un modelo — HeroMate enruta la petición por su catálogo gestionado (con OpenRouter por detrás) y cobra el consumo como AI Credits.

Conectar un proveedor (BYOK)

Para traer tu propia key de OpenAI, Anthropic o Gemini, guarda primero una credencial.

Cambiar de proveedor

Cambiar de modelo — incluso entre proveedores — es solo editar el nodo del agente. Nada más cambia:

• Tu system prompt sigue igual
• Tus tools siguen igual
• Tu memoria sigue igual (se guarda como content parts, no en formatos específicos de proveedor)
• Tu código de frontend sigue igual

Esto hace triviales los tests A/B y las estrategias de fallback. Construye una vez, prueba cualquier modelo.

Elegir el modelo adecuado

Los ids de modelo de abajo son ejemplos — consulta siempre el selector en vivo del dashboard para ver qué hay disponible ahora mismo en tu plan.

Temperatura

El campo temperature controla la aleatoriedad:

• 0.0 – 0.3 → Determinista, factual. Úsala para extracción, clasificación, output estructurado.
• 0.5 – 0.8 → Equilibrada. Valor por defecto para la mayoría de agentes de chat.
• 0.9 – 1.2 → Creativa, variada. Úsala para brainstorming, generación de contenido, respuestas diversas.

Por defecto es 0.7.

Tokens máximos de salida

El campo max_output_tokens limita cuántos tokens puede generar el modelo en una sola respuesta. Por defecto son 1024. Súbelo para respuestas largas; bájalo para mantener las respuestas (y el coste) ajustadas. En HeroMate Managed AI este valor está limitado por tu plan, así que peticiones muy grandes pueden recortarse automáticamente.

Output estructurado

A veces quieres que el agente devuelva JSON con una forma concreta en vez de texto libre — para análisis de sentimiento, extracción de datos, tagging o workflows programáticos.

Pasa un JSON Schema en el campo output_schema:

{
  "type": "object",
  "properties": {
    "sentiment": {
      "type": "string",
      "enum": ["positive", "negative", "neutral"]
    },
    "confidence": {
      "type": "number",
      "minimum": 0,
      "maximum": 1
    },
    "summary": { "type": "string" }
  },
  "required": ["sentiment", "confidence"]
}

Con esto configurado, la respuesta del agente siempre coincide con el schema. La respuesta llega en el campo object en vez de content:

{
  "object": {
    "sentiment": "positive",
    "confidence": 0.87,
    "summary": "El cliente está satisfecho con la velocidad de entrega."
  }
}

Uso y coste

Cada respuesta del agente incluye un bloque usage:

{
  "usage": {
    "prompt_tokens": 1820,
    "completion_tokens": 142,
    "total_tokens": 1962
  }
}

Cómo se te cobra depende del modo en el que corra el agente:

BYOK (tu propia key). Le pagas al proveedor directamente — HeroMate no le mete markup a tus tokens. La credencial que añadiste la cobra OpenAI / Anthropic / Google según su tarifa pública.

HeroMate Managed AI. El consumo se mide como AI Credits (con precio tipo "AI Credits / 1M tokens"). El agente devuelve un bloque managed_ai_billing junto al usage, y el coste se descuenta primero de los créditos mensuales de tu plan y luego de cualquier pack de recarga comprado. Hay una conversión a créditos — no es pass-through. Los planes Free reciben +5 AI Credits/día; Pro recibe 100/mes. Mira AI Credits y Managed AI.

Siguientes pasos