HelpStackDocs

Guías

Proveedores de IA

Un proveedor de IA es el servicio de modelos que potencia las sugerencias de respuesta de IA. 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 cuatro 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 cuatro 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.
  • Azure OpenAI — modelos OpenAI alojados a través de Microsoft Azure. Elige esta opción si tu organización está estandarizada en Azure o necesita el nivel de residencia de datos y cumplimiento normativo de Azure. Requiere una URL base (tu punto de acceso de Azure).
  • 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).

¿Cuál deberías elegir?

  • ¿Quieres el camino más sencillo con buena calidad? Empieza con OpenAI o Anthropic.
  • ¿Ya tienes inversión en Azure, o necesitas sus garantías de cumplimiento y región? Usa Azure OpenAI.
  • ¿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, Azure OpenAI 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 baseobligatoria para Ollama y Azure; 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.

Lectura de las tarjetas de proveedor#

Cada proveedor en la lista muestra:

  • Nombre
  • Insignia de tipo (OpenAI / Anthropic / Azure OpenAI / Ollama)
  • Estrella de predeterminado (si es el predeterminado)
  • 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:

  1. Configura un proveedor. Añade un proveedor OpenAI, Anthropic, Azure OpenAI u Ollama en Configuración → Proveedores de IA, elige un modelo y temperatura, y establécelo como predeterminado (o planea asignarlo a un canal específico). Para Ollama/Azure, establece la URL base.
  2. 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.
  3. 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.