Narzędzia
Dowiedz się, jak Bob Shell używa specjalistycznych narzędzi do odczytywania plików, edytowania kodu, uruchamiania poleceń i interakcji ze środowiskiem deweloperskim z wiersza poleceń.
Workflow narzędzi
Gdy opiszesz, co chcesz osiągnąć w języku naturalnym, Bob Shell:
- Wybierze odpowiednie narzędzie na podstawie twojego żądania.
- Przedstawi narzędzie wraz z jego parametrami do twojej weryfikacji.
- Uruchomi zatwierdzone narzędzie i pokaże wyniki.
- Kontynuuje ten proces do ukończenia zadania.
Kategorie narzędzi
Narzędzia Bob Shell są zorganizowane w kategorie na podstawie ich głównej funkcji. Zrozumienie tych kategorii pomoże ci wiedzieć, co Bob Shell może zrobić i jak realizuje zadania.
Narzędzia do odczytu
Uzyskuj dostęp do zawartości plików i rozumiej strukturę kodu bez wprowadzania zmian.
| Narzędzie | Cel | Przykładowe użycie |
|---|---|---|
read_file | Odczytaj zawartość jednego lub więcej plików | Przeglądaj pliki konfiguracyjne, sprawdzaj kod źródłowy |
search_files | Wyszukuj wzorce w wielu plikach używając regex | Znajdź wszystkie komentarze TODO, zlokalizuj definicje funkcji |
list_files | Wylistuj pliki i katalogi w podanej ścieżce | Eksploruj strukturę projektu, znajdź konkretne typy plików |
list_code_definition_names | Wyodrębnij nazwy klas, funkcji i metod z plików źródłowych | Uzyskaj przegląd organizacji kodu |
Kiedy Bob Shell używa narzędzi do odczytu: Gdy prosisz Bob Shell o przejrzenie kodu, znalezienie konkretnych wzorców lub zrozumienie struktury projektu.
Narzędzia do zapisu
Twórz nowe pliki lub modyfikuj istniejący kod z precyzją.
| Narzędzie | Cel | Przykładowe użycie |
|---|---|---|
write_to_file | Utwórz nowy plik lub całkowicie nadpisz istniejący | Generuj nowe komponenty, twórz pliki konfiguracyjne |
apply_diff | Wprowadzaj ukierunkowane zmiany w określonych sekcjach pliku | Aktualizuj logikę funkcji, naprawiaj błędy, refaktoryzuj kod |
insert_content | Dodaj nowe linie w określonej lokalizacji w pliku | Dodaj importy, wstaw nowe funkcje |
Kiedy Bob Shell używa narzędzi do zapisu: Gdy prosisz Bob Shell o tworzenie plików, implementowanie funkcji, naprawianie błędów lub refaktoryzację kodu.
Narzędzia do poleceń
Uruchamiaj polecenia i wykonuj operacje systemowe w terminalu.
| Narzędzie | Cel | Przykładowe użycie |
|---|---|---|
execute_command | Uruchamiaj polecenia CLI w obszarze roboczym | Instaluj zależności, uruchamiaj testy, buduj projekty |
Kiedy Bob Shell używa narzędzi do poleceń: Gdy prosisz Bob Shell o uruchamianie poleceń, instalowanie pakietów, uruchamianie skryptów lub wykonywanie operacji systemowych.
Narzędzia MCP
Rozszerz możliwości Bob Shell poprzez serwery Model Context Protocol.
| Narzędzie | Cel | Przykładowe użycie |
|---|---|---|
use_mcp_tool | Uzyskaj dostęp do narzędzi dostarczanych przez połączone serwery MCP | Wykonuj zapytania do baz danych, interakcja z API, dostęp do zewnętrznych usług |
Narzędzia trybów
Przełączaj się między różnymi trybami Bob Shell dla wyspecjalizowanych zadań.
| Narzędzie | Cel | Przykładowe użycie |
|---|---|---|
switch_mode | Zmień na inny tryb (Agent, Plan, Ask itd.) | Przełącz na tryb Plan do projektowania architektury, tryb Agent do implementacji |
Kiedy Bob Shell używa narzędzi trybów: Gdy bieżące zadanie skorzystałoby na wyspecjalizowanych możliwościach innego trybu.
Narzędzia pytań
Zbieraj dodatkowe informacje potrzebne do ukończenia zadań.
| Narzędzie | Cel | Przykładowe użycie |
|---|---|---|
ask_followup_question | Poproś o wyjaśnienie lub dodatkowe szczegóły | Zapytaj o preferowane podejście do implementacji, zażądaj brakujących informacji |
Grupy narzędzi
Grupy narzędzi to nazwane kolekcje powiązanych narzędzi, które możesz włączać lub wyłączać razem. Używaj grup narzędzi, aby ograniczyć to, co Bob Shell może zrobić w danej sesji — na przykład, aby zapobiec zapisywaniu plików w audycie tylko do odczytu, lub wyłączyć wykonywanie poleceń w kontrolowanym środowisku.
Dostępne grupy narzędzi
| Grupa | Zawarte narzędzia | Domyślnie w Agent | Domyślnie w Plan | Domyślnie w Ask |
|---|---|---|---|---|
read | Narzędzia do odczytu, wyszukiwania i listowania plików | ✓ | ✓ | ✓ |
edit | Narzędzia do zapisu plików i diff | ✓ | ✓ | ✓ |
execute | Narzędzia do wykonywania poleceń powłoki | ✓ | — | — |
mcp | Narzędzia serwera MCP | ✓ | ✓ | ✓ |
skill | Narzędzia związane z umiejętnościami | ✓ | ✓ | ✓ |
todo | Narzędzia do zarządzania listą zadań | ✓ | ✓ | — |
subagent | Narzędzia do uruchamiania subagentów | ✓ | — | — |
mode | Narzędzia do przełączania trybów | ✓ | ✓ | ✓ |
Wyłączanie grup narzędzi
Przekaż --disable-tool-groups do bob run lub bob chat z rozdzieloną przecinkami listą nazw grup:
# Wyłącz wykonywanie poleceń i narzędzia MCP
bob run --disable-tool-groups execute,mcp "Review @src/"
# Uruchom w trybie tylko do odczytu
bob run --disable-tool-groups edit,execute,mcp "Summarize the codebase"Możesz też wyłączyć wszystkie serwery MCP jednym krokiem za pomocą dedykowanej flagi:
bob run --disable-mcp "Explain @app.js"