# Πώς Λειτουργεί το Maguyva

Canonical source: https://maguyva.ai/el/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).

Συνδέστε ένα αποθετήριο GitHub και το Maguyva το μετατρέπει σε πολλαπλές αναζητήσιμες όψεις που ο πράκτοράς σας μπορεί να χρησιμοποιήσει κατ' απαίτηση. Αντί να ρίχνει ολόκληρα αρχεία μέσα στο πλαίσιο, το μοντέλο αποκτά τεκμηριωμένη πρόσβαση σε σύμβολα, δομή, έγγραφα, εξαρτήσεις και κατατεταγμένα τμήματα κώδικα.

Όταν συνδέετε ένα αποθετήριο, το Maguyva εκτελεί διοχετεύσεις εισαγωγής στο νέφος πάνω σε κώδικα, έγγραφα, μανιφέστα, σύμβολα και μεταδεδομένα εξαρτήσεων. Ο στόχος είναι να χτιστεί μια διαρκής μνήμη κώδικα μία φορά, αντί κάθε εκτέλεση πράκτορα να ανακαλύπτει ξανά το αποθετήριο από την αρχή.

Αυτές οι διοχετεύσεις παράγουν πολλαπλά εξειδικευμένα επίπεδα δεδομένων: ακριβή αναζήτηση κειμένου, σημασιολογική ανάκτηση, αναζητήσεις συμβόλων και αναφορών, δομικές όψεις και ανάλυση γραφήματος εξαρτήσεων. Διαφορετικές ερωτήσεις δρομολογούνται σε διαφορετικά επίπεδα.

Το Maguyva προσφέρει 5 δυνατότητες ανάκτησης: semantic, AST, symbol, dependency, text. Στο intelligent_search διατίθενται τέσσερις μέθοδοι αναζήτησης: σημασιολογική, κειμένου, δομική και γράφου. Η προεπιλογή auto/balanced δρομολογεί ερωτήματα που αναγνωρίζονται με υψηλή βεβαιότητα ως αναζητήσεις ορισμών στη δομική αναζήτηση, ερωτήματα αναφορών ή επιπτώσεων στον γράφο και ερωτήματα ακριβούς αντιστοίχισης στην αναζήτηση κειμένου. Τα υπόλοιπα ερωτήματα χρησιμοποιούν τη σημασιολογική έννοια και το ευρετηριασμένο κείμενο. Χρησιμοποιήστε mode=hybrid ή auto με quality=thorough για να ζητήσετε και τις τέσσερις μεθόδους αναζήτησης. Η ρητά επιλεγμένη λειτουργία υπερισχύει της ρύθμισης quality. Το language_filter παραλείπει τον γράφο από το auto/hybrid και απορρίπτεται όταν έχει οριστεί ρητά mode=graph. Τα αποτελέσματα από πολλές μεθόδους συγχωνεύονται και κατατάσσονται με βάση τη συνάφειά τους με το ερώτημα.

Οι ιδιωτικές όψεις αποθετηρίου συνυπάρχουν με δημόσια δεδομένα αναφοράς για τις υποστηριζόμενες languages and text-based technologies. Ο πράκτοράς σας φτάνει σε ολόκληρο το σύστημα μέσω εργαλείων MCP, στα οποία μπορείτε να στηρίζεστε έντονα κατά τον σχεδιασμό και την επικύρωση, ή να τα χρησιμοποιείτε ως δειγματοληπτικούς ελέγχους κατά την επεξεργασία.

### 1. Εισαγωγή Αποθετηρίου

- **Ανάλυση Δομής Κώδικα**: Αναλύει αρχεία σε σύμβολα, αναφορές και αρχιτεκτονικά όρια
- **Επίλυση Εξαρτήσεων**: Χαρτογραφεί πώς εξαρτώνται μεταξύ τους αρχεία, ενότητες και σύμβολα
- **Ενσωμάτωση Τεκμηρίωσης**: Αντλεί έγγραφα του αποθετηρίου και σχετικό υλικό αναφοράς παράλληλα με τον κώδικα

### Δρομολόγηση και Κατάταξη

- **Βαθμολόγηση Συνάφειας**: Επιλέγει στοιχεία ανάκτησης ανάλογα με τον τρόπο αναζήτησης και τη ρύθμιση ποιότητας και στη συνέχεια κατατάσσει τις αντιστοιχίσεις ως προς τη συνάφεια με το ερώτημα
- **Μείωση Θορύβου**: Μειώνει τις διπλές αντιστοιχίσεις και περιορίζει τα αποσπάσματα ανά αρχείο, ώστε ένα αρχείο να μη γεμίζει ολόκληρο το παράθυρο αποτελεσμάτων
- **Ιεράρχηση Πλαισίου**: Διατηρεί τα αποτελέσματα περιορισμένα και συναφή από προεπιλογή. Η ενίσχυση βάσει σπουδαιότητας ενεργοποιείται ρητά με boost_by_importance=true για εξερεύνηση της αρχιτεκτονικής· δεν είναι η προεπιλεγμένη πολιτική κατάταξης

### Αποθηκευμένες Αναπαραστάσεις

- **Σημασιολογική Ανάκτηση**: Βρίσκει εννοιολογικά παρόμοιο κώδικα και έγγραφα ακόμη κι όταν οι ακριβείς λέξεις διαφέρουν
- **Όψεις Συμβόλων και Δομής**: Υποστηρίζει ακριβή αναζήτηση συμβόλων, αναφορές και ερωτήματα σε μορφή AST
- **Ανάλυση Γραφήματος Εξαρτήσεων**: Παρακολουθεί καλούντες, εισαγωγές και ακτίνα επίδρασης σε όλη τη βάση κώδικα

### Χαρακτηριστικά Ασφαλείας

- **Ασφάλεια Μεταφοράς**: Οι συνδέσεις με την υπηρεσία χρησιμοποιούν HTTPS/TLS
- **Διαχειριζόμενη Αποθήκευση**: Τα ευρετηριασμένα δεδομένα αποθηκεύονται σε διαχειριζόμενη υποδομή με κρυπτογράφηση σε επίπεδο αποθήκευσης για τα αποθηκευμένα δεδομένα
- **Απομόνωση Χώρου Ονομάτων**: Τα δεδομένα αποθετηρίου περιορίζονται ανά χώρο εργασίας και χώρο ονομάτων σε όλη τη διοχέτευση και τις διαδρομές ερωτημάτων της βάσης δεδομένων
- **Έλεγχοι Πρόσβασης**: Η πρόσβαση στο αποθετήριο περιορίζεται από όρια οργανισμού και χώρου ονομάτων

### Τι να Περιμένετε

- **Καλύτερη Ακρίβεια Σχεδιασμού**: Οι πράκτορες μπορούν να επικυρώσουν μια προσέγγιση σε σχέση με το πραγματικό αποθετήριο πριν αρχίσουν να γράφουν κώδικα
- **Ασφαλέστερες Αναδιαμορφώσεις**: Οι έλεγχοι ακτίνας επίδρασης και εξαρτήσεων μειώνουν τις αποφεύξιμες βλάβες
- **Λιγότερη σπατάλη τόκενς**: Επιστρέφονται μόνο τα σχετικά τμήματα αντί για ολόκληρα αρχεία
- **Ταχύτερη Κατανόηση Αποθετηρίου**: Το μοντέλο λαμβάνει τεκμηριωμένες απαντήσεις γρήγορα, αντί να ανακαλύπτει ξανά τη δομή του έργου σε κάθε εκτέλεση

### Αυτόματες Ενημερώσεις

- **Συγχρονισμός Αποθετηρίου**: Ανανεώνεται από εργασίες συγχρονισμού του GitHub καθώς αλλάζει ο κώδικας
- **Αυξητική Επεξεργασία**: Επεξεργάζεται μόνο τα αρχεία που άλλαξαν, για αποδοτικότητα
- **Πλαίσιο με Επίγνωση Κλάδου**: Διατηρεί ξεχωριστά ευρετήρια ανά κλάδο git, ώστε οι πράκτορες να βλέπουν το σωστό πλαίσιο για κάθε κλάδο

Το Maguyva παραδίδεται ως διακομιστής MCP φιλοξενούμενος στο νέφος. Ο πράκτοράς σας καλεί τα εργαλεία για την οπτική που χρειάζεται, αντί να βασίζεται στο μοντέλο να θυμάται την αρχιτεκτονική σας από την αρχή. Οι τέσσερις επιφάνειες παραπάνω είναι ομαδοποιημένες όψεις των συγκεκριμένων εργαλείων: η Σημασιολογική αναζήτηση καλύπτει τα `semantic_search` και `intelligent_search`· η Αναζήτηση συμβόλων καλύπτει τα `find_symbol` και `get_task_context`· η Δομική αναζήτηση καλύπτει τα `structural_search` και `text_pattern_search`· ο Γράφος εξαρτήσεων καλύπτει τα `dependency_search` και `analyze_dependencies` — μαζί με τα `get_file`, `repository_context`, και `ask_maguyva` ως βοηθητικά εργαλεία. Δείτε την πλήρη [Αναφορά MCP API](https://maguyva.ai/docs/mcp-api) για όλα τα 11 εργαλεία.

Η απόδοση διαφέρει ανάλογα με το μέγεθος της βάσης κώδικα και την πολυπλοκότητα του ερωτήματος. Το Maguyva επικεντρώνεται στην παράδοση του πιο σχετικού πλαισίου αντί να ρίχνει ολόκληρα αρχεία. Δείτε τη [συμβατότητα](https://maguyva.ai/docs/compatibility) για τις υποστηριζόμενες γλώσσες και τους πελάτες.

Τα αποτελέσματα διαφέρουν ανάλογα με το μέγεθος και την πολυπλοκότητα της βάσης κώδικά σας, καθώς και τους τύπους ερωτημάτων που χειρίζεται ο πράκτορας AI σας.

Συνδέστε τα αποθετήρια GitHub μέσω της πύλης Maguyva. Τα ευρετήρια ανανεώνονται με εργασίες συγχρονισμού GitHub όταν αλλάζει ο κώδικας. Η πύλη παρέχει επίσης εικόνα της χρήσης του API.