Δικαιώματα και Όρια Συλλογών
Σε αυτήν τη σελίδα
Ο ειδικός κίνδυνος των βάσεων γνώσης
Μια εταιρική βάση γνώσης δεν είναι ποτέ τετριμμένη υπόθεση: περιλαμβάνει εσωτερικές σημειώσεις, εμπιστευτικές αναφορές και συμβάσεις υπό διαπραγμάτευση. Εάν οι έλεγχοι πρόσβασης αποτύχουν, δεν διαρρέει απλώς ένα μεμονωμένο αρχείο· εκτίθεται ολόκληρη η βάση, μαζί με τη μηχανή αναζήτησης που εντοπίζει τα κρίσιμα δεδομένα. Το σύστημα αδειοδότησης της xAI μετριάζει αυτόν τον κίνδυνο διαχωρίζοντας τα δικαιώματα, ενώ τα όρια χρήσης (quotas) διέπουν τη χρήση και τη χρέωση.
Δύο κλειδιά, δύο ρόλοι
Το οικοσύστημα της xAI βασίζεται σε δύο διαπιστευτήρια για διακριτά πεδία εφαρμογής:
| Κλειδί | Χρήση | Πεδίο εφαρμογής |
|---|---|---|
XAI_API_KEY | Μεταφόρτωση αρχείων και αναζήτηση | Λειτουργίες ανάγνωσης και χρήσης |
XAI_MANAGEMENT_API_KEY | Διαχείριση συλλογών | Διαχειριστικές λειτουργίες |
Αυτός ο διαχωρισμός εφαρμόζει πρακτικά την αρχή των ελάχιστων προνομίων. Ένας προγραμματιστής που συνδέει ένα chatbot υποστήριξης στη βάση σας χρειάζεται να κάνει ερωτήματα στη συλλογή, αλλά ποτέ να τη διαγράψει. Παρέχοντάς του μόνο το τυπικό κλειδί, ένα σφάλμα στο script ή μια παραβίαση του κλειδιού δεν μπορούν να καταστρέψουν έναν ευρετήριο που χτίστηκε επί μήνες.
Η άδεια AddFileToCollection
Ένα Management API Key δεν είναι εξ ορισμού παντοδύναμο. Τα δικαιώματά του είναι ρητά και το πιο κρίσιμο για τις συλλογές είναι το AddFileToCollection. Χωρίς αυτό, μπορείτε να δημιουργείτε και νααπαριθμείτε συλλογές, αλλά δεν μπορείτε να προσθέσετε ούτε ένα έγγραφο· μια συγχυτική κατάσταση, καθώς όλα φαίνονται να λειτουργούν μέχρι τη στιγμή της εισαγωγής δεδομένων. Η δημιουργία ενός σωστού κλειδιού περιλαμβάνει τέσσερα βήματα:
- Συνδεθείτε στην κονσόλα της xAI
- Δημιουργήστε ένα νέο Management API Key
- Ενεργοποιήστε την άδεια
AddFileToCollection - Αποθηκεύστε το κλειδί με ασφάλεια: σε μεταβλητή περιβάλλοντος ή σε διαχειριστή μυστικών
Όταν λείπει η άδεια, το API είναι σαφές και επιστρέφει σφάλμα 403:
{
"error": {
"message": "Insufficient permissions",
"type": "permission_error",
"code": 403
}
}
Το πρώτο σας βήμα πρέπει να είναι ο έλεγχος των δικαιωμάτων του κλειδιού στην κονσόλα, αντί να υποπτεύεστε το αίτημα, του οποίου η σύνταξη δεν έχει καμία σχέση με την απόρριψη.
Όρια χρήσης και το κόστος τους
Τρία ανώτατα όρια διέπουν την αποθήκευση ανά λογαριασμό: συνολικά 100.000 αρχεία, 100 GB σωρευτικής χωρητικότητας και 100 MB ανά μεμονωμένο αρχείο στις συλλογές· περισσότερο από το διπλάσιο των 48 MB που επιτρέπονται αποκλειστικά από το Files API, επιτρέποντάς σας να συμπεριλάβετε έγγραφα που δεν θα μπορούσατε να στείλετε ως άμεσα συνημμένα.
Όσον αφορά τη χρέωση, δύο γραμμές ξεχωρίζουν: Η Αναζήτηση σε Συλλογές (Collections Search) χρεώνεται με 2,50 $ ανά 1.000 κλήσεις αναζήτησης, ενώ τα Συνημμένα Αρχείων (File Attachments) κοστίζουν 10 $ ανά 1.000 κλήσεις. Η διαφορά είναι σημαντική και επηρεάζει τις αρχιτεκτονικές επιλογές. Σε συνθήκες έντονης χρήσης, η εκτέλεση ερωτημάτων σε μια ευρετηριασμένη συλλογή κοστίζει σημαντικά λιγότερο από την επανασύναψη του ίδιου εγγράφου με κάθε ερώτηση.
Εάν οι ανάγκες σας υπερβαίνουν αυτά τα όρια, η υποστήριξη της xAI μπορεί να χορηγήσει αύξηση. Προετοιμάστε το αίτημά σας με συγκεκριμένα στοιχεία—στόχο αριθμού αρχείων, συνολικό όγκο, αναμενόμενη συχνότητα αναζήτησης—και όχι με μια αόριστη εκτίμηση. Αυτό επιταχύνει την επεξεργασία του αιτήματος.
Απομόνωση, περιστροφή, παρακολούθηση
Η πρώτη πρακτική αφορά τα κλειδιά. Εκχωρήστε διαφορετικά κλειδιά σε κάθε περιβάλλον, ώστε ένα script ανάπτυξης να μην μπορεί ποτέ να αγγίξει τη βάση παραγωγής. Μην δίνετε ποτέ ένα Management key σε μια υπηρεσία της οποίας η μοναδική ανάγκη είναι η αναζήτηση. Και περιστρέφετε αυτά τα κλειδιά τακτικά, ειδικά μετά την αποχώρηση συνεργάτη που είχε πρόσβαση στα μυστικά.
Η δεύτερη αφορά τη δομή. Αντί για μια ενιαία συλλογή όπου συνυπάρχουν δημόσια τεκμηρίωση και συμβάσεις, διαχωρίστε τις βάσεις σας ανά επίπεδο εμπιστευτικότητας: μια «δημόσια» βάση για ανοιχτή τεκμηρίωση, μια «εσωτερική» βάση για εταιρικά έγγραφα και μια «εμπιστευτική» βάση για ευαίσθητα δεδομένα. Κάθε υπηρεσία λαμβάνει τότε μόνο την πρόσβαση που χρειάζεται, και το ερώτημα «μπορεί αυτό το chatbot να παραθέσει μια σύμβαση;» απαντάται εκ σχεδιασμού.
Η τρίτη είναι η παρακολούθηση. Ελέγξτε την κατανάλωσή σας στην κονσόλα της xAI, ορίστε μια ειδοποίηση για οποιαδήποτε απροσδόκητη αύξηση στον όγκο αναζήτησης—συχνά το πρώτο σημάδι ενός βρόχου που έχει ξεφύγει από τον έλεγχο—και τηρήστε γραπτό αρχείο για το ποιες υπηρεσίες αποκτούν πρόσβαση σε ποιες συλλογές.
Ένα αρχείο, πολλαπλές συλλογές
Αυτή η απομόνωση δεν απαιτεί τον διπλασιασμό των εγγράφων σας, καθώς το ίδιο αρχείο μπορεί να ανήκει σε πολλαπλές συλλογές. Μια τεχνική αναφορά εμφανίζεται έτσι στο «product-documentation» για την τεχνική ομάδα, στο «quarterly-reports» για τη διοίκηση και στο «support-base» για την εξυπηρέτηση πελατών. Αποθηκεύεται μόνο μία φορά, μετράει μόνο μία φορά στα όρια χρήσης σας και παραμένει αναζητήσιμη και στα τρία πλαίσια—θεματικές προβολές ανά κοινό, χωρίς αποκλίνοντα αντίγραφα.
Βασικά σημεία
- Δύο διακριτά κλειδιά API: τυπικό για χρήση, Management για διαχείριση
- Η άδεια
AddFileToCollectionείναι απαραίτητη για τον εμπλουτισμό των συλλογών - Τα όρια είναι 100.000 αρχεία, 100 GB και 100 MB ανά αρχείο
- Διαχωρίστε τις συλλογές σας ανά επίπεδο εμπιστευτικότητας
- Ένα αρχείο μπορεί να ανήκει σε πολλαπλές συλλογές χωρίς διπλασιασμό