Guías
Proveedores de IA
Un proveedor de IA es el servicio de modelos que potencia las sugerencias de respuesta de IA. Toda organización nueva empieza con un único proveedor llamado Automatic, ya establecido como predeterminado, de modo que las respuestas de IA funcionan antes de que configures nada: sigue el modelo que HelpStack recomiende en cada momento. Puedes cambiarlo o reemplazarlo cuando quieras. Configuras uno o más proveedores para tu organización, eliges un modelo y cómo se comporta, y seleccionas uno como predeterminado. Los canales usan el proveedor predeterminado o el que ellos mismos elijan. Esta guía cubre los tipos de proveedor compatibles, cuándo elegir cada uno, todas las opciones de configuración, cómo funciona el proveedor predeterminado y una lista de verificación para que tu primera respuesta de IA funcione de extremo a extremo.
Encontrarás los proveedores en Configuración → Proveedores de IA (ruta /settings/ai-providers). Para gestionar proveedores de IA se requiere el rol OWNER o ADMIN; los agentes y visualizadores generalmente pueden consultarlos.
Los tipos de proveedor#
Al añadir un proveedor, eliges su tipo:
- OpenAI — modelos alojados de OpenAI. Una buena opción predeterminada de uso general para la mayoría de los equipos.
- Anthropic — modelos alojados de Anthropic (Claude). Otra opción sólida de uso general.
- DeepSeek — modelos alojados de DeepSeek, accesibles a través de una API compatible con OpenAI.
- Ollama — ejecuta modelos localmente en la infraestructura que tú controlas. Elige esta opción cuando necesites inferencia local y sin salida de datos — por ejemplo, cuando los datos de los clientes no deben salir de tu red. Ollama es local, por lo que requiere una URL base que apunte a tu servidor Ollama, y el modelo es de texto libre (escribes el nombre del modelo que has descargado localmente).
- Google — los modelos Gemini de Google. Rápidos y económicos, adecuados para un volumen alto de chat.
- xAI — los modelos Grok de xAI.
- Qwen — los modelos Qwen de Alibaba. La opción más barata que ofrecemos.
- Mistral — los modelos de pesos abiertos de Mistral, desarrollados en Europa.
- Moonshot — los modelos Kimi de Moonshot, sólidos en conversaciones largas.
- MiniMax — los modelos de MiniMax.
¿Cuál deberías elegir?
- ¿Quieres el camino más sencillo con buena calidad? Empieza con OpenAI o Anthropic.
- ¿Quieres el menor coste de funcionamiento? Qwen es el más barato por respuesta.
- ¿Debes mantener los datos en local sin llamadas a API de terceros? Usa Ollama.
Opciones de configuración#
Al añadir o editar un proveedor, estableces:
- Tipo — uno de OpenAI, Anthropic, DeepSeek, Google, xAI, Qwen, Mistral, Moonshot, MiniMax u Ollama (ver arriba).
- Nombre — una etiqueta que eliges para identificar este proveedor en la lista.
- Modelo — elegido de una lista predefinida por proveedor, excepto Ollama, donde el modelo es de texto libre (escribe el nombre de un modelo que hayas descargado localmente).
- Temperatura — un control deslizante de 0 a 2. Los valores más bajos hacen que la IA sea más enfocada y consistente; los valores más altos la hacen más variada/creativa. Para respuestas de soporte, más bajo suele ser más seguro.
- Máximo de tokens — la longitud máxima de la respuesta de la IA.
- URL base — obligatoria para Ollama; opcional para los demás.
Una nota sobre las claves API
Para los proveedores en la nube, las claves API son gestionadas por la plataforma — en la configuración normal no pegas tú mismo una clave de OpenAI o Anthropic. Ollama es la excepción: al ejecutarse localmente, no usa una clave pero sí necesita su URL base para que HelpStack pueda conectarse a tu servidor.
El proveedor predeterminado#
Exactamente un proveedor por organización es el predeterminado. El proveedor predeterminado es utilizado por cualquier canal que no elija el suyo propio.
- Activa "Establecer como predeterminado" al añadir o editar un proveedor, o usa la acción Establecer predeterminado en la tarjeta del proveedor.
- Como siempre hay exactamente un proveedor predeterminado, al establecer uno nuevo se elimina la estrella del anterior.
- No puedes eliminar el proveedor predeterminado — establece primero otro proveedor como predeterminado y luego elimina el antiguo.
El proveedor alternativo#
Si tu proveedor predeterminado falla a mitad de una respuesta, HelpStack responde con un proveedor alternativo en lugar de dejar al cliente sin respuesta. Toda organización tiene una alternativa, la hayas configurado tú o no. Puedes ver cuál te corresponde al final de Configuración → Proveedores de IA.
HelpStack la elige en este orden:
- Un proveedor que hayas elegido tú. Activa «Usar como alternativa» al editar un proveedor. Solo un proveedor puede ser la alternativa, igual que solo uno puede ser el predeterminado.
- Otro proveedor que ya tengas configurado, si está activo y es de otro fabricante.
- La alternativa de HelpStack — nuestra propia elección, que se usa cuando no tienes nada más adecuado. Es lo que reciben la mayoría de las organizaciones y no requiere configuración. Mantenemos más de una, de modo que la elegida siempre es de un fabricante distinto al de tu predeterminado, incluso cuando tu predeterminado resulta ser el fabricante al que recurriríamos.
El interruptor aplica dos reglas, porque una alternativa que parece configurada pero no cubre nada es peor que ninguna:
- El proveedor predeterminado no puede ser su propia alternativa.
- La alternativa debe ser de un fabricante distinto al del predeterminado. Los fallos que una alternativa existe para superar — una caída, una limitación de peticiones, un tiempo de espera agotado — afectan a todos los modelos de un fabricante a la vez, así que pasar de un modelo de OpenAI a otro es la misma caída dos veces. Por eso el interruptor «Usar como alternativa» no aparece cuando editas tu proveedor predeterminado, ni uno del mismo fabricante.
Tu prompt del sistema, la temperatura y el máximo de tokens se mantienen en la alternativa. Solo cambian el fabricante y el modelo, de modo que una respuesta alternativa no suene de repente con otra voz.
La alternativa solo se usa ante fallos en los que otro fabricante podría plausiblemente funcionar. Quedarse sin crédito, una clave de API rechazada o una petición mal formada no se reintentan en otro sitio: hacerlo gastaría dinero en reproducir el mismo fallo y ocultaría su causa.
Lectura de las tarjetas de proveedor#
Cada proveedor en la lista muestra:
- Nombre
- Insignia de tipo (OpenAI / Anthropic / DeepSeek / Google / xAI / Qwen / Mistral / Moonshot / MiniMax / Ollama)
- Estrella de predeterminado (si es el predeterminado), o una insignia Alternativa (si es el proveedor alternativo)
- Modelo
- Temperatura
- Máximo de tokens
- Estado Activo / Inactivo
- Acciones: Establecer predeterminado, Editar, Eliminar (no puedes eliminar el predeterminado)
Dónde vive el prompt del sistema#
El prompt del sistema — la personalidad e instrucciones de la IA (su tono, qué debe y no debe hacer) — no se establece en el proveedor. Se configura por canal, en la pestaña IA y Conocimiento del canal. Esto te permite dar personalidades diferentes a canales distintos compartiendo el mismo proveedor. Consulta Canales.
Ten en cuenta también que: el correo electrónico/identificador del cliente se pone automáticamente a disposición de la IA en su prompt, para que pueda ayudar con preguntas específicas de la cuenta sin que tengas que configurarlo manualmente.
Cómo hacer funcionar tu primera respuesta de IA#
Una respuesta de IA funcional necesita tres cosas. Usa esta lista de verificación:
- Configura un proveedor. Tu cuenta ya tiene un proveedor DeepSeek como predeterminado, así que puedes saltarte este paso. Para usar otro, Añade en Configuración → Proveedores de IA un proveedor de cualquiera de los tipos anteriores, elige un modelo y temperatura, y establécelo como predeterminado (o planea asignarlo a un canal específico). Para Ollama, establece la URL base.
- Adjunta una base de conocimiento al canal. Para que las respuestas se basen en tu contenido real, adjunta grupos de la base de conocimiento al canal en Configuración → Canales → canal → IA y Conocimiento. Consulta Base de conocimiento y Canales.
- Activa las respuestas de IA en el canal. Habilita las respuestas de IA para el canal (y establece su prompt del sistema en la misma pestaña de IA y Conocimiento). Consulta Respuestas de IA.
Con esas tres cosas hechas, envía un mensaje de prueba en el canal y confirma que la IA redacta una respuesta basada en tu base de conocimiento.
Relacionado#
- Canales — asigna un proveedor por canal y establece el prompt del sistema por canal.
- Respuestas de IA — cómo funcionan las sugerencias de respuesta de IA y cómo habilitarlas.
- Base de conocimiento — fundamenta las respuestas en tu propio contenido.
- Herramientas del agente (resumen) — otorga a la IA capacidades personalizadas mientras redacta.
- Primeros pasos — configuración inicial de la organización y el canal.
- Glosario — definiciones de temperatura, tokens, prompt del sistema y más.