Dokumentacja API MCP

Pełna dokumentacja wszystkich 11 narzędzi MCP Maguyva dostępnych dla klientów. Każde narzędzie zawiera parametry, wskazówki dotyczące użycia i rekomendacje zastosowań.

Przegląd API#

API MCP Maguyva udostępnia obecnie 11 narzędzi dla klientów w 4 głównych kategoriach:

Podstawowe narzędzia wyszukiwania - Zaawansowane możliwości wyszukiwania w Twojej bazie kodu
Narzędzia strukturalne i grafowe - Zapytania AST, wyszukiwanie symboli i analiza zależności
Narzędzia analizy kodu - Dogłębna analiza kodu i mapowanie relacji
Narzędzia systemowe i pomocnicze - Kontekst repozytorium, obliczenia deterministyczne i wskazówki

Wszystkie narzędzia używają spójnego format identyfikatora repozytorium: "owner/repo:branch". Jeśli branch nie zostanie podany, domyślnie używany jest main.

Pomiń repository, gdy twój klient MCP dostarcza domyślne ustawienie dla żądania lub gdy klucz ma dostęp dokładnie do jednego repozytorium; w przeciwnym razie przekaż je jawnie. Użyj repository_context(action="info", repository="owner/repo"), aby sprawdzić, jak rozwiązuje się repozytorium.

Format parametru repozytorium#

Wszystkie narzędzia MCP używają tego formatu identyfikatora repozytorium:

Z gałęzią: "owner/repo:branch" - np., "owner/repository:develop"
Domyślna gałąź: "owner/repo" - używa głównej gałęzi, gdy nie podano gałęzi "owner/repository"
Domyślne repozytorium żądania lub jedyne dostępne: Pomiń repository, gdy klient MCP przekazuje domyślne repozytorium dla żądania lub klucz ma dostęp dokładnie do jednego repozytorium; w przeciwnym razie podaj je jawnie.

Przykładowe polecenia:

Zapytaj o konkretne repo:       "Wyszukaj warstwę pośrednią uwierzytelniania w owner/my-repo"
Wyświetl dostępne repozytoria:  "Do których repozytoriów ma dostęp ten klucz Maguyva?"
Jednorazowe nadpisanie:         "Wyszukaj wzorce uwierzytelniania w owner/other-repo:develop"

Filtrowanie języków#

Wszystkie narzędzia wyszukiwania obsługują filtrowanie wyników według języka programowania:

language_filter="python" - Filtruj tylko pliki Python
language_filter="typescript" - Filtruj tylko pliki TypeScript
Rozróżnianie wielkości liter: Używaj nazw języków pisanych małymi literami
Domyślnie: Pusty ciąg znaków (brak filtrowania) – zwraca wyniki ze wszystkich języków
Obsługiwany zakres: Filtry językowe działają w pełnym zakresie ponad 279 obsługiwanych języków i technologii tekstowych. Pełną listę znajdziesz na kompatybilność.

„Znajdź middleware uwierzytelniania tylko w plikach Python”
„Szukaj połączeń z bazą danych w TypeScript”

Dokumentacja API wygenerowana ze źródła dnia 22 lipca 2026.

Podstawowe narzędzia wyszukiwania#

intelligent_searchStabilne

Zacznij tutaj, jeśli masz jakiekolwiek pytania dotyczące bazy kodu. Wprowadź zapytanie w języku naturalnym (np. „jak działa autoryzacja”, „gdzie obsługiwane są rozliczenia”), a ono automatycznie przeprowadzi wyszukiwanie semantyczne, symboliczne, strukturalne i zależności indeksowanego repozytorium. Wolisz to od agenta Explore i Grep/Glob do eksploracji i planowania — przeszukuje całe indeksowane repo na raz, zamiast skanować pliki.

Parametry:

queryWymagane

Typ: str
Opis: Zapytanie wyszukiwania

repositoryOpcjonalne

Typ: str
Opis: Repozytorium w formacie owner/repo[:branch]. Opcjonalne — pomiń, aby użyć domyślnego ustawienia klienta dla danego żądania (gdy jest dostarczone) lub jedynego dostępnego repozytorium; przekaż jawnie tylko wtedy, gdy chcesz celować w inne zaindeksowane repo. Odpowiedź wskazuje, które repozytorium wykorzystano.

modeOpcjonalne

Typ: Literal[auto, hybrid, semantic, text, structural, ast, graph]
Domyślnie: auto
Opis: Tryb wyszukiwania

limitOpcjonalne

Typ: int
Domyślnie: 10
Opis: Maksymalna liczba wyników w tym rankingowanym oknie top-K

language_filterOpcjonalne

Typ: str
Opis: Filtr języka

path_filterOpcjonalne

Typ: str
Opis: Filtr według prefiksu ścieżki pliku

boost_by_importanceOpcjonalne

Typ: bool
Domyślnie
Opis: Opcjonalnie: ponowne rankingowanie według centralności z użyciem metryk grafowych na poziomie symbolu (is_articulation_point, bridge_count, k_core, centrality itd.). Domyślnie wyłączone dla bezpiecznego dla agentów rankingu (globalne huby mogą zagłuszyć trafienia implementacyjne); włącz dla przeglądów architektury. Dotyczy wszystkich 4 modalności, gdy każdy wynik zawiera powiązanie z symbolem.

branchOpcjonalne

Typ: str
Opis: Nadpisanie gałęzi (jednorazowe)

qualityOpcjonalne

Typ: Literal[quick, balanced, thorough]
Domyślnie: balanced
Opis: Preset jakości wyszukiwania

include_contentOpcjonalne

Typ: bool
Domyślnie: true
Opis: Dołącz treść w wynikach

explain_routingOpcjonalne

Typ: bool
Domyślnie
Opis: Dołącz wyjaśnienie decyzji routingu

importance_weightOpcjonalne

Typ: float
Domyślnie: 0.3
Opis: Waga wzmacniania ważności (0=brak, 1=pełne)

orphansOpcjonalne

Typ: bool
Domyślnie
Opis: Dołącz symbole osierocone (bez przychodzących referencji)

include_community_contextOpcjonalne

Typ: bool
Domyślnie
Opis: Dołącz powiązane symbole z tej samej społeczności kodu dla szerszego kontekstu

community_depthOpcjonalne

Typ: int
Domyślnie: 1
Opis: Głębokość rozszerzenia kontekstu społeczności

graph_viewOpcjonalne

Typ: Literal[dependency, type, data_flow, control_flow]
Domyślnie: dependency
Opis: Widok grafu dla metryk

seed_symbol_idsOpcjonalne

Typ: list[str]
Opis: Zalążki zadań Tier-1: identyfikatory symboli kluczowe dla bieżącego zadania. Po ustawieniu ponownie klasyfikuje połączone trafienia według bliskości zaniku głębokości Approach A (dokładne dopasowanie nasion + przeskoki na krawędzi wykresu). Dodatek — pomiń w rankingu globalnym.

seed_file_pathsOpcjonalne

Typ: list[str]
Opis: Ziarenka zadań Tier-1: indeksowane ścieżki plików, które agent otworzył lub właśnie edytował. Po ustawieniu ponownie klasyfikuje połączone trafienia według bliskości ścieżki z zanikiem głębokości 1/(1+d) (ten sam plik → ten sam katalog → pobliskie pakiety). Dodatek — pomiń w rankingu globalnym.

Parametr	Typ	Wymagane	Domyślnie	Opis
`query`	`str`	Tak	-	Zapytanie wyszukiwania
`repository`	`str`	Nie	-	Repozytorium w formacie owner/repo[:branch]. Opcjonalne — pomiń, aby użyć domyślnego ustawienia klienta dla danego żądania (gdy jest dostarczone) lub jedynego dostępnego repozytorium; przekaż jawnie tylko wtedy, gdy chcesz celować w inne zaindeksowane repo. Odpowiedź wskazuje, które repozytorium wykorzystano.
`mode`	`Literal[auto, hybrid, semantic, text, structural, ast, graph]`	Nie	`auto`	Tryb wyszukiwania
`limit`	`int`	Nie	`10`	Maksymalna liczba wyników w tym rankingowanym oknie top-K
`language_filter`	`str`	Nie	-	Filtr języka
`path_filter`	`str`	Nie	-	Filtr według prefiksu ścieżki pliku
`boost_by_importance`	`bool`	Nie		Opcjonalnie: ponowne rankingowanie według centralności z użyciem metryk grafowych na poziomie symbolu (is_articulation_point, bridge_count, k_core, centrality itd.). Domyślnie wyłączone dla bezpiecznego dla agentów rankingu (globalne huby mogą zagłuszyć trafienia implementacyjne); włącz dla przeglądów architektury. Dotyczy wszystkich 4 modalności, gdy każdy wynik zawiera powiązanie z symbolem.
`branch`	`str`	Nie	-	Nadpisanie gałęzi (jednorazowe)
`quality`	`Literal[quick, balanced, thorough]`	Nie	`balanced`	Preset jakości wyszukiwania
`include_content`	`bool`	Nie	`true`	Dołącz treść w wynikach
`explain_routing`	`bool`	Nie		Dołącz wyjaśnienie decyzji routingu
`importance_weight`	`float`	Nie	`0.3`	Waga wzmacniania ważności (0=brak, 1=pełne)
`orphans`	`bool`	Nie		Dołącz symbole osierocone (bez przychodzących referencji)
`include_community_context`	`bool`	Nie		Dołącz powiązane symbole z tej samej społeczności kodu dla szerszego kontekstu
`community_depth`	`int`	Nie	`1`	Głębokość rozszerzenia kontekstu społeczności
`graph_view`	`Literal[dependency, type, data_flow, control_flow]`	Nie	`dependency`	Widok grafu dla metryk
`seed_symbol_ids`	`list[str]`	Nie	-	Zalążki zadań Tier-1: identyfikatory symboli kluczowe dla bieżącego zadania. Po ustawieniu ponownie klasyfikuje połączone trafienia według bliskości zaniku głębokości Approach A (dokładne dopasowanie nasion + przeskoki na krawędzi wykresu). Dodatek — pomiń w rankingu globalnym.
`seed_file_paths`	`list[str]`	Nie	-	Ziarenka zadań Tier-1: indeksowane ścieżki plików, które agent otworzył lub właśnie edytował. Po ustawieniu ponownie klasyfikuje połączone trafienia według bliskości ścieżki z zanikiem głębokości 1/(1+d) (ten sam plik → ten sam katalog → pobliskie pakiety). Dodatek — pomiń w rankingu globalnym.

Najlepsze do:

Eksploracja całego indeksu lub start od zera, gdy nie wiadomo, które narzędzie wybrać
Wielomodalne, połączone rankingowanie w wynikach semantycznych, tekstowych, strukturalnych i grafowych

Niezalecane do:

Znana nazwa symbolu — użyj bezpośrednio find_symbol
Znana ścieżka na dysku — najpierw użyj lokalnego Read/Grep

semantic_searchStabilne

Znajdź kod według znaczenia, a nie dokładnego tekstu. Używaj w przypadku zapytań koncepcyjnych, takich jak „logika ponawiania prób” lub „przepływ dołączania użytkownika”, gdy nie znasz słowa kluczowego lub nazwy symbolu. Zwraca najbardziej odpowiednie fragmenty kodu uszeregowane według ważności. Preferuj zamiast Grepa, gdy wyszukiwanie ma charakter koncepcyjny.

Parametry:

queryWymagane

Typ: str
Opis: Zapytanie wyszukiwania (koncepcyjne, oparte na znaczeniu)

repositoryOpcjonalne

Typ: str
Opis: Repozytorium w formacie owner/repo[:branch]. Opcjonalne — pomiń, aby użyć domyślnego ustawienia klienta dla danego żądania (gdy jest dostarczone) lub jedynego dostępnego repozytorium; przekaż jawnie tylko wtedy, gdy chcesz celować w inne zaindeksowane repo. Odpowiedź wskazuje, które repozytorium wykorzystano.

limitOpcjonalne

Typ: int
Domyślnie: 5
Opis: Maksymalna liczba wyników w tym rankingowanym oknie top-K

similarity_thresholdOpcjonalne

Typ: float
Domyślnie: 0.6
Opis: Minimalny wynik podobieństwa

language_filterOpcjonalne

Typ: str
Opis: Filtr języka (python, typescript itp.)

path_filterOpcjonalne

Typ: str
Opis: Filtr według prefiksu ścieżki pliku

boost_by_importanceOpcjonalne

Typ: bool
Domyślnie
Opis: Opcjonalnie: ponowne rankingowanie według centralności PageRank (domyślnie wyłączone dla bezpiecznego dla agentów rankingu; włącz dla przeglądów architektury)

branchOpcjonalne

Typ: str
Opis: Nadpisanie gałęzi (domyślnie: z parametru repository lub main)

include_contentOpcjonalne

Typ: bool
Domyślnie: true
Opis: Dołącz zawartość fragmentu w wynikach

graph_viewOpcjonalne

Typ: Literal[dependency, type, data_flow, control_flow]
Domyślnie: dependency
Opis: Widok grafu dla metryk

Parametr	Typ	Wymagane	Domyślnie	Opis
`query`	`str`	Tak	-	Zapytanie wyszukiwania (koncepcyjne, oparte na znaczeniu)
`repository`	`str`	Nie	-	Repozytorium w formacie owner/repo[:branch]. Opcjonalne — pomiń, aby użyć domyślnego ustawienia klienta dla danego żądania (gdy jest dostarczone) lub jedynego dostępnego repozytorium; przekaż jawnie tylko wtedy, gdy chcesz celować w inne zaindeksowane repo. Odpowiedź wskazuje, które repozytorium wykorzystano.
`limit`	`int`	Nie	`5`	Maksymalna liczba wyników w tym rankingowanym oknie top-K
`similarity_threshold`	`float`	Nie	`0.6`	Minimalny wynik podobieństwa
`language_filter`	`str`	Nie	-	Filtr języka (python, typescript itp.)
`path_filter`	`str`	Nie	-	Filtr według prefiksu ścieżki pliku
`boost_by_importance`	`bool`	Nie		Opcjonalnie: ponowne rankingowanie według centralności PageRank (domyślnie wyłączone dla bezpiecznego dla agentów rankingu; włącz dla przeglądów architektury)
`branch`	`str`	Nie	-	Nadpisanie gałęzi (domyślnie: z parametru repository lub main)
`include_content`	`bool`	Nie	`true`	Dołącz zawartość fragmentu w wynikach
`graph_view`	`Literal[dependency, type, data_flow, control_flow]`	Nie	`dependency`	Widok grafu dla metryk

Najlepsze do:

Zapytania koncepcyjne ("how does auth work?", "caching strategy")
Wyszukiwanie podobieństw między pakietami

Niezalecane do:

Znana nazwa symbolu — użyj zamiast tego find_symbol
Dokładne ciągi znaków lub komunikaty błędów — użyj text_pattern_search

text_pattern_searchStabilne

Przeszukuj zaindeksowaną zawartość. Tryby exact i regex grep'ują cały korpus plików/blobów; tryb fuzzy przeszukuje ograniczony korpus fragmentów semantycznych. Zakresy plików i symboli są dostępne tylko w trybie fuzzy. Użyj lokalnego Grep dla katalogu już istniejącego na dysku.

Parametry:

queryWymagane

Typ: str
Opis: Wzorzec tekstowy do wyszukania

repositoryOpcjonalne

Typ: str
Opis: Repozytorium w formacie owner/repo[:branch]. Opcjonalne — pomiń, aby użyć domyślnego ustawienia klienta dla danego żądania (gdy jest dostarczone) lub jedynego dostępnego repozytorium; przekaż jawnie tylko wtedy, gdy chcesz celować w inne zaindeksowane repo. Odpowiedź wskazuje, które repozytorium wykorzystano.

modeOpcjonalne

Typ: Literal[fuzzy, exact, regex]
Domyślnie: exact
Opis: Tryb wyszukiwania

search_scopeOpcjonalne

Typ: Literal[content, symbols, files]
Domyślnie: content
Opis: Co przeszukiwać

limitOpcjonalne

Typ: int
Domyślnie: 5
Opis: Maksymalna liczba wyników zwracanych na tej stronie

offsetOpcjonalne

Typ: int
Opis: Przestarzały offset dla zgodności wstecznej. Preferuj cursor z pagination.next_cursor.

cursorOpcjonalne

Typ: str
Opis: Nieprzezroczysty cursor z pagination.next_cursor. Przekazuj go bez zmian i zachowaj niezmienione query oraz filtry.

language_filterOpcjonalne

Typ: str
Opis: Filtr języka

path_filterOpcjonalne

Typ: str
Opis: Filtr według prefiksu ścieżki pliku

case_sensitiveOpcjonalne

Typ: bool
Domyślnie
Opis: Dopasowanie uwzględniające wielkość liter

branchOpcjonalne

Typ: str
Opis: Nadpisanie gałęzi (jednorazowe)

fuzzy_algorithmOpcjonalne

Typ: Literal[hybrid, trigram, levenshtein]
Domyślnie: hybrid
Opis: Algorytm dopasowania rozmytego

thresholdOpcjonalne

Typ: float
Domyślnie: 0.05
Opis: Minimalny próg podobieństwa dla fuzzy

semantic_fallbackOpcjonalne

Typ: bool
Domyślnie
Opis: Fallback do wyszukiwania semantycznego, jeśli brak wyników

Parametr	Typ	Wymagane	Domyślnie	Opis
`query`	`str`	Tak	-	Wzorzec tekstowy do wyszukania
`repository`	`str`	Nie	-	Repozytorium w formacie owner/repo[:branch]. Opcjonalne — pomiń, aby użyć domyślnego ustawienia klienta dla danego żądania (gdy jest dostarczone) lub jedynego dostępnego repozytorium; przekaż jawnie tylko wtedy, gdy chcesz celować w inne zaindeksowane repo. Odpowiedź wskazuje, które repozytorium wykorzystano.
`mode`	`Literal[fuzzy, exact, regex]`	Nie	`exact`	Tryb wyszukiwania
`search_scope`	`Literal[content, symbols, files]`	Nie	`content`	Co przeszukiwać
`limit`	`int`	Nie	`5`	Maksymalna liczba wyników zwracanych na tej stronie
`offset`	`int`	Nie	-	Przestarzały offset dla zgodności wstecznej. Preferuj cursor z pagination.next_cursor.
`cursor`	`str`	Nie	-	Nieprzezroczysty cursor z pagination.next_cursor. Przekazuj go bez zmian i zachowaj niezmienione query oraz filtry.
`language_filter`	`str`	Nie	-	Filtr języka
`path_filter`	`str`	Nie	-	Filtr według prefiksu ścieżki pliku
`case_sensitive`	`bool`	Nie		Dopasowanie uwzględniające wielkość liter
`branch`	`str`	Nie	-	Nadpisanie gałęzi (jednorazowe)
`fuzzy_algorithm`	`Literal[hybrid, trigram, levenshtein]`	Nie	`hybrid`	Algorytm dopasowania rozmytego
`threshold`	`float`	Nie	`0.05`	Minimalny próg podobieństwa dla fuzzy
`semantic_fallback`	`bool`	Nie		Fallback do wyszukiwania semantycznego, jeśli brak wyników

Najlepsze do:

Dokładne ciągi znaków, komunikaty błędów i wyrażenia regularne
Dopasowywanie trigramowe fuzzy dla tekstu zbliżonego

Niezalecane do:

Znana ścieżka na dysku — preferuj lokalny Grep
Zapytania koncepcyjne — użyj semantic_search

Narzędzia strukturalne i grafowe#

structural_searchStabilne

Preferuj preset=functions|classes|methods|imports|variables (lub dowolny pattern=). Wyszukuj kod według kształtu AST (nie tekstu). Filtry średniego poziomu: name_pattern, node_type, decorator, parent_child. Filtry path/ltree/call są zaawansowane — ustaw advanced=true, gdy używasz ich celowo; płaskie klucze advanced nadal są akceptowane dla wstecznej kompatybilności. Podaj co najmniej jeden selektor strukturalny.

Parametry:

repositoryOpcjonalne

Typ: str
Opis: Repozytorium w formacie owner/repo[:branch]. Opcjonalne — pomiń, aby użyć domyślnego ustawienia klienta dla danego żądania (gdy jest dostarczone) lub jedynego dostępnego repozytorium; przekaż jawnie tylko wtedy, gdy chcesz celować w inne zaindeksowane repo. Odpowiedź wskazuje, które repozytorium wykorzystano.

presetOpcjonalne

Typ: Literal[functions, classes, methods, imports, variables]
Opis: Preferowany selektor strukturalny. Rozwija się do wielojęzycznych typów węzłów AST — functions (definicje funkcji/funkcji strzałkowych/metod w różnych językach); classes (definicje klas/struktur/impl); methods (definicje metod (i function_definition dla języków bez węzła metody)); imports (instrukcje import/use/include); variables (deklaracje zmiennych variable/let/const/static). Preferuj zamiast dowolnego pattern/node_type do zapytań w stylu przeglądania.

patternOpcjonalne

Typ: str
Opis: Free-form wzorzec, gdy presety są zbyt ogólne (autodetekcja: 'def foo(' → node_type + name_pattern). Dla zapytań przeglądowych preferuj preset=.

name_patternOpcjonalne

Typ: str
Opis: Wzorzec nazwy symbolu (symbol wieloznaczny powłoki, ograniczone wyrażenie regularne POSIX lub tekst rozmyty; maks. 256 znaków)

node_typeOpcjonalne

Typ: str
Opis: Typ węzła AST (function_definition, class_definition itd.) — dla typowych kształtów preferuj preset=

decoratorOpcjonalne

Typ: str
Opis: Filtr nazwy dekoratora

base_classOpcjonalne

Typ: str
Opis: Filtr klasy bazowej

language_filterOpcjonalne

Typ: str
Opis: Filtr języka (python, typescript itp.)

limitOpcjonalne

Typ: int
Domyślnie: 20
Opis: Maksymalna liczba wyników zwracanych na tej stronie

offsetOpcjonalne

Typ: int
Opis: Przestarzały offset dla zgodności wstecznej. Preferuj cursor z pagination.next_cursor.

cursorOpcjonalne

Typ: str
Opis: Nieprzezroczysty cursor z pagination.next_cursor. Przekazuj go bez zmian i zachowaj niezmienione query oraz filtry.

path_filterOpcjonalne

Typ: str
Opis: Filtr według prefiksu ścieżki pliku

branchOpcjonalne

Typ: str
Opis: Nadpisanie gałęzi (jednorazowe)

query_typeOpcjonalne

Typ: Literal[node_type, name_pattern, parent_child]
Opis: Jawny typ zapytania

parent_typeOpcjonalne

Typ: str
Opis: Filtr typu węzła nadrzędnego AST

relationshipOpcjonalne

Typ: Literal[parent, ancestor]
Domyślnie: parent
Opis: Dla zapytań parent_child: tylko bezpośredni rodzic, lub dowolny przodek (użyj ancestor dla metod klas zagnieżdżonych w ciele klasy)

has_modifierOpcjonalne

Typ: str
Opis: Filtruj po modyfikatorze (export, async, static itp.)

advancedOpcjonalne

Typ: bool
Domyślnie
Opis: Ustaw true, jeśli celowo używasz zaawansowanych filtrów ścieżek, ltree lub wywołań (ltree_ancestor, ltree_descendant, min_depth, max_depth, field_role, definition_name, callee_text, callee_name). Domyślnie false utrzymuje interfejs agenta skupiony na ustawieniach wstępnych. Zaawansowane klucze w formacie płaskim nadal działają w celu zapewnienia kompatybilności wstecznej z ostrzeżeniem o metadanych.

callee_textOpcjonalne

Typ: str
Opis: Zaawansowane — preferuj preset=functions|classes|methods|imports|variables. Filtr tekstu callee wyrażenia wywołania. Ustaw advanced=true, gdy celowo używasz filtrów path/ltree/call.

callee_nameOpcjonalne

Typ: str
Opis: Zaawansowane — preferuj preset=functions|classes|methods|imports|variables. Filtr nazwy callee wyrażenia wywołania. Ustaw advanced=true, gdy celowo używasz filtrów path/ltree/call.

field_roleOpcjonalne

Typ: str
Opis: Zaawansowane — preferuj preset=functions|classes|methods|imports|variables. Filtr roli pola AST. Ustaw advanced=true, gdy celowo używasz filtrów path/ltree/call.

ltree_ancestorOpcjonalne

Typ: str
Opis: Zaawansowane — preferuj preset=functions|classes|methods|imports|variables. Filtr ścieżki przodka ltree AST. Ustaw advanced=true, gdy celowo używasz filtrów path/ltree/call.

ltree_descendantOpcjonalne

Typ: str
Opis: Zaawansowane — preferuj preset=functions|classes|methods|imports|variables. Filtr ścieżki potomka ltree AST. Ustaw advanced=true, gdy celowo używasz filtrów path/ltree/call.

definition_nameOpcjonalne

Typ: str
Opis: Zaawansowane — preferuj preset=functions|classes|methods|imports|variables. Filtr nazwy definicji. Ustaw advanced=true, gdy celowo używasz filtrów path/ltree/call.

min_depthOpcjonalne

Typ: int
Opis: Zaawansowane — preferuj preset=functions|classes|methods|imports|variables. Minimalna głębokość AST. Ustaw advanced=true, gdy celowo używasz filtrów path/ltree/call.

max_depthOpcjonalne

Typ: int
Opis: Zaawansowane — preferuj preset=functions|classes|methods|imports|variables. Maksymalna głębokość AST. Ustaw advanced=true, gdy celowo używasz filtrów path/ltree/call.

Parametr	Typ	Wymagane	Domyślnie	Opis
`repository`	`str`	Nie	-	Repozytorium w formacie owner/repo[:branch]. Opcjonalne — pomiń, aby użyć domyślnego ustawienia klienta dla danego żądania (gdy jest dostarczone) lub jedynego dostępnego repozytorium; przekaż jawnie tylko wtedy, gdy chcesz celować w inne zaindeksowane repo. Odpowiedź wskazuje, które repozytorium wykorzystano.
`preset`	`Literal[functions, classes, methods, imports, variables]`	Nie	-	Preferowany selektor strukturalny. Rozwija się do wielojęzycznych typów węzłów AST — functions (definicje funkcji/funkcji strzałkowych/metod w różnych językach); classes (definicje klas/struktur/impl); methods (definicje metod (i function_definition dla języków bez węzła metody)); imports (instrukcje import/use/include); variables (deklaracje zmiennych variable/let/const/static). Preferuj zamiast dowolnego pattern/node_type do zapytań w stylu przeglądania.
`pattern`	`str`	Nie	-	Free-form wzorzec, gdy presety są zbyt ogólne (autodetekcja: 'def foo(' → node_type + name_pattern). Dla zapytań przeglądowych preferuj preset=.
`name_pattern`	`str`	Nie	-	Wzorzec nazwy symbolu (symbol wieloznaczny powłoki, ograniczone wyrażenie regularne POSIX lub tekst rozmyty; maks. 256 znaków)
`node_type`	`str`	Nie	-	Typ węzła AST (function_definition, class_definition itd.) — dla typowych kształtów preferuj preset=
`decorator`	`str`	Nie	-	Filtr nazwy dekoratora
`base_class`	`str`	Nie	-	Filtr klasy bazowej
`language_filter`	`str`	Nie	-	Filtr języka (python, typescript itp.)
`limit`	`int`	Nie	`20`	Maksymalna liczba wyników zwracanych na tej stronie
`offset`	`int`	Nie	-	Przestarzały offset dla zgodności wstecznej. Preferuj cursor z pagination.next_cursor.
`cursor`	`str`	Nie	-	Nieprzezroczysty cursor z pagination.next_cursor. Przekazuj go bez zmian i zachowaj niezmienione query oraz filtry.
`path_filter`	`str`	Nie	-	Filtr według prefiksu ścieżki pliku
`branch`	`str`	Nie	-	Nadpisanie gałęzi (jednorazowe)
`query_type`	`Literal[node_type, name_pattern, parent_child]`	Nie	-	Jawny typ zapytania
`parent_type`	`str`	Nie	-	Filtr typu węzła nadrzędnego AST
`relationship`	`Literal[parent, ancestor]`	Nie	`parent`	Dla zapytań parent_child: tylko bezpośredni rodzic, lub dowolny przodek (użyj ancestor dla metod klas zagnieżdżonych w ciele klasy)
`has_modifier`	`str`	Nie	-	Filtruj po modyfikatorze (export, async, static itp.)
`advanced`	`bool`	Nie		Ustaw true, jeśli celowo używasz zaawansowanych filtrów ścieżek, ltree lub wywołań (ltree_ancestor, ltree_descendant, min_depth, max_depth, field_role, definition_name, callee_text, callee_name). Domyślnie false utrzymuje interfejs agenta skupiony na ustawieniach wstępnych. Zaawansowane klucze w formacie płaskim nadal działają w celu zapewnienia kompatybilności wstecznej z ostrzeżeniem o metadanych.
`callee_text`	`str`	Nie	-	Zaawansowane — preferuj preset=functions\|classes\|methods\|imports\|variables. Filtr tekstu callee wyrażenia wywołania. Ustaw advanced=true, gdy celowo używasz filtrów path/ltree/call.
`callee_name`	`str`	Nie	-	Zaawansowane — preferuj preset=functions\|classes\|methods\|imports\|variables. Filtr nazwy callee wyrażenia wywołania. Ustaw advanced=true, gdy celowo używasz filtrów path/ltree/call.
`field_role`	`str`	Nie	-	Zaawansowane — preferuj preset=functions\|classes\|methods\|imports\|variables. Filtr roli pola AST. Ustaw advanced=true, gdy celowo używasz filtrów path/ltree/call.
`ltree_ancestor`	`str`	Nie	-	Zaawansowane — preferuj preset=functions\|classes\|methods\|imports\|variables. Filtr ścieżki przodka ltree AST. Ustaw advanced=true, gdy celowo używasz filtrów path/ltree/call.
`ltree_descendant`	`str`	Nie	-	Zaawansowane — preferuj preset=functions\|classes\|methods\|imports\|variables. Filtr ścieżki potomka ltree AST. Ustaw advanced=true, gdy celowo używasz filtrów path/ltree/call.
`definition_name`	`str`	Nie	-	Zaawansowane — preferuj preset=functions\|classes\|methods\|imports\|variables. Filtr nazwy definicji. Ustaw advanced=true, gdy celowo używasz filtrów path/ltree/call.
`min_depth`	`int`	Nie	-	Zaawansowane — preferuj preset=functions\|classes\|methods\|imports\|variables. Minimalna głębokość AST. Ustaw advanced=true, gdy celowo używasz filtrów path/ltree/call.
`max_depth`	`int`	Nie	-	Zaawansowane — preferuj preset=functions\|classes\|methods\|imports\|variables. Maksymalna głębokość AST. Ustaw advanced=true, gdy celowo używasz filtrów path/ltree/call.

Najlepsze do:

Struktura na poziomie AST: klasy, dekoratory, presety funkcji/metod
Wyszukiwanie kodu według kształtu, a nie tekstu

Niezalecane do:

Zapytania w wolnym tekście lub koncepcyjne — użyj semantic_search lub intelligent_search

dependency_searchStabilne

Podstawowa powierzchnia blast radius / grafu. Odpowiada na „co to wywołuje?” / „co to wykorzystuje?” poprzez rzeczywisty graf wywołań/importów. Dla analizy wpływu przed edycją: analysis_type="dependents" lub analysis_type="impact" (przychodzące, domyślnie shallow dla impact), include_metrics=false domyślnie (włącz dla centrality + refactor_risk). Analiza wpływu PR/diff (P1-8): przekaż changed_paths i/lub patch (unified diff) — symbole są rozwiązywane dla każdej ścieżki i zwracany jest kompaktowy, płytki (shallow) ładunek przychodzących zależności bez konieczności podawania nazwy symbolu. Po edycji ustaw verify_after_edit=true z targets i/lub changed_paths dla kompaktowego, wielokorzeniowego ponownego zapytania o dotknięte symbole. Obsługuje też dependencies, centrality i orphans. analyze_dependencies to cienki alias dla ścieżki impact — dla nowych agentów preferuj to narzędzie.

Parametry:

repositoryOpcjonalne

Typ: str
Opis: Repozytorium w formacie owner/repo[:branch]. Opcjonalne — pomiń, aby użyć domyślnego ustawienia klienta dla danego żądania (gdy jest dostarczone) lub jedynego dostępnego repozytorium; przekaż jawnie tylko wtedy, gdy chcesz celować w inne zaindeksowane repo. Odpowiedź wskazuje, które repozytorium wykorzystano.

queryOpcjonalne

Typ: str
Opis: Nazwa symbolu lub fraza wyszukiwania

targetOpcjonalne

Typ: str
Opis: Nazwa symbolu (alias dla query)

changed_pathsOpcjonalne

Typ: list[str]
Opis: Ścieżki względne dla repozytorium dla wpływu PR/diff (domyślnie) lub, w przypadku verify_after_edit=true, weryfikują korzenie po edycji. PR/diff: rozpoznaje symbole na ścieżkę i przechadza się po płytkich, przychodzących osobach zależnych; można łączyć z patch=. Weryfikuj: rozpoznaje do 5 symboli na ścieżkę jako korzenie weryfikacji (ograniczone do dołu w trybie weryfikacji). Nie wymaga query/target dla uderzenia PR/diff.

patchOpcjonalne

Typ: str
Opis: Wpływ PR/diff: ujednolicony tekst łatki diff/git. Ścieżki są analizowane z nagłówków diff --git / --- / +++; ta sama kompaktowa droga uderzenia co changed_paths.

analysis_typeOpcjonalne

Typ: Literal[centrality, dependencies, dependents, impact, orphans]
Domyślnie: dependencies
Opis: Tryb analizy. impact = blast radius (przychodzące zależności; głębokość shallow, gdy depth nie jest podana). dependents również odpowiada na impact. Gdy ustawiono changed_paths lub patch, analiza jest wymuszona na wpływ PR/diff. centrality/orphans nie wymagają target.

depthOpcjonalne

Typ: Literal[shallow, balanced, deep]
Domyślnie: balanced
Opis: Głębokość przeszukiwania. Dla analysis_type=impact i wpływu PR/diff efektywną wartością domyślną jest shallow, chyba że jawnie ustawisz depth.

limitOpcjonalne

Typ: int
Domyślnie: 20
Opis: Maksymalna liczba wyników zwracanych na tej stronie

offsetOpcjonalne

Typ: int
Opis: Przestarzały offset dla zgodności wstecznej. Preferuj cursor z pagination.next_cursor.

cursorOpcjonalne

Typ: str
Opis: Nieprzezroczysty cursor z pagination.next_cursor. Przekazuj go bez zmian i zachowaj niezmienione query oraz filtry.

path_filterOpcjonalne

Typ: str
Opis: Ogranicza rozwiązywanie symbolu docelowego według prefiksu ścieżki pliku; zwrócone relacje grafu mogą wykraczać poza tę ścieżkę

language_filterOpcjonalne

Typ: str
Opis: Filtruje rozwiązywanie celu i wyniki przeglądania według języka

directionOpcjonalne

Typ: Literal[outgoing, incoming, both]
Opis: Kierunek przechodzenia (nadpisuje inferencję analysis_type)

relationship_typesOpcjonalne

Typ: list[str]
Opis: Filtr typów krawędzi (CALL, IMPORT, INHERITS_FROM itd.). Niepusta lista zastępuje wartości domyślne graph_view.

exclude_test_pathsOpcjonalne

Typ: bool
Domyślnie: true
Opis: Domyślnie true: wyklucza ścieżki testów, fixture'ów, kodu dostawców (vendor) i przykładów z wyników przeszukiwania i centrality. Ustaw false, aby je uwzględnić. Analiza orphan zawsze stosuje własne, bardziej rygorystyczne wykluczenia szumu.

exclude_generated_pathsOpcjonalne

Typ: bool
Domyślnie
Opis: Wyklucz wygenerowane deklaracje oraz ścieżki kompilacji, zasięgu, pamięci podręcznej, mapy źródłowej i zminimalizowanych ścieżek artefaktów z wyników przechodzenia

include_module_symbolsOpcjonalne

Typ: bool
Domyślnie
Opis: Domyślnie false wyklucza krawędzie wykresu, gdy from_name lub to_name jest syntetycznym symbolem __module__ (szum na poziomie modułu). Ustaw true tak, aby uwzględniał krawędzie na poziomie modułu w wynikach relacji zależności i zależności.

branchOpcjonalne

Typ: str
Opis: Nadpisanie gałęzi (jednorazowe)

per_hop_limitOpcjonalne

Typ: int
Opis: Maksymalna liczba relacji na jeden przeskok (1-300)

include_metricsOpcjonalne

Typ: bool
Domyślnie
Opis: Opcjonalne metryki grafowe w wierszach wyników (skompresowane z refactor_risk). Metryki są też pobierane wewnętrznie, gdy min_centrality>0, ale nie są zwracane, jeśli to nie jest ustawione na true.

metrics_detailOpcjonalne

Typ: Literal[summary, full]
Domyślnie: summary
Opis: Gdy include_metrics=true: summary (domyślnie) zwraca sygnały decyzyjne + refactor_risk; full zwraca większy, wyselekcjonowany zestaw metryk

include_edge_metadataOpcjonalne

Typ: bool
Domyślnie
Opis: Dołącz surowe metadane i wagi krawędzi (duże). Kompaktowe ładunki udarowe to wykluczają.

symbol_typesOpcjonalne

Typ: list[str]
Opis: Filtruje zwrócone symbole według rodzaju (function, class, method itd.)

exact_matchOpcjonalne

Typ: bool
Domyślnie
Opis: Wymagaj dokładnego dopasowania nazwy symbolu

find_similar_patternsOpcjonalne

Typ: bool
Domyślnie
Opis: Znajdź podobne wzorce użycia

min_centralityOpcjonalne

Typ: float
Domyślnie: 0
Opis: Minimalny wynik PageRank. Metryki są pobierane wewnętrznie do filtrowania; graph_metrics są zwracane tylko wtedy, gdy include_metrics=true.

graph_viewOpcjonalne

Typ: Literal[dependency, type, data_flow, control_flow]
Domyślnie: dependency
Opis: Widok grafu używany do wartości domyślnych relacji przeszukiwania, metryk i rankingu centrality; analiza orphan jest obliczana we wszystkich widokach

verify_after_editOpcjonalne

Typ: bool
Domyślnie
Opis: P2-7 tryb weryfikacji po edycji: ponowne zapytanie do indeksowanego wykresu wpływu dla ostatnio edytowanych symboli w jednej zwartej odpowiedzi z wieloma pierwiastkami. Wymaga targets i/lub changed_paths (lub target/query). Domyślnie płytkie przychodzące osoby na utrzymaniu; wyniki odzwierciedlają zindeksowany wykres (może opóźniać edycję na żywo). Jeśli ma wartość true, ma pierwszeństwo przed wpływem PR/diff na ten sam changed_paths.

targetsOpcjonalne

Typ: list[str]
Opis: Gdy verify_after_edit=true: nazwy symboli do ponownej weryfikacji (osoby dzwoniące/osoby pozostające na utrzymaniu). Połączone z target/query, jeśli oba są dostarczone.

Parametr	Typ	Wymagane	Domyślnie	Opis
`repository`	`str`	Nie	-	Repozytorium w formacie owner/repo[:branch]. Opcjonalne — pomiń, aby użyć domyślnego ustawienia klienta dla danego żądania (gdy jest dostarczone) lub jedynego dostępnego repozytorium; przekaż jawnie tylko wtedy, gdy chcesz celować w inne zaindeksowane repo. Odpowiedź wskazuje, które repozytorium wykorzystano.
`query`	`str`	Nie	-	Nazwa symbolu lub fraza wyszukiwania
`target`	`str`	Nie	-	Nazwa symbolu (alias dla query)
`changed_paths`	`list[str]`	Nie	-	Ścieżki względne dla repozytorium dla wpływu PR/diff (domyślnie) lub, w przypadku verify_after_edit=true, weryfikują korzenie po edycji. PR/diff: rozpoznaje symbole na ścieżkę i przechadza się po płytkich, przychodzących osobach zależnych; można łączyć z patch=. Weryfikuj: rozpoznaje do 5 symboli na ścieżkę jako korzenie weryfikacji (ograniczone do dołu w trybie weryfikacji). Nie wymaga query/target dla uderzenia PR/diff.
`patch`	`str`	Nie	-	Wpływ PR/diff: ujednolicony tekst łatki diff/git. Ścieżki są analizowane z nagłówków diff --git / --- / +++; ta sama kompaktowa droga uderzenia co changed_paths.
`analysis_type`	`Literal[centrality, dependencies, dependents, impact, orphans]`	Nie	`dependencies`	Tryb analizy. impact = blast radius (przychodzące zależności; głębokość shallow, gdy depth nie jest podana). dependents również odpowiada na impact. Gdy ustawiono changed_paths lub patch, analiza jest wymuszona na wpływ PR/diff. centrality/orphans nie wymagają target.
`depth`	`Literal[shallow, balanced, deep]`	Nie	`balanced`	Głębokość przeszukiwania. Dla analysis_type=impact i wpływu PR/diff efektywną wartością domyślną jest shallow, chyba że jawnie ustawisz depth.
`limit`	`int`	Nie	`20`	Maksymalna liczba wyników zwracanych na tej stronie
`offset`	`int`	Nie	-	Przestarzały offset dla zgodności wstecznej. Preferuj cursor z pagination.next_cursor.
`cursor`	`str`	Nie	-	Nieprzezroczysty cursor z pagination.next_cursor. Przekazuj go bez zmian i zachowaj niezmienione query oraz filtry.
`path_filter`	`str`	Nie	-	Ogranicza rozwiązywanie symbolu docelowego według prefiksu ścieżki pliku; zwrócone relacje grafu mogą wykraczać poza tę ścieżkę
`language_filter`	`str`	Nie	-	Filtruje rozwiązywanie celu i wyniki przeglądania według języka
`direction`	`Literal[outgoing, incoming, both]`	Nie	-	Kierunek przechodzenia (nadpisuje inferencję analysis_type)
`relationship_types`	`list[str]`	Nie	-	Filtr typów krawędzi (CALL, IMPORT, INHERITS_FROM itd.). Niepusta lista zastępuje wartości domyślne graph_view.
`exclude_test_paths`	`bool`	Nie	`true`	Domyślnie true: wyklucza ścieżki testów, fixture'ów, kodu dostawców (vendor) i przykładów z wyników przeszukiwania i centrality. Ustaw false, aby je uwzględnić. Analiza orphan zawsze stosuje własne, bardziej rygorystyczne wykluczenia szumu.
`exclude_generated_paths`	`bool`	Nie		Wyklucz wygenerowane deklaracje oraz ścieżki kompilacji, zasięgu, pamięci podręcznej, mapy źródłowej i zminimalizowanych ścieżek artefaktów z wyników przechodzenia
`include_module_symbols`	`bool`	Nie		Domyślnie false wyklucza krawędzie wykresu, gdy from_name lub to_name jest syntetycznym symbolem __module__ (szum na poziomie modułu). Ustaw true tak, aby uwzględniał krawędzie na poziomie modułu w wynikach relacji zależności i zależności.
`branch`	`str`	Nie	-	Nadpisanie gałęzi (jednorazowe)
`per_hop_limit`	`int`	Nie	-	Maksymalna liczba relacji na jeden przeskok (1-300)
`include_metrics`	`bool`	Nie		Opcjonalne metryki grafowe w wierszach wyników (skompresowane z refactor_risk). Metryki są też pobierane wewnętrznie, gdy min_centrality>0, ale nie są zwracane, jeśli to nie jest ustawione na true.
`metrics_detail`	`Literal[summary, full]`	Nie	`summary`	Gdy include_metrics=true: summary (domyślnie) zwraca sygnały decyzyjne + refactor_risk; full zwraca większy, wyselekcjonowany zestaw metryk
`include_edge_metadata`	`bool`	Nie		Dołącz surowe metadane i wagi krawędzi (duże). Kompaktowe ładunki udarowe to wykluczają.
`symbol_types`	`list[str]`	Nie	-	Filtruje zwrócone symbole według rodzaju (function, class, method itd.)
`exact_match`	`bool`	Nie		Wymagaj dokładnego dopasowania nazwy symbolu
`find_similar_patterns`	`bool`	Nie		Znajdź podobne wzorce użycia
`min_centrality`	`float`	Nie	`0`	Minimalny wynik PageRank. Metryki są pobierane wewnętrznie do filtrowania; graph_metrics są zwracane tylko wtedy, gdy include_metrics=true.
`graph_view`	`Literal[dependency, type, data_flow, control_flow]`	Nie	`dependency`	Widok grafu używany do wartości domyślnych relacji przeszukiwania, metryk i rankingu centrality; analiza orphan jest obliczana we wszystkich widokach
`verify_after_edit`	`bool`	Nie		P2-7 tryb weryfikacji po edycji: ponowne zapytanie do indeksowanego wykresu wpływu dla ostatnio edytowanych symboli w jednej zwartej odpowiedzi z wieloma pierwiastkami. Wymaga targets i/lub changed_paths (lub target/query). Domyślnie płytkie przychodzące osoby na utrzymaniu; wyniki odzwierciedlają zindeksowany wykres (może opóźniać edycję na żywo). Jeśli ma wartość true, ma pierwszeństwo przed wpływem PR/diff na ten sam changed_paths.
`targets`	`list[str]`	Nie	-	Gdy verify_after_edit=true: nazwy symboli do ponownej weryfikacji (osoby dzwoniące/osoby pozostające na utrzymaniu). Połączone z target/query, jeśli oba są dostarczone.

Najlepsze do:

Analiza blast radius / wpływu przed edycją współdzielonego symbolu
Wpływ PR/diff poprzez changed_paths lub patch
Weryfikacja po edycji poprzez verify_after_edit

Niezalecane do:

Proste wyszukiwania tekstu lub symboli — użyj text_pattern_search lub find_symbol

Narzędzia analizy kodu#

find_symbolStabilne

Przejdź do miejsca, gdzie funkcja, klasa lub zmienna jest zdefiniowana i używana. Używaj, gdy znasz nazwę (np. "getCurrentUser") — szybsze i precyzyjniejsze niż Grep, obejmuje całe zaindeksowane repo. Opcjonalnie zwraca referencje i metryki ważności.

Parametry:

symbol_nameOpcjonalne

Typ: str
Opis: Nazwa symbolu do wyszukania (opcjonalne — pomiń, aby przeglądać według metryk)

repositoryOpcjonalne

Typ: str
Opis: Repozytorium w formacie owner/repo[:branch]. Opcjonalne — pomiń, aby użyć domyślnego ustawienia klienta dla danego żądania (gdy jest dostarczone) lub jedynego dostępnego repozytorium; przekaż jawnie tylko wtedy, gdy chcesz celować w inne zaindeksowane repo. Odpowiedź wskazuje, które repozytorium wykorzystano.

scopeOpcjonalne

Typ: Literal[definitions, references, both]
Domyślnie: both
Opis: Zakres wyszukiwania

limitOpcjonalne

Typ: int
Domyślnie: 15
Opis: Maksymalna liczba wyników zwracanych na tej stronie

offsetOpcjonalne

Typ: int
Opis: Przestarzały offset dla zgodności wstecznej. Preferuj cursor z pagination.next_cursor.

cursorOpcjonalne

Typ: str
Opis: Nieprzezroczysty cursor z pagination.next_cursor. Przekazuj go bez zmian i zachowaj niezmienione query oraz filtry.

find_similarOpcjonalne

Typ: bool
Domyślnie
Opis: Dołącz podobne nazwy symboli

include_metricsOpcjonalne

Typ: bool
Domyślnie
Opis: Dołącz metryki centralności

metrics_detailOpcjonalne

Typ: Literal[summary, full]
Domyślnie: summary
Opis: Gdy include_metrics=true: summary (domyślnie) zwraca sygnały decyzyjne + refactor_risk; full zwraca większy, wyselekcjonowany zestaw metryk

path_filterOpcjonalne

Typ: str
Opis: Filtr według prefiksu ścieżki pliku

branchOpcjonalne

Typ: str
Opis: Nadpisanie gałęzi (jednorazowe)

symbol_typeOpcjonalne

Typ: Literal[function, class, variable, method, constant, module, interface, type]
Opis: Filtr typu symbolu

high_impactOpcjonalne

Typ: bool
Domyślnie
Opis: Przeglądaj architektonicznie ważne symbole (pomiń symbol_name). Domyślny tryb to popularity (górny decyl PageRank pomniejszony o użytkowe mega-huby). Ustaw high_impact_mode=risk dla punktów artykulacji / mostowych wierzchołków rozcinających (articulation/bridge cut-vertices).

high_impact_modeOpcjonalne

Typ: Literal[popularity, risk]
Domyślnie: popularity
Opis: Gdy high_impact=true: popularność = najwyższy decyl PageRank minus megakoncentratory/moduły użyteczności publicznej; ryzyko = punkty artykulacji uszeregowane według SMV bridge_count, a następnie k_core (ryzyko refaktoryzacji strukturalnej, a nie popularność centrum)

in_cycleOpcjonalne

Typ: bool
Domyślnie
Opis: Filtruj tylko symbole będące w cyklach zależności

exclude_test_pathsOpcjonalne

Typ: bool
Domyślnie: true
Opis: Przeglądając dane wykresu, przed rankingiem wyklucz testy, fixtures, kod strony trzeciej i przykłady. Wyszukiwanie według nazwanego symbolu pozostaje niezmienione.

Parametr	Typ	Wymagane	Domyślnie	Opis
`symbol_name`	`str`	Nie	-	Nazwa symbolu do wyszukania (opcjonalne — pomiń, aby przeglądać według metryk)
`repository`	`str`	Nie	-	Repozytorium w formacie owner/repo[:branch]. Opcjonalne — pomiń, aby użyć domyślnego ustawienia klienta dla danego żądania (gdy jest dostarczone) lub jedynego dostępnego repozytorium; przekaż jawnie tylko wtedy, gdy chcesz celować w inne zaindeksowane repo. Odpowiedź wskazuje, które repozytorium wykorzystano.
`scope`	`Literal[definitions, references, both]`	Nie	`both`	Zakres wyszukiwania
`limit`	`int`	Nie	`15`	Maksymalna liczba wyników zwracanych na tej stronie
`offset`	`int`	Nie	-	Przestarzały offset dla zgodności wstecznej. Preferuj cursor z pagination.next_cursor.
`cursor`	`str`	Nie	-	Nieprzezroczysty cursor z pagination.next_cursor. Przekazuj go bez zmian i zachowaj niezmienione query oraz filtry.
`find_similar`	`bool`	Nie		Dołącz podobne nazwy symboli
`include_metrics`	`bool`	Nie		Dołącz metryki centralności
`metrics_detail`	`Literal[summary, full]`	Nie	`summary`	Gdy include_metrics=true: summary (domyślnie) zwraca sygnały decyzyjne + refactor_risk; full zwraca większy, wyselekcjonowany zestaw metryk
`path_filter`	`str`	Nie	-	Filtr według prefiksu ścieżki pliku
`branch`	`str`	Nie	-	Nadpisanie gałęzi (jednorazowe)
`symbol_type`	`Literal[function, class, variable, method, constant, module, interface, type]`	Nie	-	Filtr typu symbolu
`high_impact`	`bool`	Nie		Przeglądaj architektonicznie ważne symbole (pomiń symbol_name). Domyślny tryb to popularity (górny decyl PageRank pomniejszony o użytkowe mega-huby). Ustaw high_impact_mode=risk dla punktów artykulacji / mostowych wierzchołków rozcinających (articulation/bridge cut-vertices).
`high_impact_mode`	`Literal[popularity, risk]`	Nie	`popularity`	Gdy high_impact=true: popularność = najwyższy decyl PageRank minus megakoncentratory/moduły użyteczności publicznej; ryzyko = punkty artykulacji uszeregowane według SMV bridge_count, a następnie k_core (ryzyko refaktoryzacji strukturalnej, a nie popularność centrum)
`in_cycle`	`bool`	Nie		Filtruj tylko symbole będące w cyklach zależności
`exclude_test_paths`	`bool`	Nie	`true`	Przeglądając dane wykresu, przed rankingiem wyklucz testy, fixtures, kod strony trzeciej i przykłady. Wyszukiwanie według nazwanego symbolu pozostaje niezmienione.

Najlepsze do:

Przypięcie definicji, referencji i metryk grafowych znanego symbolu
Przeglądanie według centrality, high_impact lub in_cycle, gdy symbol_name jest pominięty

Niezalecane do:

Zapytania koncepcyjne lub dotyczące nieznanego obszaru — użyj intelligent_search lub semantic_search

analyze_dependenciesStabilne

Alias dla blast radius poprzez dependency_search (dependents/incoming). Dla nowych agentów preferuj dependency_search z analysis_type="dependents" lub "impact". Zachowuje starszy, wieloskokowy kształt odpowiedzi impact (graph, connection_summary, opcjonalne metryki z refactor_risk). Użyj graph_view, aby określić zakres rodziny relacji: dependency (domyślnie), type, data_flow, control_flow.

Parametry:

repositoryOpcjonalne

Typ: str
Opis: Repozytorium w formacie owner/repo[:branch]. Opcjonalne — pomiń, aby użyć domyślnego ustawienia klienta dla danego żądania (gdy jest dostarczone) lub jedynego dostępnego repozytorium; przekaż jawnie tylko wtedy, gdy chcesz celować w inne zaindeksowane repo. Odpowiedź wskazuje, które repozytorium wykorzystano.

targetWymagane

Typ: str
Opis: Nazwa symbolu do analizy

depthOpcjonalne

Typ: Literal[shallow, balanced, deep]
Domyślnie: balanced
Opis: Głębokość analizy

limitOpcjonalne

Typ: int
Domyślnie: 10
Opis: Maksymalna liczba wyników zwracanych na tej stronie

offsetOpcjonalne

Typ: int
Opis: Przestarzały offset dla zgodności wstecznej. Preferuj cursor z pagination.next_cursor.

cursorOpcjonalne

Typ: str
Opis: Nieprzezroczysty cursor z pagination.next_cursor. Przekazuj go bez zmian i zachowaj niezmienione query oraz filtry.

directionOpcjonalne

Typ: Literal[incoming, outgoing, both]
Domyślnie: incoming
Opis: Kierunek przechodzenia

relationship_typesOpcjonalne

Typ: list[str]
Opis: Filtr typów krawędzi (CALL, IMPORT, INHERITS_FROM itp.). Zawsze nadpisuje domyślny wybór z graph_view, jeśli jest dostarczone.

graph_viewOpcjonalne

Typ: Literal[dependency, type, data_flow, control_flow]
Domyślnie: dependency
Opis: Widok grafu: określa domyślne typy krawędzi do przeszukiwania oraz które metryki widoku są używane przy include_metrics=true. dependency=[CALL,IMPORT,EXPORTS,REFERENCE,INSTANTIATES] (domyślnie), type=[INHERITS_FROM,IMPLEMENTS,OVERRIDE,DECORATES,OF_TYPE], data_flow=[READS,WRITES,ASSIGNS_TO], control_flow=[CONTROL_FLOW,THROWS,CATCHES]. Stosowane tylko jako domyślne relationship_types, gdy relationship_types nie jest jawnie dostarczone. Nazwa parametru zgodna z dependency_search dla spójności między narzędziami.

path_filterOpcjonalne

Typ: str
Opis: Ogranicza rozwiązywanie symbolu docelowego według prefiksu ścieżki pliku; zwrócone relacje grafu mogą wykraczać poza tę ścieżkę

language_filterOpcjonalne

Typ: str
Opis: Filtr języka

branchOpcjonalne

Typ: str
Opis: Nadpisanie gałęzi (jednorazowe)

per_hop_limitOpcjonalne

Typ: int
Opis: Maksymalna liczba relacji na jeden przeskok (1-300)

include_metricsOpcjonalne

Typ: bool
Domyślnie
Opis: Uwzględnij metryki wykresu w wynikach, każdy wzbogacony o pochodny blok refactor_risk ({risk: "low"|"medium"|"high", is_articulation_point, bridge_count, k_core, graph_view, reasons}). risk to "low", gdy nie jest to punkt przegubowy (w wybranym widoku), "medium", gdy punkt przegubowy łączy kilka krawędzi, "high", gdy łączy wiele (próg heurystyczny, niepotwierdzony empirycznie). Pomijany dla poszczególnych symboli, jeśli dla tego symbolu/widoku nie istnieje żaden wiersz metryk.

metrics_detailOpcjonalne

Typ: Literal[summary, full]
Domyślnie: summary
Opis: Gdy include_metrics=true: summary (domyślnie) zwraca sygnały decyzyjne + refactor_risk; full zwraca większy, wyselekcjonowany zestaw metryk

include_edge_metadataOpcjonalne

Typ: bool
Domyślnie
Opis: Uwzględnij surowe metadane i wagi krawędzi. Domyślnie wyłączone, ponieważ metadane ekstraktora mogą być duże; Pokrycie wzbogacenia jest raportowane, gdy jest włączone.

exclude_test_pathsOpcjonalne

Typ: bool
Domyślnie: true
Opis: Domyślnie true: wyklucza ścieżki testowe, osprzętowe, dostawców i przykładowe ze zwróconych krawędzi wykresu. Ustaw false, aby je uwzględnić.

include_module_symbolsOpcjonalne

Typ: bool
Domyślnie
Opis: Domyślnie false wyklucza krawędzie wykresu, gdy from_name lub to_name jest syntetycznym symbolem __module__. Ustaw true tak, aby zawierał krawędzie na poziomie modułu.

Parametr	Typ	Wymagane	Domyślnie	Opis
`repository`	`str`	Nie	-	Repozytorium w formacie owner/repo[:branch]. Opcjonalne — pomiń, aby użyć domyślnego ustawienia klienta dla danego żądania (gdy jest dostarczone) lub jedynego dostępnego repozytorium; przekaż jawnie tylko wtedy, gdy chcesz celować w inne zaindeksowane repo. Odpowiedź wskazuje, które repozytorium wykorzystano.
`target`	`str`	Tak	-	Nazwa symbolu do analizy
`depth`	`Literal[shallow, balanced, deep]`	Nie	`balanced`	Głębokość analizy
`limit`	`int`	Nie	`10`	Maksymalna liczba wyników zwracanych na tej stronie
`offset`	`int`	Nie	-	Przestarzały offset dla zgodności wstecznej. Preferuj cursor z pagination.next_cursor.
`cursor`	`str`	Nie	-	Nieprzezroczysty cursor z pagination.next_cursor. Przekazuj go bez zmian i zachowaj niezmienione query oraz filtry.
`direction`	`Literal[incoming, outgoing, both]`	Nie	`incoming`	Kierunek przechodzenia
`relationship_types`	`list[str]`	Nie	-	Filtr typów krawędzi (CALL, IMPORT, INHERITS_FROM itp.). Zawsze nadpisuje domyślny wybór z graph_view, jeśli jest dostarczone.
`graph_view`	`Literal[dependency, type, data_flow, control_flow]`	Nie	`dependency`	Widok grafu: określa domyślne typy krawędzi do przeszukiwania oraz które metryki widoku są używane przy include_metrics=true. dependency=[CALL,IMPORT,EXPORTS,REFERENCE,INSTANTIATES] (domyślnie), type=[INHERITS_FROM,IMPLEMENTS,OVERRIDE,DECORATES,OF_TYPE], data_flow=[READS,WRITES,ASSIGNS_TO], control_flow=[CONTROL_FLOW,THROWS,CATCHES]. Stosowane tylko jako domyślne relationship_types, gdy relationship_types nie jest jawnie dostarczone. Nazwa parametru zgodna z dependency_search dla spójności między narzędziami.
`path_filter`	`str`	Nie	-	Ogranicza rozwiązywanie symbolu docelowego według prefiksu ścieżki pliku; zwrócone relacje grafu mogą wykraczać poza tę ścieżkę
`language_filter`	`str`	Nie	-	Filtr języka
`branch`	`str`	Nie	-	Nadpisanie gałęzi (jednorazowe)
`per_hop_limit`	`int`	Nie	-	Maksymalna liczba relacji na jeden przeskok (1-300)
`include_metrics`	`bool`	Nie		Uwzględnij metryki wykresu w wynikach, każdy wzbogacony o pochodny blok refactor_risk ({risk: "low"\|"medium"\|"high", is_articulation_point, bridge_count, k_core, graph_view, reasons}). risk to "low", gdy nie jest to punkt przegubowy (w wybranym widoku), "medium", gdy punkt przegubowy łączy kilka krawędzi, "high", gdy łączy wiele (próg heurystyczny, niepotwierdzony empirycznie). Pomijany dla poszczególnych symboli, jeśli dla tego symbolu/widoku nie istnieje żaden wiersz metryk.
`metrics_detail`	`Literal[summary, full]`	Nie	`summary`	Gdy include_metrics=true: summary (domyślnie) zwraca sygnały decyzyjne + refactor_risk; full zwraca większy, wyselekcjonowany zestaw metryk
`include_edge_metadata`	`bool`	Nie		Uwzględnij surowe metadane i wagi krawędzi. Domyślnie wyłączone, ponieważ metadane ekstraktora mogą być duże; Pokrycie wzbogacenia jest raportowane, gdy jest włączone.
`exclude_test_paths`	`bool`	Nie	`true`	Domyślnie true: wyklucza ścieżki testowe, osprzętowe, dostawców i przykładowe ze zwróconych krawędzi wykresu. Ustaw false, aby je uwzględnić.
`include_module_symbols`	`bool`	Nie		Domyślnie false wyklucza krawędzie wykresu, gdy from_name lub to_name jest syntetycznym symbolem __module__. Ustaw true tak, aby zawierał krawędzie na poziomie modułu.

Najlepsze do:

Starsze wywołania już dostosowane do jego kształtu odpowiedzi (graph, connection_summary)

Niezalecane do:

Nowe pętle agentów — preferuj dependency_search, które współdzieli ten sam rdzeń przechodzenia grafu

get_task_contextStabilne

Zaczynasz pracę w nieznanym obszarze? Opisz zadanie (np. „dodaj obsługę SSO”, „napraw webhook billingowy”) i otrzymaj ograniczony pakiet odpowiednich plików, kodu, symboli i zależności w jednym wywołaniu. Pliki seed dostarczają bezpośrednią zaindeksowaną treść, nawet jeśli nie definiują żadnych symboli. Aby uzyskać więcej wyników, kontynuuj wyspecjalizowanym narzędziem wyszukiwania dla danej warstwy.

Parametry:

task_descriptionWymagane

Typ: str
Opis: Opis zadania, dla którego potrzebujesz kontekstu

repositoryOpcjonalne

Typ: str
Opis: Repozytorium w formacie owner/repo[:branch]. Opcjonalne — pomiń, aby użyć domyślnego ustawienia klienta dla danego żądania (gdy jest dostarczone) lub jedynego dostępnego repozytorium; przekaż jawnie tylko wtedy, gdy chcesz celować w inne zaindeksowane repo. Odpowiedź wskazuje, które repozytorium wykorzystano.

limitOpcjonalne

Typ: int
Domyślnie: 15
Opis: Maksymalna liczba elementów kontekstu na warstwę

scopeOpcjonalne

Typ: Literal[semantic, symbols, dependencies, all]
Domyślnie: all
Opis: Które warstwy kontekstu uwzględnić

language_filterOpcjonalne

Typ: str
Opis: Filtr języka

path_filterOpcjonalne

Typ: str
Opis: Filtr według prefiksu ścieżki pliku

branchOpcjonalne

Typ: str
Opis: Nadpisanie gałęzi (jednorazowe)

include_related_contextOpcjonalne

Typ: bool
Domyślnie
Opis: Dołącz powiązany kontekst od sąsiednich symboli

seed_symbol_idsOpcjonalne

Typ: list[str]
Opis: Ziarna poziomu 1: identyfikatory symboli, które agent już zna jako kluczowe dla zadania (np. symbole w otwartych plikach). Są preferowane przed ziarnami pochodzącymi ze słów kluczowych. Działanie addytywne — pomiń, aby uzyskać dzisiejsze zachowanie oparte tylko na słowach kluczowych.

seed_file_pathsOpcjonalne

Typ: list[str]
Opis: Jawne seedy poziomu 1: zaindeksowane ścieżki plików, które agent ma otwarte lub właśnie edytował. Zwraca ograniczone bezpośrednie dowody plikowe i rozwiązuje do 5 symboli na plik dla kontekstu grafowego, w tym dokumentację i konfigurację bez symboli. Addytywne — pomiń dla zachowania opartego wyłącznie na słowach kluczowych.

Parametr	Typ	Wymagane	Domyślnie	Opis
`task_description`	`str`	Tak	-	Opis zadania, dla którego potrzebujesz kontekstu
`repository`	`str`	Nie	-	Repozytorium w formacie owner/repo[:branch]. Opcjonalne — pomiń, aby użyć domyślnego ustawienia klienta dla danego żądania (gdy jest dostarczone) lub jedynego dostępnego repozytorium; przekaż jawnie tylko wtedy, gdy chcesz celować w inne zaindeksowane repo. Odpowiedź wskazuje, które repozytorium wykorzystano.
`limit`	`int`	Nie	`15`	Maksymalna liczba elementów kontekstu na warstwę
`scope`	`Literal[semantic, symbols, dependencies, all]`	Nie	`all`	Które warstwy kontekstu uwzględnić
`language_filter`	`str`	Nie	-	Filtr języka
`path_filter`	`str`	Nie	-	Filtr według prefiksu ścieżki pliku
`branch`	`str`	Nie	-	Nadpisanie gałęzi (jednorazowe)
`include_related_context`	`bool`	Nie		Dołącz powiązany kontekst od sąsiednich symboli
`seed_symbol_ids`	`list[str]`	Nie	-	Ziarna poziomu 1: identyfikatory symboli, które agent już zna jako kluczowe dla zadania (np. symbole w otwartych plikach). Są preferowane przed ziarnami pochodzącymi ze słów kluczowych. Działanie addytywne — pomiń, aby uzyskać dzisiejsze zachowanie oparte tylko na słowach kluczowych.
`seed_file_paths`	`list[str]`	Nie	-	Jawne seedy poziomu 1: zaindeksowane ścieżki plików, które agent ma otwarte lub właśnie edytował. Zwraca ograniczone bezpośrednie dowody plikowe i rozwiązuje do 5 symboli na plik dla kontekstu grafowego, w tym dokumentację i konfigurację bez symboli. Addytywne — pomiń dla zachowania opartego wyłącznie na słowach kluczowych.

Najlepsze do:

Kontekst uwzględniający zadanie, łączący pliki seed z warstwami semantyczną, symboli i zależności

Niezalecane do:

Wyszukiwania jednym narzędziem, gdzie bardziej wyspecjalizowane narzędzie już odpowiada na pytanie

get_fileStabilne

Odczytuje plik z zaindeksowanego repozytorium według ścieżki. Dla plików na dysku preferuj lokalne narzędzie Read — użyj tego narzędzia do wyszukiwań międzyrepozytoryjnych lub zdalnych, gdy pliku nie ma w twoim drzewie roboczym. Obsługuje opcjonalny zakres wierszy; kontynuuj odpowiedź obciętą przez tokeny z metadata.next_line_start.

Parametry:

file_pathWymagane

Typ: str
Opis: Ścieżka pliku względem root repozytorium

repositoryOpcjonalne

Typ: str
Opis: Repozytorium w formacie owner/repo[:branch]. Opcjonalne — pomiń, aby użyć domyślnego ustawienia klienta dla danego żądania (gdy jest dostarczone) lub jedynego dostępnego repozytorium; przekaż jawnie tylko wtedy, gdy chcesz celować w inne zaindeksowane repo. Odpowiedź wskazuje, które repozytorium wykorzystano.

line_startOpcjonalne

Typ: int
Opis: Linia początkowa (indeksowana od 1)

line_endOpcjonalne

Typ: int
Opis: Wiersz końcowy (indeksowanie od 1, włącznie; musi być równy lub większy niż line_start)

branchOpcjonalne

Typ: str
Opis: Nadpisanie gałęzi (jednorazowe)

max_tokensOpcjonalne

Typ: int
Domyślnie: 5000
Opis: Maksymalna liczba tokenów do zwrócenia

include_metadataOpcjonalne

Typ: bool
Domyślnie: true
Opis: Dołącz metadane pliku w odpowiedzi

Parametr	Typ	Wymagane	Domyślnie	Opis
`file_path`	`str`	Tak	-	Ścieżka pliku względem root repozytorium
`repository`	`str`	Nie	-	Repozytorium w formacie owner/repo[:branch]. Opcjonalne — pomiń, aby użyć domyślnego ustawienia klienta dla danego żądania (gdy jest dostarczone) lub jedynego dostępnego repozytorium; przekaż jawnie tylko wtedy, gdy chcesz celować w inne zaindeksowane repo. Odpowiedź wskazuje, które repozytorium wykorzystano.
`line_start`	`int`	Nie	-	Linia początkowa (indeksowana od 1)
`line_end`	`int`	Nie	-	Wiersz końcowy (indeksowanie od 1, włącznie; musi być równy lub większy niż line_start)
`branch`	`str`	Nie	-	Nadpisanie gałęzi (jednorazowe)
`max_tokens`	`int`	Nie	`5000`	Maksymalna liczba tokenów do zwrócenia
`include_metadata`	`bool`	Nie	`true`	Dołącz metadane pliku w odpowiedzi

Najlepsze do:

Zdalne lub zaindeksowane migawki plików (zakresy wierszy, limity tokenów)

Niezalecane do:

Ścieżka już obecna na dysku lokalnym — użyj lokalnego narzędzia Read

Narzędzia systemowe i pomocnicze#

repository_contextStabilne

Wyświetla listę repozytoriów, które możesz przeszukiwać, lub pobiera informacje identyfikacyjne o jednym z nich (namespace/branch, indexed_commit_sha / aktualność indeksu). Wywołaj z action:"list" raz, aby poznać dokładny slug repozytorium akceptowany przez narzędzia wyszukiwania. (Jeśli twój klucz ma dostęp tylko do jednego repozytorium, narzędzia wyszukiwania domyślnie go używają — możesz to pominąć.) Liczniki file/blob/edge dla całej przestrzeni nazw są opcjonalne przez include_statistics=true.

Parametry:

actionWymagane

Typ: Literal[list, info]
Opis: Akcja: list — wyświetl dostępne repo lub info — pobierz informacje o repo

repositoryOpcjonalne

Typ: str
Opis: Repozytorium w formacie owner/repo lub owner/repo:branch (wymagane dla info)

branchOpcjonalne

Typ: str
Opis: Nadpisanie gałęzi (jednorazowe)

patternOpcjonalne

Typ: str
Opis: Filtr listy repozytoriów według wzorca

include_statisticsOpcjonalne

Typ: bool
Domyślnie
Opis: Opcjonalnie: dołącza liczniki zaindeksowanych danych dla całej przestrzeni nazw (file/blob/edge). Domyślnie false — identyfikacja repozytorium nie wymaga tego wolniejszego agregatu.

limitOpcjonalne

Typ: int
Domyślnie: 20
Opis: Maksymalna liczba wyników zwracanych na tej stronie

offsetOpcjonalne

Typ: int
Opis: Przestarzałe przesunięcie zgodności. Wolisz cursor od pagination.next_cursor.

cursorOpcjonalne

Typ: str
Opis: Nieprzezroczysty cursor od pagination.next_cursor. Przekaż go bez zmian, a zapytanie i filtry pozostaw niezmienione.

Parametr	Typ	Wymagane	Domyślnie	Opis
`action`	`Literal[list, info]`	Tak	-	Akcja: list — wyświetl dostępne repo lub info — pobierz informacje o repo
`repository`	`str`	Nie	-	Repozytorium w formacie owner/repo lub owner/repo:branch (wymagane dla info)
`branch`	`str`	Nie	-	Nadpisanie gałęzi (jednorazowe)
`pattern`	`str`	Nie	-	Filtr listy repozytoriów według wzorca
`include_statistics`	`bool`	Nie		Opcjonalnie: dołącza liczniki zaindeksowanych danych dla całej przestrzeni nazw (file/blob/edge). Domyślnie false — identyfikacja repozytorium nie wymaga tego wolniejszego agregatu.
`limit`	`int`	Nie	`20`	Maksymalna liczba wyników zwracanych na tej stronie
`offset`	`int`	Nie	-	Przestarzałe przesunięcie zgodności. Wolisz cursor od pagination.next_cursor.
`cursor`	`str`	Nie	-	Nieprzezroczysty cursor od pagination.next_cursor. Przekaż go bez zmian, a zapytanie i filtry pozostaw niezmienione.

Najlepsze do:

Wyświetlanie listy dostępnych repozytoriów
Ustalanie tożsamości repozytorium, gałęzi i aktualności HEAD względem indeksu

Niezalecane do:

Statystyki dla całej przestrzeni nazw domyślnie — przekaż jawnie include_statistics=true, ponieważ może to być wolniejsze niż samo rozwiązywanie

ask_maguyvaStabilne

Pomoc i opinie dotyczące Maguyva. Podstawowe: uzyskaj wskazówki dotyczące narzędzi lub prześlij zgłoszenie błędu / propozycję funkcji przechowywaną dla opiekunów Maguyva. Nigdy nie umieszczaj w opinii sekretów ani wrażliwych danych osobowych. Operacja evaluate pozostaje wyłącznie dla wstecznej kompatybilności — dla operacji matematycznych/hashowania/na ciągach preferuj obliczenia lokalne lub narzędzia hosta.

Parametry:

operationWymagane

Typ: Literal[guidance, report_bug, request_feature, evaluate]
Opis: Podstawowe: guidance, report_bug, request_feature. Tylko starsze/dla kompatybilności: evaluate (deterministyczny silnik wyrażeń; nie jest częścią podstawowego przepływu pracy agenta).

queryOpcjonalne

Typ: str
Opis: Temat wskazówek (np. tool_selection, semantic_search). Tylko dla starszej evaluate: ciąg wyrażenia.

descriptionOpcjonalne

Typ: str
Opis: Wymagane dla report_bug i request_feature. Free-form opinia dla opiekunów Maguyva. Nigdy nie umieszczaj sekretów ani wrażliwych danych osobowych.

related_toolOpcjonalne

Typ: Literal[ask_maguyva, get_file, repository_context, find_symbol, structural_search, dependency_search, analyze_dependencies, semantic_search, text_pattern_search, intelligent_search, get_task_context]
Opis: Opcjonalne narzędzie Maguyva najbardziej powiązane ze sprzężeniem zwrotnym

Parametr	Typ	Wymagane	Domyślnie	Opis
`operation`	`Literal[guidance, report_bug, request_feature, evaluate]`	Tak	-	Podstawowe: guidance, report_bug, request_feature. Tylko starsze/dla kompatybilności: evaluate (deterministyczny silnik wyrażeń; nie jest częścią podstawowego przepływu pracy agenta).
`query`	`str`	Nie	-	Temat wskazówek (np. tool_selection, semantic_search). Tylko dla starszej evaluate: ciąg wyrażenia.
`description`	`str`	Nie	-	Wymagane dla report_bug i request_feature. Free-form opinia dla opiekunów Maguyva. Nigdy nie umieszczaj sekretów ani wrażliwych danych osobowych.
`related_tool`	`Literal[ask_maguyva, get_file, repository_context, find_symbol, structural_search, dependency_search, analyze_dependencies, semantic_search, text_pattern_search, intelligent_search, get_task_context]`	Nie	-	Opcjonalne narzędzie Maguyva najbardziej powiązane ze sprzężeniem zwrotnym

Najlepsze do:

Wskazówki dotyczące narzędzia (operation="guidance")
Trwałe zgłoszenia błędów i propozycje funkcji dla opiekunów Maguyva

Niezalecane do:

Obliczenia matematyczne/hashowe/na ciągach znaków — operacja evaluate jest przeznaczona wyłącznie dla zgodności wstecznej; preferuj lokalne obliczenia hosta

Najlepsze praktyki#

Używaj jawnych nadpisań świadomie: Pomiń repozytorium, gdy twój klient MCP dostarcza domyślne ustawienie dla żądania lub gdy klucz ma dostęp dokładnie do jednego repozytorium; w przeciwnym razie przekaż je jawnie.
Wybierz właściwy tryb wyszukiwania: Używaj intelligent_search z mode="auto" w większości przypadków. Określ tryb, gdy wiesz dokładnie, czego potrzebujesz.
Wykorzystuj filtry językowe: Użyj language_filter, aby zawęzić wyniki i poprawić wydajność.
Wzmacnianie GraphRAG: Wzmacnianie ważności GraphRAG jest domyślnie wyłączone dla wyszukiwania semantycznego (boost_by_importance=false), aby ranking pozostawał bezpieczny dla agentów. Przekaż boost_by_importance=true, aby włączyć ponowne rankingowanie uwzględniające centralność do przeglądów architektury.
Dopasowanie repozytorium jest niewrażliwe na wielkość liter, ale nie rozmyte: repository_context dopasowuje nazwy repozytoriów bez rozróżniania wielkości liter — nie poprawia literówek. Sprawdź metadata.resolution_reason w akcji info ("exact" vs "corrected"), aby zobaczyć, jak rozwiązano nazwę.
Łącz narzędzia: Używaj wielu metod API razem, aby uzyskać kompleksową analizę.
Obsługuj duże wyniki: Używaj limit oraz kontrolek stronicowania specyficznych dla narzędzia (np. line_start/line_end w get_file).
Używaj ask_maguyva do wskazówek dotyczących narzędzi: Operacja evaluate w ask_maguyva (hash, base64, JSON, matematyka) jest przestarzała / zachowana tylko dla wstecznej kompatybilności. Zamiast tego wywołuj ask_maguyva z operation="guidance" i query="tool_selection", aby uzyskać macierz priorytetu narzędzi lokalnych oraz pełną ściągawkę dla każdego narzędzia.
Sprawdzaj wpływ przed edycją i po niej: Przed edycją współdzielonego symbolu wywołaj dependency_search z analysis_type="impact" (lub przekaż changed_paths dla analizy wpływu PR/diff), aby zobaczyć jego promień rażenia. Po edycji ustaw verify_after_edit=true z targets i/lub changed_paths, aby uzyskać kompaktową ponowną weryfikację tych samych symboli.

Charakterystyka wydajności#

Operacja	Uwagi dotyczące wydajności
Wyszukiwanie semantyczne	Poniżej sekundy, ale za każdym razem obejmuje osobne wywołanie API embeddingu (bez cache'owania) — spodziewaj się dodatkowego opóźnienia ponad czas zapytania wektorowego
Wyszukiwanie tekstowe	Poniżej sekundy dla wyszukiwania dokładnego/regex; rozmyte wyszukiwanie treści paginuje po stronie klienta, więc głębokie przesunięcia kosztują więcej — zawężaj za pomocą path_filter/language_filter
Wyszukiwanie strukturalne	Indeksowane przez AST — koszt skaluje się wraz z liczbą wyników, nie z rozmiarem repozytorium
Wyszukiwanie zależności	Koszt skaluje się wraz z głębokością — preferuj depth="shallow", chyba że potrzebujesz kontekstu wieloetapowego; per_hop_limit ogranicza rozrost
Pobieranie plików	Niemal natychmiastowe dla pojedynczego pliku — duże pliki stronicuj za pomocą line_start/line_end lub max_tokens zamiast jednego dużego pobrania
Kontekst repozytorium	Rozwiązywanie przestrzeni nazw jest buforowane tylko w ramach jednego żądania, nie między wywołaniami — każde wywołanie narzędzia rozwiązuje je od nowa
ask_maguyva (guidance / evaluate)	Niemal natychmiastowe — działa wewnątrz Workera bez wywołania bazy danych

Obsługa błędów#

Wszystkie metody API zwracają ustrukturyzowaną kopertę odpowiedzi:

status: String — "success" lub "error". Sygnały częściowego dopasowania i nieaktualności danych znajdują się w polach zagnieżdżonych, np. metadata.resolution_reason w repository_context lub metadata.index_freshness.status.
tool: Nazwa narzędzia, które wygenerowało odpowiedź
data: Ładunek wyniku w przypadku sukcesu (struktura zależy od narzędzia)
error: Ustrukturyzowany obiekt błędu, gdy status to "error" — zawiera type, message, suggestions oraz recovery_actions
metadata: Dodatkowe informacje o operacji (routing, cache'owanie, korekty parametrów)
pagination: Obecne w odpowiedziach z listami — zawiera has_more i next_cursor

Zawsze sprawdzaj pole status przed przetwarzaniem wyników — przyjmuje ono wyłącznie wartość "success" lub "error". W przypadku sygnałów częściowego dopasowania lub nieaktualności danych odczytaj zamiast tego pole zagnieżdżone: metadata.resolution_reason w repository_context lub metadata.index_freshness.status (known/partial/unknown/unavailable).

Pierwsze kroki#

Skonfiguruj klienta MCP: Skieruj klienta MCP na endpoint serwera Maguyva
Potwierdź dostęp do repozytorium: Użyj repository_context z akcją "list" lub "info", aby sprawdzić repozytoria dostępne dla klucza API
Rozpocznij wyszukiwanie: Zacznij od intelligent_search i w razie potrzeby korzystaj ze specjalizowanych narzędzi
Łącz narzędzia: Używaj wielu narzędzi razem dla kompleksowej analizy kodu

Szczegółowe instrukcje integracji znajdziesz w przewodnik instalacji.