Conceitos principais

Ferramentas

Aprenda como Bob usa ferramentas especializadas para ler arquivos, editar código, executar comandos, gerar subagentes, usar integrações MCP e alternar modos para otimizar seu fluxo de trabalho de codificação.

Fluxo de trabalho de ferramentas

Quando você trabalha com Bob, ele determina as ações apropriadas. Para cada etapa, Bob irá:

  1. Selecionar a ferramenta apropriada com base na sua solicitação
  2. Apresentar a ferramenta com seus parâmetros para sua revisão
  3. Executar a ferramenta aprovada e mostrar os resultados
  4. Continuar este processo até que sua tarefa esteja completa

Categorias de ferramentas

As ferramentas do Bob são agrupadas por sua função principal. Entender essas categorias ajuda você a ver como Bob executa diferentes tarefas.

Ferramentas de leitura

Ferramentas de leitura permitem que Bob acesse conteúdo de arquivo e entenda estrutura de código sem fazer mudanças.

FerramentaPropósitoExemplo de uso
read_fileLer o conteúdo de um arquivo, com intervalos de linhas opcionaisVer arquivos de configuração, examinar código-fonte
globEncontrar arquivos por padrão de nome (ex. **/*.ts)Localizar arquivos de teste, encontrar todos os componentes
grepPesquisar conteúdo de arquivo usando padrões regexEncontrar definições de função, localizar TODOs
list_filesListar arquivos e diretóriosNavegar pela estrutura de um único diretório
GetSymbolsOverviewObter símbolos de nível superior em um arquivoEntender estrutura do arquivo antes de mergulhar
FindSymbolProcurar um símbolo por caminho de nome com profundidade opcionalNavegar para uma classe, método ou função
FindReferencingSymbolsEncontrar todas as referências a um símboloEntender onde uma função ou tipo é usado

Bob usa ferramentas de leitura quando sua solicitação envolve revisar código, pesquisar padrões ou examinar estrutura do projeto.

Ferramentas de escrita

Ferramentas de escrita permitem que Bob crie novos arquivos ou modifique código existente.

FerramentaPropósitoExemplo de uso
write_fileCriar um novo arquivo ou reescrever completamente um existenteGerar novos componentes, criar arquivos de configuração
apply_diffAplicar mudanças precisas e direcionadas a partes específicas de um arquivoAtualizar lógica de função, corrigir bugs, refatorar código
insert_contentInserir novas linhas em uma posição específica em um arquivoAdicionar imports, inserir novas funções
search_and_replaceEncontrar e substituir padrões de texto ou regex em um arquivoRenomear variáveis, atualizar padrões repetidos

Bob usa ferramentas de escrita quando sua solicitação envolve criar arquivos, implementar recursos, corrigir bugs ou refatorar código.

Ferramentas de comando

Ferramentas de comando permitem que Bob execute comandos e realize operações do sistema.

FerramentaPropósitoExemplo de uso
execute_commandExecutar comandos CLI no seu espaço de trabalhoInstalar dependências, executar testes, construir projetos

Bob usa ferramentas de comando quando sua solicitação envolve executar comandos, instalar pacotes, executar scripts ou realizar operações do sistema.

Ferramentas de subagente

Ferramentas de subagente permitem que Bob gere um agente independente para lidar com trabalho focado e autocontido em seu próprio contexto isolado.

FerramentaPropósitoExemplo de uso
spawn_subagentCriar um agente independente com sua própria janela de contextoPesquisar uma seção da base de código, reunir informações sem poluir o contexto principal

Como funcionam os subagentes

Um subagente é executado independentemente da conversa principal. Ele tem sua própria janela de contexto, executa sua tarefa atribuída e retorna um resumo dos resultados para Bob. Isso torna os subagentes úteis para trabalhos que, de outra forma, adicionariam grandes quantidades de conteúdo irrelevante à conversa principal.

Bob usa subagentes com moderação. O padrão é sempre fazer o trabalho diretamente. Um subagente só é considerado quando todas as seguintes condições são verdadeiras:

  • A tarefa é claramente autocontida e apenas um resumo é necessário de volta
  • Adicionaria conteúdo irrelevante significativo ao contexto principal
  • Não pode ser realizada com uma ou duas chamadas diretas de ferramenta

Existem dois tipos de subagentes:

TipoDescrição
exploreExploração de base de código somente leitura, executa em um modelo mais leve
generalAcesso completo a ferramentas, executa no modelo padrão

Por padrão, um subagente não vê o histórico de conversa do pai. Definir fork_context: true passa o histórico de conversa para o subagente quando ele precisa entender decisões anteriores, restrições ou preferências do usuário.

Bob não usa subagentes para leituras simples de arquivo, pesquisas rápidas, operações de ferramenta única ou tarefas onde já tem o contexto relevante.

Ferramentas de subtarefa

Ferramentas de subtarefa permitem que Bob crie uma nova instância de tarefa nomeada que é executada como sua própria conversa dedicada na UI.

FerramentaPropósitoExemplo de uso
start_subtaskCriar uma nova tarefa com título, instruções e lista de tarefas opcionalDividir uma solicitação grande em uma subtarefa rastreada com seu próprio thread de conversa

Como funcionam as subtarefas

Uma subtarefa é uma tarefa completamente independente que aparece na UI com seu próprio breadcrumb e histórico de conversa. Ao contrário de um subagente — que é executado silenciosamente em segundo plano e retorna apenas um resumo — uma subtarefa é visível e interativa. Você pode acompanhar seu progresso, revisar sua saída e continuar a conversa dentro dela.

Bob usa subtarefas quando uma solicitação é complexa o suficiente para se beneficiar de rastreamento dedicado e um thread de conversa separado. Uma subtarefa pode receber:

  • Um título mostrado no breadcrumb da UI
  • Uma mensagem com instruções detalhadas
  • Uma lista de tarefas inicial para rastrear etapas
  • Um modo opcional para iniciá-la (por exemplo, modo Plan para trabalho de design)

Ferramentas MCP

Ferramentas MCP permitem que Bob estenda suas capacidades através de servidores Model Context Protocol (MCP) conectados.

FerramentaPropósitoExemplo de uso
Ferramentas de servidor MCPAcessar ferramentas fornecidas por servidores MCP conectadosConsultar bancos de dados, interagir com APIs, acessar serviços externos

Bob usa ferramentas MCP quando sua solicitação envolve capacidades fornecidas por servidores MCP configurados, como monday.com, bases de conhecimento de produtos ou integrações personalizadas.

Ferramentas de modo

Ferramentas de modo permitem que Bob alterne entre diferentes modos para tarefas especializadas.

FerramentaPropósitoExemplo de uso
switch_modeMudar para um modo diferente (Agent, Plan, Ask, etc.)Mudar para modo Plan para design de arquitetura, modo Agent para implementação

Bob usa ferramentas de modo quando sua solicitação é melhor tratada por um modo diferente e suas capacidades especializadas.

Ferramentas de skill

Ferramentas de skill permitem que Bob ative conjuntos de instruções especializadas para domínios e tarefas específicas.

FerramentaPropósitoExemplo de uso
use_skillCarregar instruções detalhadas para um skill nomeado no contexto atualAtivar o skill Carbon builder, carregar orientação de fluxo de trabalho Jira

Skills estendem o conhecimento integrado do Bob com instruções curadas e específicas do domínio. Quando uma solicitação corresponde a um skill — como trabalhar com componentes Carbon Design System, escrever documentação DITA ou gerenciar sprints Jira — Bob ativa o skill relevante uma vez por conversa para carregar sua orientação completa antes de prosseguir.

Ferramentas de workflow

Ferramentas de workflow permitem que Bob lance processos predefinidos de múltiplas etapas projetados para tarefas recorrentes específicas.

FerramentaPropósitoExemplo de uso
start_workflowLançar um workflow nomeado com suas próprias etapas estruturadasCriar um pull request, executar uma revisão de código

Workflows são processos passo a passo curados para tarefas comuns. Bob os usa quando uma solicitação corresponde claramente ao propósito de um workflow — por exemplo, gerar uma descrição de PR a partir de um diff git ou revisar mudanças de código em relação a um branch base.

Ferramentas de todo

Ferramentas de todo permitem que Bob rastreie o progresso através de tarefas de múltiplas etapas usando uma checklist visível.

FerramentaPropósitoExemplo de uso
update_todo_listCriar ou atualizar uma checklist markdown de etapas de tarefaRastrear etapas de implementação, marcar itens concluídos, adicionar tarefas recém-descobertas

Bob usa rastreamento de todo para tarefas complexas com múltiplas etapas. A lista é atualizada conforme o trabalho progride — marcando itens como concluídos, adicionando etapas recém-descobertas e mantendo um item em progresso por vez. Isso dá a você uma visão clara do que foi feito e do que resta.

Ferramentas de pergunta

Ferramentas de pergunta permitem que Bob reúna informações adicionais necessárias para completar tarefas.

FerramentaPropósitoExemplo de uso
ask_followup_questionSolicitar esclarecimento ou detalhe adicionalPerguntar sobre abordagem de implementação preferida, solicitar informações faltantes

Bob usa ferramentas de pergunta quando sua solicitação requer mais informações ou esclarecimento antes que Bob possa prosseguir.

Como está este tópico?