Características experimentales - Amazon Q Developer
Administración de características experimentalesAdministración de conocimientosModo TangentCreación de puntos de controlPorcentaje de uso del contextoDelegadosListas de tareas pendientesModo de pensamiento mejoradoIntegración de ajustesRecursos adicionales

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Características experimentales

La CLI de Amazon Q Developer incluye características experimentales que proporcionan funcionalidad avanzada para mejorar la productividad. Estas características se encuentran en desarrollo activo y deben habilitarse de forma explícita antes de su uso.

importante

Las características experimentales pueden cambiar o eliminarse en cualquier momento. Úselas según su propio criterio en los flujos de trabajo de producción.

Administración de características experimentales

Utilice el comando /experiment para ver y cambiar de características experimentales:

/experiment

Se muestra un menú interactivo en el que puede:

  • Consultar el estado actual de cada experimento (ACTIVAR/DESACTIVAR)

  • Cambiar de experimentos al seleccionarlos

  • Ver las descripciones de lo que hace cada experimento

Administración de conocimientos

La característica Administración de conocimientos permite almacenar y recuperar el contexto persistente en las sesiones de chat. Habilítela con:

q settings chat.enableKnowledge true

Uso básico

Una vez habilitada, utilice los comandos /knowledge en la sesión de chat:

/knowledge add <name> <path>

Añade archivos o directorios a la base de conocimientos.

/knowledge show

Muestra todas las entradas de la base de conocimientos.

/knowledge remove <identifier>

Elimina las entradas por nombre, ruta o ID de contexto.

/knowledge update <path>

Actualiza la entrada existente en la base de conocimientos con contenido nuevo.

/knowledge clear

Elimina todas las entradas de la base de conocimientos (requiere confirmación).

/knowledge status

Muestra el estado de las operaciones de indexación en segundo plano.

Tipos de índices

Elija entre dos métodos de indexación al añadir contenido:

Fast (--index-type Fast)

Búsqueda léxica mediante BM25. Indexación ultrarrápida y búsqueda instantánea basada en palabras clave. Opción ideal para registros, configuraciones y bases de código de gran tamaño.

Best (--index-type Best)

Búsqueda semántica mediante incrustaciones de IA. Búsqueda inteligente que entiende el contexto y el significado. Opción ideal para la documentación y la investigación.

Ejemplo de uso:

/knowledge add "project-docs" /path/to/docs --index-type Best
/knowledge add "log-files" /path/to/logs --index-type Fast

Bases de conocimiento según el agente

Cada agente mantiene su propia base de conocimientos independiente, lo que garantiza que los contextos de conocimiento se ajusten al agente específico con el que se trabaja. Al cambiar de un agente a otro, los comandos de conocimiento funcionan automáticamente con la base de conocimientos específica de ese agente.

Modo Tangent

El modo Tangent crea puntos de comprobación de la conversación, lo que le permite explorar temas secundarios sin interrumpir el flujo principal de la conversación. Habilítelo con:

q settings chat.enableTangentMode true

Uso del modo Tangent

Una vez habilitado, utilice /tangent o Ctrl+T para cambiar al modo Tangent:

  1. Entrar en el modo Tangent: crea un punto de comprobación de conversación.

    /tangent
Created a conversation checkpoint (↯). Use ctrl + t or /tangent to restore the conversation later.

  2. En el modo Tangent: aparecerá un símbolo ↯ de color amarillo en la petición.

    ↯ > What is the difference between async and sync functions?

  3. Salir del modo Tangent: vuelve a la conversación principal.

    ↯ > /tangent
Restored conversation from checkpoint (↯). - Returned to main conversation.

Prácticas recomendadas

Utilice el modo Tangent para:

  • Formular preguntas aclaratorias sobre el tema actual

  • Explorar otros métodos antes de tomar una decisión

  • Obtener ayuda con los comandos o las características de la CLI de Q Developer

  • Probar la comprensión de los conceptos

Evite usar el modo Tangent para temas no relacionados o para debates largos y complejos.

Creación de puntos de control

Los puntos de control permiten realizar instantáneas del ámbito de la sesión para realizar un seguimiento de los cambios en los archivos mediante los comandos de Git CLI. Esta función crea un repositorio de git prácticamente invisible para gestionar el estado de los archivos en toda la sesión de chat.

Activa los puntos de control con:

q settings chat.enableCheckpoint true

Características

  • El archivo de instantáneas se convierte en un repositorio de git oculto

  • Enumere, expanda, diferencie y restaure en cualquier punto de control

  • El historial de conversaciones se recupera al restaurar los puntos de control

  • Se habilita automáticamente en los repositorios de git (efímeros, se limpian al final de la sesión)

  • La inicialización manual está disponible para directorios que no son de git

Uso básico

Una vez habilitada, utilice los comandos /checkpoint en la sesión de chat:

/checkpoint init

Habilita los puntos de control manualmente (obligatorio si no están en un repositorio de git)

/checkpoint list [--limit N]

Muestra los puntos de control por turnos con las estadísticas de los archivos

/checkpoint expand <tag>

Muestra los puntos de control a nivel de herramienta en un turno específico

<tag1>/checkpoint diff [tag2|head]

Compare los puntos de control o compárelos con el estado actual

/checkpoint restore [<tag>] [--hard]

Restaurar al punto de control (muestra el selector interactivo si no se especifica ninguna etiqueta)

/punto de control limpio

Eliminar el repositorio oculto de la sesión

Opciones de restauración

Comportamiento de restauración predeterminado:

  • Revierte los cambios y eliminaciones rastreados

  • Mantiene los archivos creados después del punto de control

Restauración completa (--hardindicador):

  • Hace que el espacio de trabajo coincida exactamente con el estado del punto de control

  • Elimina los archivos rastreados creados después del punto de control

importante

Checkpointing crea repositorios de git temporales que se limpian al finalizar la sesión. Ten cuidado con la --hard restauración, ya que elimina los archivos de forma permanente.

Porcentaje de uso del contexto

El porcentaje de uso del contexto muestra el consumo actual de la ventana de contexto como un porcentaje en el mensaje del chat, lo que le ayuda a controlar qué parte de la ventana de contexto disponible se está utilizando.

Activa el porcentaje de uso del contexto con:

q settings chat.enableContextUsageIndicator true

Características

  • Muestra el porcentaje de la ventana de contexto utilizada en la solicitud (por ejemplo, «[rust-agent] 6% >»)

  • Indicadores codificados por colores para una referencia visual rápida

  • Ayuda a monitorear el consumo de ventanas contextuales durante conversaciones largas

Indicadores visuales

La pantalla de porcentajes utiliza códigos de colores para indicar los niveles de uso:

Verde: uso inferior al 50%

Funcionamiento normal con abundante espacio contextual disponible

Amarillo: entre un 50 y un 89% de uso

Uso moderado, considere la gestión del contexto

Rojo: entre un 90 y un 100% de uso

Alto nivel de uso, la ventana de contexto está casi llena

Delegados

Delegate permite iniciar y gestionar procesos de tareas asíncronos, lo que le permite ejecutar sesiones de chat de Amazon Q con agentes específicos en paralelo a su conversación principal.

Habilite la función de delegar con:

q settings chat.enableDelegate true

Características

  • Lance tareas en segundo plano utilizando un lenguaje natural

  • Organice sesiones de chat paralelas de Amazon Q con agentes específicos

  • Supervisa el progreso de las tareas de forma

  • Flujo de aprobación de los agentes para una ejecución segura de las tareas

De uso

Utilice un lenguaje natural para pedirle al modelo que inicie una tarea en segundo plano:

Can you create a background task to analyze the performance of our API endpoints?

Una vez que la tarea esté lista, compruebe los resultados:

Check the status of my API analysis task
Show me the results from the background analysis

Flujo de aprobación de los agentes

Tareas con los agentes: requieren una aprobación explícita y muestran los detalles del agente antes de la ejecución

Tareas sin agentes: ejecútelas con una advertencia sobre la posibilidad de confiar en todos los permisos

Una vez delegadas, las tareas funcionan de forma independiente y puedes:

  • Comprueba el progreso en cualquier momento

  • Lea los resultados cuando estén completos

  • Elimine las tareas cuando ya no las necesite

importante

Delega las tareas que se ejecutan con permisos elevados. Revise detenidamente los detalles del agente antes de aprobar la ejecución de la tarea.

Listas de tareas pendientes

Las listas de TAREAS pendientes permiten a Amazon Q crear y modificar listas de tareas automáticamente, a la vez que le proporcionan comandos para ver y gestionar las listas de TAREAS pendientes existentes.

Habilite las listas de TAREAS PENDIENTES con:

q settings chat.enableTodoList true

Características

  • Amazon Q crea automáticamente listas de tareas pendientes cuando es apropiado o cuando se le solicita

  • Vea, gestione y elimine TODOs mediante /todos comandos

  • Reanude las listas de TAREAS pendientes existentes almacenadas en .amazonq/cli-todo-lists

  • Almacenamiento persistente en todas las sesiones de chat

Uso básico

Una vez activado, Amazon Q creará listas de tareas pendientes automáticamente durante las conversaciones. Use /todos comandos para administrarlas:

/todos con un acabado nítido

Eliminar completado TODOs en su directorio de trabajo

/todos resumir

Seleccione y reanude una lista de TAREAS PENDIENTES existente

/todos ver

Seleccione y vea una lista de TAREAS PENDIENTES existente

/todos eliminar

Seleccione y elimine una lista de tareas pendientes existente

Integración de flujos de trabajo

Amazon Q crea listas de tareas pendientes cuando:

  • Solicita un desglose de las tareas

  • Se discuten los procesos complejos de varios pasos

  • Se producen conversaciones sobre la planificación del proyecto

  • Solicita explícitamente una lista de tareas pendientes

Las listas de tareas pendientes se guardan automáticamente .amazonq/cli-todo-lists y permanecen en las sesiones de chat, lo que te permite reanudar el trabajo en proyectos a largo plazo.

Modo de pensamiento mejorado

El modo Pensamiento permite un razonamiento complejo con procesos de step-by-step pensamiento, lo que proporciona transparencia al proceso de toma de decisiones de Amazon Q.

Habilite el modo de pensamiento con:

q settings chat.enableThinking true

Características

  • Muestra el proceso de razonamiento de la IA para problemas complejos

  • Step-by-step procesos de pensamiento para el razonamiento en varios pasos

  • Ayuda a entender cómo se llegan a las conclusiones

  • Útil para depurar y aprender

  • Toma de decisiones transparente para tareas complejas

Cuándo se debe usar

El modo de pensar es particularmente valioso para:

  • Resolución de problemas complejos: comprender el razonamiento detrás de las soluciones

  • Asistencia en la depuración: análisis del proceso analítico para la resolución de problemas

  • Escenarios de aprendizaje: comprender cómo los conceptos se conectan y se basan unos en otros

  • Flujos de trabajo de varios pasos: seguir la lógica mediante procedimientos complejos

Integración de ajustes

Todas las funciones experimentales se integran con el sistema de configuración de Amazon Q CLI y persisten en todas las sesiones. Puede gestionar los experimentos a través de:

Menú de experimentos interactivo:

/experiment

Comandos de configuración directa:

q settings chat.enableCheckpoint true
q settings chat.enableContextUsageIndicator true
q settings chat.enableKnowledge true
q settings chat.enableTangentMode true
q settings chat.enableThinking true
q settings chat.enableDelegate true
q settings chat.enableTodoList true

Todos los comandos experimentales están disponibles a través de la búsqueda difusa ()Ctrl+S:

  • /experiment- Administra las funciones experimentales

  • /knowledge- Comandos de la base de conocimientos (cuando están habilitados)

  • /checkpoint- Comandos de puntos de control (cuando están activados)

  • /todos- Comandos de lista de TAREAS PENDIENTES (cuando están activados)

  • /tangent- Conmutador de modo tangente (cuando está activado)

Esta integración hace que las funciones experimentales sean fácilmente detectables y accesibles durante el flujo de trabajo.

Recursos adicionales

Para obtener todos los detalles sobre las características experimentales, incluidas las opciones de configuración avanzadas y la solución de problemas, consulte la documentación complementaria de la CLI para Amazon Q Developer: