attempt_completion

La herramienta attempt_completion señala que AI Cockpit Reasoning cree que una tarea está completa y presenta los resultados al usuario. Proporciona un resumen de lo que se logró, opcionalmente incluye un comando para demostrar el resultado y admite el refinamiento continuo a través de la retroalimentación del usuario.

Parámetros

La herramienta acepta estos parámetros:

• result (requerido): La descripción del resultado final que resume lo que se logró
• command (opcional): Un comando de CLI a ejecutar para demostrar el resultado

Qué Hace

Esta herramienta marca el final de una tarea presentando un resumen final de lo que se logró. Señala tanto al usuario como al sistema que la tarea actual está completa. Cuando se proporciona un comando, también puede demostrar el resultado a través de una ejecución en vivo.

¿Cuándo se usa?

• Cuando AI Cockpit Reasoning cree que la tarea del usuario ha sido completada
• Al resumir qué cambios o mejoras se realizaron
• Al demostrar el resultado actual con una ejecución de comando
• Al proporcionar un punto de control para la retroalimentación del usuario sobre la solución
• Al hacer la transición de una fase de trabajo a posibles refinamientos

Características Principales

• Proporciona una señal clara de que AI Cockpit Reasoning cree que la tarea está completa
• Resume los logros en un mensaje conciso
• Opcionalmente demuestra los resultados a través de la ejecución de comandos
• Habilita la retroalimentación del usuario para refinamientos adicionales
• Muestra los resultados en un formato especial de interfaz distinto de los mensajes regulares
• Captura telemetría de finalización de tareas para análisis del sistema
• Mantiene un flujo de conversación estructurado proporcionando puntos de control
• Admite la finalización de subtareas dentro de flujos de trabajo más grandes
• Garantiza que los usuarios reciban un resumen claro de lo que se hizo
• Disponible en todos los modos como parte del grupo de herramientas "siempre disponibles"

Limitaciones

• No debe usarse hasta que los usos anteriores de herramientas se confirmen como exitosos (directriz, no aplicada)
• Limitado a un solo comando para la demostración de resultados
• No puede presentar múltiples opciones de comandos
• Los comandos requieren aprobación del usuario antes de la ejecución
• Limitado a demostrar resultados que se pueden mostrar a través de comandos de CLI
• No se puede usar para la finalización parcial de tareas o actualizaciones de progreso
• El formateo de resultados elimina las etiquetas de cierre XML a través del procesamiento interno

Cómo Funciona

Cuando se invoca la herramienta attempt_completion, sigue este proceso:

1. Consideración de Seguridad (directriz, no aplicada):

   • Se instruye a la IA para confirmar que los usos anteriores de herramientas fueron exitosos
   • Esta es una mejor práctica en lugar de un mecanismo aplicado programáticamente

2. Presentación de Resultados:

   • Muestra el mensaje de finalización al usuario en un formato especial de interfaz "completion_result"
   • Elimina las etiquetas de cierre XML del texto del resultado usando la función removeClosingTag
   • Presenta el resultado de manera diferente a los mensajes regulares para distinción visual

3. Ejecución de Comandos (si se proporciona):

   • Solicita aprobación del usuario antes de ejecutar el comando
   • Solo se ejecuta si el usuario aprueba
   • Ejecuta el comando usando la funcionalidad de ejecución de comandos del sistema
   • Muestra el resultado del comando al usuario

4. Recopilación de Retroalimentación:

   • Espera la retroalimentación del usuario sobre el resultado de la finalización
   • Procesa esta retroalimentación y la devuelve a la IA
   • Habilita el refinamiento continuo basado en la entrada del usuario

5. Finalización y Continuación de la Tarea:

   • Señala la tarea como completada en el sistema
   • Captura datos de telemetría para la tarea completada
   • Para subtareas, ofrece terminar la subtarea y reanudar la tarea principal
   • Admite la conversación continua a través del mecanismo de retroalimentación

6. Integración de Implementación:

   • Los resultados de la herramienta se analizan a través del mecanismo de análisis del sistema en parse-assistant-message.ts
   • La herramienta es parte de la constante "ALWAYS_AVAILABLE_TOOLS", lo que la hace disponible en todos los modos

Directrices de Formateo de Resultados

El mensaje de resultado debe seguir estas directrices:

• Comunicar claramente lo que se logró
• Ser conciso pero completo
• Enfocarse en el valor entregado al usuario
• Evitar amabilidades innecesarias o texto de relleno
• Mantener un tono profesional y directo
• Presentar la información de una manera fácil de escanear y comprender
• Reconocer que el usuario puede proporcionar retroalimentación para refinamientos adicionales

Nota: El sistema elimina automáticamente las etiquetas de cierre XML del texto del resultado a través de la función removeClosingTag.

Directrices de Selección de Comandos

Al incluir un comando, sigue estas directrices:

• Elige comandos que demuestren visualmente el resultado
• Prefiere comandos que muestren al usuario lo que se creó o modificó
• Ejemplos incluyen:
  • open index.html para mostrar un sitio web creado
  • npm start para lanzar un servidor de desarrollo
  • python app.py para ejecutar una aplicación creada
• Evita comandos que simplemente impriman texto (como echo o cat)
• Recuerda que los comandos requieren aprobación del usuario antes de la ejecución
• Asegúrate de que el comando sea válido para el sistema operativo del usuario

Retroalimentación y Representación en la Interfaz

La herramienta attempt_completion tiene un mecanismo de retroalimentación único:

• Los resultados aparecen en un formato especial de interfaz "completion_result" distinto de los mensajes regulares
• El sistema espera la retroalimentación del usuario después de presentar el resultado
• La retroalimentación se procesa y se devuelve a AI Cockpit Reasoning para refinamientos adicionales
• Esto crea un ciclo de mejora iterativa en lugar de terminar la conversación
• La interfaz incluye elementos especiales para proporcionar retroalimentación
• Los resultados sirven como puntos de control claros en el flujo de conversación

Cuando se usa dentro de subtareas:

• El sistema ofrece terminar la subtarea y reanudar la tarea principal
• Si se aprueba, la subtarea se completa con un resumen
• La tarea principal se reanuda con el contexto de la subtarea completada
• Esto habilita flujos de trabajo complejos y anidados mientras se mantiene el contexto

Ejemplos de Uso

• Al crear un sitio web, AI Cockpit Reasoning presenta la solución y usa open index.html para mostrar el resultado. El usuario proporciona retroalimentación y AI Cockpit Reasoning refina el diseño.
• Al implementar una característica, AI Cockpit Reasoning resume los cambios y su impacto. El usuario solicita cobertura de pruebas adicional y AI Cockpit Reasoning continúa la tarea.
• Al corregir errores, AI Cockpit Reasoning explica qué se corrigió y cómo la solución aborda la causa raíz. El usuario confirma que la corrección funciona.
• Al configurar un entorno de desarrollo, AI Cockpit Reasoning confirma que todos los componentes están instalados. El usuario solicita configuración adicional y AI Cockpit Reasoning continúa.
• Al crear un script de procesamiento de datos, AI Cockpit Reasoning resume la funcionalidad. El usuario sugiere mejoras de rendimiento y AI Cockpit Reasoning optimiza el código.

Ejemplos de Uso

Completar una tarea con solo un resumen de resultados:

<attempt_completion>
<result>
He actualizado el CSS para la barra de navegación para que coincida con el mockup de diseño. Los cambios incluyen:
1. Esquema de colores actualizado para usar los nuevos colores de marca
2. Comportamiento responsivo agregado para dispositivos móviles
3. Problemas de alineación corregidos en los menús desplegables
</result>
</attempt_completion>

Completar una tarea con un resultado y un comando de demostración:

<attempt_completion>
<result>
He creado una aplicación React simple con las siguientes características:
1. Una página de destino responsiva con la sección hero solicitada
2. Un formulario de contacto funcional con validación
3. Navegación entre las tres páginas solicitadas
4. Estilos que coinciden con el mockup de diseño proporcionado
</result>
<command>npm start</command>
</attempt_completion>

Completar una tarea de script Python con ejecución:

<attempt_completion>
<result>
He creado un script de procesamiento de datos que:
1. Lee los archivos CSV del directorio de datos
2. Limpia y normaliza los datos según lo solicitado
3. Genera las estadísticas de resumen en formato JSON
4. Genera los datos procesados en el directorio de salida
</result>
<command>python process_data.py</command>
</attempt_completion>