Ir al contenido principal

Cómo Funcionan las Herramientas

AI Cockpit Reasoning usa herramientas para interactuar con su código y entorno. Estos asistentes especializados realizan acciones específicas como leer archivos, hacer ediciones, ejecutar comandos o buscar en su base de código. Las herramientas proporcionan automatización para tareas de desarrollo comunes sin requerir ejecución manual.

Flujo de Trabajo de las Herramientas​

Describa lo que desea lograr en lenguaje natural, y AI Cockpit Reasoning:

  1. Seleccionará la herramienta apropiada según su solicitud
  2. Presentará la herramienta con sus parámetros para su revisión
  3. Ejecutará la herramienta aprobada y le mostrará los resultados
  4. Continuará este proceso hasta que su tarea esté completa

Categorías de Herramientas​

CategoríaPropósitoNombres de Herramientas
LecturaAcceder al contenido de archivos y estructura del códigoread_file, search_files, list_files, list_code_definition_names
EdiciónCrear o modificar archivos y códigowrite_to_file, apply_diff
EjecuciónEjecutar comandos y realizar operaciones del sistemaexecute_command
NavegadorInteractuar con contenido webbrowser_action
Flujo de TrabajoGestionar el flujo de tareas y el contextoask_followup_question, attempt_completion, switch_mode, new_task

Ejemplo: Uso de Herramientas​

Así es como funciona una interacción típica con herramientas:

Interfaz de aprobación de herramientas mostrando los botones Guardar y Rechazar junto con la casilla de verificación de Aprobación automática

La interfaz de aprobación de herramientas muestra los botones Guardar/Rechazar y las opciones de aprobación automática.

Usuario: Crea un archivo llamado greeting.js que registre un mensaje de saludo

AI Cockpit Reasoning: (Propone la herramienta write_to_file como se muestra en la imagen anterior)

Usuario: (Hace clic en "Guardar" en la interfaz)

AI Cockpit Reasoning: (Confirma la creación del archivo)

Seguridad y Aprobación de Herramientas​

Cada uso de herramienta requiere su aprobación explícita. Cuando AI Cockpit propone una herramienta, verá:

  • Un botón "Guardar" para aprobar y ejecutar la herramienta
  • Un botón "Rechazar" para declinar la herramienta propuesta
  • Una configuración opcional de "Aprobación automática" para operaciones de confianza

Este mecanismo de seguridad garantiza que mantenga el control sobre qué archivos se modifican, qué comandos se ejecutan y cómo se cambia su base de código. Siempre revise las propuestas de herramientas cuidadosamente antes de guardarlas.

Referencia de Herramientas Principales​

Nombre de HerramientaDescripciónCategoría
read_fileLee el contenido de un archivo con números de líneaLectura
search_filesBusca texto o patrones regex en archivosLectura
list_filesLista archivos y directorios en una ubicación especificadaLectura
list_code_definition_namesLista definiciones de código como clases y funcionesLectura
write_to_fileCrea nuevos archivos o sobrescribe los existentesEdición
apply_diffRealiza cambios precisos en partes específicas de un archivoEdición
execute_commandEjecuta comandos en el terminal de VS CodeEjecución
browser_actionRealiza acciones en un navegador sin interfazNavegador
ask_followup_questionLe hace una pregunta de aclaraciónFlujo de Trabajo
attempt_completionIndica que la tarea está completaFlujo de Trabajo
switch_modeCambia a un modo operativo diferenteFlujo de Trabajo
new_taskCrea una nueva subtarea con un modo de inicio específicoFlujo de Trabajo

Más Información sobre las Herramientas​

Para obtener información más detallada sobre cada herramienta, incluyendo referencias completas de parámetros y patrones de uso avanzado, consulte la documentación de Descripción General del Uso de Herramientas.