Bucle de agente

Que es el bucle de agente?

El modo estandar en YeePilot sigue un patron simple: usted pregunta, la IA propone un comando, usted aprueba, se ejecuta. El bucle de agente va mas alla. Permite a la IA trabajar en tareas complejas de multiples pasos leyendo archivos, ejecutando comandos, analizando la salida y decidiendo que hacer a continuacion -- todo mientras lo mantiene a usted en el ciclo de aprobacion para cada comando.

Pienselo como la diferencia entre dar a alguien una instruccion a la vez versus describir un objetivo y dejar que averigue los pasos.

Activar el bucle de agente

Hay dos formas de activar el modo agente:

Usando el comando slash

Escriba /think en el chat para habilitar el pensamiento extendido para la sesion actual:

> /think
Agent mode enabled (thinking: on)

Tambien puede especificar una intensidad de pensamiento:

> /think high
Agent mode enabled (thinking: high)

Usando la configuracion

Para habilitar el modo agente por defecto, configurelo en su archivo de configuracion (~/.yeepilot/config.yaml):

ai:
  agent_mode: true

Como funciona

Cuando describe una tarea compleja en modo agente, YeePilot sigue este bucle:

1. Analizar -- La IA descompone su solicitud y determina el primer paso
2. Proponer -- Genera uno o mas comandos para el paso actual
3. Aprobar -- Usted revisa y aprueba (o rechaza) los comandos propuestos
4. Ejecutar -- Los comandos aprobados se ejecutan y la salida se captura
5. Evaluar -- La IA lee la salida, determina si se cumplio el objetivo y decide el siguiente paso
6. Repetir -- Los pasos 2-5 se repiten hasta que la tarea este completa o se alcance el limite de iteraciones

La IA puede realizar hasta 25 iteraciones por tarea antes de detenerse. Este limite previene bucles descontrolados y mantiene los costos predecibles.

Ejemplo: Diagnosticar un servidor lento

> The application at port 8080 is responding slowly. Diagnose the issue.

En modo agente, YeePilot podria trabajar a traves de esta secuencia:

1. Verificar si el proceso esta en ejecucion y su uso de recursos (ps, top)
2. Examinar los registros recientes de la aplicacion en busca de errores
3. Verificar los recursos del sistema (CPU, memoria, disco, E/S)
4. Revisar las conexiones de red y estados de sockets
5. Revisar cambios recientes del sistema o despliegues
6. Resumir hallazgos y sugerir correcciones

En cada paso, usted ve los comandos propuestos, los aprueba y ve los resultados antes de que la IA pase al siguiente paso.

Modos de pensamiento extendido

El comando /think acepta un argumento de modo que controla cuanto razonamiento realiza la IA antes de generar comandos:

Los modos de pensamiento mas altos usan mas tokens por paso pero producen un analisis mas completo. Para tareas rutinarias, low o el on predeterminado suelen ser suficientes. Para diagnosticar problemas oscuros, high le da a la IA mas espacio para considerar posibilidades.

Que puede hacer la IA en modo agente

Durante el bucle de agente, la IA tiene acceso a varias herramientas:

Ejecutar comandos

La herramienta principal. La IA propone comandos de shell para su aprobacion y ejecucion. Cada comando sigue pasando por la validacion de riesgo y requiere su confirmacion.

Leer archivos

La IA puede leer archivos en su sistema para recopilar contexto. Por ejemplo, leer un archivo de configuracion antes de sugerir cambios, o examinar un archivo de registro para entender un error.

Reading /etc/nginx/nginx.conf ...
 
Based on the configuration, the worker_processes is set to 1.
Given this server has 8 CPU cores, I recommend increasing it.
 
Plan:
  1. sed -i 's/worker_processes 1/worker_processes 8/' /etc/nginx/nginx.conf
 
Execute? [Y/n]

Listar archivos

La IA puede listar el contenido de directorios para entender la estructura del proyecto, encontrar archivos relevantes o verificar que los archivos esperados existen.

Buscar

La IA puede buscar contenido de archivos por patrones especificos, ayudandole a localizar valores de configuracion, mensajes de error o referencias de codigo.

Mantener el control

El modo agente no omite ningun mecanismo de seguridad:

• Cada comando requiere su aprobacion. La IA no puede ejecutar nada sin que usted presione Enter.
• La clasificacion de riesgo sigue aplicandose. Los comandos DANGEROUS se senalizan. Los comandos BLOCKED se rechazan.
• Puede detenerse en cualquier momento. Presione Ctrl+C o escriba "stop" para finalizar el bucle de agente y volver al modo estandar.
• El limite de 25 iteraciones previene bucles infinitos. Si la IA no ha completado la tarea en 25 pasos, se detiene y resume su progreso.

Cuando usar el modo agente

El modo agente es mas valioso para:

• Flujos de trabajo de diagnostico donde el siguiente paso depende de la salida del anterior
• Configuraciones de multiples servicios que requieren configurar varios componentes en secuencia
• Solucion de problemas donde la causa raiz es desconocida y requiere investigacion
• Auditorias de sistema que verifican multiples aspectos de la configuracion de un servidor

Para tareas simples de un solo comando ("show me disk usage"), el modo estandar es mas rapido y eficiente.

Consejos para el modo agente

• Sea especifico sobre su objetivo. "Set up a reverse proxy for the app on port 3000 with SSL via Let's Encrypt" le da a la IA un objetivo claro hacia el cual trabajar.
• Comience con /think medium para la mayoria de las tareas. Suba a high si la IA parece estar omitiendo consideraciones importantes.
• Observe el uso de tokens. El modo agente consume mas tokens que el modo de paso unico. Use Ctrl+S para verificar su uso.
• Deje que la IA termine su analisis antes de interrumpir con nuevas instrucciones. Si redirige a mitad del bucle, la IA pierde el hilo de su investigacion.