Näin Maguyva toimii

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.

Projektien kasvaessa tekoälyagentit kamppailevat seuraavien kanssa:

• Kontekstiikkunan rajoitukset - Liika tieto ylikuormittaa tekoälymalleja
• Epäolennainen data - Tekoälyagentit tuhlaavat tokeneita tarpeettomaan tietoon
• Heikko suorituskyky - Heikentynyt tarkkuus ja hitaammat käsittelyajat
• Manuaalinen hallinta - Kehittäjät käyttävät tunteja kontekstin manuaaliseen järjestämiseen
• Korkeammat kustannukset - Ilman kontekstinhallintaa tokenikustannukset kasvavat joka kyselyllä

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 ja 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 kieltä ja tekstipohjaisia teknologioita. Agenttisi tavoittaa koko järjestelmän MCP-työkalujen kautta, joihin voit nojata voimakkaasti suunnittelun ja validoinnin aikana tai käyttää pistotarkastuksina muokkauksen aikana.

Kun GitHub on yhdistetty, Maguyva skannaa repositorion pilvessä ja poimii osat, joita agentti oikeasti tarvitsee päätellessään:

• 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

Yhden yleisindeksin sijaan Maguyva rakentaa useita hakupintoja, jotka vastaavat eri kysymyksiin nopeasti ja eri todisteiden avulla:

• 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

• 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

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 kaikista 11 työkalusta.

• Käytä enemmän tai vähemmän työkaluja - Nojaa Maguyva-palveluun voimakkaasti suunnitellessasi tai käytä sitä vain riskialttiiden muutosten tarkastamiseen
• Parempi suunnitelman validointi - Ristiintarkista ideat todellisia symboleita, viittauksia ja dokumentaatiota vasten ennen muokkausta
• Selkeämpi vaikutusalue - Riippuvuus- ja graafityökalut näyttävät, mikä voi rikkoutua jos symboli muuttuu
• Tulevaisuuteen yhteensopiva - Toimii minkä tahansa MCP-standardia tukevan asiakasohjelman kanssa

• 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

Suorituskyky vaihtelee koodikannan koon ja kyselyn monimutkaisuuden mukaan. Maguyva keskittyy tuottamaan olennaisimman kontekstin sen sijaan, että kaataisi kokonaisia tiedostoja. Katso yhteensopivuus tuetuista kielistä ja asiakasohjelmista.

Suodattamalla ja järjestämällä koodikantasi kontekstin älykkäästi Maguyva auttaa tekoälyagentteja työskentelemään tehokkaammin:

• 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

• 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

Valmiina kokeilemaan?

1. Aloita ilmaiseksi - Ei luottokorttia tarvita
2. Yhdistä repositoriosi - linkitä GitHub-repo Maguyva-portaalissa
3. Yhdistä agenttisi Maguyva-palveluun - Käytä MCP-työkaluja suunnitellessasi, tarkistaessasi tai muokatessasi (asennusopas)

Aloita ilmaiseksi →

Yhdistä GitHub-repositoriosi Maguyva-portaalissa. Indeksit päivittyvät GitHub-synkronointitöiden kautta koodin muuttuessa. Portaali näyttää myös API-käytön.