MCP API -referenssi

Täydellinen viiteopas kaikille 11 asiakkaille näkyvälle Maguyva MCP -työkalulle. Jokainen työkalu sisältää parametrit, käyttöohjeet ja suositukset parhaasta käyttötarkoituksesta.

API-yleiskatsaus#

Maguyva MCP -API tarjoaa tällä hetkellä 11 asiakkaille näkyvää työkalua 4 pääkategoriassa:

Ydinhakutyökalut - Kehittyneet hakuominaisuudet koko koodikannassasi
Rakenne- ja graafityökalut - AST-kyselyt, symbolihaku ja riippuvuusanalyysi
Koodianalyysityökalut - Syvällinen koodianalyysi ja suhteiden kartoitus
Järjestelmä- ja apuohjelmatyökalut - Repositoriokonteksti, deterministinen laskenta ja ohjeistus

Kaikki työkalut käyttävät yhtenäistä repositoriotunnisteen muoto: "owner/repo:branch". Haara on oletuksena main, jos sitä ei määritetä.

Jätä repository pois, kun MCP-asiakas antaa pyyntökohtaisen oletuksen tai kun avaimella on pääsy täsmälleen yhteen repositoryyn; muussa tapauksessa anna se erikseen. Tarkista komennolla repository_context(action="info", repository="owner/repo"), miten repository ratkaistaan.

Repositorioparametrin muoto#

Kaikki MCP-työkalut käyttävät tätä repositoriotunnisteen muotoa:

Haara mukana: "owner/repo:branch" - esim., "owner/repository:develop"
Oletushaara: "owner/repo" - käyttää main-haaraa, kun haaraa ei ole määritetty "owner/repository"
Pyyntökohtainen tai ainoan repositoryn oletus: Jätä repository pois, kun MCP-asiakas antaa pyyntökohtaisen oletuksen tai kun avaimella on pääsy täsmälleen yhteen repositoryyn; muussa tapauksessa anna se erikseen

Esimerkkikehotteet:

Kysy tietystä reposta:              "Hae todennuksen väliohjelmistoa owner/my-repo"
Listaa käytettävissä olevat repot:  "Mihin tietovarastoihin tällä Maguyva-avaimella pääsee?"
Yhden kyselyn ohitus:               "Hae todennusmalleja owner/other-repo:develop"

Kielisuodatus#

Kaikki hakutyökalut tukevat tulosten suodattamista ohjelmointikielen mukaan:

language_filter="python" - Suodata vain Python-tiedostoihin
language_filter="typescript" - Suodata vain TypeScript-tiedostoihin
Kirjainkoko merkitsee: Käytä kielten nimiä pienillä kirjaimilla
Oletus: Tyhjä merkkijono (ei suodatusta) - palauttaa tuloksia kaikista kielistä
Tuettu kattavuus: Kielisuodattimet kattavat kaikki 279+ tuettua kieltä ja tekstipohjaisia teknologioita. Katso täydellinen luettelo kohdasta yhteensopivuus.

"Etsi autentikointi-middlewarea vain Python-tiedostoista"
"Etsi tietokantayhteyksiä TypeScript-koodista"

API-referenssi luotu lähdekoodista 22. heinäkuuta 2026.

Ydinhakutyökalut#

intelligent_searchVakaa

Aloita tästä kaikissa koodikantaa koskevissa kysymyksissä. Anna luonnollisen kielen kysely (esim. "miten todennus toimii", "missä laskutus käsitellään"), niin työkalu reitittää sen automaattisesti semanttiseen hakuun, symbolihakuun, rakenteelliseen hakuun ja riippuvuushakuun indeksoidussa repossa. Suosi tätä Explore-agentin ja Grep/Glob-työkalujen sijaan tutkimisessa ja suunnittelussa — se hakee koko indeksoidusta reposta kerralla tiedostojen skannaamisen sijaan.

Parametrit:

queryPakollinen

Tyyppi: str
Kuvaus: Hakukysely

repositoryValinnainen

Tyyppi: str
Kuvaus: Repository muodossa owner/repo[:branch]. Valinnainen — jätä pois käyttääksesi asiakkaan pyyntökohtaista oletusta (jos annettu) tai ainoaa käytettävissä olevaa repositorya; anna erikseen vain valitaksesi toisen indeksoidun repon. Vastaus näyttää käytetyn repositoryn.

modeValinnainen

Tyyppi: Literal[auto, hybrid, semantic, text, structural, ast, graph]
Oletus: auto
Kuvaus: Hakutila

limitValinnainen

Tyyppi: int
Oletus: 10
Kuvaus: Enimmäistulosmäärä tässä järjestetyssä top-K-ikkunassa

language_filterValinnainen

Tyyppi: str
Kuvaus: Kielisuodatin

path_filterValinnainen

Tyyppi: str
Kuvaus: Suodata tiedostopolun etuliitteen mukaan

boost_by_importanceValinnainen

Tyyppi: bool
Oletus
Kuvaus: Opt-in: järjestä uudelleen keskeisyyden mukaan käyttäen symbolikohtaisia graafimittareita (is_articulation_point, bridge_count, k_core, centrality jne.). Oletuksena pois päältä agentin kannalta turvallista järjestystä varten (globaalit solmukohdat voivat hukuttaa toteutusosumat); ota käyttöön arkkitehtuurikierroksia varten. Koskee kaikkia 4 modaliteettia, kun jokaisella tuloksella on symbolikytkentä.

branchValinnainen

Tyyppi: str
Kuvaus: Haaran ohitus

qualityValinnainen

Tyyppi: Literal[quick, balanced, thorough]
Oletus: balanced
Kuvaus: Haun laadun esiasetus

include_contentValinnainen

Tyyppi: bool
Oletus: true
Kuvaus: Sisällytä sisältö tuloksiin

explain_routingValinnainen

Tyyppi: bool
Oletus
Kuvaus: Sisällytä reitityspäätöksen selitys

importance_weightValinnainen

Tyyppi: float
Oletus: 0.3
Kuvaus: Tärkeyden lisäämisen paino (0 = ei mitään, 1 = täysi)

orphansValinnainen

Tyyppi: bool
Oletus
Kuvaus: Sisällytä orvot symbolit (ei saapuvia viittauksia)

include_community_contextValinnainen

Tyyppi: bool
Oletus
Kuvaus: Sisällytä samaan koodiyhteisöön liittyvät symbolit

community_depthValinnainen

Tyyppi: int
Oletus: 1
Kuvaus: Yhteisön kontekstin laajenemisen syvyys

graph_viewValinnainen

Tyyppi: Literal[dependency, type, data_flow, control_flow]
Oletus: dependency
Kuvaus: Graafinäkymä mittareille

seed_symbol_idsValinnainen

Tyyppi: list[str]
Kuvaus: Tier-1 tehtäväsiemenet: nykyisen tehtävän keskeiset symbolitunnukset. Kun se on asetettu, sulautetut osumat asetetaan uudelleen järjestykseen Approach A-syvyyden vaimenemisen läheisyyden mukaan (tarkka siemenhaku + kaavion reunan hypyt). Lisäaine – jätä pois globaalista sijoituksesta.

seed_file_pathsValinnainen

Tyyppi: list[str]
Kuvaus: Tier-1 tehtäväsiemenet: indeksoidut tiedostopolut, jotka agentti on avannut tai joita hän on juuri muokannut. Kun se on asetettu, se luokittelee yhdistetyt osumat uudelleen polun läheisyyden mukaan 1/(1+d)-syvyysvajeella (sama tiedosto → sama hakemisto → lähellä olevat paketit). Lisäaine – jätä pois globaalista sijoituksesta.

Parametri	Tyyppi	Pakollinen	Oletus	Kuvaus
`query`	`str`	Kyllä	-	Hakukysely
`repository`	`str`	Ei	-	Repository muodossa owner/repo[:branch]. Valinnainen — jätä pois käyttääksesi asiakkaan pyyntökohtaista oletusta (jos annettu) tai ainoaa käytettävissä olevaa repositorya; anna erikseen vain valitaksesi toisen indeksoidun repon. Vastaus näyttää käytetyn repositoryn.
`mode`	`Literal[auto, hybrid, semantic, text, structural, ast, graph]`	Ei	`auto`	Hakutila
`limit`	`int`	Ei	`10`	Enimmäistulosmäärä tässä järjestetyssä top-K-ikkunassa
`language_filter`	`str`	Ei	-	Kielisuodatin
`path_filter`	`str`	Ei	-	Suodata tiedostopolun etuliitteen mukaan
`boost_by_importance`	`bool`	Ei		Opt-in: järjestä uudelleen keskeisyyden mukaan käyttäen symbolikohtaisia graafimittareita (is_articulation_point, bridge_count, k_core, centrality jne.). Oletuksena pois päältä agentin kannalta turvallista järjestystä varten (globaalit solmukohdat voivat hukuttaa toteutusosumat); ota käyttöön arkkitehtuurikierroksia varten. Koskee kaikkia 4 modaliteettia, kun jokaisella tuloksella on symbolikytkentä.
`branch`	`str`	Ei	-	Haaran ohitus
`quality`	`Literal[quick, balanced, thorough]`	Ei	`balanced`	Haun laadun esiasetus
`include_content`	`bool`	Ei	`true`	Sisällytä sisältö tuloksiin
`explain_routing`	`bool`	Ei		Sisällytä reitityspäätöksen selitys
`importance_weight`	`float`	Ei	`0.3`	Tärkeyden lisäämisen paino (0 = ei mitään, 1 = täysi)
`orphans`	`bool`	Ei		Sisällytä orvot symbolit (ei saapuvia viittauksia)
`include_community_context`	`bool`	Ei		Sisällytä samaan koodiyhteisöön liittyvät symbolit
`community_depth`	`int`	Ei	`1`	Yhteisön kontekstin laajenemisen syvyys
`graph_view`	`Literal[dependency, type, data_flow, control_flow]`	Ei	`dependency`	Graafinäkymä mittareille
`seed_symbol_ids`	`list[str]`	Ei	-	Tier-1 tehtäväsiemenet: nykyisen tehtävän keskeiset symbolitunnukset. Kun se on asetettu, sulautetut osumat asetetaan uudelleen järjestykseen Approach A-syvyyden vaimenemisen läheisyyden mukaan (tarkka siemenhaku + kaavion reunan hypyt). Lisäaine – jätä pois globaalista sijoituksesta.
`seed_file_paths`	`list[str]`	Ei	-	Tier-1 tehtäväsiemenet: indeksoidut tiedostopolut, jotka agentti on avannut tai joita hän on juuri muokannut. Kun se on asetettu, se luokittelee yhdistetyt osumat uudelleen polun läheisyyden mukaan 1/(1+d)-syvyysvajeella (sama tiedosto → sama hakemisto → lähellä olevat paketit). Lisäaine – jätä pois globaalista sijoituksesta.

Parhaiten sopii:

Koko indeksin laajuinen tai kylmäkäynnistyksen tutkiminen, kun oikea työkalu ei ole selvä
Monimodaalinen yhdistetty pisteytys semanttisen, tekstin, rakenteellisen ja graafin välillä

Ei suositella:

Tunnettu symbolin nimi — käytä suoraan find_symbol-työkalua
Tunnettu polku levyllä — käytä ensin paikallista Read/Grep-työkalua

semantic_searchVakaa

Etsi koodia merkityksen, ei tarkan tekstin perusteella. Käytä käsitteellisiin kyselyihin, kuten "retry-logiikka" tai "käyttäjän käyttöönottovirta", kun et tiedä avainsanaa tai symbolin nimeä. Palauttaa osuvimmat koodipalat tärkeyden mukaan järjestettyinä. Suosi tätä Grepin sijaan, kun haku on käsitteellinen.

Parametrit:

queryPakollinen

Tyyppi: str
Kuvaus: Hakulauseke (käsitteellinen, merkityksellinen)

repositoryValinnainen

Tyyppi: str
Kuvaus: Repository muodossa owner/repo[:branch]. Valinnainen — jätä pois käyttääksesi asiakkaan pyyntökohtaista oletusta (jos annettu) tai ainoaa käytettävissä olevaa repositorya; anna erikseen vain valitaksesi toisen indeksoidun repon. Vastaus näyttää käytetyn repositoryn.

limitValinnainen

Tyyppi: int
Oletus: 5
Kuvaus: Enimmäistulosmäärä tässä järjestetyssä top-K-ikkunassa

similarity_thresholdValinnainen

Tyyppi: float
Oletus: 0.6
Kuvaus: Minimi samankaltaisuuspisteet

language_filterValinnainen

Tyyppi: str
Kuvaus: Kielisuodatin (python, typescript jne.)

path_filterValinnainen

Tyyppi: str
Kuvaus: Suodata tiedostopolun etuliitteen mukaan

boost_by_importanceValinnainen

Tyyppi: bool
Oletus
Kuvaus: Opt-in: järjestä uudelleen PageRank-keskeisyyden mukaan (oletuksena pois päältä agentin kannalta turvallista järjestystä varten; ota käyttöön arkkitehtuurikierroksia varten)

branchValinnainen

Tyyppi: str
Kuvaus: Haaran ohitus (oletus: repository-parametrista tai main)

include_contentValinnainen

Tyyppi: bool
Oletus: true
Kuvaus: Sisällytä tuloksiin osasisältö

graph_viewValinnainen

Tyyppi: Literal[dependency, type, data_flow, control_flow]
Oletus: dependency
Kuvaus: Graafinäkymä mittareita varten

Parametri	Tyyppi	Pakollinen	Oletus	Kuvaus
`query`	`str`	Kyllä	-	Hakulauseke (käsitteellinen, merkityksellinen)
`repository`	`str`	Ei	-	Repository muodossa owner/repo[:branch]. Valinnainen — jätä pois käyttääksesi asiakkaan pyyntökohtaista oletusta (jos annettu) tai ainoaa käytettävissä olevaa repositorya; anna erikseen vain valitaksesi toisen indeksoidun repon. Vastaus näyttää käytetyn repositoryn.
`limit`	`int`	Ei	`5`	Enimmäistulosmäärä tässä järjestetyssä top-K-ikkunassa
`similarity_threshold`	`float`	Ei	`0.6`	Minimi samankaltaisuuspisteet
`language_filter`	`str`	Ei	-	Kielisuodatin (python, typescript jne.)
`path_filter`	`str`	Ei	-	Suodata tiedostopolun etuliitteen mukaan
`boost_by_importance`	`bool`	Ei		Opt-in: järjestä uudelleen PageRank-keskeisyyden mukaan (oletuksena pois päältä agentin kannalta turvallista järjestystä varten; ota käyttöön arkkitehtuurikierroksia varten)
`branch`	`str`	Ei	-	Haaran ohitus (oletus: repository-parametrista tai main)
`include_content`	`bool`	Ei	`true`	Sisällytä tuloksiin osasisältö
`graph_view`	`Literal[dependency, type, data_flow, control_flow]`	Ei	`dependency`	Graafinäkymä mittareita varten

Parhaiten sopii:

Käsitteelliset kyselyt (esim. "miten todennus toimii?", "välimuististrategia")
Pakettien välinen samankaltaisuushaku

Ei suositella:

Tunnettu symbolin nimi — käytä sen sijaan find_symbol-työkalua
Tarkat merkkijonot tai virheilmoitukset — käytä text_pattern_search-työkalua

text_pattern_searchVakaa

Hae indeksoitua sisältöä. exact- ja regex-tilat suorittavat grepin koko tiedosto-/blob-korpukselle; fuzzy content -tila hakee rajatusta semanttisten osien korpuksesta. file- ja symbol-scopeissa käytetään vain fuzzy-hakua. Käytä paikallista Grepiä levyllä jo olevalle rajatulle hakemistolle.

Parametrit:

queryPakollinen

Tyyppi: str
Kuvaus: Haettava tekstikuvio

repositoryValinnainen

Tyyppi: str
Kuvaus: Repository muodossa owner/repo[:branch]. Valinnainen — jätä pois käyttääksesi asiakkaan pyyntökohtaista oletusta (jos annettu) tai ainoaa käytettävissä olevaa repositorya; anna erikseen vain valitaksesi toisen indeksoidun repon. Vastaus näyttää käytetyn repositoryn.

modeValinnainen

Tyyppi: Literal[fuzzy, exact, regex]
Oletus: exact
Kuvaus: Hakutila

search_scopeValinnainen

Tyyppi: Literal[content, symbols, files]
Oletus: content
Kuvaus: Mitä etsiä

limitValinnainen

Tyyppi: int
Oletus: 5
Kuvaus: Tällä sivulla palautettujen tulosten enimmäismäärä

offsetValinnainen

Tyyppi: int
Kuvaus: Vanhentunut yhteensopivuus-offset. Suosi cursoria kohteesta pagination.next_cursor.

cursorValinnainen

Tyyppi: str
Kuvaus: Läpinäkymätön cursor kohteesta pagination.next_cursor. Välitä se muuttumattomana ja pidä query ja suodattimet muuttumattomina.

language_filterValinnainen

Tyyppi: str
Kuvaus: Kielisuodatin

path_filterValinnainen

Tyyppi: str
Kuvaus: Suodata tiedostopolun etuliitteen mukaan

case_sensitiveValinnainen

Tyyppi: bool
Oletus
Kuvaus: Kirjainkoon erottelu

branchValinnainen

Tyyppi: str
Kuvaus: Haaran ohitus

fuzzy_algorithmValinnainen

Tyyppi: Literal[hybrid, trigram, levenshtein]
Oletus: hybrid
Kuvaus: Sumea sovitusalgoritmi

thresholdValinnainen

Tyyppi: float
Oletus: 0.05
Kuvaus: Samankaltaisuuden vähimmäiskynnys sumealle

semantic_fallbackValinnainen

Tyyppi: bool
Oletus
Kuvaus: Palaa semanttiseen hakuun, jos ei tuloksia

Parametri	Tyyppi	Pakollinen	Oletus	Kuvaus
`query`	`str`	Kyllä	-	Haettava tekstikuvio
`repository`	`str`	Ei	-	Repository muodossa owner/repo[:branch]. Valinnainen — jätä pois käyttääksesi asiakkaan pyyntökohtaista oletusta (jos annettu) tai ainoaa käytettävissä olevaa repositorya; anna erikseen vain valitaksesi toisen indeksoidun repon. Vastaus näyttää käytetyn repositoryn.
`mode`	`Literal[fuzzy, exact, regex]`	Ei	`exact`	Hakutila
`search_scope`	`Literal[content, symbols, files]`	Ei	`content`	Mitä etsiä
`limit`	`int`	Ei	`5`	Tällä sivulla palautettujen tulosten enimmäismäärä
`offset`	`int`	Ei	-	Vanhentunut yhteensopivuus-offset. Suosi cursoria kohteesta pagination.next_cursor.
`cursor`	`str`	Ei	-	Läpinäkymätön cursor kohteesta pagination.next_cursor. Välitä se muuttumattomana ja pidä query ja suodattimet muuttumattomina.
`language_filter`	`str`	Ei	-	Kielisuodatin
`path_filter`	`str`	Ei	-	Suodata tiedostopolun etuliitteen mukaan
`case_sensitive`	`bool`	Ei		Kirjainkoon erottelu
`branch`	`str`	Ei	-	Haaran ohitus
`fuzzy_algorithm`	`Literal[hybrid, trigram, levenshtein]`	Ei	`hybrid`	Sumea sovitusalgoritmi
`threshold`	`float`	Ei	`0.05`	Samankaltaisuuden vähimmäiskynnys sumealle
`semantic_fallback`	`bool`	Ei		Palaa semanttiseen hakuun, jos ei tuloksia

Parhaiten sopii:

Tarkat merkkijonot, virheilmoitukset ja regex
Trigram-fuzzy-haku lähes osuvalle tekstille

Ei suositella:

Tunnettu polku levyllä — suosi paikallista Grep-työkalua
Käsitteelliset kyselyt — käytä semantic_search-työkalua

Rakenne- ja graafityökalut#

structural_searchVakaa

Suosi preset=functions|classes|methods|imports|variables (tai vapaata pattern=). Löytää koodia AST-muodon perusteella (ei tekstin). Keskitason suodattimet: name_pattern, node_type, decorator, parent_child. Path-/ltree-/call-suodattimet ovat edistyneitä — aseta advanced=true, kun käytät niitä tarkoituksella; litteät advanced-avaimet hyväksytään edelleen taaksepäin yhteensopivuuden vuoksi. Anna vähintään yksi rakenteellinen valitsin.

Parametrit:

repositoryValinnainen

Tyyppi: str
Kuvaus: Repository muodossa owner/repo[:branch]. Valinnainen — jätä pois käyttääksesi asiakkaan pyyntökohtaista oletusta (jos annettu) tai ainoaa käytettävissä olevaa repositorya; anna erikseen vain valitaksesi toisen indeksoidun repon. Vastaus näyttää käytetyn repositoryn.

presetValinnainen

Tyyppi: Literal[functions, classes, methods, imports, variables]
Kuvaus: Ensisijainen rakenteellinen valitsin. Laajenee kieliriippumattomiin AST-solmutyyppeihin — functions (funktio-/arrow-/metodimäärittelyt eri kielissä); classes (class-/struct-/impl-määrittelyt); methods (metodimäärittelyt, sekä function_definition kielille, joissa ei ole metodisolmua); imports (import-/use-/include-lauseet); variables (variable-/let-/const-/static-julistukset). Suositellaan vapaan pattern/node_type-yhdistelmän sijaan selailutyyppisiin kyselyihin.

patternValinnainen

Tyyppi: str
Kuvaus: Free-form-malli, kun presetit ovat liian karkeita (tunnistetaan automaattisesti: 'def foo(' → node_type + name_pattern). Suosi preset= selailukyselyissä.

name_patternValinnainen

Tyyppi: str
Kuvaus: Symbolinimimalli (shell-jokerimerkki, rajattu POSIX-regex tai fuzzy-teksti; enintään 256 merkkiä)

node_typeValinnainen

Tyyppi: str
Kuvaus: AST-solmutyyppi (function_definition, class_definition jne.) — suosi preset= yleisiin muotoihin

decoratorValinnainen

Tyyppi: str
Kuvaus: Dekoraattorin nimen suodatin

base_classValinnainen

Tyyppi: str
Kuvaus: Perusluokan suodatin

language_filterValinnainen

Tyyppi: str
Kuvaus: Kielisuodatin (python, typescript jne.)

limitValinnainen

Tyyppi: int
Oletus: 20
Kuvaus: Tällä sivulla palautettujen tulosten enimmäismäärä

offsetValinnainen

Tyyppi: int
Kuvaus: Vanhentunut yhteensopivuus-offset. Suosi cursoria kohteesta pagination.next_cursor.

cursorValinnainen

Tyyppi: str
Kuvaus: Läpinäkymätön cursor kohteesta pagination.next_cursor. Välitä se muuttumattomana ja pidä query ja suodattimet muuttumattomina.

path_filterValinnainen

Tyyppi: str
Kuvaus: Suodata tiedostopolun etuliitteen mukaan

branchValinnainen

Tyyppi: str
Kuvaus: Haaran ohitus

query_typeValinnainen

Tyyppi: Literal[node_type, name_pattern, parent_child]
Kuvaus: Selkeä kyselytyyppi

parent_typeValinnainen

Tyyppi: str
Kuvaus: Ylätason AST-solmutyyppisuodatin

relationshipValinnainen

Tyyppi: Literal[parent, ancestor]
Oletus: parent
Kuvaus: parent_child-kyselyissä: vain suora parent tai mikä tahansa ancestor (käytä ancestoria luokan bodyn/lohkon alle sisäkkäin määritellyille luokkametodeille)

has_modifierValinnainen

Tyyppi: str
Kuvaus: Suodata muokkaajan mukaan (vienti, asynk., staattinen jne.)

advancedValinnainen

Tyyppi: bool
Oletus
Kuvaus: Aseta true, kun käytät tarkoituksella edistyneitä polku-, ltree- tai puhelusuodattimia (ltree_ancestor, ltree_descendant, min_depth, max_depth, field_role, definition_name, callee_text, callee_name). Oletuksena false pitää agentin käyttöliittymän keskittyneenä esiasetuksiin. Litteän muodon lisänäppäimet toimivat edelleen taaksepäin yhteensopivuuden takaamiseksi metatietovaroituksen kanssa.

callee_textValinnainen

Tyyppi: str
Kuvaus: Edistynyt — suosi preset=functions|classes|methods|imports|variables. Kutsulausekkeen callee-tekstin suodatin. Aseta advanced=true, kun käytät tarkoituksella path-/ltree-/call-suodattimia.

callee_nameValinnainen

Tyyppi: str
Kuvaus: Edistynyt — suosi preset=functions|classes|methods|imports|variables. Kutsulausekkeen callee-nimen suodatin. Aseta advanced=true, kun käytät tarkoituksella path-/ltree-/call-suodattimia.

field_roleValinnainen

Tyyppi: str
Kuvaus: Edistynyt — suosi preset=functions|classes|methods|imports|variables. AST-kenttäroolin suodatin. Aseta advanced=true, kun käytät tarkoituksella path-/ltree-/call-suodattimia.

ltree_ancestorValinnainen

Tyyppi: str
Kuvaus: Edistynyt — suosi preset=functions|classes|methods|imports|variables. AST-ltree-esipolven polun suodatin. Aseta advanced=true, kun käytät tarkoituksella path-/ltree-/call-suodattimia.

ltree_descendantValinnainen

Tyyppi: str
Kuvaus: Edistynyt — suosi preset=functions|classes|methods|imports|variables. AST-ltree-jälkeläispolun suodatin. Aseta advanced=true, kun käytät tarkoituksella path-/ltree-/call-suodattimia.

definition_nameValinnainen

Tyyppi: str
Kuvaus: Edistynyt — suosi preset=functions|classes|methods|imports|variables. Määrittelynimen suodatin. Aseta advanced=true, kun käytät tarkoituksella path-/ltree-/call-suodattimia.

min_depthValinnainen

Tyyppi: int
Kuvaus: Edistynyt — suosi preset=functions|classes|methods|imports|variables. Vähimmäis-AST-syvyys. Aseta advanced=true, kun käytät tarkoituksella path-/ltree-/call-suodattimia.

max_depthValinnainen

Tyyppi: int
Kuvaus: Edistynyt — suosi preset=functions|classes|methods|imports|variables. Enimmäis-AST-syvyys. Aseta advanced=true, kun käytät tarkoituksella path-/ltree-/call-suodattimia.

Parametri	Tyyppi	Pakollinen	Oletus	Kuvaus
`repository`	`str`	Ei	-	Repository muodossa owner/repo[:branch]. Valinnainen — jätä pois käyttääksesi asiakkaan pyyntökohtaista oletusta (jos annettu) tai ainoaa käytettävissä olevaa repositorya; anna erikseen vain valitaksesi toisen indeksoidun repon. Vastaus näyttää käytetyn repositoryn.
`preset`	`Literal[functions, classes, methods, imports, variables]`	Ei	-	Ensisijainen rakenteellinen valitsin. Laajenee kieliriippumattomiin AST-solmutyyppeihin — functions (funktio-/arrow-/metodimäärittelyt eri kielissä); classes (class-/struct-/impl-määrittelyt); methods (metodimäärittelyt, sekä function_definition kielille, joissa ei ole metodisolmua); imports (import-/use-/include-lauseet); variables (variable-/let-/const-/static-julistukset). Suositellaan vapaan pattern/node_type-yhdistelmän sijaan selailutyyppisiin kyselyihin.
`pattern`	`str`	Ei	-	Free-form-malli, kun presetit ovat liian karkeita (tunnistetaan automaattisesti: 'def foo(' → node_type + name_pattern). Suosi preset= selailukyselyissä.
`name_pattern`	`str`	Ei	-	Symbolinimimalli (shell-jokerimerkki, rajattu POSIX-regex tai fuzzy-teksti; enintään 256 merkkiä)
`node_type`	`str`	Ei	-	AST-solmutyyppi (function_definition, class_definition jne.) — suosi preset= yleisiin muotoihin
`decorator`	`str`	Ei	-	Dekoraattorin nimen suodatin
`base_class`	`str`	Ei	-	Perusluokan suodatin
`language_filter`	`str`	Ei	-	Kielisuodatin (python, typescript jne.)
`limit`	`int`	Ei	`20`	Tällä sivulla palautettujen tulosten enimmäismäärä
`offset`	`int`	Ei	-	Vanhentunut yhteensopivuus-offset. Suosi cursoria kohteesta pagination.next_cursor.
`cursor`	`str`	Ei	-	Läpinäkymätön cursor kohteesta pagination.next_cursor. Välitä se muuttumattomana ja pidä query ja suodattimet muuttumattomina.
`path_filter`	`str`	Ei	-	Suodata tiedostopolun etuliitteen mukaan
`branch`	`str`	Ei	-	Haaran ohitus
`query_type`	`Literal[node_type, name_pattern, parent_child]`	Ei	-	Selkeä kyselytyyppi
`parent_type`	`str`	Ei	-	Ylätason AST-solmutyyppisuodatin
`relationship`	`Literal[parent, ancestor]`	Ei	`parent`	parent_child-kyselyissä: vain suora parent tai mikä tahansa ancestor (käytä ancestoria luokan bodyn/lohkon alle sisäkkäin määritellyille luokkametodeille)
`has_modifier`	`str`	Ei	-	Suodata muokkaajan mukaan (vienti, asynk., staattinen jne.)
`advanced`	`bool`	Ei		Aseta true, kun käytät tarkoituksella edistyneitä polku-, ltree- tai puhelusuodattimia (ltree_ancestor, ltree_descendant, min_depth, max_depth, field_role, definition_name, callee_text, callee_name). Oletuksena false pitää agentin käyttöliittymän keskittyneenä esiasetuksiin. Litteän muodon lisänäppäimet toimivat edelleen taaksepäin yhteensopivuuden takaamiseksi metatietovaroituksen kanssa.
`callee_text`	`str`	Ei	-	Edistynyt — suosi preset=functions\|classes\|methods\|imports\|variables. Kutsulausekkeen callee-tekstin suodatin. Aseta advanced=true, kun käytät tarkoituksella path-/ltree-/call-suodattimia.
`callee_name`	`str`	Ei	-	Edistynyt — suosi preset=functions\|classes\|methods\|imports\|variables. Kutsulausekkeen callee-nimen suodatin. Aseta advanced=true, kun käytät tarkoituksella path-/ltree-/call-suodattimia.
`field_role`	`str`	Ei	-	Edistynyt — suosi preset=functions\|classes\|methods\|imports\|variables. AST-kenttäroolin suodatin. Aseta advanced=true, kun käytät tarkoituksella path-/ltree-/call-suodattimia.
`ltree_ancestor`	`str`	Ei	-	Edistynyt — suosi preset=functions\|classes\|methods\|imports\|variables. AST-ltree-esipolven polun suodatin. Aseta advanced=true, kun käytät tarkoituksella path-/ltree-/call-suodattimia.
`ltree_descendant`	`str`	Ei	-	Edistynyt — suosi preset=functions\|classes\|methods\|imports\|variables. AST-ltree-jälkeläispolun suodatin. Aseta advanced=true, kun käytät tarkoituksella path-/ltree-/call-suodattimia.
`definition_name`	`str`	Ei	-	Edistynyt — suosi preset=functions\|classes\|methods\|imports\|variables. Määrittelynimen suodatin. Aseta advanced=true, kun käytät tarkoituksella path-/ltree-/call-suodattimia.
`min_depth`	`int`	Ei	-	Edistynyt — suosi preset=functions\|classes\|methods\|imports\|variables. Vähimmäis-AST-syvyys. Aseta advanced=true, kun käytät tarkoituksella path-/ltree-/call-suodattimia.
`max_depth`	`int`	Ei	-	Edistynyt — suosi preset=functions\|classes\|methods\|imports\|variables. Enimmäis-AST-syvyys. Aseta advanced=true, kun käytät tarkoituksella path-/ltree-/call-suodattimia.

Parhaiten sopii:

Rakenne AST-tasolla: classes, decorators, function-/method-presetit
Koodin löytäminen muodon, ei tekstin, perusteella

Ei suositella:

Vapaa teksti tai käsitteelliset kyselyt — käytä semantic_search- tai intelligent_search-työkalua

dependency_searchVakaa

Ensisijainen vaikutussäde-/graafipinta. Vastaa kysymyksiin "mikä kutsuu tätä?" / "mitä tämä käyttää?" todellisen kutsu-/tuontigraafin kautta. Vaikutuksen tarkistamiseen ennen muokkausta: analysis_type="dependents" tai analysis_type="impact" (saapuva, oletuksena shallow impact-tilassa), include_metrics=false oletuksena (voidaan ottaa käyttöön centrality + refactor_risk -tietoja varten). PR-/diff-vaikutus (P1-8): välitä changed_paths ja/tai patch (unified diff) — ratkaisee symbolit polkukohtaisesti ja palauttaa kompaktin, matalasti saapuvan dependents-hyötykuorman ilman symbolin nimeä. Muokkauksen jälkeen aseta verify_after_edit=true yhdessä targets- ja/tai changed_paths-parametrien kanssa kompaktia moni-juurista uudelleenkyselyä varten vaikutuksen alaisille symboleille. Tukee myös dependencies-, centrality- ja orphans-toimintoja. analyze_dependencies on ohut alias impact-polulle — suosi tätä työkalua uusille agenteille.

Parametrit:

repositoryValinnainen

Tyyppi: str
Kuvaus: Repository muodossa owner/repo[:branch]. Valinnainen — jätä pois käyttääksesi asiakkaan pyyntökohtaista oletusta (jos annettu) tai ainoaa käytettävissä olevaa repositorya; anna erikseen vain valitaksesi toisen indeksoidun repon. Vastaus näyttää käytetyn repositoryn.

queryValinnainen

Tyyppi: str
Kuvaus: Symbolin nimi tai hakutermi

targetValinnainen

Tyyppi: str
Kuvaus: Symbolin nimi (alias kyselylle)

changed_pathsValinnainen

Tyyppi: list[str]
Kuvaus: Repo-relatiiviset polut PR/diff-vaikutukselle (oletus) tai verify_after_edit=true:n kanssa, tarkista juuret muokkauksen jälkeen. PR/diff: ratkaisee symbolit polkukohtaisesti ja kävelee matalia saapuvia huollettavia; voidaan yhdistää patch=:n kanssa. Vahvista: ratkaisee enintään 5 symbolia polkua kohden vahvistusjuuriksi (rajoitettu alempi vahvistustilassa). Ei vaadi query/target PR/diff-iskua varten.

patchValinnainen

Tyyppi: str
Kuvaus: PR/diff vaikutus: yhtenäinen diff / git korjausteksti. Polut jäsennetään diff --git / --- / +++ otsikoista; sama kompakti törmäysrata kuin changed_paths.

analysis_typeValinnainen

Tyyppi: Literal[centrality, dependencies, dependents, impact, orphans]
Oletus: dependencies
Kuvaus: Analyysitila. impact = vaikutussäde (saapuvat dependents; shallow-syvyys, kun depth on jätetty pois). dependents vastaa myös impact-kyselyyn. Kun changed_paths tai patch on asetettu, analyysi pakotetaan PR-/diff-vaikutukseksi. centrality/orphans eivät vaadi targetia.

depthValinnainen

Tyyppi: Literal[shallow, balanced, deep]
Oletus: balanced
Kuvaus: Läpikäyntisyvyys. Kun analysis_type=impact tai kyseessä on PR-/diff-vaikutus, oletusarvo on käytännössä shallow, ellet aseta depth-arvoa erikseen.

limitValinnainen

Tyyppi: int
Oletus: 20
Kuvaus: Tällä sivulla palautettujen tulosten enimmäismäärä

offsetValinnainen

Tyyppi: int
Kuvaus: Vanhentunut yhteensopivuus-offset. Suosi cursoria kohteesta pagination.next_cursor.

cursorValinnainen

Tyyppi: str
Kuvaus: Läpinäkymätön cursor kohteesta pagination.next_cursor. Välitä se muuttumattomana ja pidä query ja suodattimet muuttumattomina.

path_filterValinnainen

Tyyppi: str
Kuvaus: Rajoittaa kohdesymbolin ratkaisun tiedostopolun etuliitteeseen; palautetut graafisuhteet voivat ulottua kyseisen polun ulkopuolelle

language_filterValinnainen

Tyyppi: str
Kuvaus: Suodattaa kohteen ratkaisun ja selailutulokset kielen mukaan

directionValinnainen

Tyyppi: Literal[outgoing, incoming, both]
Kuvaus: Kulkusuunta (ohittaa analysis_type-päätelmän)

relationship_typesValinnainen

Tyyppi: list[str]
Kuvaus: Suodattaa reunatyypit (CALL, IMPORT, INHERITS_FROM jne.). Ei-tyhjä lista ohittaa graph_view-oletusarvot.

exclude_test_pathsValinnainen

Tyyppi: bool
Oletus: true
Kuvaus: Oletuksena true: sulkee testi-, fixture-, vendor- ja esimerkkipolut pois läpikäynti- ja keskeisyystuloksista. Aseta false sisällyttääksesi ne. Orphan-analyysi käyttää aina omia tiukempia kohinasuodatuksiaan.

exclude_generated_pathsValinnainen

Tyyppi: bool
Oletus
Kuvaus: Sulje pois luodut ilmoitukset sekä koonti, kattavuus, välimuisti, lähdekartta ja minimoidut artefaktipolut läpikulkutuloksista

include_module_symbolsValinnainen

Tyyppi: bool
Oletus
Kuvaus: Oletuksena false sulkee pois kuvaajan reunat, kun from_name tai to_name on synteettinen __module__-symboli (moduulitason kohina). Aseta true sisällyttämään moduulitason reunat riippuvuus- ja riippuvuussuhteiden tuloksiin.

branchValinnainen

Tyyppi: str
Kuvaus: Haaran ohitus

per_hop_limitValinnainen

Tyyppi: int
Kuvaus: Suhteiden enimmäismäärä per hyppy (1-300)

include_metricsValinnainen

Tyyppi: bool
Oletus
Kuvaus: Valinnaiset graafimittarit tulosriveillä (tiivistetty refactor_risk-tiedon kanssa). Mittarit haetaan myös sisäisesti, kun min_centrality>0, mutta palautetaan vain, kun tämä on true.

metrics_detailValinnainen

Tyyppi: Literal[summary, full]
Oletus: summary
Kuvaus: Kun include_metrics=true: summary (oletus) palauttaa päätössignaalit + refactor_risk; full palauttaa suuremman kuratoidun metrijoukon

include_edge_metadataValinnainen

Tyyppi: bool
Oletus
Kuvaus: Sisällytä raakareunan metatiedot ja painot (suuri). Pienikokoiset hyötykuormat jättävät tämän pois.

symbol_typesValinnainen

Tyyppi: list[str]
Kuvaus: Suodattaa palautetut symbolit tyypin mukaan (function, class, method jne.)

exact_matchValinnainen

Tyyppi: bool
Oletus
Kuvaus: Vaadi tarkka symbolin nimen vastaavuus

find_similar_patternsValinnainen

Tyyppi: bool
Oletus
Kuvaus: Etsi samanlaisia käyttömalleja

min_centralityValinnainen

Tyyppi: float
Oletus: 0
Kuvaus: Pienin PageRank-pistemäärä. Mittarit haetaan sisäisesti suodatusta varten; graph_metrics palautetaan vain, kun include_metrics=true.

graph_viewValinnainen

Tyyppi: Literal[dependency, type, data_flow, control_flow]
Oletus: dependency
Kuvaus: Graafinäkymä, jota käytetään läpikäyntisuhteiden oletusarvoihin, mittareihin ja keskeisyysjärjestykseen; orphan-analyysi lasketaan kaikkien näkymien yli

verify_after_editValinnainen

Tyyppi: bool
Oletus
Kuvaus: P2-7 muokkauksen jälkeinen vahvistustila: kysy uudelleen indeksoidusta vaikutuskaaviosta äskettäin muokatuista symboleista yhdessä kompaktissa monijuurisessa vastauksessa. Vaatii targets ja/tai changed_paths (tai target/query). Oletuksena matalalle saapuville huollettaville; tulokset heijastavat indeksoitua kaaviota (voi viivästyä live-muokkauksissa). Kun tosi, se on etusijalla PR/diff-vaikutuksiin nähden samassa changed_paths:ssä.

targetsValinnainen

Tyyppi: list[str]
Kuvaus: Kun verify_after_edit=true: symbolien nimet, jotka tarkistetaan uudelleen (soittajat/huollettavat). Yhdistetty target/query:n kanssa, jos molemmat toimitetaan.

Parametri	Tyyppi	Pakollinen	Oletus	Kuvaus
`repository`	`str`	Ei	-	Repository muodossa owner/repo[:branch]. Valinnainen — jätä pois käyttääksesi asiakkaan pyyntökohtaista oletusta (jos annettu) tai ainoaa käytettävissä olevaa repositorya; anna erikseen vain valitaksesi toisen indeksoidun repon. Vastaus näyttää käytetyn repositoryn.
`query`	`str`	Ei	-	Symbolin nimi tai hakutermi
`target`	`str`	Ei	-	Symbolin nimi (alias kyselylle)
`changed_paths`	`list[str]`	Ei	-	Repo-relatiiviset polut PR/diff-vaikutukselle (oletus) tai verify_after_edit=true:n kanssa, tarkista juuret muokkauksen jälkeen. PR/diff: ratkaisee symbolit polkukohtaisesti ja kävelee matalia saapuvia huollettavia; voidaan yhdistää patch=:n kanssa. Vahvista: ratkaisee enintään 5 symbolia polkua kohden vahvistusjuuriksi (rajoitettu alempi vahvistustilassa). Ei vaadi query/target PR/diff-iskua varten.
`patch`	`str`	Ei	-	PR/diff vaikutus: yhtenäinen diff / git korjausteksti. Polut jäsennetään diff --git / --- / +++ otsikoista; sama kompakti törmäysrata kuin changed_paths.
`analysis_type`	`Literal[centrality, dependencies, dependents, impact, orphans]`	Ei	`dependencies`	Analyysitila. impact = vaikutussäde (saapuvat dependents; shallow-syvyys, kun depth on jätetty pois). dependents vastaa myös impact-kyselyyn. Kun changed_paths tai patch on asetettu, analyysi pakotetaan PR-/diff-vaikutukseksi. centrality/orphans eivät vaadi targetia.
`depth`	`Literal[shallow, balanced, deep]`	Ei	`balanced`	Läpikäyntisyvyys. Kun analysis_type=impact tai kyseessä on PR-/diff-vaikutus, oletusarvo on käytännössä shallow, ellet aseta depth-arvoa erikseen.
`limit`	`int`	Ei	`20`	Tällä sivulla palautettujen tulosten enimmäismäärä
`offset`	`int`	Ei	-	Vanhentunut yhteensopivuus-offset. Suosi cursoria kohteesta pagination.next_cursor.
`cursor`	`str`	Ei	-	Läpinäkymätön cursor kohteesta pagination.next_cursor. Välitä se muuttumattomana ja pidä query ja suodattimet muuttumattomina.
`path_filter`	`str`	Ei	-	Rajoittaa kohdesymbolin ratkaisun tiedostopolun etuliitteeseen; palautetut graafisuhteet voivat ulottua kyseisen polun ulkopuolelle
`language_filter`	`str`	Ei	-	Suodattaa kohteen ratkaisun ja selailutulokset kielen mukaan
`direction`	`Literal[outgoing, incoming, both]`	Ei	-	Kulkusuunta (ohittaa analysis_type-päätelmän)
`relationship_types`	`list[str]`	Ei	-	Suodattaa reunatyypit (CALL, IMPORT, INHERITS_FROM jne.). Ei-tyhjä lista ohittaa graph_view-oletusarvot.
`exclude_test_paths`	`bool`	Ei	`true`	Oletuksena true: sulkee testi-, fixture-, vendor- ja esimerkkipolut pois läpikäynti- ja keskeisyystuloksista. Aseta false sisällyttääksesi ne. Orphan-analyysi käyttää aina omia tiukempia kohinasuodatuksiaan.
`exclude_generated_paths`	`bool`	Ei		Sulje pois luodut ilmoitukset sekä koonti, kattavuus, välimuisti, lähdekartta ja minimoidut artefaktipolut läpikulkutuloksista
`include_module_symbols`	`bool`	Ei		Oletuksena false sulkee pois kuvaajan reunat, kun from_name tai to_name on synteettinen __module__-symboli (moduulitason kohina). Aseta true sisällyttämään moduulitason reunat riippuvuus- ja riippuvuussuhteiden tuloksiin.
`branch`	`str`	Ei	-	Haaran ohitus
`per_hop_limit`	`int`	Ei	-	Suhteiden enimmäismäärä per hyppy (1-300)
`include_metrics`	`bool`	Ei		Valinnaiset graafimittarit tulosriveillä (tiivistetty refactor_risk-tiedon kanssa). Mittarit haetaan myös sisäisesti, kun min_centrality>0, mutta palautetaan vain, kun tämä on true.
`metrics_detail`	`Literal[summary, full]`	Ei	`summary`	Kun include_metrics=true: summary (oletus) palauttaa päätössignaalit + refactor_risk; full palauttaa suuremman kuratoidun metrijoukon
`include_edge_metadata`	`bool`	Ei		Sisällytä raakareunan metatiedot ja painot (suuri). Pienikokoiset hyötykuormat jättävät tämän pois.
`symbol_types`	`list[str]`	Ei	-	Suodattaa palautetut symbolit tyypin mukaan (function, class, method jne.)
`exact_match`	`bool`	Ei		Vaadi tarkka symbolin nimen vastaavuus
`find_similar_patterns`	`bool`	Ei		Etsi samanlaisia käyttömalleja
`min_centrality`	`float`	Ei	`0`	Pienin PageRank-pistemäärä. Mittarit haetaan sisäisesti suodatusta varten; graph_metrics palautetaan vain, kun include_metrics=true.
`graph_view`	`Literal[dependency, type, data_flow, control_flow]`	Ei	`dependency`	Graafinäkymä, jota käytetään läpikäyntisuhteiden oletusarvoihin, mittareihin ja keskeisyysjärjestykseen; orphan-analyysi lasketaan kaikkien näkymien yli
`verify_after_edit`	`bool`	Ei		P2-7 muokkauksen jälkeinen vahvistustila: kysy uudelleen indeksoidusta vaikutuskaaviosta äskettäin muokatuista symboleista yhdessä kompaktissa monijuurisessa vastauksessa. Vaatii targets ja/tai changed_paths (tai target/query). Oletuksena matalalle saapuville huollettaville; tulokset heijastavat indeksoitua kaaviota (voi viivästyä live-muokkauksissa). Kun tosi, se on etusijalla PR/diff-vaikutuksiin nähden samassa changed_paths:ssä.
`targets`	`list[str]`	Ei	-	Kun verify_after_edit=true: symbolien nimet, jotka tarkistetaan uudelleen (soittajat/huollettavat). Yhdistetty target/query:n kanssa, jos molemmat toimitetaan.

Parhaiten sopii:

Vaikutussäde-/vaikutusanalyysi ennen jaetun symbolin muokkaamista
PR-/diff-vaikutus changed_paths- tai patch-parametrin kautta
Muokkauksen jälkeinen tarkistus verify_after_edit-parametrilla

Ei suositella:

Yksinkertaiset teksti- tai symbolihaut — käytä text_pattern_search- tai find_symbol-työkalua

Koodianalyysityökalut#

find_symbolVakaa

Siirry kohtaan, jossa funktio, luokka tai muuttuja määritellään ja sitä käytetään. Käytä, kun tiedät nimen (esim. "getCurrentUser") — tämä on Grepiä nopeampi ja tarkempi ja kattaa koko indeksoidun repon. Palauttaa valinnaisesti viittaukset ja tärkeysmittarit.

Parametrit:

symbol_nameValinnainen

Tyyppi: str
Kuvaus: Haettavan symbolin nimi (valinnainen — jätä pois, jos haluat selata mittareiden mukaan)

repositoryValinnainen

Tyyppi: str
Kuvaus: Repository muodossa owner/repo[:branch]. Valinnainen — jätä pois käyttääksesi asiakkaan pyyntökohtaista oletusta (jos annettu) tai ainoaa käytettävissä olevaa repositorya; anna erikseen vain valitaksesi toisen indeksoidun repon. Vastaus näyttää käytetyn repositoryn.

scopeValinnainen

Tyyppi: Literal[definitions, references, both]
Oletus: both
Kuvaus: Haun laajuus

limitValinnainen

Tyyppi: int
Oletus: 15
Kuvaus: Tällä sivulla palautettujen tulosten enimmäismäärä

offsetValinnainen

Tyyppi: int
Kuvaus: Vanhentunut yhteensopivuus-offset. Suosi cursoria kohteesta pagination.next_cursor.

cursorValinnainen

Tyyppi: str
Kuvaus: Läpinäkymätön cursor kohteesta pagination.next_cursor. Välitä se muuttumattomana ja pidä query ja suodattimet muuttumattomina.

find_similarValinnainen

Tyyppi: bool
Oletus
Kuvaus: Sisällytä samanlaiset symbolien nimet

include_metricsValinnainen

Tyyppi: bool
Oletus
Kuvaus: Sisällytä keskeisyysmittarit

metrics_detailValinnainen

Tyyppi: Literal[summary, full]
Oletus: summary
Kuvaus: Kun include_metrics=true: summary (oletus) palauttaa päätössignaalit + refactor_risk; full palauttaa suuremman kuratoidun metrijoukon

path_filterValinnainen

Tyyppi: str
Kuvaus: Suodata tiedostopolun etuliitteen mukaan

branchValinnainen

Tyyppi: str
Kuvaus: Haaran ohitus

symbol_typeValinnainen

Tyyppi: Literal[function, class, variable, method, constant, module, interface, type]
Kuvaus: Suodata symbolityypin mukaan

high_impactValinnainen

Tyyppi: bool
Oletus
Kuvaus: Selaa arkkitehtonisesti tärkeitä symboleita (jätä symbol_name pois). Oletustila on popularity (ylin PageRank-desiili miinus utility-megasolmukohdat). Aseta high_impact_mode=risk artikulaatio-/silta-leikkauspisteitä varten.

high_impact_modeValinnainen

Tyyppi: Literal[popularity, risk]
Oletus: popularity
Kuvaus: Kun high_impact=true: suosio = huippu PageRank-desiili miinus apuohjelman megakeskittimet/moduulit; riski = artikulaatiopisteet järjestykseen SMV bridge_count ja sitten k_core (rakenteellisen refaktorin riski, ei keskittimen suosio)

in_cycleValinnainen

Tyyppi: bool
Oletus
Kuvaus: Suodata symboleihin riippuvuusjaksoissa

exclude_test_pathsValinnainen

Tyyppi: bool
Oletus: true
Kuvaus: Kun selaat kaaviomittareita, sulje pois testit, fixtures, kolmannen osapuolen koodit ja esimerkit ennen sijoitusta. Nimetyn symbolin haku ei muutu.

Parametri	Tyyppi	Pakollinen	Oletus	Kuvaus
`symbol_name`	`str`	Ei	-	Haettavan symbolin nimi (valinnainen — jätä pois, jos haluat selata mittareiden mukaan)
`repository`	`str`	Ei	-	Repository muodossa owner/repo[:branch]. Valinnainen — jätä pois käyttääksesi asiakkaan pyyntökohtaista oletusta (jos annettu) tai ainoaa käytettävissä olevaa repositorya; anna erikseen vain valitaksesi toisen indeksoidun repon. Vastaus näyttää käytetyn repositoryn.
`scope`	`Literal[definitions, references, both]`	Ei	`both`	Haun laajuus
`limit`	`int`	Ei	`15`	Tällä sivulla palautettujen tulosten enimmäismäärä
`offset`	`int`	Ei	-	Vanhentunut yhteensopivuus-offset. Suosi cursoria kohteesta pagination.next_cursor.
`cursor`	`str`	Ei	-	Läpinäkymätön cursor kohteesta pagination.next_cursor. Välitä se muuttumattomana ja pidä query ja suodattimet muuttumattomina.
`find_similar`	`bool`	Ei		Sisällytä samanlaiset symbolien nimet
`include_metrics`	`bool`	Ei		Sisällytä keskeisyysmittarit
`metrics_detail`	`Literal[summary, full]`	Ei	`summary`	Kun include_metrics=true: summary (oletus) palauttaa päätössignaalit + refactor_risk; full palauttaa suuremman kuratoidun metrijoukon
`path_filter`	`str`	Ei	-	Suodata tiedostopolun etuliitteen mukaan
`branch`	`str`	Ei	-	Haaran ohitus
`symbol_type`	`Literal[function, class, variable, method, constant, module, interface, type]`	Ei	-	Suodata symbolityypin mukaan
`high_impact`	`bool`	Ei		Selaa arkkitehtonisesti tärkeitä symboleita (jätä symbol_name pois). Oletustila on popularity (ylin PageRank-desiili miinus utility-megasolmukohdat). Aseta high_impact_mode=risk artikulaatio-/silta-leikkauspisteitä varten.
`high_impact_mode`	`Literal[popularity, risk]`	Ei	`popularity`	Kun high_impact=true: suosio = huippu PageRank-desiili miinus apuohjelman megakeskittimet/moduulit; riski = artikulaatiopisteet järjestykseen SMV bridge_count ja sitten k_core (rakenteellisen refaktorin riski, ei keskittimen suosio)
`in_cycle`	`bool`	Ei		Suodata symboleihin riippuvuusjaksoissa
`exclude_test_paths`	`bool`	Ei	`true`	Kun selaat kaaviomittareita, sulje pois testit, fixtures, kolmannen osapuolen koodit ja esimerkit ennen sijoitusta. Nimetyn symbolin haku ei muutu.

Parhaiten sopii:

Tunnetun symbolin määrittelyn, viittausten ja graafimittareiden kiinnittäminen
Selaaminen centrality-, high_impact- tai in_cycle-parametrin mukaan, kun symbol_name jätetään pois

Ei suositella:

Käsitteelliset kyselyt tai tuntemattoman alueen kyselyt — käytä intelligent_search- tai semantic_search-työkalua

analyze_dependenciesVakaa

Alias vaikutussäteelle dependency_search-työkalun kautta (dependents/incoming). Suosi dependency_search-työkalua parametrilla analysis_type="dependents" tai "impact" uusille agenteille. Säilyttää vanhan moni-hyppyisen impact-vastausmuodon (graph, connection_summary, valinnaiset mittarit refactor_risk-tiedolla). Käytä graph_view-parametria rajaamaan suhdeperhettä: dependency (oletus), type, data_flow, control_flow.

Parametrit:

repositoryValinnainen

Tyyppi: str
Kuvaus: Repository muodossa owner/repo[:branch]. Valinnainen — jätä pois käyttääksesi asiakkaan pyyntökohtaista oletusta (jos annettu) tai ainoaa käytettävissä olevaa repositorya; anna erikseen vain valitaksesi toisen indeksoidun repon. Vastaus näyttää käytetyn repositoryn.

targetPakollinen

Tyyppi: str
Kuvaus: Analysoitava symbolin nimi

depthValinnainen

Tyyppi: Literal[shallow, balanced, deep]
Oletus: balanced
Kuvaus: Analyysin syvyys

limitValinnainen

Tyyppi: int
Oletus: 10
Kuvaus: Tällä sivulla palautettujen tulosten enimmäismäärä

offsetValinnainen

Tyyppi: int
Kuvaus: Vanhentunut yhteensopivuus-offset. Suosi cursoria kohteesta pagination.next_cursor.

cursorValinnainen

Tyyppi: str
Kuvaus: Läpinäkymätön cursor kohteesta pagination.next_cursor. Välitä se muuttumattomana ja pidä query ja suodattimet muuttumattomina.

directionValinnainen

Tyyppi: Literal[incoming, outgoing, both]
Oletus: incoming
Kuvaus: Kulkusuunta

relationship_typesValinnainen

Tyyppi: list[str]
Kuvaus: Suodattimen reunatyypit (CALL, IMPORT, INHERITS_FROM jne.). Ohittaa aina alla olevan graph_view-oletuksen, kun se toimitetaan.

graph_viewValinnainen

Tyyppi: Literal[dependency, type, data_flow, control_flow]
Oletus: dependency
Kuvaus: Graafinäkymä: määrittää sekä läpikäynnin oletusreunatyypit että sen, minkä näkymän mittareita käytetään, kun include_metrics=true. dependency=[CALL,IMPORT,EXPORTS,REFERENCE,INSTANTIATES] (oletus), type=[INHERITS_FROM,IMPLEMENTS,OVERRIDE,DECORATES,OF_TYPE], data_flow=[READS,WRITES,ASSIGNS_TO], control_flow=[CONTROL_FLOW,THROWS,CATCHES]. Käytetään relationship_types-oletuksena vain, kun relationship_types-parametria ei anneta erikseen. Nimi vastaa dependency_search-työkalun graph_view-parametria työkalujen yhdenmukaisuuden vuoksi.

path_filterValinnainen

Tyyppi: str
Kuvaus: Rajoittaa kohdesymbolin ratkaisun tiedostopolun etuliitteeseen; palautetut graafisuhteet voivat ulottua kyseisen polun ulkopuolelle

language_filterValinnainen

Tyyppi: str
Kuvaus: Kielisuodatin

branchValinnainen

Tyyppi: str
Kuvaus: Haaran ohitus

per_hop_limitValinnainen

Tyyppi: int
Kuvaus: Suhteiden enimmäismäärä per hyppy (1-300)

include_metricsValinnainen

Tyyppi: bool
Oletus
Kuvaus: Sisällytä tuloksiin graafimittarit, joista jokainen on rikastettu johdetulla refactor_risk-lohkolla ({risk: "low"|"medium"|"high", is_articulation_point, bridge_count, k_core, graph_view, reasons}). risk on "low", kun symboli ei ole valitussa näkymässä articulation point, "medium", kun articulation point yhdistää muutamia reunoja, ja "high", kun se yhdistää monia (heuristinen kynnys, ei empiirisesti validoitu). Lohko jätetään symbolikohtaisesti pois, kun symbolille ja näkymälle ei ole mittaririviä.

metrics_detailValinnainen

Tyyppi: Literal[summary, full]
Oletus: summary
Kuvaus: Kun include_metrics=true: summary (oletus) palauttaa päätössignaalit + refactor_risk; full palauttaa suuremman kuratoidun metrijoukon

include_edge_metadataValinnainen

Tyyppi: bool
Oletus
Kuvaus: Sisällytä raakareunan metatiedot ja painot. Oletusarvoisesti poissa käytöstä, koska poimijan metatiedot voivat olla suuria. rikastuksen kattavuus raportoidaan, kun se on käytössä.

exclude_test_pathsValinnainen

Tyyppi: bool
Oletus: true
Kuvaus: Oletus-true: sulje pois testi-, kiinnitys-, toimittaja- ja esimerkkipolut palautetuista kaavion reunoista. Aseta false sisällyttämään ne.

include_module_symbolsValinnainen

Tyyppi: bool
Oletus
Kuvaus: Oletuksena false sulkee pois kuvaajan reunat, kun from_name tai to_name on synteettinen __module__-symboli. Aseta true sisällyttämään moduulitason reunat.

Parametri	Tyyppi	Pakollinen	Oletus	Kuvaus
`repository`	`str`	Ei	-	Repository muodossa owner/repo[:branch]. Valinnainen — jätä pois käyttääksesi asiakkaan pyyntökohtaista oletusta (jos annettu) tai ainoaa käytettävissä olevaa repositorya; anna erikseen vain valitaksesi toisen indeksoidun repon. Vastaus näyttää käytetyn repositoryn.
`target`	`str`	Kyllä	-	Analysoitava symbolin nimi
`depth`	`Literal[shallow, balanced, deep]`	Ei	`balanced`	Analyysin syvyys
`limit`	`int`	Ei	`10`	Tällä sivulla palautettujen tulosten enimmäismäärä
`offset`	`int`	Ei	-	Vanhentunut yhteensopivuus-offset. Suosi cursoria kohteesta pagination.next_cursor.
`cursor`	`str`	Ei	-	Läpinäkymätön cursor kohteesta pagination.next_cursor. Välitä se muuttumattomana ja pidä query ja suodattimet muuttumattomina.
`direction`	`Literal[incoming, outgoing, both]`	Ei	`incoming`	Kulkusuunta
`relationship_types`	`list[str]`	Ei	-	Suodattimen reunatyypit (CALL, IMPORT, INHERITS_FROM jne.). Ohittaa aina alla olevan graph_view-oletuksen, kun se toimitetaan.
`graph_view`	`Literal[dependency, type, data_flow, control_flow]`	Ei	`dependency`	Graafinäkymä: määrittää sekä läpikäynnin oletusreunatyypit että sen, minkä näkymän mittareita käytetään, kun include_metrics=true. dependency=[CALL,IMPORT,EXPORTS,REFERENCE,INSTANTIATES] (oletus), type=[INHERITS_FROM,IMPLEMENTS,OVERRIDE,DECORATES,OF_TYPE], data_flow=[READS,WRITES,ASSIGNS_TO], control_flow=[CONTROL_FLOW,THROWS,CATCHES]. Käytetään relationship_types-oletuksena vain, kun relationship_types-parametria ei anneta erikseen. Nimi vastaa dependency_search-työkalun graph_view-parametria työkalujen yhdenmukaisuuden vuoksi.
`path_filter`	`str`	Ei	-	Rajoittaa kohdesymbolin ratkaisun tiedostopolun etuliitteeseen; palautetut graafisuhteet voivat ulottua kyseisen polun ulkopuolelle
`language_filter`	`str`	Ei	-	Kielisuodatin
`branch`	`str`	Ei	-	Haaran ohitus
`per_hop_limit`	`int`	Ei	-	Suhteiden enimmäismäärä per hyppy (1-300)
`include_metrics`	`bool`	Ei		Sisällytä tuloksiin graafimittarit, joista jokainen on rikastettu johdetulla refactor_risk-lohkolla ({risk: "low"\|"medium"\|"high", is_articulation_point, bridge_count, k_core, graph_view, reasons}). risk on "low", kun symboli ei ole valitussa näkymässä articulation point, "medium", kun articulation point yhdistää muutamia reunoja, ja "high", kun se yhdistää monia (heuristinen kynnys, ei empiirisesti validoitu). Lohko jätetään symbolikohtaisesti pois, kun symbolille ja näkymälle ei ole mittaririviä.
`metrics_detail`	`Literal[summary, full]`	Ei	`summary`	Kun include_metrics=true: summary (oletus) palauttaa päätössignaalit + refactor_risk; full palauttaa suuremman kuratoidun metrijoukon
`include_edge_metadata`	`bool`	Ei		Sisällytä raakareunan metatiedot ja painot. Oletusarvoisesti poissa käytöstä, koska poimijan metatiedot voivat olla suuria. rikastuksen kattavuus raportoidaan, kun se on käytössä.
`exclude_test_paths`	`bool`	Ei	`true`	Oletus-true: sulje pois testi-, kiinnitys-, toimittaja- ja esimerkkipolut palautetuista kaavion reunoista. Aseta false sisällyttämään ne.
`include_module_symbols`	`bool`	Ei		Oletuksena false sulkee pois kuvaajan reunat, kun from_name tai to_name on synteettinen __module__-symboli. Aseta true sisällyttämään moduulitason reunat.

Parhaiten sopii:

Vanhat kutsujat, jotka on jo kytketty sen vastausmuotoon (graph, connection_summary)

Ei suositella:

Uudet agenttisilmukat — suosi dependency_search-työkalua, joka jakaa saman läpikäyntiytimen

get_task_contextVakaa

Aloitatko työskentelyn vieraalla alueella? Kuvaile tehtävä (esim. "lisää SSO-tuki", "korjaa laskutuksen webhook") ja saat rajatussa yhdessä kutsussa nipun relevantteja tiedostoja, koodia, symboleita ja riippuvuuksia. Siemen-tiedostot tuovat suoraa indeksoitua sisältöä, vaikka ne eivät määrittäisi symboleita. Saadaksesi lisää tuloksia, jatka kyseisen kerroksen erikoistuneella hakutyökalulla.

Parametrit:

task_descriptionPakollinen

Tyyppi: str
Kuvaus: Kuvaus tehtävästä, johon tarvitset kontekstin

repositoryValinnainen

Tyyppi: str
Kuvaus: Repository muodossa owner/repo[:branch]. Valinnainen — jätä pois käyttääksesi asiakkaan pyyntökohtaista oletusta (jos annettu) tai ainoaa käytettävissä olevaa repositorya; anna erikseen vain valitaksesi toisen indeksoidun repon. Vastaus näyttää käytetyn repositoryn.

limitValinnainen

Tyyppi: int
Oletus: 15
Kuvaus: Tulosten enimmäismäärä kerrosta kohden

scopeValinnainen

Tyyppi: Literal[semantic, symbols, dependencies, all]
Oletus: all
Kuvaus: Mitkä kontekstitasot sisällytetään

language_filterValinnainen

Tyyppi: str
Kuvaus: Kielisuodatin

path_filterValinnainen

Tyyppi: str
Kuvaus: Suodata tiedostopolun etuliitteen mukaan

branchValinnainen

Tyyppi: str
Kuvaus: Haaran ohitus

include_related_contextValinnainen

Tyyppi: bool
Oletus
Kuvaus: Sisällytä asiaan liittyvä konteksti viereisistä symboleista

seed_symbol_idsValinnainen

Tyyppi: list[str]
Kuvaus: Eksplisiittiset Tier-1-seedit: symbolitunnukset, joiden agentti tietää olevan tehtävän kannalta keskeisiä (esim. sen avoimissa tiedostoissa olevat symbolit). Ne sijoitetaan avainsanoista johdettujen seedien edelle dependencies/related_context-kerroksissa. Tämä on lisäys — jätä pois, jos haluat nykyisen vain avainsanoihin perustuvan toiminnan.

seed_file_pathsValinnainen

Tyyppi: list[str]
Kuvaus: Tier-1-eksplisiittiset siemenet: indeksoidut tiedostopolut, jotka agentti on avannut tai juuri muokannut. Palauttaa rajatun suoran tiedostotodisteen ja ratkaisee jopa 5 symbolia tiedostoa kohden graafikontekstia varten, mukaan lukien symbolittomat dokumentit ja konfiguraatiot. Additiivinen — jätä pois, jos haluat pelkän avainsanapohjaisen toiminnan.

Parametri	Tyyppi	Pakollinen	Oletus	Kuvaus
`task_description`	`str`	Kyllä	-	Kuvaus tehtävästä, johon tarvitset kontekstin
`repository`	`str`	Ei	-	Repository muodossa owner/repo[:branch]. Valinnainen — jätä pois käyttääksesi asiakkaan pyyntökohtaista oletusta (jos annettu) tai ainoaa käytettävissä olevaa repositorya; anna erikseen vain valitaksesi toisen indeksoidun repon. Vastaus näyttää käytetyn repositoryn.
`limit`	`int`	Ei	`15`	Tulosten enimmäismäärä kerrosta kohden
`scope`	`Literal[semantic, symbols, dependencies, all]`	Ei	`all`	Mitkä kontekstitasot sisällytetään
`language_filter`	`str`	Ei	-	Kielisuodatin
`path_filter`	`str`	Ei	-	Suodata tiedostopolun etuliitteen mukaan
`branch`	`str`	Ei	-	Haaran ohitus
`include_related_context`	`bool`	Ei		Sisällytä asiaan liittyvä konteksti viereisistä symboleista
`seed_symbol_ids`	`list[str]`	Ei	-	Eksplisiittiset Tier-1-seedit: symbolitunnukset, joiden agentti tietää olevan tehtävän kannalta keskeisiä (esim. sen avoimissa tiedostoissa olevat symbolit). Ne sijoitetaan avainsanoista johdettujen seedien edelle dependencies/related_context-kerroksissa. Tämä on lisäys — jätä pois, jos haluat nykyisen vain avainsanoihin perustuvan toiminnan.
`seed_file_paths`	`list[str]`	Ei	-	Tier-1-eksplisiittiset siemenet: indeksoidut tiedostopolut, jotka agentti on avannut tai juuri muokannut. Palauttaa rajatun suoran tiedostotodisteen ja ratkaisee jopa 5 symbolia tiedostoa kohden graafikontekstia varten, mukaan lukien symbolittomat dokumentit ja konfiguraatiot. Additiivinen — jätä pois, jos haluat pelkän avainsanapohjaisen toiminnan.

Parhaiten sopii:

Tehtävätietoinen konteksti, joka yhdistää siemen-tiedostot semanttisiin, symboli- ja riippuvuuskerroksiin

Ei suositella:

Yhden työkalun haut, joissa tarkempi työkalu jo vastaa kysymykseen

get_fileVakaa

Lukee tiedoston indeksoidusta repositoriosta polun perusteella. Suosi levyllä oleville tiedostoille paikallista Read-työkalua — käytä tätä reposta toiseen tai etänä tehtäviin hakuihin, kun tiedosto ei ole työpuussasi. Tukee valinnaista rivialuetta; jatka tokenien vuoksi katkaistua vastausta kohdasta metadata.next_line_start.

Parametrit:

file_pathPakollinen

Tyyppi: str
Kuvaus: Tiedoston polku suhteessa arkiston juureen

repositoryValinnainen

Tyyppi: str
Kuvaus: Repository muodossa owner/repo[:branch]. Valinnainen — jätä pois käyttääksesi asiakkaan pyyntökohtaista oletusta (jos annettu) tai ainoaa käytettävissä olevaa repositorya; anna erikseen vain valitaksesi toisen indeksoidun repon. Vastaus näyttää käytetyn repositoryn.

line_startValinnainen

Tyyppi: int
Kuvaus: Aloitusrivi (1-indeksoitu)

line_endValinnainen

Tyyppi: int
Kuvaus: Loppurivi (1-indeksoitu, mukaan lukien; oltava kohdassa line_start tai sen jälkeen)

branchValinnainen

Tyyppi: str
Kuvaus: Haaran ohitus

max_tokensValinnainen

Tyyppi: int
Oletus: 5000
Kuvaus: Palautettavien tokenien enimmäismäärä

include_metadataValinnainen

Tyyppi: bool
Oletus: true
Kuvaus: Sisällytä vastaukseen tiedoston metatiedot

Parametri	Tyyppi	Pakollinen	Oletus	Kuvaus
`file_path`	`str`	Kyllä	-	Tiedoston polku suhteessa arkiston juureen
`repository`	`str`	Ei	-	Repository muodossa owner/repo[:branch]. Valinnainen — jätä pois käyttääksesi asiakkaan pyyntökohtaista oletusta (jos annettu) tai ainoaa käytettävissä olevaa repositorya; anna erikseen vain valitaksesi toisen indeksoidun repon. Vastaus näyttää käytetyn repositoryn.
`line_start`	`int`	Ei	-	Aloitusrivi (1-indeksoitu)
`line_end`	`int`	Ei	-	Loppurivi (1-indeksoitu, mukaan lukien; oltava kohdassa line_start tai sen jälkeen)
`branch`	`str`	Ei	-	Haaran ohitus
`max_tokens`	`int`	Ei	`5000`	Palautettavien tokenien enimmäismäärä
`include_metadata`	`bool`	Ei	`true`	Sisällytä vastaukseen tiedoston metatiedot

Parhaiten sopii:

Etä- tai indeksoidut tiedostotilannevedokset (rivialueet, token-rajat)

Ei suositella:

Polku, joka on jo paikallisella levyllä — käytä paikallista Read-työkalua

Järjestelmä- ja apuohjelmatyökalut#

repository_contextVakaa

Luettelee repositoriot, joista voit hakea, tai hakee tunnistetiedot yhdestä (namespace/branch, indexed_commit_sha / indeksin tuoreus). Kutsu action:"list" kerran nähdäksesi tarkan repo-tunnisteen, jonka hakutyökalut hyväksyvät. (Jos avaimellasi on vain yksi repo, hakutyökalut käyttävät sitä oletuksena — tämän voi silloin ohittaa.) Nimiavaruuden laajuiset tiedosto-/blob-/reunamäärät ovat valinnaisia parametrilla include_statistics=true.

Parametrit:

actionPakollinen

Tyyppi: Literal[list, info]
Kuvaus: Toiminto: "list" (listaa käytettävissä olevat repositoriot) tai "info" (näyttää repon tiedot)

repositoryValinnainen

Tyyppi: str
Kuvaus: Repositorio muodossa owner/repo tai owner/repo:branch (pakollinen toiminnolle info)

branchValinnainen

Tyyppi: str
Kuvaus: Haaran ohitus

patternValinnainen

Tyyppi: str
Kuvaus: Suodata arkistoluettelo mallin mukaan

include_statisticsValinnainen

Tyyppi: bool
Oletus
Kuvaus: Opt-in: sisältää nimiavaruuden laajuiset indeksoidun datan määrät (tiedosto/blob/reuna). Oletuksena false — repositorion tunniste ei vaadi tätä hitaampaa koontia.

limitValinnainen

Tyyppi: int
Oletus: 20
Kuvaus: Tällä sivulla palautettujen tulosten enimmäismäärä

offsetValinnainen

Tyyppi: int
Kuvaus: Vanhentunut yhteensopivuuspoikkeama. Valitse cursor pagination.next_cursor:stä.

cursorValinnainen

Tyyppi: str
Kuvaus: Läpinäkymätön cursor pagination.next_cursor:ltä. Välitä se muuttumattomana ja pidä kysely ja suodattimet muuttumattomina.

Parametri	Tyyppi	Pakollinen	Oletus	Kuvaus
`action`	`Literal[list, info]`	Kyllä	-	Toiminto: "list" (listaa käytettävissä olevat repositoriot) tai "info" (näyttää repon tiedot)
`repository`	`str`	Ei	-	Repositorio muodossa owner/repo tai owner/repo:branch (pakollinen toiminnolle info)
`branch`	`str`	Ei	-	Haaran ohitus
`pattern`	`str`	Ei	-	Suodata arkistoluettelo mallin mukaan
`include_statistics`	`bool`	Ei		Opt-in: sisältää nimiavaruuden laajuiset indeksoidun datan määrät (tiedosto/blob/reuna). Oletuksena false — repositorion tunniste ei vaadi tätä hitaampaa koontia.
`limit`	`int`	Ei	`20`	Tällä sivulla palautettujen tulosten enimmäismäärä
`offset`	`int`	Ei	-	Vanhentunut yhteensopivuuspoikkeama. Valitse cursor pagination.next_cursor:stä.
`cursor`	`str`	Ei	-	Läpinäkymätön cursor pagination.next_cursor:ltä. Välitä se muuttumattomana ja pidä kysely ja suodattimet muuttumattomina.

Parhaiten sopii:

Käytettävissä olevien repositorioiden listaaminen
Repositorion identiteetin, branchin ja HEAD-vs-indeksin tuoreuden ratkaiseminen

Ei suositella:

Nimiavaruuden laajuiset tilastot oletuksena — anna include_statistics=true eksplisiittisesti, koska se voi olla hitaampi kuin ratkaiseminen

ask_maguyvaVakaa

Maguyva-ohjeet ja -palaute. Ensisijaisesti: hae työkaluohjeita tai lähetä bugiraportti / ominaisuuspyyntö, joka tallennetaan Maguyva-ylläpitäjille. Älä koskaan sisällytä palautteeseen salaisuuksia tai arkaluonteisia henkilötietoja. evaluate-toiminto on olemassa vain taaksepäin yhteensopivuuden vuoksi — suosi paikallista laskentaa tai isäntätyökaluja matematiikka-/hash-/merkkijonotöihin.

Parametrit:

operationPakollinen

Tyyppi: Literal[guidance, report_bug, request_feature, evaluate]
Kuvaus: Ensisijaisesti: guidance, report_bug, request_feature. Vain legacy/yhteensopivuus: evaluate (deterministinen lausekemoottori; ei osa ensisijaista agenttien työnkulkua).

queryValinnainen

Tyyppi: str
Kuvaus: Ohjeaihe (esim. tool_selection, semantic_search). Vain legacy evaluate -toiminnolle: lausekemerkkijono.

descriptionValinnainen

Tyyppi: str
Kuvaus: Vaaditaan report_bug- ja request_feature-toiminnoille. Free-form-palaute Maguyva-ylläpitäjille. Älä koskaan sisällytä salaisuuksia tai arkaluonteisia henkilötietoja.

related_toolValinnainen

Tyyppi: 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]
Kuvaus: Valinnainen Maguyva-työkalu, joka liittyy läheisimmin palautteeseen

Parametri	Tyyppi	Pakollinen	Oletus	Kuvaus
`operation`	`Literal[guidance, report_bug, request_feature, evaluate]`	Kyllä	-	Ensisijaisesti: guidance, report_bug, request_feature. Vain legacy/yhteensopivuus: evaluate (deterministinen lausekemoottori; ei osa ensisijaista agenttien työnkulkua).
`query`	`str`	Ei	-	Ohjeaihe (esim. tool_selection, semantic_search). Vain legacy evaluate -toiminnolle: lausekemerkkijono.
`description`	`str`	Ei	-	Vaaditaan report_bug- ja request_feature-toiminnoille. Free-form-palaute Maguyva-ylläpitäjille. Älä koskaan sisällytä salaisuuksia tai arkaluonteisia henkilötietoja.
`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]`	Ei	-	Valinnainen Maguyva-työkalu, joka liittyy läheisimmin palautteeseen

Parhaiten sopii:

Työkaluohjeet (operation="guidance")
Pysyvät bugiraportit ja ominaisuuspyynnöt Maguyva-ylläpitäjille

Ei suositella:

Matematiikka-/hash-/merkkijonolaskenta — evaluate-toiminto on olemassa vain taaksepäin yhteensopivuuden vuoksi; suosi paikallista isäntälaskentaa

Parhaat käytännöt#

Käytä nimenomaisia ohituksia tarkoituksella: Jätä repository pois, kun MCP-asiakas antaa pyyntökohtaisen oletuksen tai kun avaimella on pääsy täsmälleen yhteen repositoryyn; muussa tapauksessa anna se erikseen.
Valitse oikea hakutila: Käytä intelligent_search mode="auto":n kanssa useimmissa tapauksissa. Määritä tila, kun tiedät tarkalleen mitä tarvitset.
Hyödynnä kielisuodattimia: Käytä language_filter kaventaaksesi tuloksia ja parantaaksesi suorituskykyä.
GraphRAG-tehostus: GraphRAG-tärkeystehostus on oletuksena pois päältä semanttisessa haussa (boost_by_importance=false), jotta järjestys pysyy agentille turvallisena. Anna boost_by_importance=true ottaaksesi käyttöön keskeisyystietoisen uudelleenjärjestelyn arkkitehtuurikatselmuksia varten.
Repositorion täsmäytys ei ole kirjainkokoherkkä, mutta ei myöskään sumea: repository_context täsmää repositorion nimet kirjainkoosta riippumatta — se ei korjaa kirjoitusvirheitä. Tarkista metadata.resolution_reason info-toiminnossa ("exact" vs. "corrected") nähdäksesi, miten nimi ratkaistiin.
Yhdistä työkalut: Käytä useita API-menetelmiä yhdessä kattavaan analyysiin.
Käsittele suuria tuloksia: Käytä limit ja työkalukohtaisia sivutussäätimiä (esimerkiksi line_start/line_end mallissa get_file).
Käytä ask_maguyva-työkalua työkaluohjeisiin: ask_maguyva:n evaluate-toiminto (hash, base64, JSON, matematiikka) on vain legacy-yhteensopivuutta varten. Kutsu sen sijaan ask_maguyva parametreilla operation="guidance" ja query="tool_selection" saadaksesi local-tool-wins-matriisin ja täyden työkalukohtaisen pikaoppaan.
Varmista vaikutukset ennen ja jälkeen muokkauksen: Ennen jaetun symbolin muokkaamista kutsu dependency_search parametrilla analysis_type="impact" (tai anna changed_paths PR-/diff-vaikutusta varten) nähdäksesi sen vaikutussäteen. Muokkauksen jälkeen aseta verify_after_edit=true parametreilla targets ja/tai changed_paths saadaksesi kompaktin uudelleentarkistuksen samoista symboleista.

Suorituskykyominaisuudet#

Toiminto	Suorituskykyhuomiot
Semanttinen haku	Alle sekunti, mutta sisältää joka kerta live-embedding-API-kutsun (ei välimuistissa) — varaudu ylimääräiseen viiveeseen vektorikyselyn päälle
Tekstihaku	Alle sekunti tarkalle/regex-haulle; sumea vapaatekstihaku sivuttaa asiakaspäässä, joten syvät offsetit maksavat enemmän — rajaa path_filter/language_filter-parametreilla
Rakenteellinen haku	AST-indeksoitu — kustannus skaalautuu tulosmäärän, ei repositorion koon mukaan
Riippuvuushaku	Kustannus skaalautuu syvyyden mukaan — suosi asetusta depth="shallow", ellet tarvitse moniosaista kontekstia; per_hop_limit rajaa leviämistä
Tiedostohaku	Lähes välitön yhdelle tiedostolle — sivuta suuret tiedostot line_start/line_end- tai max_tokens-parametreilla yhden ison haun sijaan
Repositoriokonteksti	Nimiavaruuden ratkaisu välimuistitetaan vain pyyntökohtaisesti, ei kutsujen välillä — jokainen työkalukutsu ratkaisee sen uudelleen
ask_maguyva (guidance / evaluate)	Lähes välitön — toimii in-Workerissa ilman tietokantakutsua

Virheenkäsittely#

Kaikki API-metodit palauttavat rakenteellisen kirjekuoren:

status: Merkkijono — "success" tai "error". Heikentyneen osuman tai tuoreuden signaalit löytyvät sisäkkäisistä kentistä, kuten metadata.resolution_reason repository_contextissa tai metadata.index_freshness.status.
tool: Vastauksen luoneen työkalun nimi
data: Tulospaketti onnistuessa (rakenne vaihtelee työkalun mukaan)
error: Rakenteellinen virheobjekti, kun status on "error" — sisältää kentät type, message, suggestions ja recovery_actions
metadata: Lisätietoa operaatiosta (reititys, välimuistitus, parametrisäädöt)
pagination: Mukana listavastauksissa — sisältää kentät has_more ja next_cursor

Tarkista aina kenttä status ennen tulosten käsittelyä — se on aina joko "success" tai "error". Heikentyneen osuman tai tuoreuden signaaleja varten lue sen sijaan sisäkkäinen kenttä: metadata.resolution_reason repository_contextissa, tai metadata.index_freshness.status (known/partial/unknown/unavailable).

Aloittaminen#

Määritä MCP-asiakas: Osoita MCP-asiakas Maguyva-palvelimen endpointiin
Vahvista repositoryjen käyttöoikeus: Tarkista API-avaimen käytettävissä olevat repositoryt komennolla repository_context(action="list"/"info")
Aloita haku: Aloita intelligent_search-työkalulla ja tutustu tarvittaessa erikoistyökaluihin
Yhdistä työkalut: Käytä useita työkaluja yhdessä kattavaan koodianalyysiin

Yksityiskohtaiset integraatio-ohjeet löydät kohdasta asennusopas.