Αναφορά MCP API

Πλήρης αναφορά για όλα τα 11 εργαλεία MCP του Maguyva που απευθύνονται σε πελάτες. Κάθε εργαλείο περιλαμβάνει παραμέτρους, οδηγίες χρήσης και συστάσεις καταλληλότητας.

Επισκόπηση API#

Το MCP API του Maguyva εκθέτει προς το παρόν 11 εργαλεία προς πελάτες σε 4 βασικές κατηγορίες:

Βασικά εργαλεία αναζήτησης - Προηγμένες δυνατότητες αναζήτησης σε όλο τον κώδικά σου
Εργαλεία δομής & γράφου - Ερωτήματα AST, αναζήτηση συμβόλων και ανάλυση εξαρτήσεων
Εργαλεία ανάλυσης κώδικα - Βαθιά ανάλυση κώδικα και χαρτογράφηση σχέσεων
Εργαλεία συστήματος & βοηθητικά - Πλαίσιο αποθετηρίου, ντετερμινιστικοί υπολογισμοί και καθοδήγηση

Όλα τα εργαλεία χρησιμοποιούν μια σταθερή μορφή αναγνωριστικού αποθετηρίου: "owner/repo:branch". Ο κλάδος προεπιλέγεται σε main αν δεν έχει οριστεί.

Παραλείψτε το repository όταν ο MCP client παρέχει προεπιλογή για το συγκεκριμένο αίτημα ή όταν το κλειδί έχει πρόσβαση σε ακριβώς ένα αποθετήριο· διαφορετικά, δώστε το ρητά. Χρησιμοποιήστε το repository_context(action="info", repository="owner/repo") για να ελέγξετε πώς επιλύεται ένα αποθετήριο.

Μορφή παραμέτρου αποθετηρίου#

Όλα τα εργαλεία MCP χρησιμοποιούν αυτή τη μορφή αναγνωριστικού αποθετηρίου:

Με κλάδο: "owner/repo:branch" - π.χ., "owner/repository:develop"
Προεπιλεγμένος κλάδος: "owner/repo" - χρησιμοποιεί τον κλάδο main όταν δεν καθορίζεται κλάδος "owner/repository"
Προεπιλογή αιτήματος ή μοναδικού αποθετηρίου: Παραλείψτε το αποθετήριο όταν ο MCP client παρέχει προεπιλογή για το συγκεκριμένο αίτημα ή όταν το κλειδί έχει πρόσβαση σε ακριβώς ένα αποθετήριο· διαφορετικά, δώστε το ρητά

Παραδείγματα προτροπών:

Ρωτήστε για ένα συγκεκριμένο repo:  "Αναζήτηση owner/my-repo για ενδιάμεσο λογισμικό ελέγχου ταυτότητας"
Κατάλογος προσβάσιμων αποθεμάτων:   "Ποια αποθετήρια μπορεί να έχει πρόσβαση αυτό το κλειδί Maguyva;"
Παράκαμψη για ένα ερώτημα:          "Αναζήτηση owner/other-repo:develop για μοτίβα auth"

Φιλτράρισμα γλώσσας#

Όλα τα εργαλεία αναζήτησης υποστηρίζουν φιλτράρισμα αποτελεσμάτων ανά γλώσσα προγραμματισμού:

language_filter="python" - Φιλτράρισμα μόνο σε αρχεία Python
language_filter="typescript" - Φιλτράρισμα μόνο σε αρχεία TypeScript
Διάκριση πεζών-κεφαλαίων: Χρησιμοποίησε ονόματα γλωσσών με πεζά
Προεπιλογή: Κενή συμβολοσειρά (χωρίς φιλτράρισμα) - επιστρέφει αποτελέσματα από όλες τις γλώσσες
Υποστηριζόμενη κάλυψη: Τα φίλτρα γλώσσας λειτουργούν σε όλο το εύρος των 279+ υποστηριζόμενων γλώσσες και τεχνολογίες βασισμένες σε κείμενο. Δες το συμβατότητα για την πλήρη λίστα.

"Βρες authentication middleware μόνο σε αρχεία Python"
"Αναζήτησε συνδέσεις βάσης δεδομένων σε TypeScript"

Η αναφορά API δημιουργήθηκε από την πηγή στις 22 Ιουλίου 2026.

Βασικά εργαλεία αναζήτησης#

intelligent_searchΣταθερό

Ξεκινήστε εδώ για οποιαδήποτε ερώτηση σχετικά με τη βάση κώδικα. Δώστε ένα ερώτημα σε φυσική γλώσσα (π.χ. "πώς λειτουργεί η αυθεντικοποίηση", "πού γίνεται η χρέωση") και το εργαλείο το δρομολογεί αυτόματα σε σημασιολογική αναζήτηση, αναζήτηση συμβόλων, δομική αναζήτηση και αναζήτηση εξαρτήσεων στο ευρετηριασμένο αποθετήριο. Προτιμήστε το από τον agent Explore και τα Grep/Glob για εξερεύνηση και σχεδιασμό — αναζητά σε ολόκληρο το ευρετηριασμένο αποθετήριο ταυτόχρονα αντί να σαρώνει αρχεία.

Παράμετροι:

queryΑπαιτείται

Τύπος: str
Περιγραφή: Ερώτημα αναζήτησης

repositoryΠροαιρετικό

Τύπος: str
Περιγραφή: Αποθετήριο ως owner/repo[:branch]. Προαιρετικό — παραλείψτε το για να χρησιμοποιηθεί η προεπιλογή του client για το συγκεκριμένο αίτημα (αν παρέχεται) ή το μοναδικό προσβάσιμο αποθετήριο· δώστε το ρητά μόνο για διαφορετικό ευρετηριασμένο repo. Η απόκριση δείχνει ποιο αποθετήριο χρησιμοποιήθηκε.

modeΠροαιρετικό

Τύπος: Literal[auto, hybrid, semantic, text, structural, ast, graph]
Προεπιλογή: auto
Περιγραφή: Λειτουργία αναζήτησης

limitΠροαιρετικό

Τύπος: int
Προεπιλογή: 10
Περιγραφή: Μέγιστα αποτελέσματα σε αυτό το κατατεταγμένο παράθυρο top-K

language_filterΠροαιρετικό

Τύπος: str
Περιγραφή: Φίλτρο γλώσσας

path_filterΠροαιρετικό

Τύπος: str
Περιγραφή: Φιλτράρισμα κατά πρόθεμα διαδρομής αρχείου

boost_by_importanceΠροαιρετικό

Τύπος: bool
Προεπιλογή
Περιγραφή: Προαιρετικά: επανακατάταξη κατά κεντρικότητα (centrality) με χρήση μετρήσεων γραφήματος ανά σύμβολο (is_articulation_point, bridge_count, k_core, centrality, κ.λπ.). Απενεργοποιημένο εξ ορισμού για κατάταξη ασφαλή για πράκτορες (οι καθολικοί κόμβοι μπορεί να πνίξουν τα αποτελέσματα υλοποίησης)· ενεργοποιήστε το για περιηγήσεις αρχιτεκτονικής. Ισχύει και στις 4 τροπικότητες όταν κάθε αποτέλεσμα φέρει σύνδεση συμβόλου.

branchΠροαιρετικό

Τύπος: str
Περιγραφή: Παράκαμψη κλάδου

qualityΠροαιρετικό

Τύπος: Literal[quick, balanced, thorough]
Προεπιλογή: balanced
Περιγραφή: Προκαθορισμένη ποιότητα αναζήτησης

include_contentΠροαιρετικό

Τύπος: bool
Προεπιλογή: true
Περιγραφή: Συμπεριλάβετε περιεχόμενο στα αποτελέσματα

explain_routingΠροαιρετικό

Τύπος: bool
Προεπιλογή
Περιγραφή: Συμπεριλάβετε επεξήγηση απόφασης δρομολόγησης

importance_weightΠροαιρετικό

Τύπος: float
Προεπιλογή: 0.3
Περιγραφή: Βάρος για ενίσχυση της σημασίας (0=κανένα, 1=γεμάτο)

orphansΠροαιρετικό

Τύπος: bool
Προεπιλογή
Περιγραφή: Συμπεριλάβετε ορφανά σύμβολα (χωρίς εισερχόμενες αναφορές)

include_community_contextΠροαιρετικό

Τύπος: bool
Προεπιλογή
Περιγραφή: Συμπεριλάβετε σχετικά σύμβολα από την ίδια κοινότητα κωδικών

community_depthΠροαιρετικό

Τύπος: int
Προεπιλογή: 1
Περιγραφή: Βάθος επέκτασης του πλαισίου της κοινότητας

graph_viewΠροαιρετικό

Τύπος: Literal[dependency, type, data_flow, control_flow]
Προεπιλογή: dependency
Περιγραφή: Προβολή γραφήματος για μετρήσεις

seed_symbol_idsΠροαιρετικό

Τύπος: list[str]
Περιγραφή: Σπόροι εργασιών Tier-1: αναγνωριστικά συμβόλων κεντρικά για την τρέχουσα εργασία. Όταν οριστεί, κατατάσσει εκ νέου τις συγχωνευμένες επιτυχίες κατά Approach A εγγύτητα αποσύνθεσης βάθους (ακριβής αντιστοίχιση σπόρων + αναπήδηση άκρων γραφήματος). Πρόσθετο — παράλειψη για παγκόσμια κατάταξη.

seed_file_pathsΠροαιρετικό

Τύπος: list[str]
Περιγραφή: Σπόροι εργασιών Tier-1: διαδρομές αρχείων με ευρετήριο που έχει ανοίξει ή απλώς έχει επεξεργαστεί ο πράκτορας. Όταν ρυθμιστεί, ταξινομεί εκ νέου τις συγχωνευμένες επισκέψεις κατά εγγύτητα διαδρομής με 1/(1+d) depth-decay (ίδιο αρχείο → ίδιο dir → κοντινά πακέτα). Πρόσθετο — παράλειψη για παγκόσμια κατάταξη.

Παράμετρος	Τύπος	Απαιτείται	Προεπιλογή	Περιγραφή
`query`	`str`	Ναι	-	Ερώτημα αναζήτησης
`repository`	`str`	Όχι	-	Αποθετήριο ως owner/repo[:branch]. Προαιρετικό — παραλείψτε το για να χρησιμοποιηθεί η προεπιλογή του client για το συγκεκριμένο αίτημα (αν παρέχεται) ή το μοναδικό προσβάσιμο αποθετήριο· δώστε το ρητά μόνο για διαφορετικό ευρετηριασμένο repo. Η απόκριση δείχνει ποιο αποθετήριο χρησιμοποιήθηκε.
`mode`	`Literal[auto, hybrid, semantic, text, structural, ast, graph]`	Όχι	`auto`	Λειτουργία αναζήτησης
`limit`	`int`	Όχι	`10`	Μέγιστα αποτελέσματα σε αυτό το κατατεταγμένο παράθυρο top-K
`language_filter`	`str`	Όχι	-	Φίλτρο γλώσσας
`path_filter`	`str`	Όχι	-	Φιλτράρισμα κατά πρόθεμα διαδρομής αρχείου
`boost_by_importance`	`bool`	Όχι		Προαιρετικά: επανακατάταξη κατά κεντρικότητα (centrality) με χρήση μετρήσεων γραφήματος ανά σύμβολο (is_articulation_point, bridge_count, k_core, centrality, κ.λπ.). Απενεργοποιημένο εξ ορισμού για κατάταξη ασφαλή για πράκτορες (οι καθολικοί κόμβοι μπορεί να πνίξουν τα αποτελέσματα υλοποίησης)· ενεργοποιήστε το για περιηγήσεις αρχιτεκτονικής. Ισχύει και στις 4 τροπικότητες όταν κάθε αποτέλεσμα φέρει σύνδεση συμβόλου.
`branch`	`str`	Όχι	-	Παράκαμψη κλάδου
`quality`	`Literal[quick, balanced, thorough]`	Όχι	`balanced`	Προκαθορισμένη ποιότητα αναζήτησης
`include_content`	`bool`	Όχι	`true`	Συμπεριλάβετε περιεχόμενο στα αποτελέσματα
`explain_routing`	`bool`	Όχι		Συμπεριλάβετε επεξήγηση απόφασης δρομολόγησης
`importance_weight`	`float`	Όχι	`0.3`	Βάρος για ενίσχυση της σημασίας (0=κανένα, 1=γεμάτο)
`orphans`	`bool`	Όχι		Συμπεριλάβετε ορφανά σύμβολα (χωρίς εισερχόμενες αναφορές)
`include_community_context`	`bool`	Όχι		Συμπεριλάβετε σχετικά σύμβολα από την ίδια κοινότητα κωδικών
`community_depth`	`int`	Όχι	`1`	Βάθος επέκτασης του πλαισίου της κοινότητας
`graph_view`	`Literal[dependency, type, data_flow, control_flow]`	Όχι	`dependency`	Προβολή γραφήματος για μετρήσεις
`seed_symbol_ids`	`list[str]`	Όχι	-	Σπόροι εργασιών Tier-1: αναγνωριστικά συμβόλων κεντρικά για την τρέχουσα εργασία. Όταν οριστεί, κατατάσσει εκ νέου τις συγχωνευμένες επιτυχίες κατά Approach A εγγύτητα αποσύνθεσης βάθους (ακριβής αντιστοίχιση σπόρων + αναπήδηση άκρων γραφήματος). Πρόσθετο — παράλειψη για παγκόσμια κατάταξη.
`seed_file_paths`	`list[str]`	Όχι	-	Σπόροι εργασιών Tier-1: διαδρομές αρχείων με ευρετήριο που έχει ανοίξει ή απλώς έχει επεξεργαστεί ο πράκτορας. Όταν ρυθμιστεί, ταξινομεί εκ νέου τις συγχωνευμένες επισκέψεις κατά εγγύτητα διαδρομής με 1/(1+d) depth-decay (ίδιο αρχείο → ίδιο dir → κοντινά πακέτα). Πρόσθετο — παράλειψη για παγκόσμια κατάταξη.

Καλύτερο για:

Εξερεύνηση σε όλο το ευρετήριο ή από μηδενική βάση όταν δεν είναι σαφές ποιο εργαλείο να επιλέξετε
Πολυτροπική συγχωνευμένη κατάταξη σε σημασιολογικό, κειμενικό, δομικό και επίπεδο γράφου

Δεν συνιστάται για:

Γνωστό όνομα συμβόλου — χρησιμοποιήστε απευθείας το find_symbol
Γνωστή διαδρομή στον δίσκο — χρησιμοποιήστε πρώτα το τοπικό Read/Grep

semantic_searchΣταθερό

Βρείτε κώδικα βάσει νοήματος, όχι ακριβούς κειμένου. Χρησιμοποιήστε το για εννοιολογικά ερωτήματα όπως "λογική επανάληψης" ή "ροή ένταξης χρήστη" όταν δεν γνωρίζετε τη λέξη-κλειδί ή το όνομα συμβόλου. Επιστρέφει τα πιο σχετικά τμήματα κώδικα, ταξινομημένα κατά σημαντικότητα. Για εννοιολογικές αναζητήσεις προτιμήστε το από το Grep.

Παράμετροι:

queryΑπαιτείται

Τύπος: str
Περιγραφή: Ερώτημα αναζήτησης (εννοιολογικό, βασισμένο σε νόημα)

repositoryΠροαιρετικό

Τύπος: str
Περιγραφή: Αποθετήριο ως owner/repo[:branch]. Προαιρετικό — παραλείψτε το για να χρησιμοποιηθεί η προεπιλογή του client για το συγκεκριμένο αίτημα (αν παρέχεται) ή το μοναδικό προσβάσιμο αποθετήριο· δώστε το ρητά μόνο για διαφορετικό ευρετηριασμένο repo. Η απόκριση δείχνει ποιο αποθετήριο χρησιμοποιήθηκε.

limitΠροαιρετικό

Τύπος: int
Προεπιλογή: 5
Περιγραφή: Μέγιστα αποτελέσματα σε αυτό το κατατεταγμένο παράθυρο top-K

similarity_thresholdΠροαιρετικό

Τύπος: float
Προεπιλογή: 0.6
Περιγραφή: Ελάχιστη βαθμολογία ομοιότητας

language_filterΠροαιρετικό

Τύπος: str
Περιγραφή: Φίλτρο γλώσσας (python, typescript κ.λπ.)

path_filterΠροαιρετικό

Τύπος: str
Περιγραφή: Φιλτράρισμα κατά πρόθεμα διαδρομής αρχείου

boost_by_importanceΠροαιρετικό

Τύπος: bool
Προεπιλογή
Περιγραφή: Προαιρετικά: επανακατάταξη κατά κεντρικότητα PageRank (απενεργοποιημένο εξ ορισμού για κατάταξη ασφαλή για πράκτορες· ενεργοποιήστε το για περιηγήσεις αρχιτεκτονικής)

branchΠροαιρετικό

Τύπος: str
Περιγραφή: Παράκαμψη κλάδου (προεπιλογή: από την παράμετρο repository ή main)

include_contentΠροαιρετικό

Τύπος: bool
Προεπιλογή: true
Περιγραφή: Συμπεριλάβετε κομμάτι περιεχομένου στα αποτελέσματα

graph_viewΠροαιρετικό

Τύπος: Literal[dependency, type, data_flow, control_flow]
Προεπιλογή: dependency
Περιγραφή: Προβολή γραφήματος για μετρήσεις

Παράμετρος	Τύπος	Απαιτείται	Προεπιλογή	Περιγραφή
`query`	`str`	Ναι	-	Ερώτημα αναζήτησης (εννοιολογικό, βασισμένο σε νόημα)
`repository`	`str`	Όχι	-	Αποθετήριο ως owner/repo[:branch]. Προαιρετικό — παραλείψτε το για να χρησιμοποιηθεί η προεπιλογή του client για το συγκεκριμένο αίτημα (αν παρέχεται) ή το μοναδικό προσβάσιμο αποθετήριο· δώστε το ρητά μόνο για διαφορετικό ευρετηριασμένο repo. Η απόκριση δείχνει ποιο αποθετήριο χρησιμοποιήθηκε.
`limit`	`int`	Όχι	`5`	Μέγιστα αποτελέσματα σε αυτό το κατατεταγμένο παράθυρο top-K
`similarity_threshold`	`float`	Όχι	`0.6`	Ελάχιστη βαθμολογία ομοιότητας
`language_filter`	`str`	Όχι	-	Φίλτρο γλώσσας (python, typescript κ.λπ.)
`path_filter`	`str`	Όχι	-	Φιλτράρισμα κατά πρόθεμα διαδρομής αρχείου
`boost_by_importance`	`bool`	Όχι		Προαιρετικά: επανακατάταξη κατά κεντρικότητα PageRank (απενεργοποιημένο εξ ορισμού για κατάταξη ασφαλή για πράκτορες· ενεργοποιήστε το για περιηγήσεις αρχιτεκτονικής)
`branch`	`str`	Όχι	-	Παράκαμψη κλάδου (προεπιλογή: από την παράμετρο repository ή main)
`include_content`	`bool`	Όχι	`true`	Συμπεριλάβετε κομμάτι περιεχομένου στα αποτελέσματα
`graph_view`	`Literal[dependency, type, data_flow, control_flow]`	Όχι	`dependency`	Προβολή γραφήματος για μετρήσεις

Καλύτερο για:

Εννοιολογικά ερωτήματα ("how does auth work?", "caching strategy")
Αναζήτηση ομοιότητας μεταξύ πακέτων

Δεν συνιστάται για:

Γνωστό όνομα συμβόλου — χρησιμοποιήστε το find_symbol αντ' αυτού
Ακριβείς συμβολοσειρές ή μηνύματα σφάλματος — χρησιμοποιήστε το text_pattern_search

text_pattern_searchΣταθερό

Αναζήτηση περιεχομένου με ευρετήριο. Ακριβής και regex λειτουργίες grep το πλήρες σώμα του αρχείου/blob. Η λειτουργία ασαφούς περιεχομένου αναζητά το οριοθετημένο σημασιολογικό τμήμα του σώματος. Τα πεδία αρχείων και συμβόλων είναι μόνο ασαφή. Χρησιμοποιήστε τον τοπικό Grep για έναν στενό κατάλογο που βρίσκεται ήδη στο δίσκο.

Παράμετροι:

queryΑπαιτείται

Τύπος: str
Περιγραφή: Μοτίβο κειμένου για αναζήτηση

repositoryΠροαιρετικό

Τύπος: str
Περιγραφή: Αποθετήριο ως owner/repo[:branch]. Προαιρετικό — παραλείψτε το για να χρησιμοποιηθεί η προεπιλογή του client για το συγκεκριμένο αίτημα (αν παρέχεται) ή το μοναδικό προσβάσιμο αποθετήριο· δώστε το ρητά μόνο για διαφορετικό ευρετηριασμένο repo. Η απόκριση δείχνει ποιο αποθετήριο χρησιμοποιήθηκε.

modeΠροαιρετικό

Τύπος: Literal[fuzzy, exact, regex]
Προεπιλογή: exact
Περιγραφή: Λειτουργία αναζήτησης

search_scopeΠροαιρετικό

Τύπος: Literal[content, symbols, files]
Προεπιλογή: content
Περιγραφή: Τι να ψάξετε

limitΠροαιρετικό

Τύπος: int
Προεπιλογή: 5
Περιγραφή: Μέγιστα αποτελέσματα που επιστρέφονται σε αυτή τη σελίδα

offsetΠροαιρετικό

Τύπος: int
Περιγραφή: Παρωχημένη μετατόπιση συμβατότητας. Προτιμήστε το cursor από το pagination.next_cursor.

cursorΠροαιρετικό

Τύπος: str
Περιγραφή: Αδιαφανές cursor από το pagination.next_cursor. Περάστε το αμετάβλητο και κρατήστε το query και τα φίλτρα αμετάβλητα.

language_filterΠροαιρετικό

Τύπος: str
Περιγραφή: Φίλτρο γλώσσας

path_filterΠροαιρετικό

Τύπος: str
Περιγραφή: Φιλτράρισμα κατά πρόθεμα διαδρομής αρχείου

case_sensitiveΠροαιρετικό

Τύπος: bool
Προεπιλογή
Περιγραφή: Ταίριασμα με διάκριση πεζών-κεφαλαίων

branchΠροαιρετικό

Τύπος: str
Περιγραφή: Παράκαμψη κλάδου

fuzzy_algorithmΠροαιρετικό

Τύπος: Literal[hybrid, trigram, levenshtein]
Προεπιλογή: hybrid
Περιγραφή: Ασαφής αλγόριθμος αντιστοίχισης

thresholdΠροαιρετικό

Τύπος: float
Προεπιλογή: 0.05
Περιγραφή: Ελάχιστο όριο ομοιότητας για ασαφές

semantic_fallbackΠροαιρετικό

Τύπος: bool
Προεπιλογή
Περιγραφή: Επιστρέψτε στη σημασιολογική αναζήτηση εάν δεν υπάρχουν αποτελέσματα

Παράμετρος	Τύπος	Απαιτείται	Προεπιλογή	Περιγραφή
`query`	`str`	Ναι	-	Μοτίβο κειμένου για αναζήτηση
`repository`	`str`	Όχι	-	Αποθετήριο ως owner/repo[:branch]. Προαιρετικό — παραλείψτε το για να χρησιμοποιηθεί η προεπιλογή του client για το συγκεκριμένο αίτημα (αν παρέχεται) ή το μοναδικό προσβάσιμο αποθετήριο· δώστε το ρητά μόνο για διαφορετικό ευρετηριασμένο repo. Η απόκριση δείχνει ποιο αποθετήριο χρησιμοποιήθηκε.
`mode`	`Literal[fuzzy, exact, regex]`	Όχι	`exact`	Λειτουργία αναζήτησης
`search_scope`	`Literal[content, symbols, files]`	Όχι	`content`	Τι να ψάξετε
`limit`	`int`	Όχι	`5`	Μέγιστα αποτελέσματα που επιστρέφονται σε αυτή τη σελίδα
`offset`	`int`	Όχι	-	Παρωχημένη μετατόπιση συμβατότητας. Προτιμήστε το cursor από το pagination.next_cursor.
`cursor`	`str`	Όχι	-	Αδιαφανές cursor από το pagination.next_cursor. Περάστε το αμετάβλητο και κρατήστε το query και τα φίλτρα αμετάβλητα.
`language_filter`	`str`	Όχι	-	Φίλτρο γλώσσας
`path_filter`	`str`	Όχι	-	Φιλτράρισμα κατά πρόθεμα διαδρομής αρχείου
`case_sensitive`	`bool`	Όχι		Ταίριασμα με διάκριση πεζών-κεφαλαίων
`branch`	`str`	Όχι	-	Παράκαμψη κλάδου
`fuzzy_algorithm`	`Literal[hybrid, trigram, levenshtein]`	Όχι	`hybrid`	Ασαφής αλγόριθμος αντιστοίχισης
`threshold`	`float`	Όχι	`0.05`	Ελάχιστο όριο ομοιότητας για ασαφές
`semantic_fallback`	`bool`	Όχι		Επιστρέψτε στη σημασιολογική αναζήτηση εάν δεν υπάρχουν αποτελέσματα

Καλύτερο για:

Ακριβείς συμβολοσειρές, μηνύματα σφάλματος και regex
Ασαφής αντιστοίχιση με τριγράμματα για σχεδόν συμπίπτον κείμενο

Δεν συνιστάται για:

Γνωστή διαδρομή στον δίσκο — προτιμήστε το τοπικό Grep
Εννοιολογικά ερωτήματα — χρησιμοποιήστε το semantic_search

Εργαλεία δομής & γράφου#

structural_searchΣταθερό

Προτιμήστε preset=functions|classes|methods|imports|variables (ή ελεύθερο pattern=). Βρείτε κώδικα κατά σχήμα AST (όχι κείμενο). Φίλτρα μεσαίου επιπέδου: name_pattern, node_type, decorator, parent_child. Τα φίλτρα path/ltree/call είναι προχωρημένα — ορίστε advanced=true όταν τα χρησιμοποιείτε σκόπιμα· τα επίπεδα κλειδιά advanced εξακολουθούν να γίνονται δεκτά για συμβατότητα προς τα πίσω. Δώστε τουλάχιστον έναν δομικό επιλογέα.

Παράμετροι:

repositoryΠροαιρετικό

Τύπος: str
Περιγραφή: Αποθετήριο ως owner/repo[:branch]. Προαιρετικό — παραλείψτε το για να χρησιμοποιηθεί η προεπιλογή του client για το συγκεκριμένο αίτημα (αν παρέχεται) ή το μοναδικό προσβάσιμο αποθετήριο· δώστε το ρητά μόνο για διαφορετικό ευρετηριασμένο repo. Η απόκριση δείχνει ποιο αποθετήριο χρησιμοποιήθηκε.

presetΠροαιρετικό

Τύπος: Literal[functions, classes, methods, imports, variables]
Περιγραφή: Προτιμώμενος δομικός επιλογέας. Επεκτείνεται σε τύπους κόμβων AST πολλαπλών γλωσσών — functions (ορισμοί function/arrow/method σε διάφορες γλώσσες)· classes (ορισμοί class/struct/impl)· methods (ορισμοί method (και function_definition για γλώσσες χωρίς κόμβο method))· imports (δηλώσεις import/use/include)· variables (δηλώσεις variable/let/const/static). Προτιμήστε το έναντι ελεύθερου pattern/node_type για ερωτήματα τύπου περιήγησης.

patternΠροαιρετικό

Τύπος: str
Περιγραφή: Μοτίβο ελεύθερης μορφής όταν οι προρυθμίσεις είναι υπερβολικά αδρά (αυτόματη ανίχνευση: 'def foo(' → node_type + name_pattern). Προτιμήστε preset= για ερωτήματα περιήγησης.

name_patternΠροαιρετικό

Τύπος: str
Περιγραφή: Μοτίβο ονόματος συμβόλου (shell wildcard, οριοθετημένο POSIX regex ή ασαφές κείμενο· έως 256 χαρακτήρες)

node_typeΠροαιρετικό

Τύπος: str
Περιγραφή: Τύπος κόμβου AST (function_definition, class_definition, κ.λπ.) — προτιμήστε preset= για κοινά σχήματα

decoratorΠροαιρετικό

Τύπος: str
Περιγραφή: Φίλτρο ονόματος decorator

base_classΠροαιρετικό

Τύπος: str
Περιγραφή: Φίλτρο βασικής κλάσης

language_filterΠροαιρετικό

Τύπος: str
Περιγραφή: Φίλτρο γλώσσας (python, typescript κ.λπ.)

limitΠροαιρετικό

Τύπος: int
Προεπιλογή: 20
Περιγραφή: Μέγιστα αποτελέσματα που επιστρέφονται σε αυτή τη σελίδα

offsetΠροαιρετικό

Τύπος: int
Περιγραφή: Παρωχημένη μετατόπιση συμβατότητας. Προτιμήστε το cursor από το pagination.next_cursor.

cursorΠροαιρετικό

Τύπος: str
Περιγραφή: Αδιαφανές cursor από το pagination.next_cursor. Περάστε το αμετάβλητο και κρατήστε το query και τα φίλτρα αμετάβλητα.

path_filterΠροαιρετικό

Τύπος: str
Περιγραφή: Φιλτράρισμα κατά πρόθεμα διαδρομής αρχείου

branchΠροαιρετικό

Τύπος: str
Περιγραφή: Παράκαμψη κλάδου

query_typeΠροαιρετικό

Τύπος: Literal[node_type, name_pattern, parent_child]
Περιγραφή: Σαφής τύπος ερωτήματος

parent_typeΠροαιρετικό

Τύπος: str
Περιγραφή: Γονικό φίλτρο τύπου κόμβου AST

relationshipΠροαιρετικό

Τύπος: Literal[parent, ancestor]
Προεπιλογή: parent
Περιγραφή: Για ερωτήματα parent_child: μόνο άμεσος γονέας ή οποιοσδήποτε πρόγονος (χρησιμοποιήστε τον πρόγονο για μεθόδους κλάσης που είναι ένθετες κάτω από σώμα/μπλοκ κλάσης)

has_modifierΠροαιρετικό

Τύπος: str
Περιγραφή: Φιλτράρισμα κατά τροποποιητή (εξαγωγή, ασυγχρονισμός, στατικό κ.λπ.)

advancedΠροαιρετικό

Τύπος: bool
Προεπιλογή
Περιγραφή: Ορίστε το true όταν χρησιμοποιείτε σκόπιμα φίλτρα προηγμένης διαδρομής, ltree ή κλήσεων (ltree_ancestor, ltree_descendant, min_depth, max_depth, field_role, definition_name, callee_text, callee_name). Από προεπιλογή, το false διατηρεί τη διεπαφή πράκτορα εστιασμένη σε προεπιλογές. Τα σύνθετα κλειδιά σε επίπεδη μορφή εξακολουθούν να λειτουργούν για συμβατότητα προς τα πίσω, με μια προειδοποίηση μεταδεδομένων.

callee_textΠροαιρετικό

Τύπος: str
Περιγραφή: Προχωρημένο — προτιμήστε preset=functions|classes|methods|imports|variables. Φίλτρο κειμένου καλούμενου (callee) έκφρασης κλήσης. Ορίστε advanced=true όταν χρησιμοποιείτε σκόπιμα φίλτρα path/ltree/call.

callee_nameΠροαιρετικό

Τύπος: str
Περιγραφή: Προχωρημένο — προτιμήστε preset=functions|classes|methods|imports|variables. Φίλτρο ονόματος καλούμενου (callee) έκφρασης κλήσης. Ορίστε advanced=true όταν χρησιμοποιείτε σκόπιμα φίλτρα path/ltree/call.

field_roleΠροαιρετικό

Τύπος: str
Περιγραφή: Προχωρημένο — προτιμήστε preset=functions|classes|methods|imports|variables. Φίλτρο ρόλου πεδίου AST. Ορίστε advanced=true όταν χρησιμοποιείτε σκόπιμα φίλτρα path/ltree/call.

ltree_ancestorΠροαιρετικό

Τύπος: str
Περιγραφή: Προχωρημένο — προτιμήστε preset=functions|classes|methods|imports|variables. Φίλτρο διαδρομής προγόνου ltree του AST. Ορίστε advanced=true όταν χρησιμοποιείτε σκόπιμα φίλτρα path/ltree/call.

ltree_descendantΠροαιρετικό

Τύπος: str
Περιγραφή: Προχωρημένο — προτιμήστε preset=functions|classes|methods|imports|variables. Φίλτρο διαδρομής απογόνου ltree του AST. Ορίστε advanced=true όταν χρησιμοποιείτε σκόπιμα φίλτρα path/ltree/call.

definition_nameΠροαιρετικό

Τύπος: str
Περιγραφή: Προχωρημένο — προτιμήστε preset=functions|classes|methods|imports|variables. Φίλτρο ονόματος ορισμού. Ορίστε advanced=true όταν χρησιμοποιείτε σκόπιμα φίλτρα path/ltree/call.

min_depthΠροαιρετικό

Τύπος: int
Περιγραφή: Προχωρημένο — προτιμήστε preset=functions|classes|methods|imports|variables. Ελάχιστο βάθος AST. Ορίστε advanced=true όταν χρησιμοποιείτε σκόπιμα φίλτρα path/ltree/call.

max_depthΠροαιρετικό

Τύπος: int
Περιγραφή: Προχωρημένο — προτιμήστε preset=functions|classes|methods|imports|variables. Μέγιστο βάθος AST. Ορίστε advanced=true όταν χρησιμοποιείτε σκόπιμα φίλτρα path/ltree/call.

Παράμετρος	Τύπος	Απαιτείται	Προεπιλογή	Περιγραφή
`repository`	`str`	Όχι	-	Αποθετήριο ως owner/repo[:branch]. Προαιρετικό — παραλείψτε το για να χρησιμοποιηθεί η προεπιλογή του client για το συγκεκριμένο αίτημα (αν παρέχεται) ή το μοναδικό προσβάσιμο αποθετήριο· δώστε το ρητά μόνο για διαφορετικό ευρετηριασμένο repo. Η απόκριση δείχνει ποιο αποθετήριο χρησιμοποιήθηκε.
`preset`	`Literal[functions, classes, methods, imports, variables]`	Όχι	-	Προτιμώμενος δομικός επιλογέας. Επεκτείνεται σε τύπους κόμβων AST πολλαπλών γλωσσών — functions (ορισμοί function/arrow/method σε διάφορες γλώσσες)· classes (ορισμοί class/struct/impl)· methods (ορισμοί method (και function_definition για γλώσσες χωρίς κόμβο method))· imports (δηλώσεις import/use/include)· variables (δηλώσεις variable/let/const/static). Προτιμήστε το έναντι ελεύθερου pattern/node_type για ερωτήματα τύπου περιήγησης.
`pattern`	`str`	Όχι	-	Μοτίβο ελεύθερης μορφής όταν οι προρυθμίσεις είναι υπερβολικά αδρά (αυτόματη ανίχνευση: 'def foo(' → node_type + name_pattern). Προτιμήστε preset= για ερωτήματα περιήγησης.
`name_pattern`	`str`	Όχι	-	Μοτίβο ονόματος συμβόλου (shell wildcard, οριοθετημένο POSIX regex ή ασαφές κείμενο· έως 256 χαρακτήρες)
`node_type`	`str`	Όχι	-	Τύπος κόμβου AST (function_definition, class_definition, κ.λπ.) — προτιμήστε preset= για κοινά σχήματα
`decorator`	`str`	Όχι	-	Φίλτρο ονόματος decorator
`base_class`	`str`	Όχι	-	Φίλτρο βασικής κλάσης
`language_filter`	`str`	Όχι	-	Φίλτρο γλώσσας (python, typescript κ.λπ.)
`limit`	`int`	Όχι	`20`	Μέγιστα αποτελέσματα που επιστρέφονται σε αυτή τη σελίδα
`offset`	`int`	Όχι	-	Παρωχημένη μετατόπιση συμβατότητας. Προτιμήστε το cursor από το pagination.next_cursor.
`cursor`	`str`	Όχι	-	Αδιαφανές cursor από το pagination.next_cursor. Περάστε το αμετάβλητο και κρατήστε το query και τα φίλτρα αμετάβλητα.
`path_filter`	`str`	Όχι	-	Φιλτράρισμα κατά πρόθεμα διαδρομής αρχείου
`branch`	`str`	Όχι	-	Παράκαμψη κλάδου
`query_type`	`Literal[node_type, name_pattern, parent_child]`	Όχι	-	Σαφής τύπος ερωτήματος
`parent_type`	`str`	Όχι	-	Γονικό φίλτρο τύπου κόμβου AST
`relationship`	`Literal[parent, ancestor]`	Όχι	`parent`	Για ερωτήματα parent_child: μόνο άμεσος γονέας ή οποιοσδήποτε πρόγονος (χρησιμοποιήστε τον πρόγονο για μεθόδους κλάσης που είναι ένθετες κάτω από σώμα/μπλοκ κλάσης)
`has_modifier`	`str`	Όχι	-	Φιλτράρισμα κατά τροποποιητή (εξαγωγή, ασυγχρονισμός, στατικό κ.λπ.)
`advanced`	`bool`	Όχι		Ορίστε το true όταν χρησιμοποιείτε σκόπιμα φίλτρα προηγμένης διαδρομής, ltree ή κλήσεων (ltree_ancestor, ltree_descendant, min_depth, max_depth, field_role, definition_name, callee_text, callee_name). Από προεπιλογή, το false διατηρεί τη διεπαφή πράκτορα εστιασμένη σε προεπιλογές. Τα σύνθετα κλειδιά σε επίπεδη μορφή εξακολουθούν να λειτουργούν για συμβατότητα προς τα πίσω, με μια προειδοποίηση μεταδεδομένων.
`callee_text`	`str`	Όχι	-	Προχωρημένο — προτιμήστε preset=functions\|classes\|methods\|imports\|variables. Φίλτρο κειμένου καλούμενου (callee) έκφρασης κλήσης. Ορίστε advanced=true όταν χρησιμοποιείτε σκόπιμα φίλτρα path/ltree/call.
`callee_name`	`str`	Όχι	-	Προχωρημένο — προτιμήστε preset=functions\|classes\|methods\|imports\|variables. Φίλτρο ονόματος καλούμενου (callee) έκφρασης κλήσης. Ορίστε advanced=true όταν χρησιμοποιείτε σκόπιμα φίλτρα path/ltree/call.
`field_role`	`str`	Όχι	-	Προχωρημένο — προτιμήστε preset=functions\|classes\|methods\|imports\|variables. Φίλτρο ρόλου πεδίου AST. Ορίστε advanced=true όταν χρησιμοποιείτε σκόπιμα φίλτρα path/ltree/call.
`ltree_ancestor`	`str`	Όχι	-	Προχωρημένο — προτιμήστε preset=functions\|classes\|methods\|imports\|variables. Φίλτρο διαδρομής προγόνου ltree του AST. Ορίστε advanced=true όταν χρησιμοποιείτε σκόπιμα φίλτρα path/ltree/call.
`ltree_descendant`	`str`	Όχι	-	Προχωρημένο — προτιμήστε preset=functions\|classes\|methods\|imports\|variables. Φίλτρο διαδρομής απογόνου ltree του AST. Ορίστε advanced=true όταν χρησιμοποιείτε σκόπιμα φίλτρα path/ltree/call.
`definition_name`	`str`	Όχι	-	Προχωρημένο — προτιμήστε preset=functions\|classes\|methods\|imports\|variables. Φίλτρο ονόματος ορισμού. Ορίστε advanced=true όταν χρησιμοποιείτε σκόπιμα φίλτρα path/ltree/call.
`min_depth`	`int`	Όχι	-	Προχωρημένο — προτιμήστε preset=functions\|classes\|methods\|imports\|variables. Ελάχιστο βάθος AST. Ορίστε advanced=true όταν χρησιμοποιείτε σκόπιμα φίλτρα path/ltree/call.
`max_depth`	`int`	Όχι	-	Προχωρημένο — προτιμήστε preset=functions\|classes\|methods\|imports\|variables. Μέγιστο βάθος AST. Ορίστε advanced=true όταν χρησιμοποιείτε σκόπιμα φίλτρα path/ltree/call.

Καλύτερο για:

Δομή σε επίπεδο AST: κλάσεις, διακοσμητές, προεπιλογές συναρτήσεων/μεθόδων
Εύρεση κώδικα βάσει σχήματος αντί για κείμενο

Δεν συνιστάται για:

Ερωτήματα ελεύθερου κειμένου ή εννοιολογικά — χρησιμοποιήστε το semantic_search ή το intelligent_search

dependency_searchΣταθερό

Κύρια επιφάνεια blast-radius / γραφήματος. Απαντήστε "τι καλεί αυτό;" / "τι χρησιμοποιεί αυτό;" μέσω του πραγματικού γραφήματος call/import. Για επίπτωση πριν την επεξεργασία: analysis_type="dependents" ή analysis_type="impact" (incoming, προεπιλογή shallow για impact), include_metrics=false εξ ορισμού (ενεργοποιήστε το για centrality + refactor_risk). Επίπτωση PR/diff (P1-8): περάστε changed_paths ή/και patch (unified diff) — αναλύει σύμβολα ανά διαδρομή και επιστρέφει ένα συμπαγές ωφέλιμο φορτίο dependents τύπου shallow-incoming χωρίς να απαιτείται όνομα συμβόλου. Μετά από επεξεργασία, ορίστε verify_after_edit=true με targets ή/και changed_paths για ένα συμπαγές ερώτημα πολλαπλών ριζών των επηρεαζόμενων συμβόλων. Υποστηρίζει επίσης dependencies, centrality και orphans. Το analyze_dependencies είναι ένα λεπτό ψευδώνυμο για τη διαδρομή impact — προτιμήστε αυτό το εργαλείο για νέους πράκτορες.

Παράμετροι:

repositoryΠροαιρετικό

Τύπος: str
Περιγραφή: Αποθετήριο ως owner/repo[:branch]. Προαιρετικό — παραλείψτε το για να χρησιμοποιηθεί η προεπιλογή του client για το συγκεκριμένο αίτημα (αν παρέχεται) ή το μοναδικό προσβάσιμο αποθετήριο· δώστε το ρητά μόνο για διαφορετικό ευρετηριασμένο repo. Η απόκριση δείχνει ποιο αποθετήριο χρησιμοποιήθηκε.

queryΠροαιρετικό

Τύπος: str
Περιγραφή: Όνομα συμβόλου ή όρος αναζήτησης

targetΠροαιρετικό

Τύπος: str
Περιγραφή: Όνομα συμβόλου (ψευδώνυμο για ερώτημα)

changed_pathsΠροαιρετικό

Τύπος: list[str]
Περιγραφή: Repo-σχετικές διαδρομές για επιρροή PR/diff (προεπιλογή) ή, με verify_after_edit=true, ρίζες επαλήθευσης μετά την επεξεργασία. PR/diff: επιλύει σύμβολα ανά διαδρομή και περπατά ρηχά εισερχόμενα εξαρτημένα άτομα. μπορεί να συνδυαστεί με το patch=. Επαλήθευση: επιλύει έως και 5 σύμβολα ανά διαδρομή ως ρίζες επαλήθευσης (περιορίζεται χαμηλότερα στη λειτουργία επαλήθευσης). Δεν απαιτεί query/target για κρούση PR/diff.

patchΠροαιρετικό

Τύπος: str
Περιγραφή: Αντίκτυπος PR/diff: ενοποιημένο κείμενο ενημέρωσης κώδικα διαφοράς / git. Οι διαδρομές αναλύονται από τις κεφαλίδες diff --git / --- / +++. ίδια συμπαγής διαδρομή πρόσκρουσης με το changed_paths.

analysis_typeΠροαιρετικό

Τύπος: Literal[centrality, dependencies, dependents, impact, orphans]
Προεπιλογή: dependencies
Περιγραφή: Λειτουργία ανάλυσης. impact = ακτίνα επίπτωσης (εισερχόμενα dependents· βάθος shallow όταν παραλείπεται το depth). Το dependents απαντά επίσης στο impact. Όταν ορίζονται changed_paths ή patch, η ανάλυση εξαναγκάζεται σε επίπτωση PR/diff. Τα centrality/orphans δεν απαιτούν στόχο.

depthΠροαιρετικό

Τύπος: Literal[shallow, balanced, deep]
Προεπιλογή: balanced
Περιγραφή: Βάθος διέλευσης. Για analysis_type=impact και επίπτωση PR/diff, η ενεργή προεπιλογή είναι shallow εκτός αν ορίσετε ρητά το depth.

limitΠροαιρετικό

Τύπος: int
Προεπιλογή: 20
Περιγραφή: Μέγιστα αποτελέσματα που επιστρέφονται σε αυτή τη σελίδα

offsetΠροαιρετικό

Τύπος: int
Περιγραφή: Παρωχημένη μετατόπιση συμβατότητας. Προτιμήστε το cursor από το pagination.next_cursor.

cursorΠροαιρετικό

Τύπος: str
Περιγραφή: Αδιαφανές cursor από το pagination.next_cursor. Περάστε το αμετάβλητο και κρατήστε το query και τα φίλτρα αμετάβλητα.

path_filterΠροαιρετικό

Τύπος: str
Περιγραφή: Περιορίστε την ανάλυση του συμβόλου-στόχου με πρόθεμα διαδρομής αρχείου· οι σχέσεις γραφήματος που επιστρέφονται ενδέχεται να εκτείνονται εκτός αυτής της διαδρομής

language_filterΠροαιρετικό

Τύπος: str
Περιγραφή: Φιλτράρισμα της ανάλυσης στόχου και των αποτελεσμάτων περιήγησης κατά γλώσσα

directionΠροαιρετικό

Τύπος: Literal[outgoing, incoming, both]
Περιγραφή: Διεύθυνση διέλευσης (παρακάμπτει το συμπέρασμα analysis_type)

relationship_typesΠροαιρετικό

Τύπος: list[str]
Περιγραφή: Φιλτράρισμα τύπων ακμών (CALL, IMPORT, INHERITS_FROM, κ.λπ.). Μια μη κενή λίστα υπερισχύει των προεπιλογών του graph_view.

exclude_test_pathsΠροαιρετικό

Τύπος: bool
Προεπιλογή: true
Περιγραφή: Προεπιλογή true: εξαίρεση διαδρομών test, fixture, vendor και παραδειγμάτων από τα αποτελέσματα διέλευσης και centrality. Ορίστε false για να συμπεριληφθούν. Η ανάλυση orphan εφαρμόζει πάντα τις δικές της αυστηρότερες εξαιρέσεις θορύβου.

exclude_generated_pathsΠροαιρετικό

Τύπος: bool
Προεπιλογή
Περιγραφή: Εξαίρεση δημιουργημένων δηλώσεων συν κατασκευής, κάλυψης, κρυφής μνήμης, χάρτη πηγής και ελαχιστοποιημένων διαδρομών τεχνουργημάτων από τα αποτελέσματα διέλευσης

include_module_symbolsΠροαιρετικό

Τύπος: bool
Προεπιλογή
Περιγραφή: Από προεπιλογή, το false εξαιρεί τις άκρες του γραφήματος όταν το from_name ή το to_name είναι το συνθετικό σύμβολο __module__ (θόρυβος σε επίπεδο μονάδας). Ρυθμίστε το true ώστε να περιλαμβάνει άκρες σε επίπεδο μονάδας στα αποτελέσματα για σχέσεις εξάρτησης και εξάρτησης.

branchΠροαιρετικό

Τύπος: str
Περιγραφή: Παράκαμψη κλάδου

per_hop_limitΠροαιρετικό

Τύπος: int
Περιγραφή: Μέγιστες σχέσεις ανά άλμα (1-300)

include_metricsΠροαιρετικό

Τύπος: bool
Προεπιλογή
Περιγραφή: Προαιρετικές μετρήσεις γραφήματος στις γραμμές αποτελεσμάτων (συμπυκνωμένες με refactor_risk). Οι μετρήσεις ανακτώνται επίσης εσωτερικά όταν min_centrality>0 αλλά δεν επιστρέφονται εκτός αν αυτό είναι true.

metrics_detailΠροαιρετικό

Τύπος: Literal[summary, full]
Προεπιλογή: summary
Περιγραφή: Όταν include_metrics=true: summary (προεπιλογή) επιστρέφει σήματα απόφασης + refactor_risk; Το full επιστρέφει το μεγαλύτερο επιλεγμένο σύνολο μετρήσεων

include_edge_metadataΠροαιρετικό

Τύπος: bool
Προεπιλογή
Περιγραφή: Συμπεριλάβετε μεταδεδομένα ακατέργαστων άκρων και βάρη (μεγάλα). Τα ωφέλιμα φορτία συμπαγούς αντίκτυπου το εγκαταλείπουν.

symbol_typesΠροαιρετικό

Τύπος: list[str]
Περιγραφή: Φιλτράρισμα των επιστρεφόμενων συμβόλων κατά είδος (function, class, method, κ.λπ.)

exact_matchΠροαιρετικό

Τύπος: bool
Προεπιλογή
Περιγραφή: Απαιτείται ακριβής αντιστοίχιση ονόματος συμβόλου

find_similar_patternsΠροαιρετικό

Τύπος: bool
Προεπιλογή
Περιγραφή: Βρείτε παρόμοια μοτίβα χρήσης

min_centralityΠροαιρετικό

Τύπος: float
Προεπιλογή: 0
Περιγραφή: Ελάχιστη βαθμολογία PageRank. Οι μετρήσεις ανακτώνται εσωτερικά για φιλτράρισμα· τα graph_metrics επιστρέφονται μόνο όταν include_metrics=true.

graph_viewΠροαιρετικό

Τύπος: Literal[dependency, type, data_flow, control_flow]
Προεπιλογή: dependency
Περιγραφή: Προβολή γραφήματος που χρησιμοποιείται για τις προεπιλογές σχέσεων διέλευσης, τις μετρήσεις και την κατάταξη κεντρικότητας· η ανάλυση orphan υπολογίζεται σε όλες τις προβολές

verify_after_editΠροαιρετικό

Τύπος: bool
Προεπιλογή
Περιγραφή: Λειτουργία επαλήθευσης μετά την επεξεργασία P2-7: ρωτήστε ξανά το ευρετηριασμένο γράφημα επιπτώσεων για σύμβολα που επεξεργάστηκαν πρόσφατα σε μία συμπαγή απάντηση πολλαπλών ριζών. Απαιτεί targets ή/και changed_paths (ή target/query). Προεπιλογές σε ρηχά εισερχόμενα εξαρτώμενα άτομα. Τα αποτελέσματα αντικατοπτρίζουν το ευρετηριασμένο γράφημα (μπορεί να καθυστερούν τις ζωντανές επεξεργασίες). Όταν ισχύει, υπερισχύει του αντίκτυπου PR/diff στο ίδιο changed_paths.

targetsΠροαιρετικό

Τύπος: list[str]
Περιγραφή: Πότε verify_after_edit=true: ονόματα συμβόλων προς επαλήθευση εκ νέου (καλούντες/εξαρτώμενα άτομα). Συγχωνεύεται με το target/query εάν παρέχονται και τα δύο.

Παράμετρος	Τύπος	Απαιτείται	Προεπιλογή	Περιγραφή
`repository`	`str`	Όχι	-	Αποθετήριο ως owner/repo[:branch]. Προαιρετικό — παραλείψτε το για να χρησιμοποιηθεί η προεπιλογή του client για το συγκεκριμένο αίτημα (αν παρέχεται) ή το μοναδικό προσβάσιμο αποθετήριο· δώστε το ρητά μόνο για διαφορετικό ευρετηριασμένο repo. Η απόκριση δείχνει ποιο αποθετήριο χρησιμοποιήθηκε.
`query`	`str`	Όχι	-	Όνομα συμβόλου ή όρος αναζήτησης
`target`	`str`	Όχι	-	Όνομα συμβόλου (ψευδώνυμο για ερώτημα)
`changed_paths`	`list[str]`	Όχι	-	Repo-σχετικές διαδρομές για επιρροή PR/diff (προεπιλογή) ή, με verify_after_edit=true, ρίζες επαλήθευσης μετά την επεξεργασία. PR/diff: επιλύει σύμβολα ανά διαδρομή και περπατά ρηχά εισερχόμενα εξαρτημένα άτομα. μπορεί να συνδυαστεί με το patch=. Επαλήθευση: επιλύει έως και 5 σύμβολα ανά διαδρομή ως ρίζες επαλήθευσης (περιορίζεται χαμηλότερα στη λειτουργία επαλήθευσης). Δεν απαιτεί query/target για κρούση PR/diff.
`patch`	`str`	Όχι	-	Αντίκτυπος PR/diff: ενοποιημένο κείμενο ενημέρωσης κώδικα διαφοράς / git. Οι διαδρομές αναλύονται από τις κεφαλίδες diff --git / --- / +++. ίδια συμπαγής διαδρομή πρόσκρουσης με το changed_paths.
`analysis_type`	`Literal[centrality, dependencies, dependents, impact, orphans]`	Όχι	`dependencies`	Λειτουργία ανάλυσης. impact = ακτίνα επίπτωσης (εισερχόμενα dependents· βάθος shallow όταν παραλείπεται το depth). Το dependents απαντά επίσης στο impact. Όταν ορίζονται changed_paths ή patch, η ανάλυση εξαναγκάζεται σε επίπτωση PR/diff. Τα centrality/orphans δεν απαιτούν στόχο.
`depth`	`Literal[shallow, balanced, deep]`	Όχι	`balanced`	Βάθος διέλευσης. Για analysis_type=impact και επίπτωση PR/diff, η ενεργή προεπιλογή είναι shallow εκτός αν ορίσετε ρητά το depth.
`limit`	`int`	Όχι	`20`	Μέγιστα αποτελέσματα που επιστρέφονται σε αυτή τη σελίδα
`offset`	`int`	Όχι	-	Παρωχημένη μετατόπιση συμβατότητας. Προτιμήστε το cursor από το pagination.next_cursor.
`cursor`	`str`	Όχι	-	Αδιαφανές cursor από το pagination.next_cursor. Περάστε το αμετάβλητο και κρατήστε το query και τα φίλτρα αμετάβλητα.
`path_filter`	`str`	Όχι	-	Περιορίστε την ανάλυση του συμβόλου-στόχου με πρόθεμα διαδρομής αρχείου· οι σχέσεις γραφήματος που επιστρέφονται ενδέχεται να εκτείνονται εκτός αυτής της διαδρομής
`language_filter`	`str`	Όχι	-	Φιλτράρισμα της ανάλυσης στόχου και των αποτελεσμάτων περιήγησης κατά γλώσσα
`direction`	`Literal[outgoing, incoming, both]`	Όχι	-	Διεύθυνση διέλευσης (παρακάμπτει το συμπέρασμα analysis_type)
`relationship_types`	`list[str]`	Όχι	-	Φιλτράρισμα τύπων ακμών (CALL, IMPORT, INHERITS_FROM, κ.λπ.). Μια μη κενή λίστα υπερισχύει των προεπιλογών του graph_view.
`exclude_test_paths`	`bool`	Όχι	`true`	Προεπιλογή true: εξαίρεση διαδρομών test, fixture, vendor και παραδειγμάτων από τα αποτελέσματα διέλευσης και centrality. Ορίστε false για να συμπεριληφθούν. Η ανάλυση orphan εφαρμόζει πάντα τις δικές της αυστηρότερες εξαιρέσεις θορύβου.
`exclude_generated_paths`	`bool`	Όχι		Εξαίρεση δημιουργημένων δηλώσεων συν κατασκευής, κάλυψης, κρυφής μνήμης, χάρτη πηγής και ελαχιστοποιημένων διαδρομών τεχνουργημάτων από τα αποτελέσματα διέλευσης
`include_module_symbols`	`bool`	Όχι		Από προεπιλογή, το false εξαιρεί τις άκρες του γραφήματος όταν το from_name ή το to_name είναι το συνθετικό σύμβολο __module__ (θόρυβος σε επίπεδο μονάδας). Ρυθμίστε το true ώστε να περιλαμβάνει άκρες σε επίπεδο μονάδας στα αποτελέσματα για σχέσεις εξάρτησης και εξάρτησης.
`branch`	`str`	Όχι	-	Παράκαμψη κλάδου
`per_hop_limit`	`int`	Όχι	-	Μέγιστες σχέσεις ανά άλμα (1-300)
`include_metrics`	`bool`	Όχι		Προαιρετικές μετρήσεις γραφήματος στις γραμμές αποτελεσμάτων (συμπυκνωμένες με refactor_risk). Οι μετρήσεις ανακτώνται επίσης εσωτερικά όταν min_centrality>0 αλλά δεν επιστρέφονται εκτός αν αυτό είναι true.
`metrics_detail`	`Literal[summary, full]`	Όχι	`summary`	Όταν include_metrics=true: summary (προεπιλογή) επιστρέφει σήματα απόφασης + refactor_risk; Το full επιστρέφει το μεγαλύτερο επιλεγμένο σύνολο μετρήσεων
`include_edge_metadata`	`bool`	Όχι		Συμπεριλάβετε μεταδεδομένα ακατέργαστων άκρων και βάρη (μεγάλα). Τα ωφέλιμα φορτία συμπαγούς αντίκτυπου το εγκαταλείπουν.
`symbol_types`	`list[str]`	Όχι	-	Φιλτράρισμα των επιστρεφόμενων συμβόλων κατά είδος (function, class, method, κ.λπ.)
`exact_match`	`bool`	Όχι		Απαιτείται ακριβής αντιστοίχιση ονόματος συμβόλου
`find_similar_patterns`	`bool`	Όχι		Βρείτε παρόμοια μοτίβα χρήσης
`min_centrality`	`float`	Όχι	`0`	Ελάχιστη βαθμολογία PageRank. Οι μετρήσεις ανακτώνται εσωτερικά για φιλτράρισμα· τα graph_metrics επιστρέφονται μόνο όταν include_metrics=true.
`graph_view`	`Literal[dependency, type, data_flow, control_flow]`	Όχι	`dependency`	Προβολή γραφήματος που χρησιμοποιείται για τις προεπιλογές σχέσεων διέλευσης, τις μετρήσεις και την κατάταξη κεντρικότητας· η ανάλυση orphan υπολογίζεται σε όλες τις προβολές
`verify_after_edit`	`bool`	Όχι		Λειτουργία επαλήθευσης μετά την επεξεργασία P2-7: ρωτήστε ξανά το ευρετηριασμένο γράφημα επιπτώσεων για σύμβολα που επεξεργάστηκαν πρόσφατα σε μία συμπαγή απάντηση πολλαπλών ριζών. Απαιτεί targets ή/και changed_paths (ή target/query). Προεπιλογές σε ρηχά εισερχόμενα εξαρτώμενα άτομα. Τα αποτελέσματα αντικατοπτρίζουν το ευρετηριασμένο γράφημα (μπορεί να καθυστερούν τις ζωντανές επεξεργασίες). Όταν ισχύει, υπερισχύει του αντίκτυπου PR/diff στο ίδιο changed_paths.
`targets`	`list[str]`	Όχι	-	Πότε verify_after_edit=true: ονόματα συμβόλων προς επαλήθευση εκ νέου (καλούντες/εξαρτώμενα άτομα). Συγχωνεύεται με το target/query εάν παρέχονται και τα δύο.

Καλύτερο για:

Ανάλυση ακτίνας επίδρασης πριν την επεξεργασία ενός κοινόχρηστου συμβόλου
Επίδραση PR/diff μέσω changed_paths ή patch
Επαλήθευση μετά την επεξεργασία μέσω verify_after_edit

Δεν συνιστάται για:

Απλές αναζητήσεις κειμένου ή συμβόλων — χρησιμοποιήστε το text_pattern_search ή το find_symbol

Εργαλεία ανάλυσης κώδικα#

find_symbolΣταθερό

Μετάβαση στο σημείο όπου ορίζεται και χρησιμοποιείται μια συνάρτηση, κλάση ή μεταβλητή. Χρησιμοποιήστε το όταν γνωρίζετε το όνομα (π.χ. "getCurrentUser") — πιο γρήγορα και με μεγαλύτερη ακρίβεια από το Grep και καλύπτει ολόκληρο το αποθετήριο με ευρετήριο. Επιστρέφει προαιρετικά αναφορές και μετρήσεις σημασίας.

Παράμετροι:

symbol_nameΠροαιρετικό

Τύπος: str
Περιγραφή: Όνομα συμβόλου για αναζήτηση (προαιρετικό — παράλειψη περιήγησης βάσει μετρήσεων)

repositoryΠροαιρετικό

Τύπος: str
Περιγραφή: Αποθετήριο ως owner/repo[:branch]. Προαιρετικό — παραλείψτε το για να χρησιμοποιηθεί η προεπιλογή του client για το συγκεκριμένο αίτημα (αν παρέχεται) ή το μοναδικό προσβάσιμο αποθετήριο· δώστε το ρητά μόνο για διαφορετικό ευρετηριασμένο repo. Η απόκριση δείχνει ποιο αποθετήριο χρησιμοποιήθηκε.

scopeΠροαιρετικό

Τύπος: Literal[definitions, references, both]
Προεπιλογή: both
Περιγραφή: Εύρος αναζήτησης

limitΠροαιρετικό

Τύπος: int
Προεπιλογή: 15
Περιγραφή: Μέγιστα αποτελέσματα που επιστρέφονται σε αυτή τη σελίδα

offsetΠροαιρετικό

Τύπος: int
Περιγραφή: Παρωχημένη μετατόπιση συμβατότητας. Προτιμήστε το cursor από το pagination.next_cursor.

cursorΠροαιρετικό

Τύπος: str
Περιγραφή: Αδιαφανές cursor από το pagination.next_cursor. Περάστε το αμετάβλητο και κρατήστε το query και τα φίλτρα αμετάβλητα.

find_similarΠροαιρετικό

Τύπος: bool
Προεπιλογή
Περιγραφή: Συμπεριλάβετε παρόμοια ονόματα συμβόλων

include_metricsΠροαιρετικό

Τύπος: bool
Προεπιλογή
Περιγραφή: Συμπεριλάβετε μετρήσεις κεντρικότητας

metrics_detailΠροαιρετικό

Τύπος: Literal[summary, full]
Προεπιλογή: summary
Περιγραφή: Όταν include_metrics=true: summary (προεπιλογή) επιστρέφει σήματα απόφασης + refactor_risk; Το full επιστρέφει το μεγαλύτερο επιλεγμένο σύνολο μετρήσεων

path_filterΠροαιρετικό

Τύπος: str
Περιγραφή: Φιλτράρισμα κατά πρόθεμα διαδρομής αρχείου

branchΠροαιρετικό

Τύπος: str
Περιγραφή: Παράκαμψη κλάδου

symbol_typeΠροαιρετικό

Τύπος: Literal[function, class, variable, method, constant, module, interface, type]
Περιγραφή: Φιλτράρισμα κατά τύπο συμβόλου

high_impactΠροαιρετικό

Τύπος: bool
Προεπιλογή
Περιγραφή: Περιηγηθείτε σε αρχιτεκτονικά σημαντικά σύμβολα (παραλείψτε το symbol_name). Η προεπιλεγμένη λειτουργία είναι δημοφιλία (ανώτατο δεκατημόριο PageRank εξαιρώντας τους γιγαντιαίους κόμβους κοινής ωφέλειας). Ορίστε high_impact_mode=risk για σημεία άρθρωσης και γέφυρες του γράφου.

high_impact_modeΠροαιρετικό

Τύπος: Literal[popularity, risk]
Προεπιλογή: popularity
Περιγραφή: Πότε high_impact=true: δημοτικότητα = κορυφαία δεκαδική PageRank μείον χρηστικά mega-hubs/modules. κίνδυνος = σημεία άρθρωσης ταξινομημένα κατά SMV bridge_count και στη συνέχεια k_core (κίνδυνος δομικού ανασχηματιστή, όχι δημοτικότητα κόμβου)

in_cycleΠροαιρετικό

Τύπος: bool
Προεπιλογή
Περιγραφή: Φιλτράρισμα σε σύμβολα σε κύκλους εξάρτησης

exclude_test_pathsΠροαιρετικό

Τύπος: bool
Προεπιλογή: true
Περιγραφή: Κατά την περιήγηση με μετρήσεις γραφήματος, εξαιρέστε δοκιμές, fixtures, κωδικό τρίτου μέρους και παραδείγματα πριν από την κατάταξη. Η αναζήτηση με ένα επώνυμο σύμβολο παραμένει αμετάβλητη.

Παράμετρος	Τύπος	Απαιτείται	Προεπιλογή	Περιγραφή
`symbol_name`	`str`	Όχι	-	Όνομα συμβόλου για αναζήτηση (προαιρετικό — παράλειψη περιήγησης βάσει μετρήσεων)
`repository`	`str`	Όχι	-	Αποθετήριο ως owner/repo[:branch]. Προαιρετικό — παραλείψτε το για να χρησιμοποιηθεί η προεπιλογή του client για το συγκεκριμένο αίτημα (αν παρέχεται) ή το μοναδικό προσβάσιμο αποθετήριο· δώστε το ρητά μόνο για διαφορετικό ευρετηριασμένο repo. Η απόκριση δείχνει ποιο αποθετήριο χρησιμοποιήθηκε.
`scope`	`Literal[definitions, references, both]`	Όχι	`both`	Εύρος αναζήτησης
`limit`	`int`	Όχι	`15`	Μέγιστα αποτελέσματα που επιστρέφονται σε αυτή τη σελίδα
`offset`	`int`	Όχι	-	Παρωχημένη μετατόπιση συμβατότητας. Προτιμήστε το cursor από το pagination.next_cursor.
`cursor`	`str`	Όχι	-	Αδιαφανές cursor από το pagination.next_cursor. Περάστε το αμετάβλητο και κρατήστε το query και τα φίλτρα αμετάβλητα.
`find_similar`	`bool`	Όχι		Συμπεριλάβετε παρόμοια ονόματα συμβόλων
`include_metrics`	`bool`	Όχι		Συμπεριλάβετε μετρήσεις κεντρικότητας
`metrics_detail`	`Literal[summary, full]`	Όχι	`summary`	Όταν include_metrics=true: summary (προεπιλογή) επιστρέφει σήματα απόφασης + refactor_risk; Το full επιστρέφει το μεγαλύτερο επιλεγμένο σύνολο μετρήσεων
`path_filter`	`str`	Όχι	-	Φιλτράρισμα κατά πρόθεμα διαδρομής αρχείου
`branch`	`str`	Όχι	-	Παράκαμψη κλάδου
`symbol_type`	`Literal[function, class, variable, method, constant, module, interface, type]`	Όχι	-	Φιλτράρισμα κατά τύπο συμβόλου
`high_impact`	`bool`	Όχι		Περιηγηθείτε σε αρχιτεκτονικά σημαντικά σύμβολα (παραλείψτε το symbol_name). Η προεπιλεγμένη λειτουργία είναι δημοφιλία (ανώτατο δεκατημόριο PageRank εξαιρώντας τους γιγαντιαίους κόμβους κοινής ωφέλειας). Ορίστε high_impact_mode=risk για σημεία άρθρωσης και γέφυρες του γράφου.
`high_impact_mode`	`Literal[popularity, risk]`	Όχι	`popularity`	Πότε high_impact=true: δημοτικότητα = κορυφαία δεκαδική PageRank μείον χρηστικά mega-hubs/modules. κίνδυνος = σημεία άρθρωσης ταξινομημένα κατά SMV bridge_count και στη συνέχεια k_core (κίνδυνος δομικού ανασχηματιστή, όχι δημοτικότητα κόμβου)
`in_cycle`	`bool`	Όχι		Φιλτράρισμα σε σύμβολα σε κύκλους εξάρτησης
`exclude_test_paths`	`bool`	Όχι	`true`	Κατά την περιήγηση με μετρήσεις γραφήματος, εξαιρέστε δοκιμές, fixtures, κωδικό τρίτου μέρους και παραδείγματα πριν από την κατάταξη. Η αναζήτηση με ένα επώνυμο σύμβολο παραμένει αμετάβλητη.

Καλύτερο για:

Εντοπισμός του ορισμού, των αναφορών και των μετρικών γράφου ενός γνωστού συμβόλου
Περιήγηση βάσει centrality, high_impact ή in_cycle όταν παραλείπεται το symbol_name

Δεν συνιστάται για:

Εννοιολογικά ερωτήματα ή άγνωστες περιοχές — χρησιμοποιήστε το intelligent_search ή το semantic_search

analyze_dependenciesΣταθερό

Ψευδώνυμο για blast-radius μέσω dependency_search (dependents/incoming). Προτιμήστε το dependency_search με analysis_type="dependents" ή "impact" για νέους πράκτορες. Διατηρεί το παλαιό σχήμα απόκρισης impact πολλαπλών αλμάτων (graph, connection_summary, προαιρετικές μετρήσεις με refactor_risk). Χρησιμοποιήστε το graph_view για να οριοθετήσετε την οικογένεια σχέσεων: dependency (προεπιλογή), type, data_flow, control_flow.

Παράμετροι:

repositoryΠροαιρετικό

Τύπος: str
Περιγραφή: Αποθετήριο ως owner/repo[:branch]. Προαιρετικό — παραλείψτε το για να χρησιμοποιηθεί η προεπιλογή του client για το συγκεκριμένο αίτημα (αν παρέχεται) ή το μοναδικό προσβάσιμο αποθετήριο· δώστε το ρητά μόνο για διαφορετικό ευρετηριασμένο repo. Η απόκριση δείχνει ποιο αποθετήριο χρησιμοποιήθηκε.

targetΑπαιτείται

Τύπος: str
Περιγραφή: Όνομα συμβόλου προς ανάλυση

depthΠροαιρετικό

Τύπος: Literal[shallow, balanced, deep]
Προεπιλογή: balanced
Περιγραφή: Βάθος ανάλυσης

limitΠροαιρετικό

Τύπος: int
Προεπιλογή: 10
Περιγραφή: Μέγιστα αποτελέσματα που επιστρέφονται σε αυτή τη σελίδα

offsetΠροαιρετικό

Τύπος: int
Περιγραφή: Παρωχημένη μετατόπιση συμβατότητας. Προτιμήστε το cursor από το pagination.next_cursor.

cursorΠροαιρετικό

Τύπος: str
Περιγραφή: Αδιαφανές cursor από το pagination.next_cursor. Περάστε το αμετάβλητο και κρατήστε το query και τα φίλτρα αμετάβλητα.

directionΠροαιρετικό

Τύπος: Literal[incoming, outgoing, both]
Προεπιλογή: incoming
Περιγραφή: Διεύθυνση διέλευσης

relationship_typesΠροαιρετικό

Τύπος: list[str]
Περιγραφή: Τύποι ακμών φίλτρου (CALL, IMPORT, INHERITS_FROM, κ.λπ.). Παρακάμπτει πάντα την προεπιλογή που προέρχεται από το graph_view παρακάτω όταν παρέχεται.

graph_viewΠροαιρετικό

Τύπος: Literal[dependency, type, data_flow, control_flow]
Προεπιλογή: dependency
Περιγραφή: Προβολή γραφήματος: καθορίζει τόσο τους προεπιλεγμένους τύπους άκρων διέλευσης όσο και τις μετρήσεις της προβολής που χρησιμοποιούνται όταν το include_metrics=true. dependency=[CALL,IMPORT,EXPORTS,REFERENCE,INSTANTIATES] (προεπιλογή), type=[INHERITS_FROM,IMPLEMENTS,OVERRIDE,DECORATES,OF_TYPE], data_flow=[READS,WRITES,ASSIGNS_TO], control_flow=[CONTROL_FLOW,THROWS,CATCHES]. Εφαρμόζεται μόνο ως προεπιλογή relationship_types όταν το relationship_types δεν παρέχεται ρητά. Ταιριάζει με το υπάρχον όνομα παραμέτρου graph_view του dependency_search για συνέπεια μεταξύ των εργαλείων.

path_filterΠροαιρετικό

Τύπος: str
Περιγραφή: Περιορίστε την ανάλυση του συμβόλου-στόχου με πρόθεμα διαδρομής αρχείου· οι σχέσεις γραφήματος που επιστρέφονται ενδέχεται να εκτείνονται εκτός αυτής της διαδρομής

language_filterΠροαιρετικό

Τύπος: str
Περιγραφή: Φίλτρο γλώσσας

branchΠροαιρετικό

Τύπος: str
Περιγραφή: Παράκαμψη κλάδου

per_hop_limitΠροαιρετικό

Τύπος: int
Περιγραφή: Μέγιστες σχέσεις ανά άλμα (1-300)

include_metricsΠροαιρετικό

Τύπος: bool
Προεπιλογή
Περιγραφή: Συμπεριλάβετε μετρήσεις γραφήματος στα αποτελέσματα, καθεμία εμπλουτισμένη με ένα παράγωγο μπλοκ refactor_risk ({risk: "low"|"medium"|"high", is_articulation_point, bridge_count, k_core, graph_view, reasons}). Το risk είναι "low" όταν το σύμβολο δεν αποτελεί σημείο άρθρωσης στην επιλεγμένη προβολή, "medium" όταν ένα σημείο άρθρωσης γεφυρώνει λίγες ακμές και "high" όταν γεφυρώνει πολλές (ευρετικό όριο, χωρίς εμπειρική επικύρωση). Παραλείπεται για κάθε σύμβολο όταν δεν υπάρχει γραμμή μετρήσεων για αυτό το σύμβολο και την προβολή.

metrics_detailΠροαιρετικό

Τύπος: Literal[summary, full]
Προεπιλογή: summary
Περιγραφή: Όταν include_metrics=true: summary (προεπιλογή) επιστρέφει σήματα απόφασης + refactor_risk; Το full επιστρέφει το μεγαλύτερο επιλεγμένο σύνολο μετρήσεων

include_edge_metadataΠροαιρετικό

Τύπος: bool
Προεπιλογή
Περιγραφή: Συμπεριλάβετε ακατέργαστα μεταδεδομένα και βάρη. Απενεργοποιήθηκε από προεπιλογή επειδή τα μεταδεδομένα εξαγωγής μπορεί να είναι μεγάλα. Η κάλυψη εμπλουτισμού αναφέρεται όταν είναι ενεργοποιημένη.

exclude_test_pathsΠροαιρετικό

Τύπος: bool
Προεπιλογή: true
Περιγραφή: Προεπιλεγμένο true: εξαιρέστε διαδρομές δοκιμής, προσαρμογής, προμηθευτή και παραδειγμάτων από τις επιστρεφόμενες άκρες γραφήματος. Ρυθμίστε το false για να τα συμπεριλάβει.

include_module_symbolsΠροαιρετικό

Τύπος: bool
Προεπιλογή
Περιγραφή: Από προεπιλογή, το false εξαιρεί τις άκρες του γραφήματος όταν το from_name ή το to_name είναι το συνθετικό σύμβολο __module__. Ρυθμίστε το true ώστε να περιλαμβάνει άκρες σε επίπεδο μονάδας.

Παράμετρος	Τύπος	Απαιτείται	Προεπιλογή	Περιγραφή
`repository`	`str`	Όχι	-	Αποθετήριο ως owner/repo[:branch]. Προαιρετικό — παραλείψτε το για να χρησιμοποιηθεί η προεπιλογή του client για το συγκεκριμένο αίτημα (αν παρέχεται) ή το μοναδικό προσβάσιμο αποθετήριο· δώστε το ρητά μόνο για διαφορετικό ευρετηριασμένο repo. Η απόκριση δείχνει ποιο αποθετήριο χρησιμοποιήθηκε.
`target`	`str`	Ναι	-	Όνομα συμβόλου προς ανάλυση
`depth`	`Literal[shallow, balanced, deep]`	Όχι	`balanced`	Βάθος ανάλυσης
`limit`	`int`	Όχι	`10`	Μέγιστα αποτελέσματα που επιστρέφονται σε αυτή τη σελίδα
`offset`	`int`	Όχι	-	Παρωχημένη μετατόπιση συμβατότητας. Προτιμήστε το cursor από το pagination.next_cursor.
`cursor`	`str`	Όχι	-	Αδιαφανές cursor από το pagination.next_cursor. Περάστε το αμετάβλητο και κρατήστε το query και τα φίλτρα αμετάβλητα.
`direction`	`Literal[incoming, outgoing, both]`	Όχι	`incoming`	Διεύθυνση διέλευσης
`relationship_types`	`list[str]`	Όχι	-	Τύποι ακμών φίλτρου (CALL, IMPORT, INHERITS_FROM, κ.λπ.). Παρακάμπτει πάντα την προεπιλογή που προέρχεται από το graph_view παρακάτω όταν παρέχεται.
`graph_view`	`Literal[dependency, type, data_flow, control_flow]`	Όχι	`dependency`	Προβολή γραφήματος: καθορίζει τόσο τους προεπιλεγμένους τύπους άκρων διέλευσης όσο και τις μετρήσεις της προβολής που χρησιμοποιούνται όταν το include_metrics=true. dependency=[CALL,IMPORT,EXPORTS,REFERENCE,INSTANTIATES] (προεπιλογή), type=[INHERITS_FROM,IMPLEMENTS,OVERRIDE,DECORATES,OF_TYPE], data_flow=[READS,WRITES,ASSIGNS_TO], control_flow=[CONTROL_FLOW,THROWS,CATCHES]. Εφαρμόζεται μόνο ως προεπιλογή relationship_types όταν το relationship_types δεν παρέχεται ρητά. Ταιριάζει με το υπάρχον όνομα παραμέτρου graph_view του dependency_search για συνέπεια μεταξύ των εργαλείων.
`path_filter`	`str`	Όχι	-	Περιορίστε την ανάλυση του συμβόλου-στόχου με πρόθεμα διαδρομής αρχείου· οι σχέσεις γραφήματος που επιστρέφονται ενδέχεται να εκτείνονται εκτός αυτής της διαδρομής
`language_filter`	`str`	Όχι	-	Φίλτρο γλώσσας
`branch`	`str`	Όχι	-	Παράκαμψη κλάδου
`per_hop_limit`	`int`	Όχι	-	Μέγιστες σχέσεις ανά άλμα (1-300)
`include_metrics`	`bool`	Όχι		Συμπεριλάβετε μετρήσεις γραφήματος στα αποτελέσματα, καθεμία εμπλουτισμένη με ένα παράγωγο μπλοκ refactor_risk ({risk: "low"\|"medium"\|"high", is_articulation_point, bridge_count, k_core, graph_view, reasons}). Το risk είναι "low" όταν το σύμβολο δεν αποτελεί σημείο άρθρωσης στην επιλεγμένη προβολή, "medium" όταν ένα σημείο άρθρωσης γεφυρώνει λίγες ακμές και "high" όταν γεφυρώνει πολλές (ευρετικό όριο, χωρίς εμπειρική επικύρωση). Παραλείπεται για κάθε σύμβολο όταν δεν υπάρχει γραμμή μετρήσεων για αυτό το σύμβολο και την προβολή.
`metrics_detail`	`Literal[summary, full]`	Όχι	`summary`	Όταν include_metrics=true: summary (προεπιλογή) επιστρέφει σήματα απόφασης + refactor_risk; Το full επιστρέφει το μεγαλύτερο επιλεγμένο σύνολο μετρήσεων
`include_edge_metadata`	`bool`	Όχι		Συμπεριλάβετε ακατέργαστα μεταδεδομένα και βάρη. Απενεργοποιήθηκε από προεπιλογή επειδή τα μεταδεδομένα εξαγωγής μπορεί να είναι μεγάλα. Η κάλυψη εμπλουτισμού αναφέρεται όταν είναι ενεργοποιημένη.
`exclude_test_paths`	`bool`	Όχι	`true`	Προεπιλεγμένο true: εξαιρέστε διαδρομές δοκιμής, προσαρμογής, προμηθευτή και παραδειγμάτων από τις επιστρεφόμενες άκρες γραφήματος. Ρυθμίστε το false για να τα συμπεριλάβει.
`include_module_symbols`	`bool`	Όχι		Από προεπιλογή, το false εξαιρεί τις άκρες του γραφήματος όταν το from_name ή το to_name είναι το συνθετικό σύμβολο __module__. Ρυθμίστε το true ώστε να περιλαμβάνει άκρες σε επίπεδο μονάδας.

Καλύτερο για:

Παλαιοί καλούντες ήδη συνδεδεμένοι με τη μορφή απόκρισής του (graph, connection_summary)

Δεν συνιστάται για:

Νέοι βρόχοι πρακτόρων — προτιμήστε το dependency_search, το οποίο μοιράζεται τον ίδιο πυρήνα διάσχισης

get_task_contextΣταθερό

Ξεκινάτε εργασία σε άγνωστη περιοχή; Περιγράψτε την εργασία (π.χ. "προσθήκη υποστήριξης SSO", "διόρθωση του webhook χρέωσης") και λάβετε ένα οριοθετημένο πακέτο μίας κλήσης με σχετικά αρχεία, κώδικα, σύμβολα και dependencies. Τα αρχεία-σπόροι συνεισφέρουν άμεσο ευρετηριασμένο περιεχόμενο ακόμη κι όταν δεν ορίζουν σύμβολα. Για περισσότερα αποτελέσματα, συνεχίστε με το εξειδικευμένο εργαλείο αναζήτησης για εκείνο το επίπεδο.

Παράμετροι:

task_descriptionΑπαιτείται

Τύπος: str
Περιγραφή: Περιγραφή της εργασίας για την οποία χρειάζεστε το πλαίσιο

repositoryΠροαιρετικό

Τύπος: str
Περιγραφή: Αποθετήριο ως owner/repo[:branch]. Προαιρετικό — παραλείψτε το για να χρησιμοποιηθεί η προεπιλογή του client για το συγκεκριμένο αίτημα (αν παρέχεται) ή το μοναδικό προσβάσιμο αποθετήριο· δώστε το ρητά μόνο για διαφορετικό ευρετηριασμένο repo. Η απόκριση δείχνει ποιο αποθετήριο χρησιμοποιήθηκε.

limitΠροαιρετικό

Τύπος: int
Προεπιλογή: 15
Περιγραφή: Μέγιστα αποτελέσματα ανά στρώση

scopeΠροαιρετικό

Τύπος: Literal[semantic, symbols, dependencies, all]
Προεπιλογή: all
Περιγραφή: Ποια επίπεδα περιβάλλοντος να συμπεριληφθούν

language_filterΠροαιρετικό

Τύπος: str
Περιγραφή: Φίλτρο γλώσσας

path_filterΠροαιρετικό

Τύπος: str
Περιγραφή: Φιλτράρισμα κατά πρόθεμα διαδρομής αρχείου

branchΠροαιρετικό

Τύπος: str
Περιγραφή: Παράκαμψη κλάδου

include_related_contextΠροαιρετικό

Τύπος: bool
Προεπιλογή
Περιγραφή: Συμπεριλάβετε σχετικό πλαίσιο από γειτονικά σύμβολα

seed_symbol_idsΠροαιρετικό

Τύπος: list[str]
Περιγραφή: Ακριβείς σπόροι επιπέδου 1: αναγνωριστικά συμβόλων που ο πράκτορας γνωρίζει ήδη ότι είναι κεντρικοί στην εργασία (π.χ. σύμβολα σε αρχεία που έχει ανοιχτά). Κατατάχθηκε μπροστά από τους σπόρους που προέρχονται από λέξεις-κλειδιά στα επίπεδα εξαρτήσεων/related_context. Πρόσθετος — παράλειψη για τη σημερινή συμπεριφορά μόνο για λέξεις-κλειδιά.

seed_file_pathsΠροαιρετικό

Τύπος: list[str]
Περιγραφή: Ρητοί σπόροι Tier-1: ευρετηριασμένες διαδρομές αρχείων που ο πράκτορας έχει ανοιχτές ή μόλις επεξεργάστηκε. Επιστρέφει οριοθετημένα άμεσα στοιχεία αρχείων και αναλύει έως 5 σύμβολα ανά αρχείο για συμφραζόμενα γραφήματος, συμπεριλαμβανομένων εγγράφων και config χωρίς σύμβολα. Προσθετικό — παραλείψτε το για συμπεριφορά μόνο με λέξεις-κλειδιά.

Παράμετρος	Τύπος	Απαιτείται	Προεπιλογή	Περιγραφή
`task_description`	`str`	Ναι	-	Περιγραφή της εργασίας για την οποία χρειάζεστε το πλαίσιο
`repository`	`str`	Όχι	-	Αποθετήριο ως owner/repo[:branch]. Προαιρετικό — παραλείψτε το για να χρησιμοποιηθεί η προεπιλογή του client για το συγκεκριμένο αίτημα (αν παρέχεται) ή το μοναδικό προσβάσιμο αποθετήριο· δώστε το ρητά μόνο για διαφορετικό ευρετηριασμένο repo. Η απόκριση δείχνει ποιο αποθετήριο χρησιμοποιήθηκε.
`limit`	`int`	Όχι	`15`	Μέγιστα αποτελέσματα ανά στρώση
`scope`	`Literal[semantic, symbols, dependencies, all]`	Όχι	`all`	Ποια επίπεδα περιβάλλοντος να συμπεριληφθούν
`language_filter`	`str`	Όχι	-	Φίλτρο γλώσσας
`path_filter`	`str`	Όχι	-	Φιλτράρισμα κατά πρόθεμα διαδρομής αρχείου
`branch`	`str`	Όχι	-	Παράκαμψη κλάδου
`include_related_context`	`bool`	Όχι		Συμπεριλάβετε σχετικό πλαίσιο από γειτονικά σύμβολα
`seed_symbol_ids`	`list[str]`	Όχι	-	Ακριβείς σπόροι επιπέδου 1: αναγνωριστικά συμβόλων που ο πράκτορας γνωρίζει ήδη ότι είναι κεντρικοί στην εργασία (π.χ. σύμβολα σε αρχεία που έχει ανοιχτά). Κατατάχθηκε μπροστά από τους σπόρους που προέρχονται από λέξεις-κλειδιά στα επίπεδα εξαρτήσεων/related_context. Πρόσθετος — παράλειψη για τη σημερινή συμπεριφορά μόνο για λέξεις-κλειδιά.
`seed_file_paths`	`list[str]`	Όχι	-	Ρητοί σπόροι Tier-1: ευρετηριασμένες διαδρομές αρχείων που ο πράκτορας έχει ανοιχτές ή μόλις επεξεργάστηκε. Επιστρέφει οριοθετημένα άμεσα στοιχεία αρχείων και αναλύει έως 5 σύμβολα ανά αρχείο για συμφραζόμενα γραφήματος, συμπεριλαμβανομένων εγγράφων και config χωρίς σύμβολα. Προσθετικό — παραλείψτε το για συμπεριφορά μόνο με λέξεις-κλειδιά.

Καλύτερο για:

Συμφραζόμενα με επίγνωση εργασίας που συνδυάζουν αρχικά αρχεία με σημασιολογικά, συμβολικά και επίπεδα εξαρτήσεων

Δεν συνιστάται για:

Αναζητήσεις ενός εργαλείου όπου ένα πιο συγκεκριμένο εργαλείο απαντά ήδη στην ερώτηση

get_fileΣταθερό

Διαβάστε ένα αρχείο από το ευρετηριασμένο repo κατά διαδρομή. Προτιμήστε το τοπικό εργαλείο Read για αρχεία στον δίσκο — χρησιμοποιήστε αυτό για αναζητήσεις μεταξύ repo ή απομακρυσμένες όπου το αρχείο δεν βρίσκεται στο δέντρο εργασίας σας. Υποστηρίζει προαιρετικό εύρος γραμμών· συνεχίστε μια απόκριση περικομμένη λόγω token από το metadata.next_line_start.

Παράμετροι:

file_pathΑπαιτείται

Τύπος: str
Περιγραφή: Διαδρομή αρχείου σε σχέση με τη ρίζα του αποθετηρίου

repositoryΠροαιρετικό

Τύπος: str
Περιγραφή: Αποθετήριο ως owner/repo[:branch]. Προαιρετικό — παραλείψτε το για να χρησιμοποιηθεί η προεπιλογή του client για το συγκεκριμένο αίτημα (αν παρέχεται) ή το μοναδικό προσβάσιμο αποθετήριο· δώστε το ρητά μόνο για διαφορετικό ευρετηριασμένο repo. Η απόκριση δείχνει ποιο αποθετήριο χρησιμοποιήθηκε.

line_startΠροαιρετικό

Τύπος: int
Περιγραφή: Γραμμή έναρξης (αρίθμηση από 1)

line_endΠροαιρετικό

Τύπος: int
Περιγραφή: Γραμμή λήξης (αρίθμηση από 1, συμπεριλαμβανομένη· πρέπει να είναι στο ή μετά το line_start)

branchΠροαιρετικό

Τύπος: str
Περιγραφή: Παράκαμψη κλάδου

max_tokensΠροαιρετικό

Τύπος: int
Προεπιλογή: 5000
Περιγραφή: Μέγιστα διακριτικά για επιστροφή

include_metadataΠροαιρετικό

Τύπος: bool
Προεπιλογή: true
Περιγραφή: Συμπεριλάβετε μεταδεδομένα αρχείου ως απάντηση

Παράμετρος	Τύπος	Απαιτείται	Προεπιλογή	Περιγραφή
`file_path`	`str`	Ναι	-	Διαδρομή αρχείου σε σχέση με τη ρίζα του αποθετηρίου
`repository`	`str`	Όχι	-	Αποθετήριο ως owner/repo[:branch]. Προαιρετικό — παραλείψτε το για να χρησιμοποιηθεί η προεπιλογή του client για το συγκεκριμένο αίτημα (αν παρέχεται) ή το μοναδικό προσβάσιμο αποθετήριο· δώστε το ρητά μόνο για διαφορετικό ευρετηριασμένο repo. Η απόκριση δείχνει ποιο αποθετήριο χρησιμοποιήθηκε.
`line_start`	`int`	Όχι	-	Γραμμή έναρξης (αρίθμηση από 1)
`line_end`	`int`	Όχι	-	Γραμμή λήξης (αρίθμηση από 1, συμπεριλαμβανομένη· πρέπει να είναι στο ή μετά το line_start)
`branch`	`str`	Όχι	-	Παράκαμψη κλάδου
`max_tokens`	`int`	Όχι	`5000`	Μέγιστα διακριτικά για επιστροφή
`include_metadata`	`bool`	Όχι	`true`	Συμπεριλάβετε μεταδεδομένα αρχείου ως απάντηση

Καλύτερο για:

Στιγμιότυπα απομακρυσμένων ή ευρετηριασμένων αρχείων (εύρη γραμμών, όρια token)

Δεν συνιστάται για:

Διαδρομή που βρίσκεται ήδη στον τοπικό δίσκο — χρησιμοποιήστε το τοπικό εργαλείο Read

Εργαλεία συστήματος & βοηθητικά#

repository_contextΣταθερό

Παραθέστε τα repository στα οποία μπορείτε να αναζητήσετε, ή λάβετε πληροφορίες ταυτότητας για ένα (namespace/branch, indexed_commit_sha / φρεσκάδα ευρετηρίου). Καλέστε με action:"list" μία φορά για να μάθετε το ακριβές repo slug που δέχονται τα εργαλεία αναζήτησης. (Αν το κλειδί σας έχει ένα μόνο repo, τα εργαλεία αναζήτησης το χρησιμοποιούν εξ ορισμού — μπορείτε να το παραλείψετε.) Τα πλήθη file/blob/edge σε επίπεδο namespace είναι προαιρετικά μέσω include_statistics=true.

Παράμετροι:

actionΑπαιτείται

Τύπος: Literal[list, info]
Περιγραφή: Ενέργεια: "list" για τα διαθέσιμα repo ή "info" για πληροφορίες repo

repositoryΠροαιρετικό

Τύπος: str
Περιγραφή: Αποθετήριο σε μορφή owner/repo ή owner/repo:branch (απαιτείται για info)

branchΠροαιρετικό

Τύπος: str
Περιγραφή: Παράκαμψη κλάδου

patternΠροαιρετικό

Τύπος: str
Περιγραφή: Φιλτράρισμα λίστας αποθετηρίου κατά μοτίβο

include_statisticsΠροαιρετικό

Τύπος: bool
Προεπιλογή
Περιγραφή: Προαιρετικά: συμπερίληψη πληθών ευρετηριασμένων δεδομένων σε επίπεδο namespace (file/blob/edge). Προεπιλογή false — η ταυτότητα του repository δεν απαιτεί αυτό το πιο αργό σύνολο.

limitΠροαιρετικό

Τύπος: int
Προεπιλογή: 20
Περιγραφή: Μέγιστα αποτελέσματα που επιστρέφονται σε αυτή τη σελίδα

offsetΠροαιρετικό

Τύπος: int
Περιγραφή: Καταργημένη μετατόπιση συμβατότητας. Προτιμήστε το cursor από το pagination.next_cursor.

cursorΠροαιρετικό

Τύπος: str
Περιγραφή: Αδιαφανές cursor από το pagination.next_cursor. Περάστε το αμετάβλητο και διατηρήστε το ερώτημα και τα φίλτρα αμετάβλητα.

Παράμετρος	Τύπος	Απαιτείται	Προεπιλογή	Περιγραφή
`action`	`Literal[list, info]`	Ναι	-	Ενέργεια: "list" για τα διαθέσιμα repo ή "info" για πληροφορίες repo
`repository`	`str`	Όχι	-	Αποθετήριο σε μορφή owner/repo ή owner/repo:branch (απαιτείται για info)
`branch`	`str`	Όχι	-	Παράκαμψη κλάδου
`pattern`	`str`	Όχι	-	Φιλτράρισμα λίστας αποθετηρίου κατά μοτίβο
`include_statistics`	`bool`	Όχι		Προαιρετικά: συμπερίληψη πληθών ευρετηριασμένων δεδομένων σε επίπεδο namespace (file/blob/edge). Προεπιλογή false — η ταυτότητα του repository δεν απαιτεί αυτό το πιο αργό σύνολο.
`limit`	`int`	Όχι	`20`	Μέγιστα αποτελέσματα που επιστρέφονται σε αυτή τη σελίδα
`offset`	`int`	Όχι	-	Καταργημένη μετατόπιση συμβατότητας. Προτιμήστε το cursor από το pagination.next_cursor.
`cursor`	`str`	Όχι	-	Αδιαφανές cursor από το pagination.next_cursor. Περάστε το αμετάβλητο και διατηρήστε το ερώτημα και τα φίλτρα αμετάβλητα.

Καλύτερο για:

Παράθεση των προσβάσιμων αποθετηρίων
Προσδιορισμός ταυτότητας αποθετηρίου, κλάδου και φρεσκάδας HEAD-vs-ευρετήριο

Δεν συνιστάται για:

Στατιστικά σε όλο το namespace από προεπιλογή — περάστε ρητά include_statistics=true, καθώς μπορεί να είναι πιο αργό από τον προσδιορισμό

ask_maguyvaΣταθερό

Βοήθεια και σχόλια για το Maguyva. Κύρια χρήση: λάβετε καθοδήγηση εργαλείων, ή υποβάλετε αναφορά σφάλματος / αίτημα λειτουργίας που αποθηκεύεται για τους συντηρητές του Maguyva. Μην συμπεριλαμβάνετε ποτέ μυστικά ή ευαίσθητα προσωπικά δεδομένα στα σχόλια. Η λειτουργία evaluate παραμένει μόνο για συμβατότητα προς τα πίσω — προτιμήστε τοπικό υπολογισμό ή εργαλεία του περιβάλλοντος εκτέλεσης για εργασίες μαθηματικών/hash/συμβολοσειρών.

Παράμετροι:

operationΑπαιτείται

Τύπος: Literal[guidance, report_bug, request_feature, evaluate]
Περιγραφή: Κύρια: guidance, report_bug, request_feature. Μόνο παλαιού τύπου/συμβατότητας: evaluate (ντετερμινιστική μηχανή εκφράσεων· δεν αποτελεί μέρος της κύριας ροής εργασίας πράκτορα).

queryΠροαιρετικό

Τύπος: str
Περιγραφή: Θέμα καθοδήγησης (π.χ. tool_selection, semantic_search). Μόνο για την παλαιά evaluate: συμβολοσειρά έκφρασης.

descriptionΠροαιρετικό

Τύπος: str
Περιγραφή: Απαιτείται για report_bug και request_feature. Σχόλια ελεύθερης μορφής για τους συντηρητές του Maguyva. Μην συμπεριλαμβάνετε ποτέ μυστικά ή ευαίσθητα προσωπικά δεδομένα.

related_toolΠροαιρετικό

Τύπος: Literal[ask_maguyva, get_file, repository_context, find_symbol, structural_search, dependency_search, analyze_dependencies, semantic_search, text_pattern_search, intelligent_search, get_task_context]
Περιγραφή: Προαιρετικό εργαλείο Maguyva που σχετίζεται περισσότερο με την ανατροφοδότηση

Παράμετρος	Τύπος	Απαιτείται	Προεπιλογή	Περιγραφή
`operation`	`Literal[guidance, report_bug, request_feature, evaluate]`	Ναι	-	Κύρια: guidance, report_bug, request_feature. Μόνο παλαιού τύπου/συμβατότητας: evaluate (ντετερμινιστική μηχανή εκφράσεων· δεν αποτελεί μέρος της κύριας ροής εργασίας πράκτορα).
`query`	`str`	Όχι	-	Θέμα καθοδήγησης (π.χ. tool_selection, semantic_search). Μόνο για την παλαιά evaluate: συμβολοσειρά έκφρασης.
`description`	`str`	Όχι	-	Απαιτείται για report_bug και request_feature. Σχόλια ελεύθερης μορφής για τους συντηρητές του Maguyva. Μην συμπεριλαμβάνετε ποτέ μυστικά ή ευαίσθητα προσωπικά δεδομένα.
`related_tool`	`Literal[ask_maguyva, get_file, repository_context, find_symbol, structural_search, dependency_search, analyze_dependencies, semantic_search, text_pattern_search, intelligent_search, get_task_context]`	Όχι	-	Προαιρετικό εργαλείο Maguyva που σχετίζεται περισσότερο με την ανατροφοδότηση

Καλύτερο για:

Καθοδήγηση εργαλείων (operation="guidance")
Ανθεκτικές αναφορές σφαλμάτων και αιτήματα λειτουργιών για τους συντηρητές του Maguyva

Δεν συνιστάται για:

Υπολογισμοί μαθηματικών/hash/συμβολοσειρών — η λειτουργία evaluate είναι μόνο παλαιού τύπου/προς τα πίσω συμβατότητας· προτιμήστε τον τοπικό υπολογισμό στο περιβάλλον εκτέλεσης

Βέλτιστες πρακτικές#

Χρησιμοποιήστε σκόπιμα ρητές παρακάμψεις: Παραλείψτε το αποθετήριο όταν ο MCP client παρέχει προεπιλογή για το συγκεκριμένο αίτημα ή όταν το κλειδί έχει πρόσβαση σε ακριβώς ένα αποθετήριο· διαφορετικά, δώστε το ρητά.
Επιλέξτε τη σωστή λειτουργία αναζήτησης: Χρησιμοποιήστε το intelligent_search με το mode="auto" για τις περισσότερες περιπτώσεις. Καθορίστε μια λειτουργία όταν γνωρίζετε ακριβώς τι χρειάζεστε.
Αξιοποιήστε τα φίλτρα γλώσσας: Χρησιμοποιήστε το language_filter για να περιορίσετε τα αποτελέσματα και να βελτιώσετε την απόδοση.
Ενίσχυση GraphRAG: Η ενίσχυση σημασίας GraphRAG είναι απενεργοποιημένη από προεπιλογή για τη σημασιολογική αναζήτηση (boost_by_importance=false) ώστε η κατάταξη να παραμένει ασφαλής για πράκτορες. Περάστε boost_by_importance=true για να ενεργοποιήσετε την επανακατάταξη με επίγνωση κεντρικότητας για ξεναγήσεις αρχιτεκτονικής.
Η αντιστοίχιση αποθετηρίων δεν διακρίνει πεζά-κεφαλαία, δεν είναι ασαφής: Το repository_context αντιστοιχίζει ονόματα αποθετηρίων χωρίς διάκριση πεζών-κεφαλαίων — δεν διορθώνει τυπογραφικά λάθη. Ελέγξτε το metadata.resolution_reason στην ενέργεια info ("exact" έναντι "corrected") για να δείτε πώς επιλύθηκε ένα όνομα.
Συνδυάστε εργαλεία: Χρησιμοποιήστε πολλές μεθόδους API μαζί για ολοκληρωμένη ανάλυση.
Χειριστείτε μεγάλα αποτελέσματα: Χρησιμοποιήστε limit και χειριστήρια σελιδοποίησης ειδικά για το εργαλείο (για παράδειγμα line_start/line_end στο get_file).
Χρησιμοποιήστε το ask_maguyva για καθοδήγηση εργαλείων: Η λειτουργία evaluate του ask_maguyva (hash, base64, JSON, μαθηματικά) είναι μόνο παλαιού τύπου / συμβατότητας προς τα πίσω. Καλέστε το ask_maguyva με operation="guidance" και query="tool_selection" αντ' αυτού για τον πίνακα «το τοπικό εργαλείο κερδίζει» και ένα πλήρες φύλλο αναφοράς εργαλείο προς εργαλείο.
Επαληθεύστε τον αντίκτυπο πριν και μετά την επεξεργασία: Πριν επεξεργαστείτε ένα κοινόχρηστο σύμβολο, καλέστε το dependency_search με analysis_type="impact" (ή περάστε changed_paths για αντίκτυπο PR/diff) για να δείτε την ακτίνα επίδρασής του. Μετά την επεξεργασία, ορίστε verify_after_edit=true με targets ή/και changed_paths για έναν συμπαγή επανέλεγχο των ίδιων συμβόλων.

Χαρακτηριστικά απόδοσης#

Λειτουργία	Σημειώσεις απόδοσης
Σημασιολογική αναζήτηση	Κάτω από δευτερόλεπτο, αλλά περιλαμβάνει μια ζωντανή κλήση στο API διανυσματικών αναπαραστάσεων κάθε φορά (χωρίς προσωρινή αποθήκευση) — αναμένετε επιπλέον καθυστέρηση πάνω από το ερώτημα διανυσμάτων
Αναζήτηση κειμένου	Κάτω από δευτερόλεπτο για ακριβή/regex· η ασαφής αναζήτηση περιεχομένου σελιδοποιείται στην πλευρά του πελάτη, οπότε οι βαθιές μετατοπίσεις κοστίζουν περισσότερο — περιορίστε με path_filter/language_filter
Δομική αναζήτηση	Ευρετηριασμένη με AST — το κόστος κλιμακώνεται με τον όγκο των αποτελεσμάτων, όχι με το μέγεθος του αποθετηρίου
Αναζήτηση εξαρτήσεων	Το κόστος κλιμακώνεται με το βάθος — προτιμήστε depth="shallow" εκτός αν χρειάζεστε πλαίσιο πολλαπλών αλμάτων· το per_hop_limit περιορίζει τη διάχυση
Ανάκτηση αρχείου	Σχεδόν άμεση για ένα μεμονωμένο αρχείο — σελιδοποιήστε μεγάλα αρχεία με line_start/line_end ή max_tokens αντί για μία μεγάλη ανάκτηση
Πλαίσιο αποθετηρίου	Η επίλυση του namespace αποθηκεύεται προσωρινά μόνο ανά αίτημα, όχι μεταξύ κλήσεων — κάθε κλήση εργαλείου επιλύει εκ νέου
ask_maguyva (guidance / evaluate)	Σχεδόν άμεση — εκτελείται εντός Worker χωρίς κλήση βάσης δεδομένων

Διαχείριση σφαλμάτων#

Όλες οι μέθοδοι API επιστρέφουν έναν δομημένο φάκελο απόκρισης:

status: Συμβολοσειρά — "success" ή "error". Τα σήματα υποβαθμισμένης αντιστοίχισης και φρεσκάδας βρίσκονται σε ένθετα πεδία, όπως το metadata.resolution_reason στο repository_context ή το metadata.index_freshness.status.
tool: Όνομα του εργαλείου που δημιούργησε την απόκριση
data: Το ωφέλιμο φορτίο αποτελέσματος όταν είναι επιτυχές (η δομή διαφέρει ανά εργαλείο)
error: Δομημένο αντικείμενο σφάλματος όταν το status είναι "error" — περιλαμβάνει type, message, suggestions, και recovery_actions
metadata: Επιπλέον πληροφορίες για τη λειτουργία (δρομολόγηση, προσωρινή αποθήκευση, προσαρμογές παραμέτρων)
pagination: Παρόν σε αποκρίσεις λίστας — περιλαμβάνει has_more και next_cursor

Ελέγχετε πάντα το πεδίο status πριν επεξεργαστείτε τα αποτελέσματα — είναι πάντοτε μόνο "success" ή "error". Για σήματα υποβαθμισμένης αντιστοίχισης ή φρεσκάδας, διαβάστε το ένθετο πεδίο αντ' αυτού: metadata.resolution_reason στο repository_context, ή metadata.index_freshness.status (known/partial/unknown/unavailable).

Ξεκινώντας#

Διαμόρφωση MCP client: Κατευθύνετε τον MCP client στο endpoint του διακομιστή Maguyva
Επιβεβαίωση πρόσβασης σε αποθετήρια: Χρησιμοποιήστε το repository_context με "list" ή "info" για να ελέγξετε τα αποθετήρια που είναι διαθέσιμα στο κλειδί API
Έναρξη αναζήτησης: Ξεκινήστε με το intelligent_search και εξερευνήστε εξειδικευμένα εργαλεία όταν χρειάζεται
Συνδυασμός εργαλείων: Χρησιμοποιήστε πολλά εργαλεία μαζί για ολοκληρωμένη ανάλυση κώδικα

Για αναλυτικές οδηγίες ενσωμάτωσης, δες το οδηγός εγκατάστασης.