---
title: Proveedor de IA
description: Conecte un endpoint de IA compatible con OpenAI para AI Chat y AI Agent: active el módulo de IA, introduzca el endpoint y clave, pruébelo y fije límites.
url: https://nexcmp.com/es/docs/ai/ai-providers/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# Proveedor de IA {#ai-provider}

> **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 {#what-it-does}

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 {#requirements}

| 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](https://nexcmp.com/es/docs/ai/ai-agent/#requirements). |

## Preparar la infraestructura {#prepare-the-infrastructure}

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:

   ```bash
   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 {#connect-in-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.

![Página de AI provider con el módulo AI activado y el formulario de conexión completado con valores de ejemplo](https://nexcmp.com/es/docs/images/ai/ai-providers-01-connection.webp)


### Qué ocurre al guardar {#what-saving-does}

- 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 {#verify}

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 {#limits-notes}

- **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](https://nexcmp.com/es/docs/ai/ai-chat/) y [AI Agent](https://nexcmp.com/es/docs/ai/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](https://nexcmp.com/es/docs/customers/legal/).
- **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 {#troubleshooting}

| 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. |