Proveedores de IA — Referencia Técnica
Referencia del comportamiento en tiempo de ejecución del modelo propio: proveedores soportados, cómo se resuelve una selección, facturación, degradación y límites.
Proveedores soportados
| Proveedor | Notas |
|---|---|
| OpenAI | |
| Anthropic | Corre sobre la interfaz nativa de Anthropic (no una capa de compatibilidad OpenAI) |
| Google Gemini | |
| Azure OpenAI | |
| Fireworks AI | |
| DeepInfra | |
| OpenRouter | |
| Personalizado | Cualquier servicio compatible con chat-completions de OpenAI; requiere la URL base del servicio |
Cada fila de proveedor guarda su propia clave, una lista de modelos habilitados y un modelo predeterminado. Hasta 10 proveedores por cuenta.
Resolución de modelo
Una conversación resuelve su modelo con esta precedencia:
- Selección explícita — el menú de modelos de esa conversación.
- Predeterminado de la cuenta — aplica solo a conversaciones nuevas en superficies que lo soportan; las existentes conservan su modelo.
- El predeterminado Nirvai de la superficie — siempre disponible, siempre al final.
Para los agentes guardados el modelo se almacena en el propio agente y siempre se resuelve contra los proveedores del dueño del agente — un compañero ejecutando un agente compartido, o un cliente escribiéndole por un canal, usa la cuenta del dueño, nunca la suya.
Dónde aplica
| Superficie | Modelo propio |
|---|---|
| Chat principal (Work) | ✅ |
| Agentes personalizados — chat web y todos los canales (WhatsApp, Telegram, Slack, Discord, Instagram, Messenger, chatbot) | ✅ vía el modelo del agente |
| Investigación | ✅ el investigador principal; las sub-búsquedas en segundo plano usan modelos de Nirvai |
| Asistentes de configuración (herramientas, credenciales, bases de datos, memorias) | ✅ |
| Pasos de Automatizaciones, Live Apps, Ayuda | Modelos de Nirvai |
| API exportada con formato estricto de respuesta (JSON schema) | Modelos de Nirvai |
Facturación
- Una respuesta generada con tu modelo registra 0 créditos. El uso (tokens de entrada/salida, modelo, proveedor) se sigue registrando y es visible en la pestaña Analítica, junto a una cifra de créditos estimados — lo que la misma respuesta habría costado con modelos de Nirvai.
- Las respuestas con modelos de Nirvai cobran créditos como siempre, incluidas las respuestas de respaldo (ver abajo).
- Eliminar un proveedor conserva su historial de uso.
Reglas de degradación
El objetivo de diseño: una clave rota degrada la conversación, nunca la rompe.
| Situación | Comportamiento |
|---|---|
| Clave revocada / sin fondos / proveedor inaccesible | El turno corre con el modelo Nirvai predeterminado de la superficie y cobra créditos; la tarjeta del proveedor pasa a Requiere atención |
| Modelo deshabilitado o eliminado de la fila del proveedor | Mismo respaldo |
| Proveedor eliminado con un agente aún apuntándole | El agente usa modelos de Nirvai; al eliminar se ofrece reasignar los agentes |
| El predeterminado de la cuenta apunta a algo no disponible | Los chats nuevos empiezan silenciosamente con modelos de Nirvai; la página de Proveedores de IA marca el predeterminado obsoleto |
Los fallos repetidos se registran por proveedor (conteo de fallos consecutivos y marca de primer fallo) para avisar de una clave rota una vez, no en cada mensaje.
Seguridad
- Las claves se cifran en reposo y ninguna lectura las devuelve — solo un prefijo corto y los últimos 4 caracteres se guardan en claro para mostrarse.
- La clave descifrada existe solo en memoria mientras dura una respuesta; nunca se registra en logs ni se incluye en la analítica.
- Los mensajes de validación usan un vocabulario fijo — los cuerpos de error del proveedor nunca se almacenan literalmente.
Límites
| Límite | Valor |
|---|---|
| Proveedores por cuenta | 10 |
| Tiempo máximo de una petición con tu modelo | 90 s (mayor que el propio de Nirvai, para pasarelas más lentas) |
| Mensaje de prueba | una única respuesta mínima ("hi") por guardado / prueba manual |