Saltar a contenido

Enriquecimiento

El enriquecimiento permite proporcionar contexto adicional al agente para mejorar la calidad de sus respuestas.

¿Qué es el enriquecimiento?

Es el proceso de añadir información relevante a la conversación:

  • Archivos: Código, documentos, configuraciones
  • Estado actual: Datos del sistema, métricas
  • Contexto externo: Información de APIs, bases de datos
  • Historial: Ejecuciones anteriores, logs
graph LR
    E[Enriquecimiento] --> C[Contexto]
    C --> A[Agente]
    A --> R[Respuesta mejorada]

    subgraph Fuentes
        F[Archivos]
        S[Sistema]
        D[Datos]
    end

    F --> E
    S --> E
    D --> E

Abrir el panel de enriquecimiento

  1. En el Workspace, haz clic en Enriquecer
  2. Se abre el diálogo de enriquecimiento
┌─────────────────────────────────────────────────────────────────┐
│ Enriquecimiento de Contexto                          [✕ Cerrar]│
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│ [Archivos] [Sistema] [Datos] [Historial]                       │
│                                                                 │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│ ARCHIVOS DEL PROYECTO                                          │
│                                                                 │
│ 📁 src/                                                        │
│    📁 Controllers/                                             │
│       📄 UserController.cs                              [+]    │
│       📄 ProjectController.cs                           [+]    │
│    📁 Services/                                                │
│       📄 UserService.cs                                 [+]    │
│                                                                 │
│ SELECCIONADOS (2)                                              │
│ ┌─────────────────────────────────────────────────────────┐    │
│ │ 📄 UserController.cs                              [✕]   │    │
│ │ 📄 UserService.cs                                 [✕]   │    │
│ └─────────────────────────────────────────────────────────┘    │
│                                                                 │
│ [Cancelar]                    [Añadir al contexto]             │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

Tipos de enriquecimiento

Archivos

Añade archivos del proyecto al contexto.

Seleccionar archivos

  1. Navega por el árbol de directorios
  2. Haz clic en [+] junto al archivo
  3. El archivo se añade a "Seleccionados"

Buscar archivos

  1. Usa el campo de búsqueda
  2. Escribe parte del nombre
  3. Se filtran los resultados

Tipos de archivo soportados

Tipo Extensiones
Código .cs, .js, .ts, .py, .java
Config .json, .yaml, .xml, .env
Docs .md, .txt, .rst
Scripts .ps1, .sh, .bat

Sistema

Información del estado actual del sistema:

Dato Descripción
Git status Estado del repositorio
Última build Resultado del CI
Servicios Estado de servicios
Métricas Métricas actuales

Seleccionar datos del sistema

  1. Haz clic en la pestaña Sistema
  2. Marca los datos que quieres incluir
  3. Se cargan automáticamente

Datos

Información de fuentes externas:

Fuente Datos
Sentry Errores recientes
Base de datos Estadísticas
APIs Respuestas cacheadas
Logs Entradas recientes

Historial

Información de ejecuciones anteriores:

Elemento Uso
Última ejecución Ver qué se hizo antes
Errores anteriores Contexto de problemas
Cambios recientes Historial de cambios

Límites del enriquecimiento

Tamaño máximo

El contexto total tiene un límite. Si añades demasiada información:

  • El sistema truncará contenido
  • Se priorizará lo más reciente
  • Verás una advertencia

Límites aproximados

Elemento Límite
Archivos 5-10 archivos
Tamaño total ~100KB de texto
Profundidad 3 niveles de directorio

Enriquecimiento automático

Algunas fuentes se añaden automáticamente:

  • Proyecto activo: Información básica del proyecto
  • Usuario: Datos del usuario actual
  • Fecha/hora: Timestamp actual
  • Variables de sesión: Las que hayas definido

Uso en conversación

Referenciar contenido

Después de enriquecer, puedes referenciar el contenido:

En el archivo UserService.cs que te compartí,
¿puedes mejorar el manejo de errores?

El agente tiene acceso al archivo y puede analizarlo.

Ver contexto actual

Para ver qué contexto tiene el agente:

  1. Escribe /context
  2. El agente muestra el contexto cargado

Enriquecimiento durante la conversación

No solo puedes enriquecer al inicio:

  1. En cualquier momento, haz clic en
  2. Añade nuevo contexto
  3. El agente lo incorpora

Útil cuando:

  • La conversación cambia de dirección
  • Necesitas añadir más archivos
  • El agente pide más información

Limpiar contexto

Si el contexto se vuelve ruidoso:

  1. Haz clic en Limpiar contexto
  2. Confirma la acción
  3. El contexto vuelve al mínimo

Guardar configuración de enriquecimiento

Si usas frecuentemente el mismo conjunto de archivos:

  1. Configura el enriquecimiento
  2. Haz clic en Guardar como preset
  3. Dale un nombre
  4. Úsalo en futuras sesiones

Usar preset

  1. Haz clic en Cargar preset
  2. Selecciona el preset guardado
  3. Se carga todo el contexto

Siguiente: Backlog en Workspace - Trabajar sobre items del backlog.