Siirry sisältöön

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.

Kontekstiongelma#

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ä

Mitä suuremmaksi projekti kasvaa, sitä enemmän kohinaa pääsee kontekstiikkunaan — ja agentin tarkkuus laskee sen seurauksena.

Maguyva-palvelun ratkaisu#

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.

Haku yhdistää 5 hakutilaa: semantic, AST, symbol, dependency ja text. Tulokset yhdistetään ja pisteytetään niin, että tärkeät symbolit nousevat esiin ennen vähäarvoisia apufunktioita.

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.

1. Repositorion sisäänluku#

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

2. Erikoistuneet hakukerrokset#

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

Kontekstibudjetti: Maguyva palauttaa pisteytettyjä koodikatkelmia tiedostopolkuineen ja rivinumeroineen sen sijaan, että kaataisi kokonaisia tiedostoja kontekstiin. Todellinen tokenien säästö riippuu repositorion koosta ja kyselyn tarkkuudesta.

Reititys ja pisteytys#

  • Relevanssipisteytys
     - Valitsee oikean hakutilan ja nostaa tärkeät tulokset esiin ensin
  • Kohinan vähennys - Poistaa boilerplate-koodin, päällekkäiset katkelmat ja vähäarvoiset osumat
  • Kontekstin priorisointi - Järjestää tulokset niin, että agentti näkee ydinsymbolit ennen reunatapausten apufunktioita

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 vaikutussädettä koko koodikannassa

3. Model Context Protocol (MCP) -työkalukerros#

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; Symbol Lookup kattaa find_symbol- ja get_task_context-työkalut; Rakenteellinen haku kattaa structural_search- ja text_pattern_search-työkalut; Dependency Graph 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.

MCP-yhteensopivuuden edut#

  • Käytä enemmän tai vähemmän työkaluja - Nojaa Maguyva:iin 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 vaikutussäde - Riippuvuus- ja graafityökalut näyttävät, mikä voi rikkoutua jos symboli muuttuu
  • Tulevaisuuteen yhteensopiva - Toimii minkä tahansa MCP-standardia tukevan asiakasohjelman kanssa

Tekninen arkkitehtuuri#

Turvallinen käsittelyputki#

Tietoturvaominaisuudet#

  • Siirtoyhteyden turvallisuus - Palveluun tehtävät yhteydet käyttävät HTTPS/TLS:ää
  • Hallinnoitu tallennustila - Indeksoitu data tallennetaan hallinnoituun infrastruktuuriin, jossa on tallennustason salaus levossa
  • 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

Suorituskykyominaisuudet#

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.

Mitä odottaa#

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 - Vaikutussäde- 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

Tulokset vaihtelevat koodikantasi koon, monimutkaisuuden ja tekoälyagenttisi käsittelemien kyselytyyppien mukaan.

Indeksin pitäminen ajan tasalla#

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

Näin pääset alkuun#

Valmiina kokeilemaan?

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

Aloita ilmaiseksi →

Repositorioiden hallinta#

Yhdistä GitHub-repositoriosi Maguyva-portaalin kautta. Alusta päivittää indeksit GitHub-synkronointitöiden avulla koodin muuttuessa, pitäen MCP-työkalukerroksen ajan tasalla jokaiselle haaralle. Portaali tarjoaa myös perustason näkyvyyden API-käyttöön, tarkemmat analytiikkaominaisuudet ovat tulossa.