# Użycie narzędzi > Narzędzia DevHub w grupach: do czego służą, które argumenty mają znaczenie i jaki błąd zobaczysz najczęściej. Ta strona grupuje narzędzia według celu. Każde narzędzie ze wszystkimi parametrami jest w [katalogu narzędzi DevHub](/pl/devhub/reference/mcp-tools/index.md). Gwiazdka oznacza argument wymagany. To, które narzędzia dostajesz, zależy od Ustawień użytkownika i jego planu; zobacz [Ograniczenia](/pl/devhub/for-agents/limits/index.md). Większość narzędzi list i wyszukiwania przyjmuje `format` i `tokenBudget`. Zwiększ `tokenBudget`, gdy wynik mówi, że został ucięty. ## Kontekst | Narzędzie | Użyj, aby | Kluczowe argumenty | Typowy błąd | | -------------- | ----------------------------------------------------------------------------------------------------- | ---------------------------- | --------------------------------------------------------------------------------------- | | `context_pull` | wziąć to, co użytkownik zakolejkował dla Ciebie: notatki vaultu, symbole, przeglądy. Opróżnia kolejkę | `peek`, `ids`, `tokenBudget` | element zgłoszony jako brakujący zostaje w kolejce; plik lub symbol został przeniesiony | | `context_get` | odczytać ten sam ładunek bez opróżniania kolejki | `peek`, `ids` | | ## Orientacja | Narzędzie | Użyj, aby | Kluczowe argumenty | Typowy błąd | | ---------------- | ---------------------------------------------------------------------------------------------- | ------------------------------ | ----------- | | `workspace_list` | wylistować repozytoria, których możesz dotykać, z projektem, organizacją i sugerowanym vaultem | `organization`, `project`, `q` | | | `vault_list` | wylistować vaulty, które możesz czytać lub zapisywać, z zakresem i dostępem | | | ## Wiedza i vaulty | Narzędzie | Użyj, aby | Kluczowe argumenty | Typowy błąd | | --------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------- | ------------------------------------------------------------------------------- | | `vault_overview` | zobaczyć foldery, co należy do każdego, i liczbę notatek | `vaultId`* | | | `knowledge_search` | zapytać vault: decyzje, reguły, „dlaczego”. Czyta tylko foldery wiedzy; brak wyniku nie oznacza braku notatki | `query`*, `vaultId` lub `workspaceId`, `knowledgeType`, `limit` | pusty wynik: spróbuj `vault_files_search` albo sprawdź `knowledge_index_status` | | `rag_context` | złożyć oparty na źródłach kontekst do jednego pytania, podzielony według autorytetu | `query`*, `vaultId` | | | `knowledge_get` | przeczytać w całości jeden wynik wyszukiwania | `id`*, te same identyfikatory co w wyszukiwaniu | | | `vault_files_search` | znaleźć notatkę w całym vaulcie po słowach w niej | `query`_, `vaultId`_, `type`, `tags` | | | `vault_files_list` | przejrzeć jeden folder | `vaultId`*, `path` | | | `vault_file_read` | przeczytać notatkę, całą lub zakres linii | `vaultId`_, `path`_ | | | `vault_file_replace`, `vault_file_edit`, `vault_file_write`, `vault_file_create`, `vault_file_properties` | zmienić notatkę: dokładny tekst, zakresy linii, cała notatka, nowa notatka, front matter | `vaultId`_, `path`_ | „Vault is not configured for MCP write access” | | `vault_open` | pokazać użytkownikowi notatkę w oknie Vault Viewer | `vaultId`*, `path` | | | `knowledge_index_status`, `knowledge_index_refresh` | sprawdzić, czy Business Context jest zaindeksowany; przebudować po edycji notatek | `vaultIds` | | Do edycji wybieraj `vault_file_replace`. `vault_file_write` nadpisuje i usuwa to, czego nie ma w nowej treści. ## Pliki repozytorium | Narzędzie | Użyj, aby | Kluczowe argumenty | Typowy błąd | | ----------------------------------------------- | --------------------------------------------------------------------------------------- | ------------------------------------------ | ------------------------------------------------------------------------------- | | `files_list`, `files_search` | przeglądać folder; szukać tekstu | `workspaceId`_, `path`, `query`_ | | | `file_read` | przeczytać plik, cały lub zakres linii | `workspaceId`_, `path`_, `offset`, `limit` | odczyt częściowy mówi o tym w nagłówku; nie nadpisuj pliku na jego podstawie | | `file_replace`, `file_edit` | zmienić znany tekst; zmienić znane zakresy linii | `expectedHash` dla `file_edit` | niezgodność hasha lub tekstu: przeczytaj ponownie | | `file_create`, `file_write`, `directory_create` | utworzyć plik (kończy się błędem, gdy istnieje); utworzyć lub nadpisać; utworzyć folder | `workspaceId`_, `path`_ | „already exists” przy `file_create` | | `file_delete` | usunąć plik lub folder. Nieodwracalne; najpierw zapytaj użytkownika | `recursive` | wymaga poziomu zarządzania | | `asset_read`, `asset_write` | odczytać lub zapisać plik binarny jako Base64, do 20 MB | `base64`*, `mimeType` | | | `npm_script_list`, `npm_script_run` | wylistować i uruchomić zadeklarowane skrypty pakietu. Bez dowolnych poleceń | `script`*, `timeoutMs`, `ci` | niezadeklarowany skrypt jest odrzucany; uruchomienie wymaga poziomu zarządzania | | `display_list`, `display_screenshot` | zobaczyć to, co widzi użytkownik | `displayId`* | wymaga poziomu zarządzania | ## Indeks repozytorium Najpierw wywołaj `repo_index_status`; wywołaj `repo_index_refresh`, jeśli indeks jest nieaktualny. | Narzędzie | Użyj, aby | Kluczowe argumenty | | ------------------------------------------------- | -------------------------------------------------------------------------------------- | ---------------------------------------- | | `repo_overview` | zobaczyć mapę podsystemów i najbardziej połączonych symboli | `limit`, `tokenBudget` | | `repo_symbol_search` | znaleźć definicję po nazwie, sygnaturze, rodzaju lub ścieżce | `query`*, `kind`, `path`, `includeTests` | | `repo_symbol_get` | potwierdzić jeden symbol | `symbolId`* | | `repo_callers` | kto wywołuje symbol | `symbolId`* | | `repo_references` | każde odwołanie, także nierozstrzygnięte; użyj, gdy wynik callers wygląda na za krótki | `symbolId`* | | `repo_neighbors` | wszystko, co jest bezpośrednio połączone | `symbolId`*, `direction`, `kind` | | `repo_impact` | co się zepsuje, jeśli symbol się zmieni | `symbolId`*, `depth` | | `repo_file` | symbole pliku, importy i importujące | `path`* | | `repo_routes` | trasy HTTP i kanały IPC Electrona | `query` | | `repo_changed` | ile odczytała ostatnia przebudowa | | | `repo_unnamed_subsystems`, `repo_name_subsystems` | nazwać grupy, których indeks nie nazwał | `names`* | Wszystkie wymagają `workspaceId`. `symbolId` bierz z `repo_symbol_search`. ## Plany i śledztwa | Narzędzie | Użyj, aby | Kluczowe argumenty | Typowy błąd | | ------------------------------------------- | ----------------------------------------------------------------------------- | -------------------------- | --------------------------------------------------------------- | | `investigation_list` | zobaczyć, co już zbadano | `q` | | | `investigation_create`, `investigation_add` | otworzyć śledztwo; dopisać w nim dokument (analiza, wariant, plan, ustalenie) | `title`_, `body`_ | | | `investigation_read` | przeczytać jedno śledztwo lub jeden dokument | `id`*, `documentId` | | | `investigation_close` | agent nie może zamknąć śledztwa | | „An agent cannot close an investigation” | | `plan_ready` | co możesz wziąć teraz i dlaczego reszta jest zablokowana | `planId` | | | `plan_claim` | wziąć krok na wyłączność; zwraca krok i katalog roboczy | `planId`_, `stepId`_, `by` | odmowa: krok zajęty, bramka otwarta albo te same pliki w użyciu | | `plan_renew` | dać znać, że nadal nad tym pracujesz | `planId`_, `stepId`_ | | | `step_resume` | przeczytać krok w całości | `planId`_, `stepId`_ | | | `step_update`, `step_log` | przesunąć krok dalej; zapisać podejście | `outcome`* w `step_log` | | | `plan_close` | scalić katalog roboczy i zapisać commity | `commits`, `as` | „Step not closed: …” | | `plan_create`, `step_add` | otworzyć plan; dodać krok | `title`_, `id`_ | odmowa, gdy identyfikator jest zajęty | | `plan_status` | plan zestawiony z tym, co pokazuje repozytorium | `planId`* | | ## Agenci | Narzędzie | Użyj, aby | Kluczowe argumenty | Typowy błąd | | ------------------------------ | ------------------------------------------------------------------------------------------------ | --------------------------------- | ------------------------------------------------------------------------ | | `agent_list` | zobaczyć skonfigurowanych agentów i to, co przyjmuje `agent_create` | `workspaceId` | | | `agent_run` | zlecić zadanie skonfigurowanemu agentowi | `agentId`_, `task`_ | „RUNNING” to nie porażka; uruchomienie agenta wymaga poziomu zarządzania | | `agent_run_status` | poczekać na przebieg | `runId`*, `wait` (0 do 45 sekund) | „No such run” | | `agent_create`, `agent_update` | skonfigurować agenta. Nowy lub rozszerzony agent jest wyłączony, dopóki właściciel go nie włączy | | „No persona …” lub „No client …” | ## Biblioteka, pamięć i nauka | Narzędzie | Użyj, aby | | -------------------------------- | ----------------------------------------------------------------------------------------------------- | | `library_list`, `library_get` | znaleźć istniejący skill, regułę, polecenie, personę, profil lub instrukcję i wczytać ją do tej sesji | | `library_create`, `library_edit` | pisać do własnej kolekcji użytkownika. Najpierw wywołaj `library_list` | | `memory_note` | zapisać trwały fakt o pracy, użytkowniku lub o tym, gdzie co leży | | `learning_note` | zapisać jedną lekcję o tym, dlaczego coś poszło źle | ## Audyt `audit_summary` odpowiada na pytanie „czy teraz coś nie działa”. `audit_analyze` znajduje powtarzające się błędy i wolne narzędzia. `audit_list` pokazuje pojedyncze wywołania z argumentami, błędem i czasem. ## Zwierzak `pet_persona`: wywołaj raz na sesję i zachowaj wynik. Mówi, czy persona dotyczy Twoich odpowiedzi. `pet_say` pokazuje użytkownikowi, co robisz; `pet_status` pokazuje aktualny stan zwierzaka. ## Powiązane - [Katalog narzędzi DevHub](/pl/devhub/reference/mcp-tools/index.md) - [Przepływy pracy](/pl/devhub/for-agents/workflows/index.md)