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

Το σημείο τελικού χρήστη αναζήτησης εγγράφων

Μάθημα 9 / 16 Ενημερώθηκε 29 Ιουλίου 2026 Για developers
Σε αυτήν τη σελίδα
  1. Ερωτήματα στις βάσεις γνώσης σας
  2. Δομή του αιτήματος
  3. Ανάγνωση της απόκρισης
  4. Αναζήτηση σε πολλαπλές συλλογές
  5. Κόστος
  6. Βασικά σημεία

Ερωτήματα στις βάσεις γνώσης σας

Μέχρι στιγμής έχετε δημιουργήσει το δοχείο: συλλογές, ευρετηριασμένα έγγραφα, μεταδεδομένα. Τίποτα από αυτά δεν έχει αξία αν δεν ξέρετε πώς να θέσετε μια ερώτηση. Αυτός είναι ο ρόλος του POST /v1/documents/search, το οποίο δέχεται ένα ερώτημα σε φυσική γλώσσα και επιστρέφει τα αποσπάσματα από τα έγγραφά σας που απαντούν σε αυτό με τον καλύτερο τρόπο. Φανταστείτε μια ομάδα υποστήριξης που λαμβάνει την ερώτηση «Ποια είναι η προθεσμία ανάκλησης;». Αντί να αναγκάσετε έναν πράκτορα να διαβάσει τους όρους και τις προϋποθέσεις, στέλνετε την ερώτηση στο σημείο τελικού χρήστη και ανακτάτε τις τρεις χρήσιμες παραγράφους, συνοδευόμενες από τη βαθμολογία και την πηγή τους.

POST
/v1/documents/search
3 modes
keyword, semantic, hybrid
$2.50
Per 1,000 calls
Multi
Multiple collections

Δομή του αιτήματος

Το πρώτο πράγμα που πρέπει να θυμάστε, και αυτό αποτελεί συχνή πηγή σφαλμάτων, είναι ότι αυτό το σημείο τελικού χρήστη βρίσκεται στο τυπικό API (api.x.ai) και όχι στο Management API που χρησιμοποιήσατε για τη δημιουργία συλλογών. Πιστοποιείτε την ταυτότητά σας με το συνηθισμένο κλειδί API σας. Το ελάχιστο αίτημα περιορίζεται σε τρία πεδία.

curl -X POST https://api.x.ai/v1/documents/search \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "How do I configure OAuth authentication?",
    "source": {
      "collection_ids": ["col_xyz789"]
    },
    "retrieval_mode": {
      "type": "hybrid"
    }
  }'

Κύριες παράμετροι

  • query: η ερώτησή σας σε φυσική γλώσσα. Όσο πιο συγκεκριμένη είναι η ερώτηση, τόσο πιο σχετικά θα είναι τα αποτελέσματα.
  • source.collection_ids: ένας πίνακας με αναγνωριστικά συλλογών (collection IDs) προς αναζήτηση. Μπορείτε να αναζητήσετε σε πολλαπλές συλλογές με ένα μόνο αίτημα.
  • retrieval_mode.type: η λειτουργία αναζήτησης που θα χρησιμοποιηθεί (keyword, semantic ή hybrid).

Ανάγνωση της απόκρισης

Το API δεν επιστρέφει ολόκληρα έγγραφα, αλλά θραύσματα, τα τμήματα που δημιουργήθηκαν κατά την ευρετηρίαση, ταξινομημένα από τα πιο σχετικά στα λιγότερο σχετικά.

{
  "results": [
    {
      "content": "To configure OAuth, start by...",
      "score": 0.92,
      "document_id": "file_abc123",
      "metadata": {
        "filename": "security-guide.pdf",
        "page": 12
      }
    },
    {
      "content": "The OAuth 2.0 flow uses...",
      "score": 0.87,
      "document_id": "file_def456",
      "metadata": {
        "filename": "api-reference.pdf",
        "page": 45
      }
    }
  ]
}

Κάθε εγγραφή περιέχει τέσσερα στοιχεία πληροφοριών:

  • content: το απόσπασμα κειμένου από το έγγραφο.
  • score: μια βαθμολογία συνάφειας μεταξύ 0 και 1.
  • document_id: το αναγνωριστικό του αρχείου προέλευσης.
  • metadata: τα μεταδεδομένα του εγγράφου (όνομα, σελίδα, προσαρμοσμένα πεδία).

Στο παραπάνω παράδειγμα, το πρώτο απόσπασμα προέρχεται από τη σελίδα 12 του security-guide.pdf με βαθμολογία 0,92, ενώ το δεύτερο από τη σελίδα 45 ενός άλλου αρχείου με βαθμολογία 0,87. Αυτές οι δύο τιμές αρκούν για να δημιουργήσετε μια διεπαφή που εμφανίζει την απάντηση και, ακριβώς από κάτω, έναν σύνδεσμο «προβολή αρχικού αποσπάσματος, σελίδα 12». Η βαθμολογία λειτουργεί ως κατώφλι: πολλές ομάδες απορρίπτουν οποιοδήποτε αποτέλεσμα κάτω από 0,5 αντί να αφήνουν το μοντέλο να συλλογίζεται πάνω σε θόρυβο.

Αναζήτηση σε πολλαπλές συλλογές

Αν το collection_ids είναι πίνακας, αυτό δεν είναι τυχαίο. Μια ερώτηση πελάτη συχνά συνδυάζει several document universes (διάφορους κόσμους εγγράφων) και δεν θέλετε να κάνετε τρία αιτήματα και στη συνέχεια να συγχωνεύσετε τα αποτελέσματα χειροκίνητα.

{
  "query": "Refund policy",
  "source": {
    "collection_ids": [
      "col_docs_produit",
      "col_faq",
      "col_conditions_generales"
    ]
  },
  "retrieval_mode": {
    "type": "hybrid"
  }
}

Εδώ, η τεκμηρίωση προϊόντος, οι Συχνές Ερωτήσεις (FAQ) και οι Όροι και Προϋποθέσεις αναζητούνται ταυτόχρονα. Τα αποτελέσματα επιστρέφουν συγχωνευμένα και ταξινομημένα κατά βαθμολογία, ανεξάρτητα από την αρχική τους συλλογή: ένα απόσπασμα από τις Συχνές Ερωτήσεις με 0,94 θα καταταχθεί υψηλότερα από ένα απόσπασμα από τους Όρους και Προϋποθέσεις με 0,71. Διασταυρώνετε ετερογενείς πηγές σε έναν μόνο γύρο δικτύου.

Κόστος

Η αναζήτηση σε συλλογές κοστίζει 2,50 $ ανά 1.000 κλήσεις και αυτός ο συντελεστής δεν αλλάζει βάσει του αριθμού των συλλογών που αναζητούνται ή του μεγέθους των ευρετηριασμένων εγγράφων. Συγκρίνετέ το με τα συνημμένα αρχεία, εκείνα τα μεμονωμένα αρχεία που περνούν μέσω του input_file, τα οποία χρεώνονται με 10 $ ανά 1.000 κλήσεις: μόλις αρχίσετε να κάνετε ερωτήματα στα ίδια έγγραφα επανειλημμένα, οι συλλογές κοστίζουν τέσσερις φορές λιγότερο. Ένας εσωτερικός βοηθός που διαχειρίζεται 20.000 ερωτήσεις τον μήνα πληρώνει 50 $ με συλλογές έναντι 200 $ με συνημμένα—και λαμβάνει ταχύτερα αποτελέσματα ως επιπλέον όφελος, καθώς το ευρετήριο υπάρχει ήδη.

Τιμολόγηση από τις 5 Αυγούστου 2026 — οι τιμές αλλάζουν τακτικά: πριν από οποιονδήποτε υπολογισμό προϋπολογισμού, ελέγξτε τον τρέχοντα τιμοκατάλογο στη επίσημη σελίδα μοντέλων και τιμολόγησης της xAI.

Βασικά σημεία

  • Το σημείο τελικού χρήστη POST /v1/documents/search κάνει ερωτήματα στις συλλογές σας σε φυσική γλώσσα.
  • Διατίθενται τρεις λειτουργίες αναζήτησης: keyword, semantic, hybrid.
  • Μπορείτε να αναζητήσετε σε πολλαπλές συλλογές ταυτόχρονα.
  • Τα αποτελέσματα ταξινομούνται κατά βαθμολογία συνάφειας μαζί με το περιεχόμενο της πηγής.
  • Το κόστος είναι 2,50 $ ανά 1.000 κλήσεις, τέσσερις φορές φθηνότερο από τα συνημμένα αρχεία.