Μετάβαση στο κύριο περιεχόμενο
Ελληνικά— Επιλέξτε γλώσσα
Μενού

Αυτόματες παραπομπές και βέλτιστες πρακτικές

Μάθημα 16 / 16 Ενημερώθηκε 30 Ιουλίου 2026 Για developers
Σε αυτήν τη σελίδα
  1. Τεκμηριωμένες και αξιόπιστες απαντήσεις
  2. Πώς λειτουργούν οι παραπομπές
  3. Εμφάνιση παραπομπών στην εφαρμογή σας
  4. Βέλτιστες πρακτικές για παραγωγή
  5. Λίστα ελέγχου ανάπτυξης
  6. Βασικά σημεία
  7. Δοκιμάστε τις γνώσεις σας

Τεκμηριωμένες και αξιόπιστες απαντήσεις

Όταν το μοντέλο χρησιμοποιεί αναζήτηση στον ιστό ή αναζήτηση στο 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
urlURL πηγής
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 σας.