Αυτόματες παραπομπές και βέλτιστες πρακτικές
Σε αυτήν τη σελίδα
Τεκμηριωμένες και αξιόπιστες απαντήσεις
Όταν το μοντέλο χρησιμοποιεί αναζήτηση στον ιστό ή αναζήτηση στο X, το API Responses περιλαμβάνει αυτόματα παραπομπές στην απάντηση. Αυτές οι παραπομπές επιτρέπουν στους χρήστες σας να επαληθεύουν τις πηγές και να οικοδομούν εμπιστοσύνη στις παραγόμενες απαντήσεις.
Πώς λειτουργούν οι παραπομπές
Οι παραπομπές εμφανίζονται στον πίνακα annotations κάθε στοιχείου περιεχομένου:
{
"output": [{
"type": "message",
"content": [{
"type": "output_text",
"text": "According to the latest data, the AI market...",
"annotations": [
{
"type": "url_citation",
"url": "https://example.com/article",
"title": "AI Market Analysis in 2026",
"start_index": 35,
"end_index": 68
}
]
}]
}]
}
Πεδία παραπομπής
| Πεδίο | Περιγραφή |
|---|---|
type | Πάντα url_citation |
url | URL πηγής |
title | Τίτλος σελίδας πηγής |
start_index | Θέση έναρξης στο κείμενο |
end_index | Θέση λήξης στο κείμενο |
Εμφάνιση παραπομπών στην εφαρμογή σας
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="What are the latest advancements in AI?",
tools=[{"type": "web_search"}]
)
text = response.output[0].content[0].text
annotations = response.output[0].content[0].annotations
# Δημιουργία κειμένου με υποσημειώσεις
footnotes = []
for i, ann in enumerate(annotations, 1):
footnotes.append(f"[{i}] {ann.title} — {ann.url}")
print(text)
print("\n--- Sources ---")
for fn in footnotes:
print(fn)
Σε HTML
def render_with_citations(text, annotations):
# Ταξινόμηση κατά θέση (από το τέλος στην αρχή για να μην μετατοπιστούν οι δείκτες)
sorted_anns = sorted(annotations, key=lambda a: a.start_index, reverse=True)
html = text
for i, ann in enumerate(sorted_anns):
ref_num = len(sorted_anns) - i
link = f'<a href="{ann.url}" title="{ann.title}" target="_blank">[{ref_num}]</a>'
html = html[:ann.end_index] + link + html[ann.end_index:]
return html
Βέλτιστες πρακτικές για παραγωγή
1. Επαλήθευση πάντα της κατάστασης
response = client.responses.create(...)
if response.status != "completed":
handle_error(response)
return
2. Διαχείριση κενών απαντήσεων
if not response.output or not response.output[0].content:
return "The model did not generate a response."
text = response.output[0].content[0].text
3. Καταγραφή μετρικών
Για κάθε αίτημα παραγωγής, καταγράψτε:
- Το
response.idγια ιχνηλασιμότητα - Το
usage.total_tokensγια την κατανάλωση - Το
usage.cost_in_nano_usdγια το κόστος - Τον χρόνο απόκρισης από την πλευρά του πελάτη
- Την κατάσταση της απόκρισης
4. Ασφάλιση του κλειδιού API σας
- Αποθηκεύστε το σε μεταβλητή περιβάλλοντος, ποτέ μέσα στον κώδικα
- Χρησιμοποιήστε διαχειριστή μυστικών σε παραγωγή (Vault, AWS Secrets Manager)
- Περιστρέφετε τα κλειδιά σας τακτικά
- Μην τα εκθέτετε ποτέ στην πλευρά του πελάτη (browser)
5. Διαχείριση παραγόμενου περιεχομένου
Οι απαντήσεις του μοντέλου ενδέχεται να περιέχουν ακατάλληλο περιεχόμενο παρά τους φίλτρους. Υλοποιήστε ένα επίπεδο δια moderation εάν εμφανίζετε απαντήσεις δημόσια.
6. Σχεδιασμός για κλιμάκωση
- Χρησιμοποιήστε ροή δεδομένων (streaming) για να μειώσετε τον αντιληπτό χρόνο αναμονής
- Υλοποιήστε ένα σύστημα ουράς για βαριά αιτήματα
- Κάντε cache συχνών απαντήσεων
- Παρακολουθήστε τα όρια του ρυθμού περιορισμού (rate limiting)
Λίστα ελέγχου ανάπτυξης
- Χρονικό όριο (timeout) ορισμένο στα 3600 δευτερόλεπτα
- Επαναληπτική προσπάθεια με εκθετική καθυστέρηση (exponential backoff)
- Περιορισμός ρυθμού στην πλευρά του πελάτη
- Καταγραφή μετρικών (tokens, κόστος, λανθάνουσα χρονική καθυστέρηση)
- Διαχείριση σφαλμάτων (401, 429, 500, timeout)
- Ασφαλές κλειδί API
- Δια moderation περιεχομένου εάν χρειάζεται
- Παρακολούθηση κόστους και ειδοποιήσεις
- Διακόπτης κυκλώματος (circuit breaker) για ανθεκτικότητα
Βασικά σημεία
- Οι παραπομπές είναι αυτόματες όταν το μοντέλο χρησιμοποιεί
web_searchήx_search - Περιέχουν το URL, τον τίτλο και τη θέση στο κείμενο
- Επαληθεύετε πάντα την κατάσταση και διαχειρίζεστε τις κενές απαντήσεις
- Ασφαλίστε το κλειδί API σας—ποτέ στον πηγαίο κώδικα ή στην πλευρά του πελάτη
- Υλοποιήστε καταγραφή, επαναληπτικές προσπάθειες, περιορισμό ρυθμού και παρακολούθηση πριν τη μετάβαση σε παραγωγή
Δοκιμάστε τις γνώσεις σας
Το API Responses σε βάθος: η τελική επαλήθευση.
1. Τι προσφέρει το API Responses σε σύγκριση με το Chat Completions;
Απάντηση: Η σύγχρονη μορφή: επιμονή απόκρισης στην πλευρά του διακομιστή (GET/DELETE, αλυσιδωτή σύνδεση με ID), ενσωματωμένα εργαλεία και πρόσφατα χαρακτηριστικά—το API όπου η xAI εστιάζει την εξέλιξη.
2. Πώς αλυσιδώνετε μια συνομιλία;
Απάντηση: Αναφερόμενοι στην προηγούμενη απόκριση: το πλαίσιο διατηρείται στην πλευρά του διακομιστή—δεν χρειάζεται να ξαναστείλετε ολόκληρο το ιστορικό σε κάθε βήμα.
3. Τι είναι η κρυπτογραφημένη συλλογιστική;
Απάντηση: Η εσωτερική συλλογιστική του μοντέλου επιστρέφεται σε κρυπτογραφημένη μορφή: επαναχρησιμοποιήσιμη σε επόμενα βήματα χωρίς να είναι αναγνώσιμη—η διαδικασία σκέψης ταξιδεύει, η εμπιστευτικότητα παραμένει.
4. Τι επιτρέπει η ανάμειξη εργαλείων διακομιστή και πελάτη;
Απάντηση: Συνδυασμό ενσωματωμένων εργαλείων που εκτελούνται από την xAI (αναζήτηση ιστού κ.λπ.) και των δικών σας προσαρμοσμένων συναρτήσεων που εκτελούνται από τον κώδικά σας—κάθε εργαλείο στο σωστό σημείο, συντονισμένο στο ίδιο αίτημα.
5. Ποιες είναι οι βέλτιστες πρακτικές για παραγωγή;
Απάντηση: Διαχείριση χρονικού ορίου και επαναληπτικής προσπάθειας, παρακολούθηση χρέωσης (tokens, εργαλεία) και αξιοποίηση αυτόματων παραπομπών για επαληθεύσιμες απαντήσεις—ευρωστία και εμπιστοσύνη μαζί.
Επιμονή, εργαλεία, κρυπτογραφημένη συλλογιστική, παραπομπές: το API Responses είναι η σύγχρονη βάση—εδώ χτίζονται οι εφαρμογές Grok σας.