Αξιοποίηση των παραπομπών στα αποτελέσματα
Σε αυτήν τη σελίδα
Ιχνηλατήσιμες απαντήσεις με παραπομπές
Όταν ένας χρήστης υποβάλλει στην εφαρμογή σας ένα ερώτημα πραγματικών δεδομένων, επιθυμεί να επαληθεύσει τις πληροφορίες. Οι παραπομπές του API του Grok καλύπτουν ακριβώς αυτή την ανάγκη: κάθε γεγονός που ανακτάται μέσω αναζήτησης στον ιστό συνοδεύεται από την πηγή του. Αυτό σας επιτρέπει να δημιουργήσετε διεπαφές όπου κάθε ισχυρισμός είναι clickable και επαληθεύσιμος.

Το API προσφέρει δύο συμπληρωματικούς μηχανισμούς παραπομπών: καθολικές παραπομπές και ενσωματωμένες παραπομπές. Η κατανόηση της λειτουργίας τους σας επιτρέπει να δημιουργήσετε επαγγελματικές και διαφανείς εμπειρίες χρήστη.
Καθολικές παραπομπές: Η πλήρης λίστα πηγών
Οι καθολικές παραπομπές επιστρέφονται εξ ορισμού στο πεδίο citations της απάντησης. Περιέχουν μια λίστα με όλα τα URL που συμβουλεύτηκε το μοντέλο, ακόμη και εκείνα που δεν αναφέρονται άμεσα στο κείμενο της απάντησης.
response = client.responses.create(
model="grok-4.5",
input="What are the latest AI regulations in Europe?",
tools=[{"type": "web_search"}]
)
# Access global citations
for citation in response.citations:
print(f"Source: {citation.url}")
Δεν απαιτείται πρόσθετη διαμόρφωση. Αυτή είναι η εγγενής συμπεριφορά του API.
Ενσωματωμένες παραπομπές: Αναφορές μέσα στο κείμενο
Οι ενσωματωμένες παραπομπές εισάγουν συνδέσμους Markdown απευθείας στο κείμενο της απάντησης, χρησιμοποιώντας τη μορφή [[N]](url), όπου το N είναι ένας διαδοχικός αριθμός που ξεκινά από το 1. Εάν η ίδια πηγή παρατίθεται πολλές φορές, επαναχρησιμοποιείται ο αρχικός αριθμός.
Η προεπιλεγμένη συμπεριφορά εξαρτάται από το SDK που χρησιμοποιείτε:
- Direct Responses API: οι ενσωματωμένες παραπομπές είναι ενεργοποιημένες εξ ορισμού
- xAI SDK: οι ενσωματωμένες παραπομπές είναι απενεργοποιημένες εξ ορισμού (προαιρετική ενεργοποίηση)
Ενεργοποίηση ενσωματωμένων παραπομπών με το xAI SDK
response = client.responses.create(
model="grok-4.5",
input="Current status of the European AI Act",
tools=[{"type": "web_search"}],
include=["inline_citations"]
)
Απενεργοποίηση ενσωματωμένων παραπομπών στο Responses API
response = client.responses.create(
model="grok-4.5",
input="Current status of the European AI Act",
tools=[{"type": "web_search"}],
include=["no_inline_citations"]
)
Το σχήμα δομημένου σχολιασμού
Κάθε ενσωματωμένη παραπομπή δημιουργεί ένα αντικείμενο σχολιασμού με ακριβή μεταδεδομένα. Αυτή η δομή επιτρέπει προηγμένη προγραμματιστική επεξεργασία:
{
"type": "url_citation",
"url": "https://eur-lex.europa.eu/eli/reg/2024/1689",
"start_index": 145,
"end_index": 178,
"title": "1"
}
Τα πεδία start_index και end_index ακολουθούν τη σύμβαση slicing της Python. Μπορείτε να τα χρησιμοποιήσετε για να εξαγάγετε το ακριβές κείμενο που παρατίθεται ή να δημιουργήσετε προσαρμοσμένη απόδοση HTML:
text = response.output_text
for annotation in response.annotations:
cited_text = text[annotation.start_index:annotation.end_index]
print(f"Cited text: {cited_text}")
print(f"Source: {annotation.url}")
Συμπεριφορά κατά τη ροή δεδομένων (Streaming)
Κατά τη χρήση ροής δεδομένων (streaming), οι ενσωματωμένες παραπομπές εμφανίζονται προοδευτικά στα τμήματα κειμένου. Ωστόσο, οι πλήρεις σχολιασμοί είναι διαθέσιμοι μόνο στην τελική απάντηση. Προγραμματίστε επεξεργασία σε δύο στάδια εάν η διεπαφή σας εμφανίζει πηγές σε πραγματικό χρόνο.
Δημιουργία διεπαφής με πηγές
Ακολουθεί ένα παράδειγμα μετατροπής των παραπομπών σε δομημένο HTML:
def format_response_with_sources(response):
text = response.output_text
sources = []
# Collect unique sources
seen_urls = set()
for citation in response.citations:
if citation.url not in seen_urls:
sources.append(citation.url)
seen_urls.add(citation.url)
# Build the render
html = f"<div class='response'>{text}</div>"
html += "<div class='sources'><h4>Sources</h4><ul>"
for i, url in enumerate(sources, 1):
html += f"<li><a href='{url}'>[{i}] {url}</a></li>"
html += "</ul></div>"
return html
Παραπομπές συλλογών
Εάν χρησιμοποιείτε το εργαλείο collections_search παράλληλα με το web_search, οι παραπομπές από τα έγγραφα που έχετε μεταφορτώσει χρησιμοποιούν μια συγκεκριμένη μορφή URI: collections://collection_id/files/file_id. Διακρίνετε αυτές τις παραπομπές από τις τυπικές διαδικτυακές παραπομπές για να προσαρμόσετε την απόδοση του front-end.
Πρακτική εξάσκηση
Δημιουργήστε μια εφαρμογή που εμφανίζει τα αποτελέσματα αναζήτησης του Grok με ένα σύστημα υποσημειώσεων. Κάθε γεγονός πρέπει να συνδέεται με την αρχική του πηγή. Δοκιμάστε με ερωτήσεις σχετικά με τρέχοντα γεγονότα και επαληθεύστε χειροκίνητα ότι οι σύνδεσμοι είναι έγκυροι και σχετικοί.
Βασικά σημεία
- Οι καθολικές παραπομπές (λίστα URL) επιστρέφονται εξ ορισμού, χωρίς διαμόρφωση
- Οι ενσωματωμένες παραπομπές (σύνδεσμοι στο κείμενο) ενεργοποιούνται μέσω της παραμέτρου
include - Η προεπιλεγμένη συμπεριφορά των ενσωματωμένων παραπομπών ποικίλλει ανάλογα με το SDK
- Κάθε σχολιασμός περιέχει το URL, τους δείκτες θέσης και τον αριθμό παραπομπής
- Στη ροή δεδομένων, οι πλήρεις σχολιασμοί είναι διαθέσιμοι μόνο στην τελική απάντηση
- Οι παραπομπές συλλογών χρησιμοποιούν μια ξεχωριστή μορφή URI (
collections://)