> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/el/basi-gnoseon/040-git-integration.md). # ενσωμάτωση Git **Η ενσωμάτωση Git του Overleaf** είναι μια [λειτουργία premium](/latex/el/basi-gnoseon/120-overleaf-premium-features.md). Οι premium λειτουργίες του Overleaf είναι διαθέσιμες στους συμμετέχοντες σε [Overleaf Commons](https://www.overleaf.com/for/universities), μέλη της ομάδας [συνδρομές](https://www.overleaf.com/for/groups), και οι κάτοχοι ατομικών [συνδρομές](https://www.overleaf.com/user/subscription/plans). Η ενσωμάτωση Git είναι διαθέσιμη στο Overleaf Cloud και στο Overleaf Server Pro (έκδοση 4.0 και νεότερη). ### Τι είναι η ενσωμάτωση Git του Overleaf; Η ενσωμάτωση Git του Overleaf σάς επιτρέπει να αποκτήσετε ένα URL Git από το έργο σας στο Overleaf και να το χειριστείτε σαν ένα απομακρυσμένο αποθετήριο Git (repo). Μπορείτε να κλωνοποιήσετε το έργο σας σε ένα τοπικό αποθετήριο Git και να εργάζεστε τοπικά στο έργο σας, προωθώντας αλλαγές στο έργο σας από τον τοπικό σας υπολογιστή και λαμβάνοντας ενημερώσεις που συμβαίνουν στον διαδικτυακό επεξεργαστή του Overleaf στο τοπικό σας repo. Αυτό σας επιτρέπει να εργάζεστε τοπικά στο έργο σας για εκείνες τις φορές που η online εργασία δεν είναι εφικτή, να χρησιμοποιείτε έναν διαφορετικό τοπικό επεξεργαστή της επιλογής σας όταν εργάζεστε σε ένα έργο Overleaf, ή να προσθέτετε εύκολα εξαγωγές από άλλο τοπικό λογισμικό στο έργο σας στο Overleaf. Μπορείτε να αποκτήσετε το URL Git και την εντολή κλωνοποίησης για το έργο σας από την επιλογή Git στο μενού του έργου σας στο Overleaf. ![Μενού έργου git.png](/files/e95ccc6d7ee559bd1d993fd6db21e703f447e041) ### Πώς να ταυτοποιηθείτε όταν χρησιμοποιείτε την ενσωμάτωση Git Όταν εκτελείτε μια λειτουργία Git, όπως clone, pull ή push προς το απομακρυσμένο έργο σας στο Overleaf, θα σας ζητηθεί να ταυτοποιηθείτε. Για να αποκτήσετε πρόσβαση στο έργο σας στο Overleaf από το Git, πρέπει να χρησιμοποιήσετε ταυτοποίηση με διακριτικό του Overleaf. Για οδηγίες βήμα προς βήμα δείτε: [Ταυτοποίηση με διακριτικό](/latex/el/basi-gnoseon/042-git-integration-authentication-tokens.md). ### Κλωνοποίηση του έργου σας ως τοπικό αποθετήριο Από το [**Μενού**](/latex/el/basi-gnoseon/148-using-the-overleaf-project-menu.md) μέσα στο έργο σας, μπορείτε να επιλέξετε Git από τις επιλογές Συγχρονισμού. Αυτό θα εμφανίσει ένα παράθυρο διαλόγου που δείχνει την `git clone` εντολή που πρέπει να χρησιμοποιήσετε όταν δημιουργείτε το τοπικό σας αποθετήριο. ![Μενού έργου git.png](/files/e95ccc6d7ee559bd1d993fd6db21e703f447e041) Εναλλακτικά, μπορείτε να βρείτε το URL Git από το URL του έργου (το URL στη γραμμή διευθύνσεων του προγράμματος περιήγησης όταν βρίσκεστε σε ένα έργο). #### Overleaf Cloud Αν χρησιμοποιείτε το Overleaf Cloud και το URL του έργου σας στο Overleaf μοιάζει με αυτό: ``` https://www.overleaf.com/project/1234567 ``` Τότε το URL Git που θα χρησιμοποιήσετε για να κλωνοποιήσετε το έργο θα είναι ``` https://git.overleaf.com/1234567 ``` Και η εντολή που χρησιμοποιείται για την κλωνοποίηση του έργου σε ένα τοπικό αποθετήριο Git θα είναι: ``` git clone https://git.overleaf.com/1234567 ``` **Σημείωση**: μπορεί να σας ζητηθεί όνομα χρήστη και κωδικός πρόσβασης. Δείτε παρακαλώ [ταυτοποίηση με κωδικό πρόσβασης για την ενσωμάτωση Git](/latex/el/basi-gnoseon/043-git-integration-password-based-authentication.md) #### Overleaf Server Pro (έκδοση 4.0 ή νεότερη) **Σημείωση**: Η ενσωμάτωση Git-bridge δεν είναι ενεργοποιημένη από προεπιλογή στο Server Pro. Δείτε τον [Οδηγό ενσωμάτωσης Git](https://github.com/overleaf/overleaf/wiki/Git-Integration) για οδηγίες σχετικά με το πώς να την ενεργοποιήσετε. Αν χρησιμοποιείτε το Overleaf Server Pro και το URL του έργου σας μοιάζει κάπως έτσι: ``` https:///project/1234567 ``` Τότε το URL Git που χρησιμοποιείται όταν κλωνοποιείτε το έργο θα είναι: ``` https://git@/git/1234567 ``` Και η εντολή που χρησιμοποιείται για την κλωνοποίηση του έργου σε ένα τοπικό αποθετήριο Git χρησιμοποιώντας τη γραμμή εντολών Git θα είναι: ``` git clone git@/git/1234567 ``` **Σημείωση**: Μπορεί να σας ζητηθεί κωδικός πρόσβασης. Δείτε παρακάτω: [διακριτικά ταυτοποίησης για την ενσωμάτωση Git](/latex/el/basi-gnoseon/042-git-integration-authentication-tokens.md) ### Δημιουργία έργου Overleaf από ένα υπάρχον αποθετήριο Git Αν έχετε ένα υπάρχον αποθετήριο, μπορείτε να προσθέσετε ένα έργο Overleaf ως απομακρυσμένο αποθετήριο. Υπάρχουν μερικές εντολές παρακάτω που θα χρειαστεί να εκτελέσετε για να ξεκινήσετε. Σημειώστε ότι το Overleaf υποστηρίζει μόνο ένα γραμμικό ιστορικό για κάθε έργο. Η ενσωμάτωση Git επιβάλλει αυτόν τον περιορισμό περιορίζοντας τον αριθμό των κλάδων σε έναν. Αυτός ο ένας κλάδος είναι αυτή τη στιγμή ενσωματωμένα ορισμένος να ονομάζεται `master`. 1. Πρώτα, υποθέτουμε ότι έχετε αποθετήριο git στον υπολογιστή σας σε έναν φάκελο που ονομάζεται `my-paper`. (Μπορεί επίσης να φιλοξενείται στο GitHub, GitLab ή Bitbucket κ.λπ., αλλά πρέπει να το έχετε κλωνοποιήσει τοπικά επίσης.) 2. Δημιουργία [ένα νέο έργο](/latex/el/basi-gnoseon/031-creating-a-document-in-overleaf.md) στο Overleaf. Εφόσον οποιοδήποτε περιεχόμενο στο έργο θα αντικατασταθεί, χρησιμοποιήστε την επιλογή έργου «Κενό» κατά τη δημιουργία αυτού του έργου και διαγράψτε το `main.tex` αρχείο στο Overleaf. 3. Βρείτε το URL Git για το έργο (βλ. [παραπάνω](#cloning-your-project-as-a-local-repository)). ![Git-bridge-url.png](/files/d7dcabcc69ff0a3c2885112cfa8ae87eef907021) 4. Προσθέστε το URL Git για το έργο ως απομακρυσμένο στο τοπικό σας έργο. ``` $ cd my-paper $ git remote add overleaf ``` (Βεβαιωθείτε ότι χρησιμοποιείτε τον δικό σας σύνδεσμο, όχι τον σύνδεσμο του παραδείγματος.) 5. Λάβετε το πιο πρόσφατο περιεχόμενο από το έργο του Overleaf και συγχωνεύστε το στον κλάδο master σας. ``` $ git checkout master $ git pull overleaf master --allow-unrelated-histories --rebase=false ``` 6. Προωθήστε το έργο σας στο Overleaf. ``` $ git push overleaf master --set-upstream ``` Αν θέλετε να χρησιμοποιήσετε διαφορετικό όνομα κλάδου τοπικά, π.χ. `my-branch`, μπορείτε να προωθήσετε τις αλλαγές σας με ένα ψευδώνυμο: ``` $ git push overleaf my-branch:master ``` 7. Επισκεφθείτε το έργο στο Overleaf. Οι αλλαγές σας θα πρέπει να είναι εκεί. (Ίσως χρειαστεί να ανοίξετε το μενού του έργου στο Overleaf για να βρείτε ποιο αρχείο έχει οριστεί ως το κύριο αρχείο εγγράφου και πιθανόν να αλλάξετε αυτήν την αρχική επιλογή.) ### Οι δεσμεύσεις Git και η ενσωμάτωση Git του Overleaf Το Overleaf διαθέτει ένα εσωτερικό [σύστημα Ιστορικού](/latex/el/perissotera-themata/49-using-the-history-feature.md) που επιτρέπει ταυτόχρονη συνεργασία μέσα σε ένα έργο Overleaf. Αυτό δεν είναι το ίδιο με το Git, οπότε η ενσωμάτωση Git του Overleaf είναι ουσιαστικά μια μετάφραση από τον μηχανισμό ιστορικού και εκδόσεων του Overleaf προς το Git. Αυτό επιτρέπει πολλές χρήσεις με δυνατότητα Git, αλλά δεν σας επιτρέπει να εργάζεστε μέσα στο Overleaf σαν να ήταν μια πλήρης υλοποίηση Git. #### Πότε δημιουργούνται οι δεσμεύσεις; Όταν εκτελείτε μια `λήψη` ή `ανάκτηση` εντολή, αν δεν υπάρχει δέσμευση για την τρέχουσα κατάσταση του έργου, δημιουργείται δυναμικά μια νέα δέσμευση. Όταν `προωθείτε` αρχεία από το τοπικό σας αποθετήριο στο απομακρυσμένο του Overleaf, δημιουργείται τότε επίσης μια δέσμευση, η οποία θα είναι ορατή σε τυχόν μελλοντικές κλωνοποιήσεις που θα κάνετε του έργου Overleaf. Όταν εσείς ή άλλοι επεξεργάζονται στο Overleaf, δεν θα δημιουργούνται αυτόματα δεσμεύσεις μέχρι να χρειαστούν. #### Αναγκαστική δημιουργία δεσμεύσεων Αν θέλετε να αναγκάσετε τη δημιουργία μιας δέσμευσης σε ένα συγκεκριμένο σημείο του ιστορικού του Overleaf, μπορείτε να το κάνετε με [την επισήμανση μιας έκδοσης](/latex/el/perissotera-themata/49-using-the-history-feature.md) στο ιστορικό του Overleaf. Η επισημασμένη έκδοση θα αποκτήσει το δικό της hash δέσμευσης ακόμη κι αν δεν κάνετε αμέσως git pull. Μια δέσμευση θα δημιουργηθεί από μια ετικέτα μόνο αν δεν έχουν γίνει άλλες δεσμεύσεις πιο πρόσφατα από το σημείο ιστορικού του Overleaf που επισημαίνεται. #### Παρακολούθηση συγγραφικής ταυτότητας Ο χαρακτηρισμός των δεσμεύσεων από την ενσωμάτωση Git του Overleaf τη στιγμή που χρειάζονται σημαίνει ότι αν έχουν υπάρξει πολλαπλές αλλαγές στην πλευρά του Overleaf πριν δημιουργηθεί μια δέσμευση, ο συντάκτης της πιο πρόσφατης αλλαγής θα εμφανίζεται ως συντάκτης της δέσμευσης. Όταν εργάζεστε με συν-συγγραφείς, είναι χρήσιμο να δημιουργείτε μια ετικέτα (που παράγει μια δέσμευση) μετά την ολοκλήρωση μιας σημαντικής ενημέρωσης από κάθε συνεργάτη - αυτό δημιουργεί μια ακολουθία δεσμεύσεων ορατή στο Git που αντανακλά όσο το δυνατόν πιο πιστά τις αλλαγές που συμβαίνουν στο Overleaf. ### Συγχρονισμός με άλλο απομακρυσμένο αποθετήριο Η ενσωμάτωση Git του Overleaf επιτρέπει στο έργο σας στο Overleaf να λειτουργεί ως απομακρυσμένο αποθετήριο για τοπικά αποθετήρια. Ωστόσο, ίσως θελήσετε να συγχρονίσετε το έργο σας στο Overleaf με ένα άλλο απομακρυσμένο αποθετήριο, που φιλοξενείται στο GitHub, στο GitLab ή σε άλλη υπηρεσία φιλοξενίας Git. Αν συγχρονίζετε το έργο σας με ένα αποθετήριο που φιλοξενείται στο GitHub (), ίσως θελήσετε να χρησιμοποιήσετε την άμεση [συγχρονισμού GitHub](/latex/el/basi-gnoseon/044-github-synchronization.md) λειτουργία. Αν συγχρονίζετε το έργο σας με το GitLab, το GitHub Enterprise ή κάποιον άλλο host, μπορείτε να χρησιμοποιήσετε την ενσωμάτωση Git του Overleaf για να στήσετε ένα ενδιάμεσο τοπικό αποθετήριο. Ακολουθώντας τις παραπάνω οδηγίες για [την κλωνοποίηση του έργου σας](#cloning-your-project-as-a-local-repository) ή [τη σύνδεση ενός έργου με ένα υπάρχον αποθετήριο](#creating-an-overleaf-project-from-an-existing-git-repository), θα έχετε ένα τοπικό αποθετήριο που μπορεί να προωθεί/λαμβάνει αλλαγές από το Overleaf. Στη συνέχεια μπορείτε να προσθέσετε ένα δεύτερο απομακρυσμένο σε αυτό το αποθετήριο που να δείχνει στο φιλοξενούμενο αποθετήριό σας. Το τοπικό σας θα χρειαστεί να έχει δύο απομακρυσμένα, ώστε να δείχνει τόσο στον host Git σας όσο και στο έργο του Overleaf. Αν και δεν θα υπάρχει άμεση σύνδεση μεταξύ του έργου Overleaf και του αποθετηρίου Git σας, αυτό θα σας επιτρέψει να τα διατηρείτε συγχρονισμένα. ![Git other remote.png](/files/7ac7e31f0edebb8efb6e786a1f227b0dfb504493) ### Προσθέστε ένα έργο Overleaf ως υπομονάδα Git Κάθε έργο στο Overleaf λειτουργεί ως ανεξάρτητο αποθετήριο Git, αλλά αν θέλετε να οργανώσετε πολλά τέτοια έργα σε ένα αποθετήριο Git, μπορείτε να προσθέσετε το αποθετήριο για κάθε έργο ως υπομονάδα Git με τον συνήθη τρόπο. Στη συνέχεια μπορείτε να προωθείτε και να λαμβάνετε το αποθετήριο κάθε υπομονάδας από/προς το Overleaf ξεχωριστά και παρ' όλα αυτά να τα έχετε συγκεντρωμένα ως υπομονάδες σε ένα μεγαλύτερο έργο. **Σημείωση:** Παρόλο που τα έργα Overleaf μπορεί να είναι υπομονάδες μέσα σε ένα άλλο αποθετήριο, τα ίδια τα έργα Overleaf δεν μπορούν να περιέχουν άλλες υπομονάδες. ### Γνωστοί περιορισμοί **Κλάδοι**: Το σύστημα Git του Overleaf δεν υποστηρίζει διακλάδωση. **Συμβολικοί σύνδεσμοι**: Το σύστημα Git του Overleaf δεν χειρίζεται καλά τους συμβολικούς συνδέσμους. Ένας συμβολικός σύνδεσμος μπορεί να προωθηθεί σε ένα έργο Overleaf, αλλά θα μετατραπεί σε κανονικό αρχείο και θα αντικαταστήσει τον τοπικό συμβολικό σύνδεσμο την επόμενη φορά που το έργο θα ληφθεί. **Ετικέτες**: Το σύστημα Git του Overleaf δεν υποστηρίζει ετικέτες. **Δικαιώματα αρχείων**: Το σύστημα Git του Overleaf δεν διατηρεί τα δικαιώματα εκτέλεσης. Για να το παρακάμψετε, μπορείτε να εκτελέσετε `git config core.fileMode false` στο τοπικό σας κλωνοποιημένο αποθετήριο. Στη συνέχεια μπορείτε να επαναφέρετε τα δικαιώματα εκτέλεσης σε τυχόν επηρεαζόμενα αρχεία. Με αυτόν τον τρόπο δεν θα τροποποιούνται ξανά με επόμενες λειτουργίες Git. **Git LFS:** Τα έργα Overleaf δεν υποστηρίζουν το Git Large File Storage. **Υπομονάδες Git:** Τα έργα Overleaf μπορούν να λειτουργούν ως υπομονάδες Git μέσα σε άλλα αποθετήρια, αλλά δεν μπορούν να περιέχουν άλλες υπομονάδες Git. Για αναφορά σε αρχεία από άλλα έργα, προτείνεται να χρησιμοποιήσετε τη [λειτουργία προσθήκης από άλλο έργο](/latex/el/basi-gnoseon/009-can-i-share-files-e.g.-.bib-and-some-graphics-across-my-projects.md). **Μετονομασία φακέλων**: Αν ένας χρήστης μετονομάσει έναν φάκελο και προωθήσει την αλλαγή στο Overleaf, το έργο θα διατηρήσει έναν κενό φάκελο με το παλιό όνομα, επιπλέον του νέου φακέλου. (Για παράδειγμα, η μετονομασία του images/ σε img/ θα αφήσει δύο φακέλους στο έργο: τον img/ που περιέχει τα αρχεία εικόνας, και τον images/, ο οποίος θα είναι κενός. Αυτό μπορεί να προκαλέσει προβλήματα όταν ένας χρήστης μετονομάζει έναν φάκελο και δημιουργεί ένα νέο αρχείο με το ίδιο όνομα με τον παλιό φάκελο, σε μία δέσμευση. Το σύστημα Git του Overleaf θα απορρίψει αυτή τη δέσμευση. Σε αυτή την περίπτωση συνιστούμε να χωρίσετε τη δέσμευση σε δύο μέρη και να διαγράψετε τον εναπομείναντα φάκελο. **Μετονομασία αρχείων και μετακίνηση αρχείων:** Η μετονομασία ενός αρχείου στο τοπικό σας αποθετήριο γίνεται διαγραφή και δημιουργία από την πλευρά του Overleaf. Αυτό μπορεί να οδηγήσει σε απώλεια μεταδεδομένων που σχετίζονται με ένα αρχείο στην πλευρά του Overleaf, προκαλώντας τη διαγραφή των παρακολουθούμενων αλλαγών και των σχολίων. Δεν συνιστάται να μετακινείτε ή να μετονομάζετε αρχεία στην πλευρά Git που έχουν παρακολουθούμενες αλλαγές ή σχόλια του Overleaf. **Παρακολούθηση αλλαγών και σχόλια**: Δυστυχώς, οι προωθήσεις από το Git προς το Overleaf μπορούν να οδηγήσουν σε απώλεια ή μετατόπιση παρακολουθούμενων αλλαγών και σχολίων· κατά συνέπεια, δεν συνιστούμε να αναμειγνύεται η ενεργή χρήση του Git με τη χρήση παρακολουθούμενων αλλαγών ή/και σχολίων. ### Αντιμετώπιση προβλημάτων #### Σφάλματα «Το αποθετήριο δεν βρέθηκε» Αν βλέπετε σφάλμα «Το αποθετήριο δεν βρέθηκε», πιθανότατα χρησιμοποιείται το λάθος URL. Το σωστό URL μπορείτε να το βρείτε κάνοντας κλικ στην επιλογή Git στο μενού μέσα στο έργο. Για το Overleaf cloud, η ενσωμάτωση Git είναι premium λειτουργία, επομένως θα είναι διαθέσιμη μόνο αν ο ιδιοκτήτης του έργου έχει συνδρομή επί πληρωμή στο Overleaf ή έχει λάβει πρόσβαση στη λειτουργία (π.χ. συμμετέχοντας σε πρώιμη beta δοκιμή). #### Σφάλματα αποτυχίας ταυτοποίησης Δείτε τις οδηγίες αντιμετώπισης προβλημάτων για το [διακριτικά ταυτοποίησης για την ενσωμάτωση Git](/latex/el/basi-gnoseon/042-git-integration-authentication-tokens.md) ή [ταυτοποίηση με κωδικό πρόσβασης για την ενσωμάτωση Git](/latex/el/basi-gnoseon/043-git-integration-password-based-authentication.md) ανάλογα με τη μέθοδο σύνδεσης που χρησιμοποιείτε. #### Όρια ρυθμού Ο περιορισμός ρυθμού του Git Bridge γενικά δεν εμφανίζεται όταν οι λειτουργίες Git εκτελούνται χειροκίνητα. Ορισμένοι πελάτες Git μπορούν να ρυθμιστούν ώστε να προσπαθούν να ελέγχουν αυτόματα τα απομακρυσμένα για αλλαγές, κάτι που μπορεί σε ορισμένες περιπτώσεις να οδηγήσει σε σφάλματα περιορισμού ρυθμού. Γενικά, η απενεργοποίηση οποιουδήποτε αυτοματοποιημένου polling ή η μείωση της συχνότητας των λειτουργιών Git θα πρέπει να επιλύσει αυτά τα προβλήματα. #### Αποτυχία προώθησης αναφορών Η αποτυχία προώθησης ορισμένων αναφορών στο απομακρυσμένο έργο μπορεί να προκληθεί από [υπέρβαση του μεγέθους αρχείου ή των περιορισμών αριθμού ενός έργου](/latex/el/basi-gnoseon/119-overleaf-plan-limits.md) ή από τη συμπερίληψη μη υποστηριζόμενων τύπων αρχείων (για παράδειγμα, συμβολικών συνδέσμων ή LFS). Παρακαλούμε εξετάστε τους γνωστούς περιορισμούς που παρατίθενται παραπάνω για να εντοπίσετε τυχόν προβληματικά αρχεία στη δέσμευση. Σε ορισμένες περιπτώσεις, η αύξηση της **postBuffer** ρύθμισης μπορεί να αντιμετωπίσει αποτυχίες προώθησης αναφορών από το τοπικό σας αποθετήριο στο έργο του Overleaf. Πρώτα, μπορείτε να ελέγξετε την τρέχουσα ρύθμισή σας με την εντολή: ```      git config http.postBuffer ``` Αν δεν υπάρχει έξοδος, αυτό σημαίνει ότι χρησιμοποιείται η προεπιλεγμένη τιμή του 1MB. Στη συνέχεια, δοκιμάστε την εντολή ```      git config --global http.postBuffer 10485760 ``` η οποία θα ορίσει αντί αυτού την τιμή σε 10MB. Τώρα μπορείτε να δοκιμάσετε να προωθήσετε τη δέσμευση (είτε στο αρχικό έργο είτε στο νέο). Αν αυτό δεν λειτουργήσει, μπορείτε να επιστρέψετε στην προηγούμενη ρύθμισή σας ή να αφαιρέσετε τη ρύθμιση με: ```      git config --global --unset http.postBuffer ``` #### Χρονικά όρια Οι δεσμεύσεις Git που περιλαμβάνουν μεγάλο αριθμό αλλαγών μπορούν ενδεχομένως να οδηγήσουν σε χρονικά όρια. Αν αντιμετωπίσετε χρονικό όριο, παρακαλούμε προσπαθήστε να χωρίσετε τη δέσμευση σε μικρότερες αλλαγές. Αν το πρόβλημα επιμένει, σκεφτείτε να ορίσετε το **postBuffer** στα 10MB όπως περιγράφεται παραπάνω. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://overleaf-pro.ayaka.space/latex/el/basi-gnoseon/040-git-integration.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.