Contexto de archivos

Por que importa el contexto de archivos

Cuando le pide a YeePilot que modifique un archivo de configuracion, depure un script o analice un registro, la IA funciona mejor cuando puede ver el contenido real del archivo. El contexto de archivos le permite cargar archivos directamente en la conversacion para que la IA pueda referenciarlos, entender su estructura y generar comandos precisos.

Sin contexto de archivos, la IA tiene que adivinar formatos de archivo y valores actuales. Con contexto de archivos, puede ver exactamente que hay alli y proponer cambios especificos.

Agregar archivos

Use el comando /file seguido de una ruta de archivo:

> /file /etc/nginx/nginx.conf

YeePilot lee el archivo y agrega su contenido al contexto de la IA. La IA ahora puede referenciar el contenido del archivo en sus respuestas y usar la informacion para generar comandos mas precisos.

Puede agregar multiples archivos uno a la vez:

> /file /etc/nginx/sites-available/myapp.conf
> /file /var/log/nginx/error.log
> /file /home/deploy/myapp/docker-compose.yml

Ejemplo practico

> /file /etc/nginx/nginx.conf
Added /etc/nginx/nginx.conf to context (2.1 KB)
 
> The site is returning 502 errors. Check the nginx config for issues
  and fix any problems you find.

Con el archivo de configuracion cargado, la IA puede leer los bloques de servidor reales, definiciones de upstream y configuraciones de proxy en lugar de trabajar a ciegas.

Listar archivos cargados

Vea que archivos estan actualmente en el contexto de la IA:

> /files

Esto muestra todos los archivos cargados con sus tamanos:

Files in context:
  1. /etc/nginx/nginx.conf           (2.1 KB)
  2. /etc/nginx/sites-available/myapp.conf  (856 B)
  3. /var/log/nginx/error.log         (12.3 KB)
 
Total: 3 files, 15.3 KB

Eliminar archivos

Elimine un archivo del contexto cuando ya no se necesite:

> /unfile /var/log/nginx/error.log

Esto libera espacio de contexto para otros archivos o conversacion. Eliminar archivos con los que ya termino ayuda a mantener el uso de tokens bajo y mantiene a la IA enfocada en el contenido relevante.

Subir archivos

El comando /upload proporciona una forma alternativa de agregar archivos:

> /upload

Esto abre un flujo de seleccion de archivos. Uselo cuando desee agregar archivos de forma interactiva en lugar de escribir las rutas directamente.

Limites

El contexto de archivos tiene limites razonables para evitar saturar la ventana de contexto de la IA:

Los archivos que excedan el limite por archivo seran rechazados con un mensaje explicando la restriccion de tamano. Si el tamano total cargado excederia los 512 KB, necesitara eliminar algunos archivos antes de agregar nuevos.

Ajustar limites

Puede personalizar estos limites en su archivo de configuracion (~/.yeepilot/config.yaml):

files:
  max_entries: 20
  max_file_size: 102400    # bytes (100 KB)
  max_total: 524288        # bytes (512 KB)

Aumentar estos limites usa mas de la ventana de contexto de la IA por mensaje, lo que incrementa los costos de tokens y puede activar la compactacion de contexto antes. Los valores predeterminados funcionan bien para la mayoria de las tareas de administracion de servidores.

Panel de transmision en vivo

Cuando el bucle de agente de YeePilot realiza ediciones de archivos durante una tarea de multiples pasos, el panel de transmision en vivo muestra esos cambios en tiempo real. Esto le brinda visibilidad sobre exactamente que esta leyendo y modificando la IA mientras trabaja.

Alternar la transmision en vivo

> /livestream

Esto activa o desactiva el panel de transmision en vivo. Cuando esta habilitado, el panel aparece junto a la conversacion principal y muestra:

• Contenidos de archivos siendo leidos por la IA
• Ediciones propuestas resaltadas con diffs
• Progreso en tiempo real a traves de operaciones con multiples archivos

La transmision en vivo es especialmente util en modo agente cuando la IA esta trabajando a traves de una secuencia de modificaciones de archivos, como actualizar multiples archivos de configuracion o aplicar un conjunto de cambios a traves de un proyecto.

Flujos de trabajo comunes

Revision de configuracion

Cargue un archivo de configuracion y pida a la IA que lo revise:

> /file /etc/ssh/sshd_config
> Review this SSH configuration for security issues and suggest hardening changes

La IA lee los valores de configuracion reales y proporciona recomendaciones especificas con cambios exactos de lineas.

Analisis de registros

Cargue un archivo de registro para obtener ayuda entendiendo errores:

> /file /var/log/syslog
> What errors occurred in the last hour? Summarize the issues.

Para archivos de registro grandes que excedan el limite de tamano, use la IA para leer secciones especificas en su lugar:

> Show me the last 200 lines of /var/log/syslog that contain "error" or "fail"

Contexto de multiples archivos

Cuando trabaja en una tarea que involucra varios archivos relacionados, carguelos todos:

> /file /etc/nginx/nginx.conf
> /file /etc/nginx/sites-available/api.conf
> /file /etc/letsencrypt/renewal/api.example.com.conf
> /file docker-compose.yml
 
> Set up nginx as a reverse proxy for the Docker service on port 3000
  with SSL using the existing Let's Encrypt certificate

Con todos los archivos relevantes cargados, la IA puede cruzar referencias entre la configuracion del servicio Docker, las rutas de certificados SSL existentes y la configuracion actual de nginx para generar una configuracion completa y correcta.

Desarrollo de scripts

Cargue un script existente para obtener ayuda extendiendolo o depurandolo:

> /file /home/deploy/backup.sh
> This backup script is failing silently. Add proper error handling
  and send an email notification on failure.

La IA ve la estructura actual del script y puede agregar manejo de errores que se ajuste al estilo de codigo y flujo logico existentes.

Consejos

• Cargue archivos antes de preguntar sobre ellos. La IA da respuestas mucho mejores cuando puede ver el contenido real en lugar de adivinar.
• Elimine archivos con los que ya termino. Esto mantiene el contexto limpio y los costos mas bajos.
• Use /files para verificar que esta cargado antes de comenzar una nueva tarea. Archivos sobrantes de una tarea anterior pueden confundir a la IA.
• Para archivos muy grandes, pida a la IA que lea secciones especificas con comandos como head, tail o grep en lugar de cargar el archivo completo en el contexto.