Přeskočit na obsah

Referenční příručka MCP API

Prozkoumejte 11 MCP nástrojů Maguyva, jejich parametry a vhodné použití. Dostupné argumenty ověřte v odpovědi tools/list připojeného klienta.

Přehled API

#

Nástroje jsou rozděleny do 4 kategorií:

  • Základní vyhledávací nástroje - Pokročilé vyhledávací možnosti napříč vaší kódovou základnou
  • Strukturální a grafové nástroje - AST dotazy, vyhledávání symbolů a analýza závislostí
  • Nástroje pro analýzu kódu - Hloubková analýza kódu a mapování vztahů
  • Systémové a pomocné nástroje - Kontext repozitáře, nápověda k nástrojům a zpětná vazba

U nástrojů přijímajících repozitář použijte tento formát identifikátoru repozitáře: "owner/repo:branch". Není-li větev uvedena, výchozí je main.

repository vynechte, pokud klient MCP poskytuje výchozí hodnotu pro daný požadavek nebo pokud má klíč přístup právě k jednomu repozitáři; jinak jej zadejte explicitně. Pomocí repository_context(action="info", repository="owner/repo") zjistíte, jak se repozitář vyhodnotí.

Formát parametru repozitáře

#

Při zadávání repozitáře použijte tyto formáty:

  • S větví: "owner/repo:branch" - např., "owner/repository:develop"
  • Výchozí větev: "owner/repo" - používá větev main, když není zadána žádná větev "owner/repository"
  • Výchozí repozitář požadavku nebo jediný repozitář: Repozitář vynechte, pokud klient MCP poskytuje výchozí hodnotu pro daný požadavek nebo pokud má klíč přístup právě k jednomu repozitáři; jinak jej zadejte explicitně

Příklady dotazů:

Zeptejte se na konkrétní repo:  "Najdi autentizační middleware v owner/my-repo"
Seznam přístupných úložišť:     "K jakým úložištím může tento klíč Maguyva přistupovat?"
Přepsat pro jeden dotaz:        "Vyhledej vzory autentizace v owner/other-repo:develop"

Filtrování podle jazyka

#

Použijte language_filter v podporovaných režimech vyhledávání. Pro text_pattern_search zvolte search_scope="content"; pro get_task_context použijte scope="semantic" bez výchozích bodů nebo souvisejícího kontextu.

  • language_filter="python" - Filtrovat pouze soubory Python
  • language_filter="typescript" - Filtrovat pouze soubory TypeScript
  • Rozlišuje velikost písmen: Používejte názvy jazyků malými písmeny
  • Výchozí: Prázdný řetězec (bez filtrování) – vrátí výsledky ze všech jazyků
  • Podporované pokrytí: Jazykové filtry fungují pro všech 285+ podporovaných jazyků a textových technologií. Úplný seznam najdete na stránce kompatibility. 
"Najdi autentizační middleware pouze v souborech Python"
"Vyhledej databázová připojení v TypeScript"

Referenční příručka API vygenerována ze zdroje dne 21. října 2026.

Základní vyhledávací nástroje

#

intelligent_search Stabilní

Zde začněte s jakoukoli otázkou o kódové základně. Výchozí auto/balanced směruje dotazy, u nichž s vysokou jistotou rozpozná hledání definice, na strukturální vyhledávání, dotazy na reference nebo dopady do grafu a dotazy na přesnou shodu na textové vyhledávání. Ostatní dotazy využívají sémantický význam a indexovaný text. Pomocí mode=hybrid nebo auto s quality=thorough požádejte o všechny čtyři modality vyhledávání. Výslovně zvolený režim má přednost před nastavením quality. language_filter vynechá graf v auto/hybrid a s výslovně zadaným mode=graph je odmítnut. Pokud ještě neznáte cestu, dejte tomuto nástroji přednost před Grep/Glob.

Parametry:

query Povinné
Typ
str minLength=1
Popis
Vyhledávací dotaz
repository Volitelné
Typ
str
Popis
Repozitář ve formátu owner/repo[:branch]. Volitelné — vynechte jej, chcete-li použít výchozí repozitář klienta pro daný požadavek (pokud je poskytnut) nebo jediný přístupný repozitář; explicitně jej zadejte pouze pro jiný indexovaný repozitář. Preferovány jsou přesně indexované větve; nedostupná větev se může vrátit k main nebo k jediné přístupné větvi. Metadata odpovědi zobrazují požadovanou a skutečně použitou identitu a v takovém případě varují.
mode Volitelné
Typ
Literal[auto, hybrid, semantic, text, structural, ast, graph]
Výchozí
auto
Popis
Režim vyhledávání
limit Volitelné
Typ
int minimum=1, maximum=50
Výchozí
10
Popis
Maximální počet výsledků v tomto seřazeném okně top-K
language_filter Volitelné
Typ
str
Popis
Filtr jazyka
path_filter Volitelné
Typ
str
Popis
Filtruje kandidáty vyhledávání podle prefixu cesty k souboru. Sousední uzly grafu a připojený kontext komunity mohou zahrnovat soubory mimo tento prefix.
boost_by_importance Volitelné
Typ
bool
Výchozí
false
Popis
Volitelné: přeřazení podle centrality pomocí grafových metrik na úrovni symbolu (is_articulation_point, bridge_count, k_core, centrality atd.). Ve výchozím nastavení vypnuto pro řazení bezpečné pro agenty (globální huby mohou přehlušit relevantní zásahy v implementaci); zapněte pro architektonické prohlídky. Platí pro všechny 4 modality, pokud každý výsledek nese vazbu na symbol.
branch Volitelné
Typ
str
Popis
Přepsání větve
quality Volitelné
Typ
Literal[quick, balanced, thorough]
Výchozí
balanced
Popis
Předvolba kvality vyhledávání
include_content Volitelné
Typ
bool
Výchozí
true
Popis
Zahrnout obsah do výsledků
explain_routing Volitelné
Typ
bool
Výchozí
false
Popis
Zahrňte vysvětlení rozhodnutí o směrování
importance_weight Volitelné
Typ
float minimum=0, maximum=1
Výchozí
0.3
Popis
Váha pro zvýšení důležitosti (0=žádná, 1=plná)
orphans Volitelné
Typ
bool
Výchozí
false
Popis
Zahrnout osiřelé symboly (bez příchozích referencí)
include_community_context Volitelné
Typ
bool
Výchozí
false
Popis
Zahrnout související symboly ze stejného shluku kódu v grafu
community_depth Volitelné
Typ
int minimum=1, maximum=3
Výchozí
1
Popis
Hloubka rozšíření kontextu z grafové komunity
graph_view Volitelné
Typ
Literal[dependency, type, data_flow, control_flow]
Výchozí
dependency
Popis
Zobrazení grafu pro metriky
seed_symbol_ids Volitelné
Typ
list[str] maxItems=20
Popis
Výchozí body úlohy Tier-1: ID symbolů zásadních pro aktuální úlohu. Pokud jsou zadány, sloučené výsledky se znovu seřadí podle blízkosti s klesající vahou podle hloubky metodou Approach A (přesná shoda výchozího bodu + kroky po hranách grafu). Jde o doplněk — pro globální řazení vynechte.
seed_file_paths Volitelné
Typ
list[str] maxItems=10
Popis
Výchozí body úlohy Tier-1: cesty k indexovaným souborům, které má agent otevřené nebo je právě upravil. Pokud jsou zadány, sloučené výsledky se znovu seřadí podle blízkosti cest s vahou 1/(1+d), která klesá s hloubkou (stejný soubor → stejný adresář → blízké balíčky). Jde o doplněk — pro globální řazení vynechte.

Nejlepší pro:

  • Prohledávání celého indexu nebo start od nuly, když není jasné, který nástroj použít
  • Multimodální sloučené řazení napříč sémantickým, textovým, strukturálním a grafovým vyhledáváním

Nedoporučeno pro:

  • Známý název symbolu — použijte přímo find_symbol
  • Známá cesta na disku — nejprve použijte lokální Read/Grep

semantic_search Stabilní

Hledejte kód podle významu, ne přesného textu. Hodí se pro pojmové dotazy jako „logika opakovaných pokusů“ či „úvodní postup pro uživatele“, když neznáte klíčové slovo ani název symbolu. Vrací relevantní úryvky s omezenou rozmanitostí souborů; přerovnání podle důležitosti v grafu se volitelně zapíná pomocí boost_by_importance. Pro pojmové hledání jej upřednostněte před Grep.

Parametry:

query Povinné
Typ
str minLength=1
Popis
vyhledávací dotaz (pojmový, založený na významu)
repository Volitelné
Typ
str
Popis
Repozitář ve formátu owner/repo[:branch]. Volitelné — vynechte jej, chcete-li použít výchozí repozitář klienta pro daný požadavek (pokud je poskytnut) nebo jediný přístupný repozitář; explicitně jej zadejte pouze pro jiný indexovaný repozitář. Preferovány jsou přesně indexované větve; nedostupná větev se může vrátit k main nebo k jediné přístupné větvi. Metadata odpovědi zobrazují požadovanou a skutečně použitou identitu a v takovém případě varují.
limit Volitelné
Typ
int minimum=1, maximum=50
Výchozí
5
Popis
Maximální počet výsledků v tomto seřazeném okně top-K
similarity_threshold Volitelné
Typ
float minimum=0, maximum=1
Výchozí
0.6
Popis
Minimální skóre podobnosti
language_filter Volitelné
Typ
str
Popis
Jazykový filtr (python, typescript atd.)
path_filter Volitelné
Typ
str
Popis
Filtrujte podle předpony cesty k souboru
boost_by_importance Volitelné
Typ
bool
Výchozí
false
Popis
Volitelné: přerovnání podle normalizované důležitosti každého symbolu v grafu (výchozí stav vypnuto; nejvýše 1,5násobek podobnosti).
branch Volitelné
Typ
str
Popis
Přepsání větve (výchozí: z parametru repository nebo main)
include_content Volitelné
Typ
bool
Výchozí
true
Popis
Zahrnout blokový obsah do výsledků
graph_view Volitelné
Typ
Literal[dependency, type, data_flow, control_flow]
Výchozí
dependency
Popis
Zobrazení grafu pro metriky

Nejlepší pro:

  • Koncepční dotazy ("jak funguje autentizace?", "strategie cachování")
  • Vyhledávání podobnosti napříč balíčky

Nedoporučeno pro:

  • Známý název symbolu — použijte místo toho find_symbol
  • Přesné řetězce nebo chybové zprávy — použijte text_pattern_search

text_pattern_search Stabilní

Prohledává indexovaný obsah. exact a regex používají grep nad celým korpusem souborů/blob; fuzzy content hledá v omezeném korpusu sémantických úryvků. Oblasti file a symbol podporují jen trigramy — výchozí mode=exact se převádí na fuzzy. Nastavení jazyka, velikosti písmen a vlastního prahu vyžadují oblast content. Filtr cest používá omezené okno kandidátů a hlásí neúplné pokrytí. Pro úzce vymezený adresář na disku použijte místní Grep.

Parametry:

query Povinné
Typ
str minLength=1
Popis
Textový vzor k vyhledání
repository Volitelné
Typ
str
Popis
Repozitář ve formátu owner/repo[:branch]. Volitelné — vynechte jej, chcete-li použít výchozí repozitář klienta pro daný požadavek (pokud je poskytnut) nebo jediný přístupný repozitář; explicitně jej zadejte pouze pro jiný indexovaný repozitář. Preferovány jsou přesně indexované větve; nedostupná větev se může vrátit k main nebo k jediné přístupné větvi. Metadata odpovědi zobrazují požadovanou a skutečně použitou identitu a v takovém případě varují.
mode Volitelné
Typ
Literal[fuzzy, exact, regex]
Výchozí
exact
Popis
Režim vyhledávání. Regex používá pokročilou/POSIX syntaxi PostgreSQL; pro hranice slov použijte \y (\b znamená backspace). Vzory také procházejí bezpečnostním validátorem JavaScriptu, takže konstrukce specifické pouze pro PostgreSQL, jako jsou vložené příznaky (?i), jsou odmítnuty; místo toho použijte case_sensitive.
search_scope Volitelné
Typ
Literal[content, symbols, files]
Výchozí
content
Popis
Co hledat
limit Volitelné
Typ
int minimum=1, maximum=50
Výchozí
5
Popis
Maximální počet výsledků na stránku bez cursor. Pokračování používá velikost stránky uloženou v cursor; vynechte cursor pro spuštění s jiným limit.
offset Volitelné
Typ
int minimum=0
Popis
Zastaralý offset pro zpětnou kompatibilitu. Upřednostněte cursor z pagination.next_cursor.
cursor Volitelné
Typ
str
Popis
Neprůhledný cursor z pagination.next_cursor. Předávejte jej beze změny a ponechte query i filtry beze změny. Jeho pozice a velikost stránky mají přednost před offset a limit.
language_filter Volitelné
Typ
str
Popis
Filtr jazyka
path_filter Volitelné
Typ
str
Popis
Filtrujte podle předpony cesty k souboru
case_sensitive Volitelné
Typ
bool
Výchozí
false
Popis
Rozlišování velkých a malých písmen
branch Volitelné
Typ
str
Popis
Přepsání větve
fuzzy_algorithm Volitelné
Typ
Literal[hybrid, trigram, levenshtein]
Výchozí
hybrid
Popis
Fuzzy párovací algoritmus
threshold Volitelné
Typ
float minimum=0, maximum=1
Výchozí
0.05
Popis
Minimální práh podobnosti pro fuzzy
semantic_fallback Volitelné
Typ
bool
Výchozí
false
Popis
Zkusí sémantické vyhledávání po prázdné první lexikální stránce; metadata.fallback_status rozlišuje záložní stavy used, empty a unavailable.

Nejlepší pro:

  • Přesné řetězce, chybové zprávy a regulární výrazy
  • Trigramové fuzzy porovnávání pro téměř shodný text

Nedoporučeno pro:

  • Známá cesta na disku — upřednostněte lokální Grep
  • Koncepční dotazy — použijte semantic_search

Strukturální a grafové nástroje

#

structural_search Stabilní

Upřednostněte preset=functions|classes|methods|imports|variables (nebo volný pattern=). Hledejte kód podle struktury AST, nikoli textu. Filtry střední úrovně: name_pattern, node_type, decorator, parent_child. Filtry cest/ltree/volání jsou pokročilé; při jejich vědomém použití nastavte advanced=true. Bez něj se pokročilé filtry použijí s varováním v metadatech. Zadejte alespoň jeden strukturální selektor.

Parametry:

repository Volitelné
Typ
str
Popis
Repozitář ve formátu owner/repo[:branch]. Volitelné — vynechte jej, chcete-li použít výchozí repozitář klienta pro daný požadavek (pokud je poskytnut) nebo jediný přístupný repozitář; explicitně jej zadejte pouze pro jiný indexovaný repozitář. Preferovány jsou přesně indexované větve; nedostupná větev se může vrátit k main nebo k jediné přístupné větvi. Metadata odpovědi zobrazují požadovanou a skutečně použitou identitu a v takovém případě varují.
preset Volitelné
Typ
Literal[functions, classes, methods, imports, variables]
Popis
Preferovaný strukturální selektor. Rozbaluje se na mezijazykové typy uzlů AST — functions (definice funkcí/šipkových funkcí/metod napříč jazyky); classes (deklarace tříd/struktur/rozhraní, těla typů a implementace); methods (definice metod (a function_definition pro jazyky bez uzlu metody)); imports (příkazy import/use/include); variables (deklarace proměnných variable/let/const/static). Upřednostněte před volným pattern/node_type pro dotazy typu procházení.
pattern Volitelné
Typ
str
Popis
Volný pattern doplňuje chybějící selektory (automatická detekce: 'def foo(' → node_type + name_pattern). Lze kombinovat s preset; explicitní selektory mají přednost. Pro procházecí dotazy upřednostněte preset=.
name_pattern Volitelné
Typ
str maxLength=256
Popis
Vzor názvu symbolu (zástupný znak shellu, omezený POSIX regulární výraz nebo fuzzy text; max. 256 znaků)
node_type Volitelné
Typ
str
Popis
Typ uzlu AST (function_definition, class_definition atd.) — pro běžné tvary upřednostněte preset=
decorator Volitelné
Typ
str
Popis
Filtr názvu dekorátoru
base_class Volitelné
Typ
str
Popis
Filtr základní třídy
language_filter Volitelné
Typ
str
Popis
Jazykový filtr (python, typescript atd.)
limit Volitelné
Typ
int minimum=1, maximum=50
Výchozí
20
Popis
Maximální počet výsledků na stránku bez cursor. Pokračování používá velikost stránky uloženou v cursor; vynechte cursor pro spuštění s jiným limit.
offset Volitelné
Typ
int minimum=0
Popis
Zastaralý offset pro zpětnou kompatibilitu. Upřednostněte cursor z pagination.next_cursor.
cursor Volitelné
Typ
str
Popis
Neprůhledný cursor z pagination.next_cursor. Předávejte jej beze změny a ponechte query i filtry beze změny. Jeho pozice a velikost stránky mají přednost před offset a limit.
path_filter Volitelné
Typ
str
Popis
Filtrujte podle předpony cesty k souboru
branch Volitelné
Typ
str
Popis
Přepsání větve
query_type Volitelné
Typ
Literal[node_type, name_pattern, parent_child]
Popis
Explicitní typ dotazu
parent_type Volitelné
Typ
str
Popis
Filtr typu rodičovského uzlu AST
relationship Volitelné
Typ
Literal[parent, ancestor]
Výchozí
parent
Popis
Pro dotazy parent_child: pouze přímý rodič nebo libovolný předek (pro metody vnořené do těla či bloku třídy použijte ancestor)
has_modifier Volitelné
Typ
str
Popis
Filtrujte podle modifikátoru (export, async, static atd.)
advanced Volitelné
Typ
bool
Výchozí
false
Popis
Nastavte true při záměrném použití pokročilých filtrů cest/ltree/volání (ltree_ancestor, ltree_descendant, min_depth, max_depth, field_role, definition_name, callee_text, callee_name). Při false se zadané pokročilé filtry použijí s varováním v metadatech. Pro běžné strukturální dotazy upřednostněte preset=.
callee_text Volitelné
Typ
str
Popis
Pokročilé — upřednostněte preset=functions|classes|methods|imports|variables. Filtr textu volané funkce ve výrazu volání. Nastavte advanced=true, když záměrně používáte filtry path/ltree/call.
callee_name Volitelné
Typ
str
Popis
Pokročilé — upřednostněte preset=functions|classes|methods|imports|variables. Filtr názvu volané funkce ve výrazu volání. Nastavte advanced=true, když záměrně používáte filtry path/ltree/call.
field_role Volitelné
Typ
str
Popis
Pokročilé — upřednostněte preset=functions|classes|methods|imports|variables. Filtr role pole AST. Nastavte advanced=true, když záměrně používáte filtry path/ltree/call.
ltree_ancestor Volitelné
Typ
str
Popis
Pokročilé — upřednostněte preset=functions|classes|methods|imports|variables. Filtr cesty předka ltree AST. Nastavte advanced=true, když záměrně používáte filtry path/ltree/call.
ltree_descendant Volitelné
Typ
str
Popis
Pokročilé — upřednostněte preset=functions|classes|methods|imports|variables. Filtr cesty potomka ltree AST. Nastavte advanced=true, když záměrně používáte filtry path/ltree/call.
definition_name Volitelné
Typ
str
Popis
Pokročilé — upřednostněte preset=functions|classes|methods|imports|variables. Filtr názvu definice. Nastavte advanced=true, když záměrně používáte filtry path/ltree/call.
min_depth Volitelné
Typ
int
Popis
Pokročilé — upřednostněte preset=functions|classes|methods|imports|variables. Minimální hloubka AST. Nastavte advanced=true, když záměrně používáte filtry path/ltree/call.
max_depth Volitelné
Typ
int
Popis
Pokročilé — upřednostněte preset=functions|classes|methods|imports|variables. Maximální hloubka AST. Nastavte advanced=true, když záměrně používáte filtry path/ltree/call.

Nejlepší pro:

  • Struktura na úrovni AST: třídy, dekorátory, přednastavení funkcí/metod
  • Hledání kódu podle tvaru, ne podle textu

Nedoporučeno pro:

  • Volný text nebo koncepční dotazy — použijte semantic_search nebo intelligent_search

dependency_search Stabilní

Hlavní nástroj pro rozsah dopadu a graf. Odpovídá na „které části kódu to volají?“ a „které části kódu to používají?“ pomocí skutečného grafu volání/importů. Pro dopad před úpravou: analysis_type="dependents" nebo analysis_type="impact" (příchozí směr, u impact výchozí malá hloubka), standardně include_metrics=false (zapněte pro centralitu a refactor_risk). dependents/impact standardně zahrnují production_callers: jedinečná místa použití v produkčním kódu podle druhu (call, instantiate, value_reference pro funkce předávané jako hodnoty) a místa IMPORT, bez testů, s důvěryhodností EXTRACTED/INFERRED — nejde jen o výpis metrik. Dopad PR/diff: předejte changed_paths a/nebo patch (sjednocený diff); rozpozná symboly podle cest a vrátí stručná data o příchozích závislých komponentách v malé hloubce, bez nutnosti uvádět jméno symbolu. Po úpravě nastavte verify_after_edit=true s targets a/nebo changed_paths pro stručný opakovaný dotaz z více kořenů na ovlivněné symboly. Podporuje také dependencies, centrality a orphans. analyze_dependencies používá stejný průchod pro analýzu dopadu přes více kroků.

Parametry:

repository Volitelné
Typ
str
Popis
Repozitář ve formátu owner/repo[:branch]. Volitelné — vynechte jej, chcete-li použít výchozí repozitář klienta pro daný požadavek (pokud je poskytnut) nebo jediný přístupný repozitář; explicitně jej zadejte pouze pro jiný indexovaný repozitář. Preferovány jsou přesně indexované větve; nedostupná větev se může vrátit k main nebo k jediné přístupné větvi. Metadata odpovědi zobrazují požadovanou a skutečně použitou identitu a v takovém případě varují.
query Volitelné
Typ
str
Popis
Název symbolu nebo hledaný výraz
target Volitelné
Typ
str
Popis
Název symbolu (alias pro query)
symbol_id Volitelné
Typ
UUID
Popis
Po filtrování podle jmenného prostoru, cesty a jazyka vyberte pomocí UUID konkrétní výskyt mezi kandidáty s názvem uvedeným v query/target. Použijte ID vrácené nástrojem find_symbol nebo alternativními výsledky grafu. Pouze pro průchod se zadaným názvem; ID mimo omezené okno kandidátů způsobí chybu.
changed_paths Volitelné
Typ
list[str] maxItems=50
Popis
Přesné cesty k souborům relativní ke kořeni repozitáře pro dopad PR/diff (výchozí) nebo při verify_after_edit=true výchozí body ověření po úpravě. Nerozpoznané cesty mohou vrátit označené návrhy; navržené soubory se nikdy nestanou výchozími body dopadu. PR/diff: bez informací o řádcích projde definice nejvyšší úrovně každé cesty (nejdřív exportované, v pořadí v souboru) a ohlásí changed_lines_unknown; pro symboly změněné po řádcích předejte patch=. Ověření: až 5 definic nejvyšší úrovně na cestu jako výchozí body (uvnitř ověřovacího režimu platí nižší limit). Pro dopad PR/diff nevyžaduje query/target.
patch Volitelné
Typ
str maxLength=500000
Popis
Dopad PR/diff: text ve formátu unified diff / git patch. Cesty se berou ze záhlaví diff --git / --- / +++; řádky hunků (stará strana = indexovaný commit) se mapují na obklopující funkce, metody a třídy, které se pak procházejí kvůli přesným závislým částem, public_api_changed a volajícím, kterých se diff nedotýká.
head_commit Volitelné
Typ
str pattern=^[0-9a-fA-F]{7,64}$
Popis
SHA commitu kódu, na který se ptáte (git rev-parse HEAD, nebo základní commit patche). complete:true vyžaduje, aby index byl na tomto commitu a sestavil ho aktuální resolver; jinak zůstává complete:false s index_stale / index_freshness_unverified / index_built_by_older_resolver a index_basis.statement uvádí, v jakém rozsahu je odpověď úplná. Hodnotu dodá i řádek 'base-commit:' v patchi (git format-patch --base).
analysis_type Volitelné
Typ
Literal[centrality, dependencies, dependents, impact, orphans]
Výchozí
dependencies
Popis
Režim analýzy. impact = rozsah dopadu (příchozí závislé komponenty; malá hloubka, pokud depth není zadán). dependents také zodpovídá otázky dopadu. Při zadání changed_paths nebo patch se vždy použije analýza dopadu PR/diff. centrality/orphans nevyžadují cíl. orphans jsou kandidáti na nepoužívaný kód, nikoli důkaz, že je bezpečné jej odstranit; ověřte odkazy ve zdrojovém kódu.
depth Volitelné
Typ
Literal[shallow, balanced, deep]
Popis
Hloubka průchodu. Výchozí je balanced; impact a PR/diff impact ve výchozím nastavení používají shallow. Explicitně nastavené depth tyto výchozí hodnoty přepíše. Ověřovací režim vždy používá shallow.
limit Volitelné
Typ
int minimum=1, maximum=50
Výchozí
20
Popis
Maximální počet výsledků na stránku bez cursor. Pokračování používá velikost stránky uloženou v cursor; vynechte cursor pro spuštění s jiným limit.
offset Volitelné
Typ
int minimum=0
Popis
Zastaralý offset pro zpětnou kompatibilitu. Upřednostněte cursor z pagination.next_cursor.
cursor Volitelné
Typ
str
Popis
Neprůhledný cursor z pagination.next_cursor. Předávejte jej beze změny a ponechte query i filtry beze změny. Jeho pozice a velikost stránky mají přednost před offset a limit.
path_filter Volitelné
Typ
str
Popis
Omezuje rozřešení cílového symbolu podle prefixu cesty k souboru; vrácené vztahy grafu mohou přesahovat mimo tuto cestu
language_filter Volitelné
Typ
str
Popis
Filtruje rozřešení cíle a výsledky procházení podle jazyka
direction Volitelné
Typ
Literal[outgoing, incoming, both]
Popis
Směr průchodu (přepisuje odvození analysis_type)
relationship_types Volitelné
Typ
list[str]
Popis
Filtr typů hran (CALL, IMPORT, INHERITS_FROM atd.). Neprázdný seznam přepisuje výchozí hodnoty graph_view.
exclude_test_paths Volitelné
Typ
bool
Výchozí
true
Popis
Výchozí hodnota true: vylučuje cesty testů, fixtures, vendor kódu a příkladů z výsledků procházení a centrality. Nastavte false pro jejich zahrnutí. Analýza orphan to respektuje jen tam, kde to nasazený backend podporuje; jinak si ponechá vlastní přísnější vyloučení šumu a úpravu ohlásí.
exclude_generated_paths Volitelné
Typ
bool
Výchozí
false
Popis
Vyloučit z výsledků průchodu generované deklarace a cesty k výstupům sestavení, reportům pokrytí, cache, zdrojovým mapám a minifikovaným artefaktům
include_module_symbols Volitelné
Typ
bool
Výchozí
false
Popis
Výchozí false: vyloučit hrany, jejichž from_name nebo to_name je syntetický symbol __module__ (šum na úrovni modulu). Nastavte true pro zahrnutí hran na úrovni modulu do výsledků dependents/dependencies.
include_isolated Volitelné
Typ
bool
Popis
Pouze pro orphans. Výchozí false. Nastavte true, chcete-li vracet i symboly bez řádku grafových metrik (bez jakýchkoli hran v grafu). Dokud je exclude_test_paths nastaveno na true, zůstávají symboly stylů, značkování a dat (CSS, HTML, ...), deklarace .d.ts a cesty test/fixture/vendor/example vyloučeny tam, kde to backend podporuje, pokud language_filter neuvádí daný jazyk; vlastnosti objektových literálů TypeScript se přesto mohou objevit jako izolované funkce.
exclude_exported Volitelné
Typ
bool
Výchozí
false
Popis
Pouze pro osiřelé symboly. Výchozí false: exportované symboly (veřejné API), které nic v repozitáři nepoužívá, se vracejí s is_exported=true. Pro pouze interní kandidáty nastavte true.
branch Volitelné
Typ
str
Popis
Přepsání větve
per_hop_limit Volitelné
Typ
int minimum=1, maximum=300
Popis
Maximální počet vztahů na jeden přechod (1-300)
include_metrics Volitelné
Typ
bool
Výchozí
false
Popis
Volitelné grafové metriky v řádcích výsledků (zkompaktněné s refactor_risk). Metriky se také interně načítají, když min_centrality>0, ale nevrací se, pokud toto není nastaveno na true.
metrics_detail Volitelné
Typ
Literal[summary, full]
Výchozí
summary
Popis
Když include_metrics=true: summary (výchozí) vrací rozhodovací signály + refactor_risk; full vrátí větší soubor vybraných metrik
include_edge_metadata Volitelné
Typ
bool
Výchozí
false
Popis
Zahrnout nezpracovaná metadata hran a váhy (velký objem dat). Stručné odpovědi o dopadu mají tuto možnost vypnutou.
symbol_types Volitelné
Typ
list[str]
Popis
Filtruje vrácené symboly podle druhu (function, class, method atd.). Není podporováno v analýze orphan; tam místo toho použijte path_filter nebo language_filter. Prázdný seznam neuplatní žádný filtr podle druhu.
exact_match Volitelné
Typ
bool
Výchozí
false
Popis
Vyžadovat přesnou shodu názvu symbolu
find_similar_patterns Volitelné
Typ
bool
Výchozí
false
Popis
Najděte podobné vzorce použití
min_centrality Volitelné
Typ
float minimum=0
Výchozí
0
Popis
Minimální skóre PageRank pro průchod pojmenovanými symboly a pro analýzu dopadu PR/diff. Kladné prahové hodnoty nejsou v režimech procházení centrality/orphans podporovány. Metriky se interně načítají pro filtrování; graph_metrics se vrací pouze při include_metrics=true. Ignoruje je verify_after_edit, který používá pevná kompaktní nastavení.
graph_view Volitelné
Typ
Literal[dependency, type, data_flow, control_flow]
Výchozí
dependency
Popis
Zobrazení grafu použité pro výchozí hodnoty vztahů procházení, metriky a řazení podle centrality; analýza orphan se počítá napříč všemi zobrazeními
verify_after_edit Volitelné
Typ
bool
Výchozí
false
Popis
Znovu dotazuje indexovaný graf dopadu pro upravené symboly v jedné kompaktní odpovědi s více kořeny. Vyžaduje targets a/nebo changed_paths (nebo target/query). Používá pevný průchod shallow a kompaktní rozpočty; ovládací prvky depth/limit/cursor/metrics se nepoužijí. Ve výchozím nastavení vrací incoming dependents; výsledky odrážejí indexovaný graf (mohou zaostávat za živými úpravami). Je-li true, má přednost před PR/diff impact pro stejné changed_paths.
targets Volitelné
Typ
list[str] maxItems=15
Popis
Když verify_after_edit=true: názvy symbolů k opětovnému ověření (volající/závislí). Sloučeno s target/query, pokud jsou dodány oba.

Nejlepší pro:

  • Analýza rozsahu dopadu před úpravou sdíleného symbolu
  • Dopad PR/diff pomocí changed_paths nebo patch
  • Ověření po úpravě pomocí verify_after_edit

Nedoporučeno pro:

  • Jednoduché vyhledávání textu nebo symbolů — použijte text_pattern_search nebo find_symbol

Nástroje pro analýzu kódu

#

find_symbol Stabilní

Přejít na místo, kde je definována a použita funkce, třída nebo proměnná. Použijte, když znáte název (např. „getCurrentUser“) – rychlejší a přesnější než Grep a zahrnuje celé indexované repo. Volitelně vrací reference a metriky důležitosti.

Parametry:

symbol_name Volitelné
Typ
str
Popis
Název hledaného symbolu (volitelné — vynechte pro procházení podle metrik)
repository Volitelné
Typ
str
Popis
Repozitář ve formátu owner/repo[:branch]. Volitelné — vynechte jej, chcete-li použít výchozí repozitář klienta pro daný požadavek (pokud je poskytnut) nebo jediný přístupný repozitář; explicitně jej zadejte pouze pro jiný indexovaný repozitář. Preferovány jsou přesně indexované větve; nedostupná větev se může vrátit k main nebo k jediné přístupné větvi. Metadata odpovědi zobrazují požadovanou a skutečně použitou identitu a v takovém případě varují.
scope Volitelné
Typ
Literal[definitions, references, both]
Výchozí
both
Popis
Rozsah vyhledávání; references vyžaduje neprázdný symbol_name.
limit Volitelné
Typ
int minimum=1, maximum=50
Výchozí
15
Popis
Maximální počet výsledků na stránku bez cursor. Pokračování používá velikost stránky uloženou v cursor; vynechte cursor pro spuštění s jiným limit.
offset Volitelné
Typ
int minimum=0
Popis
Zastaralý offset pro zpětnou kompatibilitu. Upřednostněte cursor z pagination.next_cursor.
cursor Volitelné
Typ
str
Popis
Neprůhledný cursor z pagination.next_cursor. Předávejte jej beze změny a ponechte query i filtry beze změny. Jeho pozice a velikost stránky mají přednost před offset a limit.
find_similar Volitelné
Typ
bool
Výchozí
false
Popis
Zahrnout podobné názvy symbolů
include_metrics Volitelné
Typ
bool
Výchozí
false
Popis
Zahrnout metriky centrality
metrics_detail Volitelné
Typ
Literal[summary, full]
Výchozí
summary
Popis
Když include_metrics=true: summary (výchozí) vrací rozhodovací signály + refactor_risk; full vrátí větší soubor vybraných metrik
path_filter Volitelné
Typ
str
Popis
Filtrujte podle předpony cesty k souboru
branch Volitelné
Typ
str
Popis
Přepsání větve
symbol_type Volitelné
Typ
str minLength=1
Popis
Filtrovat podle indexovaného typu symbolu, např. function, class, struct, enum nebo trait. Použijte typ vrácený výsledkem symbolu; typ se liší podle jazyka.
high_impact Volitelné
Typ
bool
Výchozí
false
Popis
Procházejte architektonicky důležité symboly (vynechte symbol_name). Výchozí režim je popularity (horní decil PageRank minus utilitní mega-huby). Nastavte high_impact_mode=risk pro artikulační/mostní řezné vrcholy (articulation/bridge cut-vertices).
high_impact_mode Volitelné
Typ
Literal[popularity, risk]
Výchozí
popularity
Popis
Když high_impact=true: popularity = horní decil PageRank bez velkých uzlů/modulů pomocných funkcí; risk = artikulační body seřazené podle SMV bridge_count a poté k_core (strukturální riziko refaktoringu, nikoli popularita uzlu)
in_cycle Volitelné
Typ
bool
Výchozí
false
Popis
Filtruje symboly se zaznamenaným členstvím v cyklu závislostí.
exclude_test_paths Volitelné
Typ
bool
Výchozí
true
Popis
Při procházení podle metrik grafu před hodnocením vylučte testy, fixtures, kód třetí strany a příklady. Vyhledávání podle pojmenovaného symbolu se nemění.
reference_views Volitelné
Typ
list[Literal[dependency, type, data_flow, control_flow, all]] minItems=1, maxItems=5
Popis
Pohledy grafu, jejichž příchozí hrany plní references/reference_count (scope references/both). Výchozí ["dependency", "type"]: volání, importy, exporty, odkazy, vytváření instancí, dědičnost, přepsání, dekorátory a použití typů. Není-li vybráno data_flow, přesně rozlišená použití data_flow (zpětná volání, obslužné funkce, řadicí klíče) se vracejí samostatně jako value_references/value_reference_count, bez shod odvozených pouze z názvu. Přidejte data_flow nebo control_flow, nebo předejte ["all"] pro všechny typy a úrovně hran. Stejné rodiny pohledů jako graph_view v dependency_search.
relationship_types Volitelné
Typ
list[str]
Popis
Explicitní typy referenčních hran (CALL, IMPORT, READS atd.). Neprázdný seznam nahrazuje reference_views.

Nejlepší pro:

  • Ukotvení definice, referencí a grafových metrik známého symbolu
  • Procházení podle centrality, high_impact nebo in_cycle, když je symbol_name vynechán

Nedoporučeno pro:

  • Koncepční dotazy nebo dotazy z neznámé oblasti — použijte intelligent_search nebo semantic_search

analyze_dependencies Stabilní

Analyzujte rozsah dopadu stejným průchodem jako dependency_search (dependents/incoming). Pro analýzu dopadu upřednostněte dependency_search s analysis_type="dependents" nebo "impact". Vrací odpověď s dopadem přes více kroků, poli graph a connection_summary a volitelnými metrikami s refactor_risk. connection_summary počítá pro zvolený kořen hrany omezené na rodinu vztahů, a to před jakýmkoli filtrováním testů či cest. Zastaralá pole incoming_production/outgoing_production označují hrany mimo moduly, včetně testů; nejde o počty produkčních volajících. Pomocí graph_view omezte rodinu vztahů: dependency (výchozí), type, data_flow, control_flow.

Parametry:

repository Volitelné
Typ
str
Popis
Repozitář ve formátu owner/repo[:branch]. Volitelné — vynechte jej, chcete-li použít výchozí repozitář klienta pro daný požadavek (pokud je poskytnut) nebo jediný přístupný repozitář; explicitně jej zadejte pouze pro jiný indexovaný repozitář. Preferovány jsou přesně indexované větve; nedostupná větev se může vrátit k main nebo k jediné přístupné větvi. Metadata odpovědi zobrazují požadovanou a skutečně použitou identitu a v takovém případě varují.
target Povinné
Typ
str minLength=1
Popis
Název symbolu k analýze
symbol_id Volitelné
Typ
UUID
Popis
Po filtrování podle jmenného prostoru, cesty a jazyka vyberte pomocí UUID konkrétní výskyt mezi kandidáty target; ID mimo omezené okno kandidátů způsobí chybu.
depth Volitelné
Typ
Literal[shallow, balanced, deep]
Výchozí
balanced
Popis
Hloubka analýzy
limit Volitelné
Typ
int minimum=1, maximum=50
Výchozí
10
Popis
Maximální počet výsledků na stránku bez cursor. Pokračování používá velikost stránky uloženou v cursor; vynechte cursor pro spuštění s jiným limit.
offset Volitelné
Typ
int minimum=0
Popis
Zastaralý offset pro zpětnou kompatibilitu. Upřednostněte cursor z pagination.next_cursor.
cursor Volitelné
Typ
str
Popis
Neprůhledný cursor z pagination.next_cursor. Předávejte jej beze změny a ponechte query i filtry beze změny. Jeho pozice a velikost stránky mají přednost před offset a limit.
direction Volitelné
Typ
Literal[incoming, outgoing, both]
Výchozí
incoming
Popis
Směr průchodu
relationship_types Volitelné
Typ
list[str]
Popis
Filtruje typy hran (CALL, IMPORT, INHERITS_FROM atd.). Neprázdný seznam přepíše výchozí hodnoty graph_view; prázdný seznam tyto výchozí hodnoty použije.
graph_view Volitelné
Typ
Literal[dependency, type, data_flow, control_flow]
Výchozí
dependency
Popis
Zobrazení grafu: určuje jak výchozí typy procházených hran, tak metriky, ze kterého zobrazení se použijí, když include_metrics=true. dependency=[CALL,IMPORT,EXPORTS,REFERENCE,INSTANTIATES] (výchozí), type=[INHERITS_FROM,IMPLEMENTS,OVERRIDE,DECORATES,OF_TYPE], data_flow=[READS,WRITES,ASSIGNS_TO], control_flow=[CONTROL_FLOW,THROWS,CATCHES]. Použije se jako výchozí hodnota relationship_types, když je relationship_types vynecháno nebo prázdné. Odpovídá stávajícímu názvu parametru graph_view v dependency_search, pro konzistenci mezi nástroji.
path_filter Volitelné
Typ
str
Popis
Omezuje rozřešení cílového symbolu podle prefixu cesty k souboru; vrácené vztahy grafu mohou přesahovat mimo tuto cestu
language_filter Volitelné
Typ
str
Popis
Jazykový filtr
branch Volitelné
Typ
str
Popis
Přepsání větve
per_hop_limit Volitelné
Typ
int minimum=1, maximum=300
Popis
Maximální počet vztahů na jeden přechod (1-300)
include_metrics Volitelné
Typ
bool
Výchozí
false
Popis
Zahrňte do výsledků metriky grafu, každou obohacenou o odvozený blok refactor_risk ({risk: "low"|"medium"|"high", is_articulation_point, bridge_count, k_core, graph_view, reasons}). riziko je "low", pokud se nejedná o artikulační bod (ve vybraném pohledu), "medium" když artikulační bod přemosťuje několik hran, "high" když přemosťuje mnoho (heuristický práh, empiricky neověřeno). Vynecháno pro každý symbol, pokud pro tento symbol/zobrazení neexistuje žádný řádek metrik.
metrics_detail Volitelné
Typ
Literal[summary, full]
Výchozí
summary
Popis
Když include_metrics=true: summary (výchozí) vrací rozhodovací signály + refactor_risk; full vrátí větší soubor vybraných metrik
include_edge_metadata Volitelné
Typ
bool
Výchozí
false
Popis
Zahrňte nezpracovaná metadata hran a váhy. Ve výchozím nastavení zakázáno, protože metadata extraktoru mohou být velká; pokrytí obohacením je hlášeno, když je povoleno.
exclude_test_paths Volitelné
Typ
bool
Výchozí
true
Popis
Výchozí true: vyloučit cesty testů, testovacích případů, kódu třetích stran a příkladů z vrácených hran grafu. Chcete-li je zahrnout, nastavte false.
include_module_symbols Volitelné
Typ
bool
Výchozí
false
Popis
Výchozí false: vyloučit hrany, jejichž from_name nebo to_name je syntetický symbol __module__. Nastavte true pro zahrnutí hran na úrovni modulu.
head_commit Volitelné
Typ
str pattern=^[0-9a-fA-F]{7,64}$
Popis
SHA commitu kódu, na který se ptáte (git rev-parse HEAD, nebo základní commit patche). complete:true vyžaduje, aby index byl na tomto commitu a sestavil ho aktuální resolver; jinak zůstává complete:false s index_stale / index_freshness_unverified / index_built_by_older_resolver a index_basis.statement uvádí, v jakém rozsahu je odpověď úplná. Hodnotu dodá i řádek 'base-commit:' v patchi (git format-patch --base).

Nejlepší pro:

  • Analýza dopadu přes více kroků, když potřebujete pole odpovědi graph a connection_summary

Nedoporučeno pro:

  • Obecná analýza dopadu: upřednostněte dependency_search pro pružný průchod a kontroly z více kořenů

get_task_context Stabilní

Začínáte pracovat v neznámé oblasti? Popište úkol (např. „přidat podporu SSO“, „opravit fakturační webhook“) a jedním voláním získáte ohraničený balíček relevantních souborů, kódu, symbolů a závislostí. Soubory předané jako seed přispívají přímo indexovaným obsahem, i když nedefinují žádné symboly. Neúspěšné vrstvy jsou označeny; při úplném selhání načtení se vrátí chyba nástroje. Pro další výsledky pokračujte specializovaným vyhledávacím nástrojem pro danou vrstvu.

Parametry:

task_description Povinné
Typ
str minLength=1
Popis
Popis úkolu, pro který potřebujete kontext
repository Volitelné
Typ
str
Popis
Repozitář ve formátu owner/repo[:branch]. Volitelné — vynechte jej, chcete-li použít výchozí repozitář klienta pro daný požadavek (pokud je poskytnut) nebo jediný přístupný repozitář; explicitně jej zadejte pouze pro jiný indexovaný repozitář. Preferovány jsou přesně indexované větve; nedostupná větev se může vrátit k main nebo k jediné přístupné větvi. Metadata odpovědi zobrazují požadovanou a skutečně použitou identitu a v takovém případě varují.
limit Volitelné
Typ
int minimum=1, maximum=50
Výchozí
15
Popis
Maximální počet výsledků na vrstvu
scope Volitelné
Typ
Literal[semantic, symbols, dependencies, all]
Výchozí
all
Popis
Které kontextové vrstvy zahrnout
language_filter Volitelné
Typ
str
Popis
Filtr jazyka: vyžaduje scope=semantic bez výslovných výchozích bodů či souvisejícího kontextu; indexy ostatních vrstev nemohou jazyk vynutit.
path_filter Volitelné
Typ
str
Popis
Předpona cesty k souboru pro výchozí body sémantického a klíčového vyhledávání. Explicitní seedy mohou ležet mimo tuto předponu; grafový kontext může přesahovat hranice adresářů.
branch Volitelné
Typ
str
Popis
Přepsání větve
include_related_context Volitelné
Typ
bool
Výchozí
false
Popis
Zahrňte související kontext ze sousedních symbolů
seed_symbol_ids Volitelné
Typ
list[str] maxItems=20
Popis
Explicitní výchozí body úlohy: objevují se jako první ve vrstvě symbolů a jsou zachovány v rámci omezeného okna dependencies/related_context. Grafové vrstvy řadí explicitní výchozí body a jejich nejbližší okolí dříve, než se vrátí ke klíčovým slovům; důležitost rozhoduje jen při shodné relevanci. Rozšíření grafu vyžaduje scope=all|dependencies (scope=symbols|semantic procházení závislostí nikdy nespouští). Vynechte pro řazení pouze podle klíčových slov, s klesající důležitostí podle hloubky.
seed_file_paths Volitelné
Typ
list[str] maxItems=10
Popis
Explicitní seedy: přesné indexované cesty souborů, které má agent otevřené nebo právě upravil. Vrací omezené přímé souborové důkazy a až 5 grafových seedů na soubor, přičemž upřednostňuje přesné shody s názvem úlohy z omezeného vyhledávání symbolů před definicemi a náhodně zachycenými symboly. Soubory bez symbolů přesto poskytují důkazy. Chybějící soubory mohou vrátit označené návrhy, které nejsou seedy. Rozšíření grafu vyžaduje scope=all|dependencies.

Nejlepší pro:

  • Kontext zohledňující úkol, který kombinuje seed soubory se sémantickou, symbolovou a závislostní vrstvou

Nedoporučeno pro:

  • Vyhledávání jedním nástrojem, kde na otázku už odpovídá specifičtější nástroj

get_file Stabilní

Přečte soubor z indexovaného repozitáře podle cesty. U souborů na disku upřednostněte místní souborové nástroje; toto použijte pro vzdálené indexované snímky. Pokračujte v omezených odpovědích pomocí metadata.next_line_start a next_character_start. Odstraňte koncový znak nového řádku a značku [truncated] pouze tehdy, když je metadata.truncated=true; jinak se může jednat o doslovný zdrojový text.

Parametry:

file_path Povinné
Typ
str
Popis
Cesta k souboru vzhledem ke kořenovému adresáři úložiště
repository Volitelné
Typ
str
Popis
Repozitář ve formátu owner/repo[:branch]. Volitelné — vynechte jej, chcete-li použít výchozí repozitář klienta pro daný požadavek (pokud je poskytnut) nebo jediný přístupný repozitář; explicitně jej zadejte pouze pro jiný indexovaný repozitář. Preferovány jsou přesně indexované větve; nedostupná větev se může vrátit k main nebo k jediné přístupné větvi. Metadata odpovědi zobrazují požadovanou a skutečně použitou identitu a v takovém případě varují.
line_start Volitelné
Typ
int minimum=1
Popis
Počáteční řádek (1-indexovaný)
line_end Volitelné
Typ
int minimum=1
Popis
Koncový řádek (číslováno od 1, včetně; musí být na hodnotě line_start nebo za ní)
character_start Volitelné
Typ
int minimum=0
Výchozí
0
Popis
Posun v kódových jednotkách UTF-16 pouze v počátečním řádku (číslování od 0). Pro pokračování uprostřed řádku použijte metadata.next_character_start.
branch Volitelné
Typ
str
Popis
Přepsání větve
max_tokens Volitelné
Typ
int minimum=1, maximum=50000
Výchozí
5000
Popis
Přibližný rozpočet obsahu (4 kódové jednotky UTF-16 na token; nejde o přesný limit tokenizátoru).
include_metadata Volitelné
Typ
bool
Výchozí
true
Popis
Zahrnout popisná metadata souboru. Metadata zkrácení a pokračování se vracejí vždy.

Nejlepší pro:

  • Vzdálené nebo indexované snímky souborů (rozsahy řádků, limity tokenů)

Nedoporučeno pro:

  • Cesta již existující na lokálním disku — použijte lokální nástroj Read

Systémové a pomocné nástroje

#

repository_context Stabilní

Vypíše repozitáře, které můžete prohledávat, nebo získá identifikační informace o jednom z nich (namespace/branch, indexed_commit_sha / aktuálnost indexu). Použijte action:"list", pokud neznáte slug repozitáře; vyhledávací nástroje přijímají známý slug přímo, nebo ve výchozím nastavení použijí jediný repozitář vašeho klíče. list používá pattern a stránkování; info vyžaduje repository a podporuje branch a volitelné include_statistics=true.

Parametry:

action Povinné
Typ
Literal[list, info]
Popis
Akce: vypsat dostupné repozitáře pomocí list nebo získat informace pomocí info
repository Volitelné
Typ
str
Popis
Pouze pro info: repozitář ve formátu owner/repo nebo owner/repo:branch (u info povinné)
branch Volitelné
Typ
str
Popis
Pouze pro info: přepsání větve
pattern Volitelné
Typ
str
Popis
Pouze pro list: podřetězec názvu repozitáře nerozlišující velikost písmen
include_statistics Volitelné
Typ
bool
Výchozí
false
Popis
Pouze informativní: zahrnuje omezené počty indexovaných dat. Počty file/blob jsou přesné; větší počty indexu jsou odhady. Viz count_accuracy a estimate_analyzed_at. Výchozí hodnota false.
limit Volitelné
Typ
int minimum=1, maximum=50
Výchozí
20
Popis
Maximální počet výsledků na stránku bez cursor. Pokračování používá velikost stránky uloženou v cursor; vynechte cursor pro spuštění s jiným limit.
offset Volitelné
Typ
int minimum=0
Popis
Zastaralý posun pro zpětnou kompatibilitu. Upřednostněte cursor z pagination.next_cursor.
cursor Volitelné
Typ
str
Popis
Neprůhledný cursor z pagination.next_cursor. Předávejte jej beze změny a ponechte query i filtry beze změny. Jeho pozice a velikost stránky mají přednost před offset a limit.

Nejlepší pro:

  • Výpis dostupných repozitářů
  • Zjištění identity repozitáře, větve a aktuálnosti HEAD oproti indexu

Nedoporučeno pro:

  • Statistiky napříč jmenným prostorem ve výchozím nastavení — předejte explicitně include_statistics=true, protože to může být pomalejší než samotné rozlišení

ask_maguyva Stabilní

Získejte nápovědu k nástrojům Maguyva nebo odešlete hlášení chyby či požadavek na funkci, který se uloží pro správce Maguyva. Do zpětné vazby nikdy nevkládejte tajné údaje ani citlivé osobní údaje. Operace evaluate podporuje deterministické výrazy; pro matematiku, hashování a práci s řetězci upřednostněte místní výpočty nebo nástroje hostitelského prostředí.

Parametry:

operation Povinné
Typ
Literal[guidance, report_bug, request_feature, evaluate]
Popis
Použijte guidance pro nápovědu k nástrojům, report_bug pro chyby nebo request_feature pro návrhy. evaluate provádí deterministické výrazy; pro výpočty upřednostněte místní prostředky.
query Volitelné
Typ
str maxLength=500
Popis
Téma nápovědy (například tool_selection, semantic_search) nebo řetězec výrazu pro evaluate.
description Volitelné
Typ
str minLength=1, maxLength=4000
Popis
Povinné pro report_bug a request_feature. Zpětná vazba ve volném textu pro správce Maguyva. Nikdy nevkládejte tajné údaje ani citlivé osobní údaje.
related_tool Volitelné
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]
Popis
Volitelný nástroj Maguyva nejblíže související se zpětnou vazbou

Nejlepší pro:

  • Nápověda k nástroji (operation="guidance")
  • Trvalá hlášení chyb a požadavky na funkce pro správce Maguyva

Nedoporučeno pro:

  • Matematické výpočty, hashování a práce s řetězci: upřednostněte místní výpočty nebo nástroje hostitelského prostředí

Osvědčené postupy

#
  1. Záměrně používejte explicitní přepisy: Repozitář vynechte, pokud klient MCP poskytuje výchozí hodnotu pro daný požadavek nebo pokud má klíč přístup právě k jednomu repozitáři; jinak jej zadejte explicitně.
  2. Vyberte správný režim vyhledávání: Pro většinu případů použijte intelligent_search s mode="auto". Určete režim, když přesně víte, co potřebujete.
  3. Využijte jazykové filtry: Použijte language_filter k zúžení výsledků a zlepšení výkonu.
  4. GraphRAG Posílení: Posílení důležitosti GraphRAG je pro sémantické vyhledávání ve výchozím nastavení vypnuto (boost_by_importance=false), aby řazení zůstalo bezpečné pro agenty. Předejte boost_by_importance=true, čímž zapnete přeřazení podle centrality pro architektonické prohlídky.
  5. Shoda repozitáře nerozlišuje velikost písmen, ale není fuzzy: repository_context porovnává názvy repozitářů bez ohledu na velikost písmen — překlepy však neopravuje. Když se doručená identita liší od požadované, metadata.resolution_reason uvádí "defaulted" (žádná větev nebyla vyžádána) nebo "fallback" (požadovaná větev či repozitář nejsou dostupné). Při přesné shodě se pole vynechává.
  6. Kombinovat nástroje: Pro komplexní analýzu použijte více metod API společně.
  7. Zvládněte velké výsledky: Použijte limit a ovládací prvky stránkování specifické pro nástroj (například line_start/line_end v get_file).
  8. Použijte ask_maguyva pro nápovědu k nástrojům: Zavolejte ask_maguyva s operation="guidance" a query="tool_selection" pro rady k výběru nástrojů a příklady. Pro výpočty a transformace řetězců používejte místní nástroje.
  9. Ověřujte dopad před úpravou i po ní: Před úpravou sdíleného symbolu zavolejte dependency_search s analysis_type="impact" (nebo předejte changed_paths pro dopad PR/diff), abyste viděli rozsah dopadu. Po úpravě nastavte verify_after_edit=true s targets a/nebo changed_paths pro stručnou opětovnou kontrolu indexovaného grafu. Nástroj nečte lokální změny bez commitu ani nenahrazuje lokální testy. Než výsledky použijete jako důkaz pro novou revizi, zkontrolujte indexed_commit_sha a aktuálnost indexu.

Charakteristiky výkonu

#
Operace Poznámky k výkonu
Sémantické vyhledávání Zahrnuje vytvoření vektorové reprezentace dotazu a vektorové vyhledávání. Latence závisí na obou operacích.
Textové vyhledávání Při přibližném hledání v obsahu načítají vzdálenější stránky více kandidátů. Zužte dotaz pomocí path_filter a language_filter.
Strukturální vyhledávání Dotazuje indexované uzly AST. Použijte konkrétní předvolbu nebo vzor a omezte počet výsledků.
Vyhledávání závislostí Náklady škálují podle hloubky — preferujte depth="shallow", pokud nepotřebujete vícekrokový kontext; per_hop_limit omezuje rozrůstání
Načtení souboru Načtěte potřebný rozsah pomocí line_start/line_end nebo max_tokens a pro zkrácený obsah použijte vrácená metadata pro pokračování.
Kontext repozitáře Repozitář se rozpoznává při každém volání nástroje. Pokud potřebujete konkrétní repozitář, předejte repository explicitně.
ask_maguyva (guidance / evaluate) Běží na serveru MCP bez dotazování indexu repozitáře.

Zpracování chyb

#

Odpovědi nástrojů obsahují na nejvyšší úrovni společná stavová pole a datová pole specifická pro nástroj. Vyhledávání vrací results; get_file vrací content. Mezi společná pole patří:

  • status: Řetězec — "success" nebo "error". Signály o zhoršené shodě a čerstvosti indexu mají vlastní pole: metadata.resolution_reason pod metadata a index_freshness.status na nejvyšší úrovni akce info u repository_context.
  • timing_ms: Uplynulá doba provádění nástroje v milisekundách
  • applied_filters: Skutečně použité parametry požadavku zaznamenané pro operaci
  • error: Řetězec chybové zprávy, když je status rovno "error"; může obsahovat pokyny k nápravě.
  • metadata: Doplňující informace o operaci (směrování, cachování, úpravy parametrů)
  • pagination: Přítomno v odpovědích kolekcí stránkovaných pomocí kurzoru — obsahuje has_more a next_cursor. Seřazená okna vyhledávání jsou omezené výsledky top-K, nikoli úplné stránkované kolekce.

Než začnete zpracovávat data z nástroje, zkontrolujte pole status — jeho hodnoty jsou "success" nebo "error". Ošetřete také přenosové chyby MCP/JSON-RPC a chyby validace požadavku, které mohou nastat ještě předtím, než nějaká data vzniknou. Pro signály o zhoršené shodě nebo čerstvosti čtěte příslušné pole: metadata.resolution_reason pod metadata, případně index_freshness.status na nejvyšší úrovni akce info u repository_context (known/partial/unknown/unavailable).

Začínáme

#
  1. Nakonfigurujte klienta MCP: Nasměrujte klienta MCP na koncový bod serveru Maguyva
  2. Ověřte přístup k repozitářům: Pomocí repository_context s akcí "list" nebo "info" zkontrolujte repozitáře dostupné pro klíč API
  3. Začněte hledat: Začněte s intelligent_search a podle potřeby prozkoumejte specializované nástroje
  4. Kombinujte nástroje: Pro komplexní analýzu kódu používejte více nástrojů společně

Podrobné pokyny k integraci najdete v průvodci instalací.

Související

Čtěte dál