Come funziona Maguyva

Collega un repository GitHub e Maguyva lo trasforma in diverse viste consultabili che il tuo agente può usare a richiesta. Invece di riversare interi file nel contesto, il modello accede a simboli, struttura, documentazione, dipendenze e frammenti di codice ordinati per pertinenza, con riscontri nel repository reale.

Man mano che i tuoi progetti crescono, gli agenti IA faticano con:

• Limiti della finestra di contesto - Troppe informazioni sopraffanno i modelli IA
• Dati irrilevanti - Gli agenti IA sprecano token su informazioni non necessarie
• Prestazioni scarse - Accuratezza ridotta e tempi di elaborazione più lenti
• Gestione manuale - Gli sviluppatori passano ore a organizzare manualmente il contesto
• Costi più alti - Senza gestione del contesto, i costi in token aumentano a ogni query

Quando colleghi un repository, Maguyva esegue pipeline di acquisizione nel cloud su codice, documentazione, manifest, simboli e metadati delle dipendenze. L'obiettivo è costruire una memoria del codice duratura una sola volta, invece di far riscoprire il repo da zero a ogni run dell'agente.

Quelle pipeline producono diversi livelli di dati specializzati: ricerca testuale esatta, recupero semantico, ricerca di simboli e riferimenti, viste strutturali e analisi del grafo delle dipendenze. Domande diverse vengono instradate a livelli diversi.

Maguyva offre 5 funzionalità di recupero delle informazioni: semantic, AST, symbol, dependency e text. In intelligent_search sono disponibili quattro modalità di ricerca: semantica, testuale, strutturale e a grafo. L'impostazione predefinita auto/balanced indirizza le query riconosciute con alta confidenza come ricerche di definizioni alla ricerca strutturale, le domande su riferimenti o impatto al grafo e quelle su corrispondenze esatte alla ricerca testuale. Le altre domande utilizzano il significato semantico e il testo indicizzato. Usa mode=hybrid oppure auto con quality=thorough per richiedere tutte e quattro le modalità di ricerca. Una modalità scelta esplicitamente ha la precedenza su quality. language_filter esclude il grafo da auto/hybrid e viene rifiutato quando si sceglie esplicitamente mode=graph. I risultati di più modalità vengono combinati e ordinati in base alla pertinenza rispetto alla query.

Le viste private del repository convivono con i dati di riferimento pubblici relativi a linguaggi e tecnologie basate su testo supportati. Il tuo agente accede all'intero sistema tramite gli strumenti MCP: puoi usarli intensamente durante la pianificazione e la validazione, oppure per controlli puntuali durante le modifiche.

Dopo la connessione a GitHub, Maguyva analizza il repository nel cloud ed estrae le parti di cui un agente ha davvero bisogno per ragionare:

• Analisi della struttura del codice ░╔═╗░ ▓║◉║▓ ░╚═╝░ - Analizza i file in simboli, riferimenti e confini architetturali
• Risoluzione delle dipendenze ╲▄█▄╱ ─◆●◆─ ╱▀█▀╲ - Mappa come file, moduli e simboli dipendono l'uno dall'altro
• Integrazione della documentazione - Include la documentazione del repository e il materiale di riferimento correlato insieme al codice

Invece di un unico indice generico, Maguyva costruisce diversi strumenti di recupero specializzati che rispondono rapidamente a domande diverse, ciascuno con riscontri diversi:

• Punteggio di rilevanza ▄█▄ ║⊙⊙║ ╚═█═╝ - Seleziona le evidenze in base alla modalità di ricerca e al livello di qualità, poi ordina le corrispondenze per pertinenza rispetto alla query
• Riduzione del rumore - Riduce le corrispondenze duplicate e limita i frammenti per file, così un solo file non occupa tutta la finestra dei risultati
• Prioritizzazione del contesto - Mantiene i risultati limitati e pertinenti per impostazione predefinita. Il potenziamento per importanza si attiva con boost_by_importance=true per esplorare l'architettura; non è la politica di ordinamento predefinita

• Recupero semantico ┌─◈─┐ ║███║ ╚═══╝ - Trova codice e documentazione concettualmente simili anche quando le parole esatte differiscono
• Viste di simboli e struttura - Supporta la ricerca esatta dei simboli, i riferimenti e le query basate sulla struttura AST
• Analisi del grafo delle dipendenze ▓█▓ ╔═●═╗ ╚═╤═╝ - Segue chiamanti, import e raggio d'impatto in tutto il codice

Maguyva viene fornito come server MCP ospitato nel cloud. Il tuo agente chiama gli strumenti per la vista di cui ha bisogno, invece di affidarsi al modello per ricordare la tua architettura da zero. Le quattro superfici sopra sono viste raggruppate sugli strumenti concreti: Ricerca semantica copre semantic_search e intelligent_search; Ricerca di simboli copre find_symbol e get_task_context; Ricerca strutturale copre structural_search e text_pattern_search; Grafo delle dipendenze copre dependency_search e analyze_dependencies — insieme a get_file, repository_context e ask_maguyva come utility di supporto. Consulta il riferimento API MCP completo per tutti gli 11 strumenti.

• Usa più o meno strumenti - Fai grande affidamento su Maguyva durante la pianificazione, oppure usalo solo per verificare la sensatezza di una modifica rischiosa
• Migliore validazione dei piani - Verifica le idee incrociandole con simboli, riferimenti e documentazione reali prima di modificare
• Raggio d'impatto più chiaro - Gli strumenti di dipendenze e grafo mostrano cosa potrebbe rompersi se un simbolo cambia
• Compatibile con il futuro - Funziona con qualsiasi client che supporti lo standard MCP

• Sicurezza del trasporto - Le connessioni al servizio usano HTTPS/TLS
• Archiviazione gestita - I dati indicizzati sono archiviati su infrastruttura gestita con crittografia a riposo a livello di storage
• Isolamento per namespace - I dati del repository sono delimitati per workspace e namespace lungo la pipeline e i percorsi di query del database
• Controlli di accesso - L'accesso al repository è limitato dai confini di organizzazione e namespace

Le prestazioni variano in base alla dimensione del codice e alla complessità della query. Maguyva si concentra sul fornire il contesto più rilevante invece di riversare interi file. Consulta compatibilità per i linguaggi e i client supportati.

Filtrando e organizzando in modo intelligente il contesto del tuo codice, Maguyva aiuta gli agenti IA a lavorare in modo più efficiente:

• Maggiore accuratezza nella pianificazione - Gli agenti possono validare un approccio rispetto al repository reale prima di iniziare a scrivere codice
• Refactoring più sicuri - I controlli di raggio d'impatto e dipendenze riducono le rotture evitabili
• Meno spreco di token - Vengono restituiti solo i frammenti rilevanti invece di file interi
• Comprensione più rapida del repo - Il modello ottiene rapidamente risposte fondate, invece di riscoprire la struttura del progetto a ogni run

• Sincronizzazione del repository - Si aggiorna tramite i job di sincronizzazione GitHub man mano che il codice cambia
• Elaborazione incrementale - Elabora solo i file modificati per maggiore efficienza
• Contesto consapevole del branch - Mantiene indici separati per branch git, in modo che gli agenti vedano il contesto corretto per ogni branch

Pronto a provarlo?

1. Inizia gratis - Non è richiesta la carta di credito
2. Collega il tuo repository - collega un repo GitHub nel portale Maguyva
3. Punta il tuo agente su Maguyva - Usa gli strumenti MCP durante la pianificazione, il controllo o la modifica (guida all'installazione)

Inizia gratis →

Collega i tuoi repository GitHub tramite il portale Maguyva. Gli indici si aggiornano tramite processi di sincronizzazione GitHub quando il codice cambia. Il portale permette anche di consultare l'utilizzo dell'API.