Acerca de los datos de sesión de CLI de GitHub Copilot

CLI de Copilot registra cada sesión localmente. Puede reanudar sesiones anteriores, hacer preguntas a Copilot sobre las interacciones con la CLI y usar el comando de barra oblicua /chronicle para obtener información útil basada en la sesión.

En este artículo

Introducción

Cada vez que use CLI de Copilot, un conjunto completo de datos sobre su sesión, incluidos sus mensajes, las respuestas de Copilot, las herramientas que se usaron y los detalles de los archivos modificados, se registran en su equipo local. Con el tiempo, esto va creando un historial detallado de en qué ha trabajado, cómo lo ha hecho y qué ha hecho Copilot por usted.

Estos datos de sesión potencian varias características:

  •         **Reanudación de sesiones**: puede continuar donde lo dejó en cualquier sesión anterior.

  •         **Formular preguntas sobre tu historial**: Puede hacer preguntas a Copilot sobre su trabajo anterior, y este consultará los datos de la sesión para poder responderlas.

  •           **El comando de barra oblicua `/chronicle` **: un conjunto de subcomandos creados específicamente que generan informes de progreso, consejos personalizados y sugerencias para mejorar las instrucciones personalizadas, todas derivadas del historial de sesiones.

En este artículo conceptual se explica cómo se almacenan los datos de sesión y cómo puede aprovecharlos para mejorar el flujo de trabajo. Para obtener una guía práctica sobre cómo reanudar una sesión, preguntar a Copilot acerca de tus sesiones de CLI, y utilizar el comando slash /chronicle, consulta Uso de los datos de sesión de CLI de GitHub Copilot.

Nota:

El comando /chronicle y la capacidad de Copilot para responder a preguntas sobre el historial de la sesión son, por el momento, funciones experimentales y solo están disponibles si ha usado el comando de barra oblicua /experimental on o la opción de línea de comandos --experimental.

Cómo se almacenan los datos de sesión

Cada sesión de CLI de Copilot se conserva como un conjunto de archivos en el directorio ~/.copilot/session-state/ de tu máquina. Los datos de cada sesión contienen un registro completo de la sesión. Estos archivos le permiten reanudar una sesión interactiva de la CLI.

Además de los archivos de sesión, CLI de Copilot almacena datos de sesión estructurados en una base de datos de SQLite local, denominada almacén de sesiones. Estos datos son un subconjunto de los datos completos almacenados en los archivos de sesión. El almacén de sesiones es lo que impulsa el comando de barra oblicua /chronicle y también permite que Copilot responda a las preguntas que haga sobre el trabajo anterior.

Privacidad y localidad de datos

Todos los datos de sesión se almacenan localmente en el directorio principal y solo es accesible para su cuenta de usuario. Copilot lee estos datos en tu máquina cuando formulas preguntas sobre tus interacciones con el CLI, o cuando usas el /chronicle comando de barra. Los datos de sesión, como las indicaciones anteriores, los datos de contexto y las respuestas que recibió, se pueden enviar al modelo de IA, tal como lo harían en cualquier interacción normal CLI de Copilot .

Si desea quitar datos de una sesión determinada de la CLI, puede eliminar el directorio de sesión correspondiente de ~/.copilot/session-state/. Puede borrar todos los datos de sesión eliminando todo en ~/.copilot/session-state/. Después de hacerlo, debe volver a indexar manualmente el almacén de sesiones. Consulte Reindexación del almacén de sesiones más adelante en este artículo.

Acerca del comando de barra oblicua /chronicle

El comando /chronicle SUBCOMMAND usa los datos del almacén de sesiones para proporcionar información y sugerencias sobre su uso de CLI de Copilot.

Puede escribir los siguientes comandos en una sesión interactiva de la CLI:

  •           `/chronicle standup`: genera un breve informe que resume en qué ha trabajado en las últimas sesiones de la CLI, incluidos los nombres de ramas, los enlaces a las solicitudes de extracción y las comprobaciones de estado.

  •         `/chronicle tips`: proporciona consejos personalizados para usar CLI de Copilot de manera más eficaz.

  •         `/chronicle improve`: analiza el historial de sesiones para identificar patrones en los que Copilot puede haber malinterpretado su intención o donde hubo muchas interacciones de ida y vuelta, y genera instrucciones personalizadas para ayudar a Copilot a comprenderle mejor en el futuro.

  •         `/chronicle reindex`: reconstruye el almacén de sesiones basándose en los archivos del historial de sesión.

Ventajas de /chronicle y los datos de sesión

  •         **Flujo de trabajo de mejora automática**: el `improve` subcomando crea un bucle de comentarios que le ayuda a refinar las instrucciones personalizadas. Con el tiempo, esto hace que el agente sea más eficaz para su proyecto específico.

  •           **Realizar informes sin esfuerzo sobre las reuniones de pie**: en lugar de tener que reconstruir manualmente lo que hizo ayer, `/chronicle standup` genera un resumen de las reuniones de pie informal a partir de los datos reales de su sesión.

  •         **Entrenamiento personalizado**: el `tips` subcomando actúa como un entrenador de productividad personal que sabe lo que CLI de Copilot puede hacer y cómo lo usa realmente. Puentea la brecha entre las características disponibles y el flujo de trabajo actual.

  •           **Hablar con el historial de notificaciones**: el almacén de sesiones permite a Copilot responder a cualquier pregunta para la que sus sesiones anteriores puedan ser de ayuda, desde recordar una corrección de errores que hizo la semana pasada hasta analizar sus patrones de solicitud de información a lo largo del tiempo.

  •         **Local y privado**: todos los datos de sesión (tanto los archivos JSONL sin procesar como el almacén de sesiones de SQLite) permanecen en el equipo. No se sube ni comparte nada más allá de las interacciones normales del modelo de IA que ocurren en cualquier sesión de CLI de Copilot. Tiene control total sobre los datos y puede eliminarlos en cualquier momento.

¿Cuándo debe usar estas características?

  •         **Al principio del día**: ejecute `/chronicle standup last 3 days` para generar un recordatorio de lo que ha trabajado recientemente y la sesión de la CLI en la que estaba trabajando.

  •         **Periódicamente, para mejorar**: ejecute `/chronicle tips` cada semana o dos para descubrir características y mejoras en el flujo de trabajo que podría no haber notado.

  •         **Cuando Copilot sigue cometiendo el mismo error**: ejecute `/chronicle improve` para identificar el patrón y generar instrucciones personalizadas para corregirlo.

  •         **Para recordar el trabajo pasado**: Pregunte una pregunta de forma libre como "¿He trabajado en cualquier cosa relacionada con la API de pagos?" y Copilot buscará en el historial.

  •           **Para continuar con el trabajo anterior**: use `copilot --continue` o `copilot --resume` para continuar donde lo dejó.

Volver a indexar el almacén de sesiones

El almacén de sesión se rellena incrementalmente durante una sesión CLI. Los datos de una sesión se escriben en el disco en un subdirectorio específico de la sesión de ~/.copilot/session-state/. Esto también sucede periódicamente durante una sesión y también cuando finaliza la sesión.

Puede reindexar la tienda de sesiones a partir de los archivos de sesión almacenados en disco, aunque normalmente nunca necesitará hacerlo.

Entre las situaciones en las que es posible que tenga que volver a indexar se incluyen las siguientes:

  •         **Indexación de sesiones antiguas**: si tiene archivos de sesión antiguos en el disco que se crearon antes de que existiera el almacén de sesiones, la reindexación rellenará el almacén de sesiones con datos de esas sesiones.

  •         **Eliminación de** sesión: si desea eliminar una sesión del historial, puede eliminar el directorio de sesión y, a continuación, volver a indexar el almacén de sesiones.

  •         **Migración o recuperación de sesiones**: si movió los archivos de sesión a otra máquina o los restauró desde una copia de seguridad, sin mover o restaurar el archivo de almacén de sesiones (`~/.copilot/session-store.db`), puede usar el comando reindex para volver a crear el almacén de sesiones.

  •         **Corrupción de archivos**: si el archivo de almacén de sesión (`~/.copilot/session-store.db`) se corrompe o se elimina accidentalmente, puede recuperar el almacén de sesiones a partir de los archivos de sesión.

  •         **Terminación inesperada**: si una sesión finaliza inesperadamente (por ejemplo, debido a una pérdida de energía o bloqueo) antes de que los datos mantenidos en la memoria se hayan vaciado en el almacén de sesiones, es posible que pueda rellenar el almacén de sesiones con los datos que faltan si se escribió en el disco, en los archivos de sesión, antes de la finalización.

Para volver a indexar el almacén de sesiones, use el siguiente comando de barra diagonal en una sesión interactiva de la CLI:

Copilot prompt
/chronicle reindex

Lectura adicional

  •         [AUTOTITLE](/copilot/how-tos/copilot-cli/chronicle)

  •         [AUTOTITLE](/copilot/reference/cli-command-reference)