---
title: AI Agent
description: Permita a los clientes administrar sus VM Linux con lenguaje natural — cómo conecta el Agent por SSH, qué ejecuta por su cuenta y qué debe tener listo.
url: https://nexcmp.com/es/docs/ai/ai-agent/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# AI Agent {#ai-agent}

> **Dónde está en el admin:** System › Settings › AI provider (`/settings/ai`) — interruptor del módulo y proveedor; System › Admin › License & updates (`/license`) — interruptor del módulo. **Dónde está en el portal:** AI Agent (`/ai/agent`) y la página `/chat/agent`, o el modo **Agent** dentro del chat.

## Qué hace {#what-it-does}

El AI Agent se conecta a la VM Linux del cliente mediante SSH y realiza tareas descritas en lenguaje natural: "check system health", "install Docker", "find recent errors", "free up disk space". Muestra cada comando propuesto y su salida. Los comandos de solo lectura pueden ejecutarse automáticamente; cualquier cambio en el servidor espera a que el cliente pulse **Run**.

## Requisitos {#requirements}

| Elemento | Requisito |
|---|---|
| Módulo y proveedor de AI | El módulo **AI** activado y un [AI provider](https://nexcmp.com/es/docs/ai/ai-providers/) funcional. El Agent también necesita un modelo compatible con tool calling. |
| `openssh-client` en el servidor del panel | El Agent ejecuta comandos con el propio programa `ssh` del panel (`/usr/bin/ssh`). El instalador instala `openssh-client`; verifíquelo con `ssh -V`. Sin él, el Agent informa "ssh client is not installed on the panel server". |
| Sin gateway SSH independiente | En la instalación predeterminada se utiliza el SSH integrado y **no** se necesita el terminal web `ssh-proxy`. Solo cuando se ha habilitado la función opcional de *web SSH* (`feature_ssh_web`) y se ha instalado el servicio `ssh-proxy`, el Agent pasa a través de `ssh-proxy`. |
| Red | El servidor del panel debe poder comunicarse con la IP de la VM en su puerto SSH (22 de forma predeterminada). Compruebe los firewalls y grupos de seguridad entre el panel y la red de invitados. |
| VM | Propiedad del cliente, **en ejecución**, no bloqueada, **Linux** (se rechazan las VM Windows), con una dirección IP pública o accesible. |
| Credenciales SSH | El usuario y la contraseña de inicio de sesión de la VM almacenados por NexCMP (guardados de forma cifrada cuando se creó la VM o se restableció su contraseña), o la clave de operaciones del panel si hay una instalada. Si ninguno de los dos existe, el Agent indica que no puede iniciar sesión. |

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

1. Verifique el cliente SSH en el servidor del panel:

   ```bash
   ssh -V
   sudo apt-get install -y openssh-client   # only if missing
   ```

2. Compruebe que el servidor del panel pueda conectarse por SSH a una VM invitada:

   ```bash
   nc -vz 198.51.100.10 22
   ```

   Sustituya la dirección por la IP de una VM de prueba. Si esto falla, corrija primero el enrutamiento o el firewall.
3. Asegúrese de que el sistema invitado permita el inicio de sesión por contraseña para el usuario almacenado por NexCMP (algunas imágenes cloud lo deshabilitan) o de que la clave de operaciones del panel esté instalada en el invitado.

## Conectar en NexCMP {#connect-in-nexcmp}

1. Complete [AI provider](https://nexcmp.com/es/docs/ai/ai-providers/): módulo activado, proveedor guardado y **Test connection** en verde.
2. No es necesario configurar nada más en el panel de administración. El interruptor del módulo hace que aparezcan las entradas de **AI Agent** en el portal del cliente.
3. Como cliente: abra **AI Agent**, elija un servidor en ejecución y haga clic en **Choose server**. La página comprueba primero la conexión SSH con un comando fijo inofensivo (sin utilizar llamadas de AI) y muestra *SSH connected* o el motivo por el cual falló.
4. Escriba una tarea o elija un inicio rápido (*Check system health*, *Install Docker*, *Install Nginx*, *Find recent errors*, *Security check*, *Free up disk space*).



## Cómo ejecuta los comandos {#how-it-runs-commands}

- **Desde dónde:** el servidor del panel, con el cliente `ssh` del sistema, un comando no interactivo a la vez. El destino siempre es la IP de la VM **desde la base de datos**, nunca desde la solicitud; solo se puede acceder a la VM desbloqueada y en ejecución del propio propietario.
- **Autenticación:** la contraseña almacenada se pasa a través de un asistente `SSH_ASKPASS` de un solo uso en el entorno del proceso; no se escribe en el disco ni se coloca en la línea de comandos. Las claves de host no están fijadas (las VM se reinstalan con nuevas claves). La salida por comando está limitada a 200 KB y cada comando tiene un límite de tiempo (60 segundos).
- **Bucle del Agent:** la IA propone comandos y lee las salidas; un turno finaliza después de un máximo de **10 pasos**.
- **Modos:**

  | Modo | Comportamiento |
  |---|---|
  | **Confirm** | Cada comando espera a **Run**. |
  | **Auto** | Solo los comandos que superan una estricta lista de permitidos de solo lectura se ejecutan automáticamente (por ejemplo, `df -h`, `ps`, `journalctl`). Cualquier otra cosa, y todo lo que el analizador no pueda analizar con certeza (variables, sustitución de comandos, redirecciones a archivos), espera a **Run**. |

- **Etiquetas de riesgo:** los comandos que sobrescriben o eliminan archivos, escriben en discos, modifican cuentas o SSH keys, envían datos a un servidor externo, abren conexiones de red sin procesar, ejecutan código ofuscado, descargan y ejecutan un script, apagan o reinician la máquina, o se comunican con otros servidores siempre muestran **Needs confirmation**, incluso en modo Auto.
- **Salida no confiable:** la salida del comando se muestra al modelo como datos no confiables; las instrucciones en su interior no se siguen.

## Verificación {#verify}

1. Elija una VM de prueba en ejecución. La página muestra *SSH connected*.
2. Pregunte "Check CPU, RAM and disk". En modo Auto, los comandos de solo lectura se ejecutan y la respuesta los resume.
3. Pregunte "Install Nginx". El comando de instalación aparece con **Run** y **Skip**; no se ejecuta nada hasta que presione **Run**.
4. El contador en la parte superior muestra el número de llamadas de IA utilizadas hoy (por ejemplo, `3/300`).

## Límites y notas {#limits-notes}

- **Límite diario:** 300 llamadas de IA por cliente al día (UTC); se restablece a las 00:00 UTC. Cuando se agota, el Agent responde "Daily AI quota reached".
- **Concurrencia:** como máximo 2 ejecuciones del Agent por cliente al mismo tiempo; una sesión ejecuta un turno a la vez.
- **Sesiones:** hasta 100 mensajes por sesión, 4,000 caracteres por mensaje. Una sesión pertenece a una VM; si la VM se elimina o se transfiere, la sesión anterior pasa a ser de solo lectura.
- **VM bloqueada o detenida, o Windows:** la VM se muestra como *Locked*, *Stopped*, *Windows* o *No address* y no se puede seleccionar.
- **Suplantación:** un administrador que suplanta a un cliente no puede usar las funciones de credenciales del Agent (consulte [Log in as a customer](https://nexcmp.com/es/docs/customers/login-as/)).
- **Responsabilidad:** el Agent puede cometer errores. El portal indica a los clientes que revisen los comandos antes de ejecutarlos. Indique a los clientes en sus términos que son responsables de los comandos que aprueben.
- Desactivar el módulo de IA elimina las entradas del Agent y las rutas responden 404 `module_disabled`.

## Resolución de problemas {#troubleshooting}

| Síntoma | Causa | Solución |
|---|---|---|
| "el cliente ssh no está instalado en el servidor del panel (apt install openssh-client)" | Falta el binario `ssh` | `sudo apt-get install -y openssh-client`. |
| "El agente no pudo iniciar sesión" / `ssh: no saved credentials for this VM` | Sin contraseña almacenada ni clave de operaciones | Restablezca la contraseña de la VM en el portal para que se guarde de nuevo, o instale la clave de operaciones. |
| "El servidor no respondió a tiempo" | Firewall, SSH no escucha, VM ocupada | Pruebe `nc -vz <ip> 22` desde el servidor del panel; inicie `sshd` en la VM. |
| "No se pudo conectar a SSH en este servidor" | Enrutamiento o grupo de seguridad | Permita que el servidor del panel alcance la VM en el puerto 22. |
| "La VM no está en ejecución" / "Prohibido" | VM detenida, bloqueada, eliminada o no pertenece al cliente | Iníciela, desbloquéela o elija otra. |
| "No disponible: N (detenida, bloqueada o Windows)" | Motivos indicados arriba | La VM debe ser Linux y estar en ejecución. |
| "La pasarela SSH no está disponible temporalmente" | Función Web SSH habilitada pero `ssh-proxy` está caído | Inicie `ssh-proxy` o desactive la función Web SSH para usar el SSH integrado. |
| "La IA está respondiendo con demasiada lentitud (más de 90 segundos)" | Proveedor lento | Use un modelo más rápido o un **Reasoning effort** menor. |
| "Cuota diaria de IA alcanzada" | 300 llamadas utilizadas | Espere hasta las 00:00 UTC. |
| "Esta sesión aún está en ejecución" | Otro turno en curso | Espere o pulse **Stop**. |