Proveedor de IA

Dónde está en el admin: System › Settings › AI provider (/settings/ai). El interruptor del módulo de IA está allí y en System › Admin › License & updates (/license), tarjeta Module.

Qué hace

AI Chat (chat de soporte automático) y AI Agent (administración de VM en lenguaje natural) no incluyen un modelo integrado. Usted elige su propio proveedor: cualquier servicio que ofrezca una API chat/completions compatible con OpenAI, por ejemplo OpenAI, OpenRouter, una pasarela LiteLLM o su propio servidor vLLM. NexCMP almacena el endpoint y la clave de API (cifrados) y los utiliza para cada función de IA. Usted le paga directamente al proveedor.

Requisitos

Elemento	Requisito
Endpoint	Una URL base compatible con OpenAI (https://api.openai.com/v1, https://ai.example.com/v1). NexCMP añade /chat/completions a una URL que termina en /v1; para cualquier otra URL añade /v1/chat/completions; una URL que ya termina en /chat/completions se utiliza tal cual.
Modelo	Un modelo compatible con tool (function) calling. Tanto AI Chat como el Agent dependen de ello.
API key	Una clave para ese endpoint. Se recomienda una clave con un límite de gasto en el proveedor (por ejemplo, una clave virtual de LiteLLM con presupuesto mensual).
Red	El servidor del panel debe poder conectarse al endpoint mediante HTTP(S). Las URL introducidas en el formulario solo pueden apuntar a Internet en los puertos 80, 443, 8080 u 8443; para utilizar una dirección interna, guarde primero el proveedor y luego realice la prueba.
Dependencias	El módulo AI activado. Para el Agent, consulte AI Agent.

Preparar la infraestructura

1. Regístrese con el proveedor y cree una API key. Si el proveedor admite presupuestos o límites de frecuencia, establezca un límite mensual.

2. Anote la URL base y el nombre exacto del modelo (y, opcionalmente, hasta cuatro modelos de reserva).

3. Pruébelo desde el servidor de NexCMP antes de introducirlo:

   curl -s https://ai.example.com/v1/chat/completions \
     -H "Authorization: Bearer XXXX" -H "Content-Type: application/json" \
     -d '{"model":"gpt-4o-mini","messages":[{"role":"user","content":"Reply with one word: OK"}]}'

   Una respuesta JSON con choices[0].message.content indica que el endpoint funciona.

Conectar en NexCMP

1. Abra System › Settings › AI provider.

2. En la tarjeta Module AI, active el módulo (on). Mientras no esté activado, los clientes no verán AI Chat ni el AI Agent en el portal. (También puede activarlo en License & updates).

3. En la tarjeta Connection, complete:

   Campo	Ejemplo	Notas
   Usar este proveedor	activado	Requiere una URL base, un modelo y una clave para poder activarse.
   Nombre para mostrar	LiteLLM	Hasta 60 caracteres.
   URL base (compatible con OpenAI)	https://ai.example.com/v1	http:// o https://, hasta 300 caracteres, sin espacios.
   API key del proveedor	sk-XXXX	Se almacena cifrada; posteriormente solo se muestran los últimos 4 caracteres. Déjela vacía para conservar la clave guardada.
   Modelo predeterminado	gpt-4o-mini	Letras, dígitos y - _ . / : @.
   Modelos de reserva	gemini-2.5-flash	Separados por comas, hasta 4. Se utilizan cuando el modelo predeterminado falla.
   Esfuerzo de razonamiento	Predeterminado (no se envía)	Minimal, Low, Medium o High. Para modelos de razonamiento (Gemini, serie o), un nivel bajo responde mucho más rápido. Déjelo en Default para modelos normales.

4. Haga clic en Save y luego en Test connection. La prueba envía una pregunta breve y muestra Connected — <model>, <ms> ms o el error devuelto por el proveedor.

Qué ocurre al guardar

• La configuración del proveedor se guarda como una entrada de configuración única y la clave se cifra con AES-256-GCM, vinculada a este propósito, utilizando la clave maestra de la instalación.
• Los ajustes de soporte Primary model y Fallback model (utilizados por AI Chat) se configuran automáticamente con su modelo predeterminado y el primer modelo de reserva.
• El cambio se registra en el registro de auditoría (endpoint, modelo, si la clave cambió — nunca la clave).

Verificación

1. Test connection se muestra en verde.
2. Inicie sesión en el portal como cliente de prueba: el menú ahora ofrece AI Chat (o la burbuja de chat) y AI Agent.
3. Pregunte a AI Chat "What is my balance?". Una respuesta que indique su saldo real demuestra que el proveedor gestiona las tool calls correctamente.

Límites y notas

• Un solo proveedor. NexCMP utiliza un único proveedor configurado para Chat, Agent y la investigación de tickets. Los modelos de reserva ofrecen resiliencia dentro de ese proveedor.
• Seguridad de la clave. La clave guardada se envía únicamente al endpoint guardado. Si cambia la Base URL, debe introducir la clave nuevamente antes de realizar la prueba.
• Límites por cliente. AI Chat solo está disponible para clientes autenticados, con límites de mensajes por minuto y por chat. El agente tiene un límite diario de llamadas por cuenta. Consulte AI Chat y AI Agent.
• Privacidad. Las preguntas de los clientes y los datos que la IA consulta para ese cliente (solo lectura) se envían a su proveedor. Indíquelo en su política de privacidad.
• Control de costos. NexCMP no tarifica los costos de IA; utilice las funciones de presupuesto del proveedor.
• El módulo se puede desactivar en cualquier momento: los elementos de menú de IA desaparecen y las rutas de IA responden 404 module_disabled. Algunas tareas en segundo plano de AI Chat (investigación de tickets, respuestas diferidas) aplicarán el cambio en el siguiente reinicio del panel.

Resolución de problemas

Síntoma	Causa	Solución
base_url must be an http(s) URL	Esquema ausente o espacios	Utilice https://host/v1.
api_key is required to enable the provider	No hay ninguna clave almacenada	Introduzca la clave y guarde.
base_url and model are required to enable the provider	Campo vacío	Complete ambos.
"URL base bloqueada: solo http(s) público, puertos 80/443/8080/8443"	Prueba de una dirección interna no guardada u otro puerto	Guarde primero el proveedor y luego realice la prueba.
api_key is required (enter the key again when you change the endpoint)	La Base URL difiere de la guardada	Vuelva a introducir la clave.
model: letters, digits and - _ . / : @	Carácter no válido	Utilice el ID de modelo exacto del proveedor.
fallback_models: up to 4 model names	Demasiados	Mantenga cuatro o menos.
La prueba falla con 401	Clave incorrecta	Compruebe la clave y el endpoint.
La prueba falla con 404 o "model not found"	Ruta o modelo incorrectos	Compruebe la Base URL (/v1) y el ID de modelo.
Too many tests — wait a minute (429)	Más de 10 pruebas por minuto	Espere.
El portal sigue sin mostrar el menú de IA	Módulo desactivado o proveedor no marcado como "in use"	Active el módulo y habilite el proveedor.