Użycie narzędzi

Ta strona grupuje narzędzia według celu. Każde narzędzie ze wszystkimi parametrami jest w katalogu narzędzi DevHub. Gwiazdka oznacza argument wymagany. To, które narzędzia dostajesz, zależy od Ustawień użytkownika i jego planu; zobacz Ograniczenia.

Większość narzędzi list i wyszukiwania przyjmuje format i tokenBudget. Zwiększ tokenBudget, gdy wynik mówi, że został ucięty.

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

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

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.

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

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.

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*

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 …”

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

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.

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.

• Katalog narzędzi DevHub
• Przepływy pracy