Разрешения и ограничения за колекции
На тази страница
Специфичният риск при базите знания
Базата знания на едно предприятие никога не е тривиална задача: вътрешни бележки, поверителни доклади, договори в процес на преговори. Ако контролът на достъпа се провали, Вие не просто изтичате един единствен файл – Вие излагате цялата база, заедно с търсачка, която да открива важното. Системата за разрешения на xAI смекчава този риск чрез разделяне на правата, докато квотите регулират използването и фактурирането.
Два ключа, две роли
Екосистемата на xAI разчита на два удостоверителни знака за различни обхвати:
| Ключ | Използване | Обхват |
|---|---|---|
XAI_API_KEY | Качване на файлове и търсене | Операции за четене и използване |
XAI_MANAGEMENT_API_KEY | Управление на колекции | Административни операции |
Това разделяне прилага принципа на най-малките привилегии конкретно. Разработчик, свързващ чатбот за поддръжка с Вашата база, трябва да може да прави заявки към колекцията, но никога да я изтрива. Като му предоставите само стандартния ключ, грешка в скрипта или компрометиран ключ не могат да унищожат индекс, изграждан с месеци.
Разрешението AddFileToCollection
Ключът за Management API по подразбиране не е всемогъщ. Неговите права са изрични, а най-критичното за колекциите е AddFileToCollection. Без него Вие можете да създавате и изброявате колекции, но не можете да добавите нито един документ – объркваща ситуация, тъй като всичко изглежда работи до момента на ingest (вкарване на данни). Генерирането на правилен ключ включва четири стъпки:
- Влезте в конзолата на 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 за 1000 повиквания за търсене, докато прикачените файлове (File Attachments) струват $10 за 1000 повиквания. Разликата е значителна и тежи върху архитектурните избори. При интензивно използване, заявката към индексирана колекция струва значително по-малко от повторното прикачване на същия документ с всеки въпрос.
Ако нуждите Ви надвишават тези квоти, поддръжката на xAI може да отпусне увеличение. Подгответе заявката си с цифри – целеви брой файлове, общ обем, очаквана честота на търсене – вместо с неясна оценка. Това ускорява обработката на заявката.
Изолирайте, ротацирайте, наблюдавайте
Първата практика се отнася до ключовете. Присвоявайте различни ключове за всяка среда, така че скрипт за разработка никога да не може да докосне производствената база. Никога не предоставяйте Management ключ на услуга, чиято единствена нужда е търсенето. И ротацирайте тези ключове редовно, особено след като сътрудник с достъп до тайните напусне.
Второто се отнася до структурата. Вместо една единствена колекция, където публичната документация и договорите съществуват заедно, разделете базите си според нивото на поверителност: “публична” база за отворена документация, “вътрешна” база за фирмени документи и “поверителна” база за чувствителни данни. Всяка услуга тогава получава само достъпа, от който се нуждае, и въпросът “може ли този чатбот да цитира договор?” получава отговор още на етапа на проектиране.
Третото е мониторингът. Проверете потреблението си в конзолата на xAI, задайте предупреждение при всяко неочаквано повишаване на обема на търсенията – често първият признак за безконтролен цикъл – и водете писмен запис кои услуги имат достъп до кои колекции.
Един файл, множество колекции
Тази изолация не изисква дублиране на документите Ви, тъй като един и същ файл може да принадлежи на множество колекции. Един технически доклад така се появява в “product-documentation” за техническия екип, в “quarterly-reports” за ръководството и в “support-base” за обслужването на клиенти. Той се съхранява само веднъж, брои се само веднъж към Вашите квоти и остава търсим във всичките три контекста – тематични изгледи по аудитория, без разминаващи се копия.
Ключови изводи
- Два различни API ключа: стандартен за използване, Management за администрация
- Разрешението
AddFileToCollectionе от съществено значение за попълване на колекции - Ограниченията са 100 000 файла, 100 GB и 100 MB на файл
- Разделете колекциите си според нивото на поверителност
- Един файл може да принадлежи на множество колекции без дублиране