# Näin Maguyva toimii Canonical source: https://maguyva.ai/fi/docs/how-it-works License: text under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); code samples under [MIT-0](https://opensource.org/license/mit-0); the Maguyva name, logos, brand assets and other code are not covered. Details: [maguyva.ai/license](https://maguyva.ai/license). Yhdistä GitHub-repositorio, ja Maguyva muuttaa sen useiksi haettaviksi näkymiksi, joita agenttisi voi käyttää tarpeen mukaan. Sen sijaan, että koko tiedostoja kaadettaisiin kontekstiin, malli saa ankkuroidun pääsyn symboleihin, rakenteeseen, dokumentaatioon, riippuvuuksiin ja pisteytettyihin koodikatkelmiin. Kun yhdistät repositorion, Maguyva ajaa pilvipohjaisia sisäänlukuputkia koodin, dokumentaation, manifestien, symbolien ja riippuvuusmetadatan yli. Tavoitteena on rakentaa pysyvä koodimuisti kerran sen sijaan, että jokainen agenttiajo joutuisi löytämään repositorion uudelleen tyhjästä. Nämä putket tuottavat useita erikoistuneita datakerroksia: tarkan tekstin haku, semanttinen haku, symboli- ja viittaushaut, rakenteelliset näkymät ja riippuvuusgraafianalyysi. Eri kysymykset reitittyvät eri kerroksille. Maguyva tarjoaa 5 tiedonhakutoimintoa: semantic, AST, symbol, dependency, text. intelligent_search tarjoaa neljä hakumenetelmää: semanttinen haku, tekstihaku, rakenteellinen haku ja graafihaku. Oletusarvoinen auto/balanced ohjaa suurella varmuudella määritelmien hauiksi tunnistetut kyselyt rakenteelliseen hakuun, viittaus- tai vaikutuskyselyt graafihakuun ja tarkkaa osumaa hakevat kyselyt tekstihakuun. Muut kyselyt käyttävät semanttista merkitystä ja indeksoitua tekstiä. Pyydä kaikkia neljää hakumenetelmää valinnalla mode=hybrid tai auto ja quality=thorough. Erikseen valittu tila on ensisijainen quality-asetukseen nähden. language_filter jättää graafin pois auto/hybrid-haussa ja hylätään, kun mode=graph on valittu erikseen. Eri hakumenetelmien tulokset yhdistetään ja järjestetään kyselyyn liittyvän relevanssin mukaan. Yksityiset repositorionäkymät ovat rinnakkain julkisen viitedatan kanssa tuetuille languages and text-based technologies. Agenttisi tavoittaa koko järjestelmän MCP-työkalujen kautta, joihin voit nojata voimakkaasti suunnittelun ja validoinnin aikana tai käyttää pistotarkastuksina muokkauksen aikana. ### 1. Repositorion sisäänluku - **Koodirakenteen analyysi**: Jäsentää tiedostot symboleiksi, viittauksiksi ja arkkitehtuurirajoiksi - **Riippuvuuksien ratkaisu**: Kartoittaa, miten tiedostot, moduulit ja symbolit riippuvat toisistaan - **Dokumentaation integrointi**: Tuo repositorion dokumentaation ja siihen liittyvän viitemateriaalin koodin rinnalle ### Reititys ja pisteytys - **Relevanssipisteytys**: Valitsee haun tietolähteet hakutilan ja laatuasetuksen mukaan ja järjestää sitten osumat kyselyn kannalta olennaisuuden mukaan - **Kohinan vähennys**: Vähentää päällekkäisiä osumia ja rajoittaa katkelmien määrää tiedostoa kohti, jotta yksi tiedosto ei täytä koko tulosikkunaa - **Kontekstin priorisointi**: Pitää tulokset oletusarvoisesti rajattuina ja olennaisina. Tärkeyspainotus otetaan erikseen käyttöön asetuksella boost_by_importance=true arkkitehtuurin tarkastelua varten; se ei ole oletusarvoinen järjestämisperiaate ### Tallennetut esitykset - **Semanttinen haku**: Löytää käsitteellisesti samankaltaista koodia ja dokumentaatiota, vaikka tarkat sanat eroaisivat - **Symboli- ja rakennenäkymät**: Tukee tarkkaa symbolihakua, viittauksia ja AST-muotoisia kysymyksiä - **Riippuvuusgraafianalyysi**: Seuraa kutsujia, tuonteja ja vaikutusaluetta koko koodikannassa ### Tietoturvaominaisuudet - **Siirtoyhteyden turvallisuus**: Palveluun tehtävät yhteydet käyttävät HTTPS/TLS:ää - **Hallinnoitu tallennustila**: Indeksoitu data tallennetaan hallinnoituun infrastruktuuriin, jossa on tallennustasolla toteutettu tietojen salaus - **Nimiavaruuksien eristäminen**: Repositoriodata rajataan työtilan ja nimiavaruuden mukaan koko putken ja tietokantakyselyiden reiteillä - **Pääsynhallinta**: Repositorion käyttöoikeutta rajoittavat organisaatio- ja nimiavaruusrajat ### Mitä odottaa - **Parempi suunnittelutarkkuus**: Agentit voivat validoida lähestymistavan todellista repositoriota vasten ennen koodaamisen aloittamista - **Turvallisemmat refaktoroinnit**: Vaikutusalue- ja riippuvuustarkistukset vähentävät vältettävissä olevaa rikkoutumista - **Vähemmän hukattuja tokeneita**: Vain olennaiset katkelmat palautetaan kokonaisten tiedostojen sijaan - **Nopeampi repositorion ymmärtäminen**: Malli saa ankkuroituja vastauksia nopeasti sen sijaan, että löytäisi projektin rakenteen uudelleen joka ajolla ### Automaattiset päivitykset - **Repositorion synkronointi**: Päivittyy GitHub-synkronointitöiden avulla koodin muuttuessa - **Inkrementaalinen käsittely**: Käsittelee tehokkuuden vuoksi vain muuttuneet tiedostot - **Haaratietoinen konteksti**: Ylläpitää erillisiä indeksejä jokaiselle git-haaralle, jotta agentit näkevät oikean kontekstin jokaiselle haaralle Maguyva toimitetaan pilvipohjaisena MCP-palvelimena. Agenttisi kutsuu tarvitsemaansa näkökulmaa vastaavia työkaluja sen sijaan, että luottaisi mallin muistavan arkkitehtuurisi tyhjästä. Yllä olevat neljä näkymää ovat ryhmiteltyjä näkymiä konkreettisiin työkaluihin: Semanttinen haku kattaa `semantic_search`- ja `intelligent_search`-työkalut; Symbolihaku kattaa `find_symbol`- ja `get_task_context`-työkalut; Rakenteellinen haku kattaa `structural_search`- ja `text_pattern_search`-työkalut; Riippuvuusgraafi kattaa `dependency_search`- ja `analyze_dependencies`-työkalut — sekä `get_file`-, `repository_context`- ja `ask_maguyva`-työkalut tukena. Katso täydellinen [MCP API -viite](https://maguyva.ai/docs/mcp-api) kaikista 11 työkalusta. Suorituskyky vaihtelee koodikannan koon ja kyselyn monimutkaisuuden mukaan. Maguyva keskittyy tuottamaan olennaisimman kontekstin sen sijaan, että kaataisi kokonaisia tiedostoja. Katso [yhteensopivuus](https://maguyva.ai/docs/compatibility) tuetuista kielistä ja asiakasohjelmista. Tulokset vaihtelevat koodikantasi koon, monimutkaisuuden ja tekoälyagenttisi käsittelemien kyselytyyppien mukaan. Yhdistä GitHub-repositoriosi Maguyva-portaalissa. Indeksit päivittyvät GitHub-synkronointitöiden kautta koodin muuttuessa. Portaali näyttää myös API-käytön.