Herramientas
Aprende cómo Bob usa herramientas especializadas para leer archivos, editar código, ejecutar comandos, generar subagentes, usar integraciones MCP y cambiar de modo para optimizar tu flujo de trabajo de codificación.
Flujo de trabajo de herramientas
Cuando trabajas con Bob, determina las acciones apropiadas. Para cada paso, Bob:
- Seleccionará la herramienta apropiada según tu solicitud
- Presentará la herramienta con sus parámetros para tu revisión
- Ejecutará la herramienta aprobada y te mostrará los resultados
- Continuará este proceso hasta que tu tarea esté completa
Categorías de herramientas
Las herramientas de Bob están agrupadas por su función principal. Entender estas categorías te ayuda a ver cómo Bob realiza diferentes tareas.
Herramientas de lectura
Las herramientas de lectura permiten a Bob acceder al contenido de archivos y entender la estructura del código sin hacer cambios.
| Herramienta | Propósito | Ejemplo de uso |
|---|---|---|
read_file | Lee el contenido de un archivo, con rangos de líneas opcionales | Ver archivos de configuración, examinar código fuente |
glob | Encuentra archivos por patrón de nombre (ej. **/*.ts) | Localizar archivos de prueba, encontrar todos los componentes |
grep | Busca contenido de archivos usando patrones regex | Encontrar definiciones de funciones, localizar TODOs |
list_files | Lista archivos y directorios | Explorar la estructura de un solo directorio |
GetSymbolsOverview | Obtiene símbolos de nivel superior en un archivo | Entender la estructura del archivo antes de profundizar |
FindSymbol | Busca un símbolo por ruta de nombre con profundidad opcional | Navegar a una clase, método o función |
FindReferencingSymbols | Encuentra todas las referencias a un símbolo | Entender dónde se usa una función o tipo |
Bob usa herramientas de lectura cuando tu solicitud involucra revisar código, buscar patrones o examinar la estructura del proyecto.
Herramientas de escritura
Las herramientas de escritura permiten a Bob crear nuevos archivos o modificar código existente.
| Herramienta | Propósito | Ejemplo de uso |
|---|---|---|
write_file | Crea un nuevo archivo o reescribe completamente uno existente | Generar nuevos componentes, crear archivos de configuración |
apply_diff | Aplica cambios precisos y específicos a partes particulares de un archivo | Actualizar lógica de funciones, corregir errores, refactorizar código |
insert_content | Inserta nuevas líneas en una posición específica en un archivo | Agregar imports, insertar nuevas funciones |
search_and_replace | Encuentra y reemplaza patrones de texto o regex en un archivo | Renombrar variables, actualizar patrones repetidos |
Bob usa herramientas de escritura cuando tu solicitud involucra crear archivos, implementar funciones, corregir errores o refactorizar código.
Herramientas de comando
Las herramientas de comando permiten a Bob ejecutar comandos y realizar operaciones del sistema.
| Herramienta | Propósito | Ejemplo de uso |
|---|---|---|
execute_command | Ejecuta comandos CLI en tu espacio de trabajo | Instalar dependencias, ejecutar pruebas, construir proyectos |
Bob usa herramientas de comando cuando tu solicitud involucra ejecutar comandos, instalar paquetes, ejecutar scripts o realizar operaciones del sistema.
Herramientas de subagente
Las herramientas de subagente permiten a Bob generar un agente independiente para manejar trabajo enfocado y autocontenido en su propio contexto aislado.
| Herramienta | Propósito | Ejemplo de uso |
|---|---|---|
spawn_subagent | Crea un agente independiente con su propia ventana de contexto | Investigar una sección del código base, recopilar información sin contaminar el contexto principal |
Cómo funcionan los subagentes
Un subagente se ejecuta independientemente de la conversación principal. Tiene su propia ventana de contexto, ejecuta su tarea asignada y devuelve un resumen de resultados a Bob. Esto hace que los subagentes sean útiles para trabajos que de otro modo agregarían grandes cantidades de contenido irrelevante a la conversación principal.
Bob usa subagentes con moderación. El comportamiento predeterminado es siempre hacer el trabajo directamente. Un subagente solo se considera cuando se cumplen todas las siguientes condiciones:
- La tarea está claramente autocontenida y solo se necesita un resumen de vuelta
- Agregaría contenido irrelevante significativo al contexto principal
- No se puede lograr con una o dos llamadas directas a herramientas
Hay dos tipos de subagentes:
| Tipo | Descripción |
|---|---|
explore | Exploración de código base de solo lectura, se ejecuta en un modelo más ligero |
general | Acceso completo a herramientas, se ejecuta en el modelo predeterminado |
Por defecto, un subagente no ve el historial de conversación del padre. Establecer fork_context: true pasa el historial de conversación al subagente cuando necesita entender decisiones previas, restricciones o preferencias del usuario.
Bob no usa subagentes para lecturas simples de archivos, búsquedas rápidas, operaciones de una sola herramienta o tareas donde ya tiene el contexto relevante.
Herramientas de subtarea
Las herramientas de subtarea permiten a Bob crear una nueva instancia de tarea con nombre que se ejecuta como su propia conversación dedicada en la UI.
| Herramienta | Propósito | Ejemplo de uso |
|---|---|---|
start_subtask | Crea una nueva tarea con título, instrucciones y lista de tareas opcional | Dividir una solicitud grande en una subtarea rastreada con su propio hilo de conversación |
Cómo funcionan las subtareas
Una subtarea es una tarea completamente independiente que aparece en la UI con su propia ruta de navegación e historial de conversación. A diferencia de un subagente — que se ejecuta silenciosamente en segundo plano y solo devuelve un resumen — una subtarea es visible e interactiva. Puedes seguir su progreso, revisar su salida y continuar la conversación dentro de ella.
Bob usa subtareas cuando una solicitud es lo suficientemente compleja como para beneficiarse del seguimiento dedicado y un hilo de conversación separado. Una subtarea puede recibir:
- Un título mostrado en la ruta de navegación de la UI
- Un mensaje con instrucciones detalladas
- Una lista de tareas inicial para rastrear pasos
- Un modo opcional para iniciarlo (por ejemplo, modo Plan para trabajo de diseño)
Herramientas MCP
Las herramientas MCP permiten a Bob extender sus capacidades a través de servidores Model Context Protocol (MCP) conectados.
| Herramienta | Propósito | Ejemplo de uso |
|---|---|---|
| Herramientas de servidor MCP | Accede a herramientas proporcionadas por servidores MCP conectados | Consultar bases de datos, interactuar con APIs, acceder a servicios externos |
Bob usa herramientas MCP cuando tu solicitud involucra funcionalidad proporcionada por servidores MCP configurados, como monday.com, bases de conocimiento de productos o integraciones personalizadas.
Herramientas de modo
Las herramientas de modo permiten a Bob cambiar entre diferentes modos para tareas especializadas.
| Herramienta | Propósito | Ejemplo de uso |
|---|---|---|
switch_mode | Cambia a un modo diferente (Agent, Plan, Ask, etc.) | Cambiar al modo Plan para diseño de arquitectura, modo Agent para implementación |
Bob usa herramientas de modo cuando tu solicitud se maneja mejor con un modo diferente y sus capacidades especializadas.
Herramientas de skill
Las herramientas de skill permiten a Bob activar conjuntos de instrucciones especializadas para dominios y tareas específicas.
| Herramienta | Propósito | Ejemplo de uso |
|---|---|---|
use_skill | Carga instrucciones detalladas para un skill nombrado en el contexto actual | Activar el skill de Carbon builder, cargar guía de flujo de trabajo de Jira |
Los skills extienden el conocimiento integrado de Bob con instrucciones curadas y específicas del dominio. Cuando una solicitud coincide con un skill — como trabajar con componentes de Carbon Design System, escribir documentación DITA o gestionar sprints de Jira — Bob activa el skill relevante una vez por conversación para cargar su guía completa antes de continuar.
Herramientas de workflow
Las herramientas de workflow permiten a Bob lanzar procesos predefinidos de múltiples pasos diseñados para tareas recurrentes específicas.
| Herramienta | Propósito | Ejemplo de uso |
|---|---|---|
start_workflow | Lanza un workflow nombrado con sus propios pasos estructurados | Crear un pull request, ejecutar una revisión de código |
Los workflows son procesos paso a paso curados para tareas comunes. Bob los usa cuando una solicitud coincide claramente con el propósito de un workflow — por ejemplo, generar una descripción de PR a partir de un diff de git o revisar cambios de código contra una rama base.
Herramientas de todo
Las herramientas de todo permiten a Bob rastrear el progreso a través de tareas de múltiples pasos usando una lista de verificación visible.
| Herramienta | Propósito | Ejemplo de uso |
|---|---|---|
update_todo_list | Crea o actualiza una lista de verificación markdown de pasos de tarea | Rastrear pasos de implementación, marcar elementos completados, agregar tareas recién descubiertas |
Bob usa el seguimiento de todos para tareas complejas con múltiples pasos. La lista se actualiza a medida que avanza el trabajo — marcando elementos como completados, agregando pasos recién descubiertos y manteniendo un elemento en progreso a la vez. Esto te da una vista clara de lo que se ha hecho y lo que queda.
Herramientas de pregunta
Las herramientas de pregunta permiten a Bob recopilar información adicional necesaria para completar tareas.
| Herramienta | Propósito | Ejemplo de uso |
|---|---|---|
ask_followup_question | Solicita aclaración o detalles adicionales | Preguntar sobre el enfoque de implementación preferido, solicitar información faltante |
Bob usa herramientas de pregunta cuando tu solicitud requiere más información o aclaración antes de que Bob pueda proceder.
Mantener la documentación sincronizada con tu base de código
Aprende a mantener la documentación técnica sincronizada con tu base de código usando el comando init de IBM Bob y un modo Docs Architect personalizado en escenarios de desarrollo reales — desarrollo de funcionalidades, revisiones de código, incorporación y mantenimiento continuo.
Gestión del context window
Aprende cómo funciona el context window de 270.000 tokens de Bob, cómo contribuye cada categoría al uso de tokens y las mejores prácticas para mantener las tasks enfocadas y eficientes en costes.