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

Δημιουργία και διαχείριση συλλογών

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

Από μεμονωμένα αρχεία σε βάση γνώσεων

Μέχρι τώρα, κάθε έγγραφο στεκόταν μόνο του: το ανεβάζατε, το αναφέρατε και ο ευρετηριασμός που δημιουργούνταν για την περίσταση εξαφανιζόταν μαζί με το ερώτημα. Οι συλλογές αλλάζουν την κλίμακα: ομαδοποιούν τα αρχεία σας σε δομημένες βάσεις γνώσεων, οι οποίες ευρετηριάζονται μία φορά και μπορούν να αναζητηθούν επ’ αόριστον. Αυτή είναι η βάση του RAG (Retrieval-Augmented Generation) με το Grok, και η διαφορά γίνεται αντιληπτή μόλις μια ομάδα υποστήριξης αναζητήσει σε διακόσια φύλλα προϊόντων αντί για ένα μόνο PDF.

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

100k
Αρχεία ανά λογαριασμό
100 GB
Συνολική χωρητικότητα
CRUD
Πλήρεις λειτουργίες
$2.50
Ανά 1.000 αναζητήσεις

Ένα ξεχωριστό API και ο λόγος

Δεν διαχειρίζεστε τις συλλογές από το API που χρησιμοποιούσατε από την αρχή του μαθήματος. Αυτές εμπίπτουν στο Management API, το οποίο φιλοξενείται στο management-api.x.ai, με τη βασική διεύθυνση URL:

https://management-api.x.ai/v1

Αυτός ο διαχωρισμός δεν είναι αρχιτεκτονική ιδιοτροπία. Η δημιουργία, η τροποποίηση ή η διαγραφή μιας συλλογής αποτελούν διοικητικές λειτουργίες με σοβαρές συνέπειες και το xAI απαιτεί ένα αφιερωμένο κλειδί για αυτές: ένα Management API Key, με την άδεια AddFileToCollection. Το όφελος είναι άμεσο για τις ομάδες: η υπηρεσία που αναζητά στη βάση από τη δημόσια εφαρμογή σας λαμβάνει το τυπικό κλειδί και δεν μπορεί να καταστρέψει τίποτα· μόνο ο αγωγός εισαγωγής δεδομένων (ingestion pipeline) σας κατέχει το κλειδί διαχείρισης.

Δημιουργήστε την πρώτη σας συλλογή

Η δημιουργία ανάγεται σε μια απλή κλήση με ένα όνομα:

curl -X POST https://management-api.x.ai/v1/collections \
  -H "Authorization: Bearer $XAI_MANAGEMENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"collection_name": "technical-docs"}'

Η απόκριση επιστρέφει το αναγνωριστικό που πρέπει να κρατήσετε:

{
  "collection_id": "col_xyz789",
  "collection_name": "technical-docs",
  "created_at": "2026-04-01T10:00:00Z"
}

Επιλέξτε αυτό το όνομα προσεκτικά: θα εμφανίζεται σε όλες τις λίστες σας και, έξι μήνες αργότερα, θα είναι η μόνη ένδειξη που θα σας επιτρέπει να διακρίνετε δύο γειτονικές βάσεις. Το technical-docs επιτελεί αυτόν τον ρόλο· το test2 όχι. Υιοθετήστε μια σύμβαση από την πρώτη συλλογή, επειδή η μετονομασία μιας βάσης στην οποία αναφέρονται ήδη τρεις εφαρμογές κοστίζει περισσότερο από το να της δώσετε ένα καλό όνομα εξαρχής.

Οι πέντε διαθέσιμες λειτουργίες

Το Management API εκθέτει ένα πλήρες σύνολο CRUD για τις συλλογές:

ΛειτουργίαΜέθοδοςΤερματικό σημείο (Endpoint)
ΔημιουργίαPOST/v1/collections
ΛίσταGET/v1/collections
ΛεπτομέρειεςGET/v1/collections/{collection_id}
ΕνημέρωσηPUT/v1/collections/{collection_id}
ΔιαγραφήDELETE/v1/collections/{collection_id}

Η λίστα των συλλογών σας γίνεται χωρίς παραμέτρους και παρέχει μια χρήσιμη επισκόπηση πριν από οποιαδήποτε λειτουργία συντήρησης:

curl https://management-api.x.ai/v1/collections \
  -H "Authorization: Bearer $XAI_MANAGEMENT_API_KEY"

Η διαγραφή ακολουθεί την ίδια λογική, ορίζοντας το αναγνωριστικό που αποκτήθηκε κατά τη δημιουργία:

curl -X DELETE https://management-api.x.ai/v1/collections/col_xyz789 \
  -H "Authorization: Bearer $XAI_MANAGEMENT_API_KEY"

Ένα πράγμα πρέπει να σας καθησυχάζει όταν εκτελείτε αυτή την εντολή: η διαγραφή μιας συλλογής αφαιρεί τον ευρετηριασμό, όχι τα αρχεία. Τα έγγραφά σας παραμένουν προσβάσιμα μέσω του Files API και μπορούν να ευρετηριαστούν εκ νέου αλλού. Χάνετε τη δομή αναζήτησης, όχι την πρώτη ύλη—γεγονός που καθιστά την ανοικοδόμηση μιας κακώς οργανωμένης βάσης πολύ λιγότερο επικίνδυνη από ό,τι φαίνεται.

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

  • Οι συλλογές ομαδοποιούν τα αρχεία σας σε ευρετηριασμένες βάσεις γνώσεων για RAG
  • Η διαχείριση γίνεται μέσω του Management API (management-api.x.ai), όχι του τυπικού API
  • Απαιτείται ένα Management API Key με την άδεια AddFileToCollection
  • Τα όρια είναι 100.000 αρχεία και 100 GB ανά λογαριασμό
  • Οι πέντε λειτουργίες CRUD καλύπτουν τη δημιουργία, την ανάγνωση, την ενημέρωση και τη διαγραφή