Permisiuni și limite pentru colecții
Pe această pagină
Riscul specific al bazelor de cunoștințe
O bază de cunoștințe enterprise nu este niciodată banală: note interne, rapoarte confidențiale, contracte în curs de negociere. Dacă controalele de acces eșuează, nu scurgeți doar un singur fișier – expuneți întreaga bază, completată cu un motor de căutare pentru a găsi ceea ce contează. Sistemul de permisiuni xAI atenuează acest risc prin separarea drepturilor, în timp ce cotele guvernează utilizarea și facturarea.
Două chei, două roluri
Ecosistemul xAI se bazează pe două credențiale pentru domenii distincte:
| Cheie | Utilizare | Domeniu de aplicare |
|---|---|---|
XAI_API_KEY | Încărcare fișiere și căutare | Operațiuni de citire și utilizare |
XAI_MANAGEMENT_API_KEY | Gestionarea colecțiilor | Operațiuni de administrare |
Această separare aplică concret principiul privilegiului minim. Un dezvoltator care conectează un chatbot de suport la baza dumneavoastră trebuie să interogheze colecția, niciodată să o șteargă. Oferindu-i doar cheia standard, o eroare de script sau o cheie compromisă nu pot distruge un index construit timp de luni.
Permisiunea AddFileToCollection
O cheie API de management nu este atotputernică în mod implicit. Drepturile sale sunt explicite, iar cea mai critică pentru colecții este AddFileToCollection. Fără aceasta, puteți crea și lista colecții, dar nu puteți adăuga niciun document – o situație confuză, deoarece totul pare să funcționeze până la ingestie. Generarea unei chei corecte implică patru pași:
- Conectați-vă la consola xAI
- Creați o nouă cheie API de management
- Activați permisiunea
AddFileToCollection - Stocați cheia în siguranță: variabilă de mediu sau manager de secrete
Când permisiunea lipsește, API-ul este explicit și returnează un 403:
{
"error": {
"message": "Insufficient permissions",
"type": "permission_error",
"code": 403
}
}
Primul pas ar trebui să fie verificarea drepturilor cheii în consolă, mai degrabă decât suspectarea cererii, a cărei sintaxă nu are nicio legătură cu respingerea.
Cote și costurile lor
Trei plafoane guvernează stocarea per cont: 100.000 de fișiere în total, 100 GB capacitate cumulată și 100 MB per fișier individual în colecții – mai mult decât dublu față de cei 48 MB允许 de API-ul Files singur, permițându-vă să includeți documente pe care nu le-ați fi putut trimite ca atașamente directe.
În ceea ce privește facturarea, două linii se disting: Căutarea în colecții este facturată la 2,50 USD per 1.000 de apeluri de căutare, în timp ce Atașamentele de fișiere costă 10 USD per 1.000 de apeluri. Diferența este semnificativă și cântărește în alegerile arhitecturale. În cazul unei utilizări intense, interogarea unei colecții indexate costă semnificativ mai puțin decât re-atașarea aceluiași document la fiecare întrebare.
Dacă nevoile dumneavoastră depășesc aceste cote, suportul xAI poate acorda o majorare. Pregătiți cererea cu cifre – numărul țintă de fișiere, volumul total, frecvența estimată de căutare – mai degrabă decât cu o estimare vagă. Acest lucru accelerează procesarea cererii.
Izolare, rotație, monitorizare
Prima practică privește cheile. Atribuiți chei diferite fiecărui mediu, astfel încât un script de dezvoltare să nu poată atinge niciodată baza de producție. Nu oferiți niciodată o cheie de management unui serviciu a cărui singură nevoie este căutarea. Și rotiți aceste chei în mod regulat, în special după ce un colaborator cu acces la secrete părăsește organizația.
A doua privește structura. În loc de o singură colecție unde documentația publică și contractele coexistă, separați bazele după nivelul de confidențialitate: o bază „publică“ pentru documentația deschisă, una „internă“ pentru documentele companiei și una „confidențială“ pentru datele sensibile. Fiecare serviciu primește apoi doar accesul de care are nevoie, iar întrebarea „poate acest chatbot cita un contract?“ primește un răspuns prin design.
A treia este monitorizarea. Verificați consumul în consola xAI, setați o alertă pentru orice creștere neașteptată a volumului de căutare – adesea primul semn al unei bucle scăpate de sub control – și păstrați o evidență scrisă a serviciilor care accesează anumite colecții.
Un fișier, multiple colecții
Această izolare nu necesită duplicarea documentelor, deoarece același fișier poate aparține mai multor colecții. Un raport tehnic apare astfel în „product-documentation“ pentru echipa tehnică, în „quarterly-reports“ pentru management și în „support-base“ pentru serviciul clienți. Este stocat o singură dată, contează o singură dată în cotele dumneavoastră și rămâne căutabil în toate cele trei contexte – vizualizări tematice pe public, fără copii divergente.
Puncte cheie
- Două chei API distincte: standard pentru utilizare, Management pentru administrare
- Permisiunea
AddFileToCollectioneste esențială pentru popularea colecțiilor - Limitele sunt 100.000 de fișiere, 100 GB și 100 MB per fișier
- Separați colecțiile după nivelul de confidențialitate
- Un fișier poate aparține mai multor colecții fără duplicare