Cruthaigh agus bainistigh bailiúcháin
Ar an leathanach seo
Ó chomhaid ar leithligh go dtí bonn eolais
Go dtí seo, bhí gach doiciméad ina sheasamh aige féin: d’uchtaigh tú é, rinne tú tagairt dó, agus d’imíodh an t-innéacs a tógadh don ócáid sin leis an gceist. Athraíonn bailiúcháin an scála: grúpáilíonn siad do chuid comhad i mbunair eolais struchtúrtha, innéacsaithe uair amháin agus incheistithe go deo. Is é seo bunús RAG—Retrieval-Augmented Generation—le Grok, agus feictear an difríocht chomh luath agus a dhéanann foireann tacaíochta ceist ar dhá chéad bileog táirge seachas ar PDF amháin.
Smaoinigh ar bhailiúchán mar fhillteán cliste. Cuirtear doiciméid ann, déanann xAI innéacsú orthu le haghaidh cuardaigh shéimeantach, agus cuardaíonn Grok an bonn seo chun freagra a thabhairt go beacht, ag tarraingt na dtrí phasáiste úsáideacha as measc na mílte.
API ar leith, agus cén fáth
Ní bhainistíonn tú bailiúcháin ón API a d’úsáid tú ó thús an chúrsa. Tagann siad faoin Management API, óstaithe ar management-api.x.ai, leis an mbonn-URL seo a leanas:
https://management-api.x.ai/v1
Ní caprice ailtireachta é an deighilt seo. Is oibríochtaí riaracháin iad bailiúchán a chruthú, a mhodhnú nó a scriosadh a bhfuil tionchar tromchúiseach acu, agus éilíonn xAI eochair tiomnaithe ina leith: Management API Key, leis an gcead AddFileToCollection. Tá an tairbhe láithreach d’fhoirne: faigheann an tseirbhís a dhéanann ceistiú ar an mbónn ó d’iarratas poiblí an ghnáth-eochair agus ní féidir léis aon rud a scriosadh; níl an eochair bhainistíochta ach ag do phíblíne ionghabhála amháin.
Do chéad bhailiúchán a chruthú
Tagann an cruthú anuas ar ghlaoidh amháin le hainm:
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"}'
Tugann an freagra an t-aitheantóir le coinneáil ar ais:
{
"collection_id": "col_xyz789",
"collection_name": "technical-docs",
"created_at": "2026-04-01T10:00:00Z"
}
Roghnaigh an t-ainm seo go cúramach: beidh sé le feiceáil i do gach liosta, agus, sé mhí ina dhiaidh sin, is é an t-aon leid a bheidh agat chun dhá bhonn atá in aice le chéile a idirdhealú. Comhlíonann technical-docs an ról seo; ní dhéanfaidh test2. Glac le coinbhinsiún ón gcéad bhailiúchán, toisc go gcostaíonn bonn a athainmniú atá tagartha cheana féin ag trí fheidhmchlár níos mó ná é a ainmniú go maith ón tús.
Na cúig oibríocht atá ar fáil
Nochtann an Management API sraith CRUD iomlán ar bhailiúcháin:
| Oibríocht | Modh | Críochphointe |
|---|---|---|
| Cruthaigh | POST | /v1/collections |
| Liostaigh | GET | /v1/collections |
| Sonraí | GET | /v1/collections/{collection_id} |
| Nuashonraigh | PUT | /v1/collections/{collection_id} |
| Scrios | DELETE | /v1/collections/{collection_id} |
Tarlaíonn liostú do bhailiúchán gan paraiméadair agus tugann sé forbhreathnú úsáideach sula ndéantar aon oibríocht cothabhála:
curl https://management-api.x.ai/v1/collections \
-H "Authorization: Bearer $XAI_MANAGEMENT_API_KEY"
Leanann an scriosadh an loighic chéanna, ag ainmniú an aitheantóra a fuarthas ag an am cruthaithe:
curl -X DELETE https://management-api.x.ai/v1/collections/col_xyz789 \
-H "Authorization: Bearer $XAI_MANAGEMENT_API_KEY"
Ba chóir rud amháin tú a shuaimhniú nuair a ritheann tú an t-ordú seo: nuair a scriostar bailiúchán, baintear an t-innéacsú, ní na comhaid. Fanann do dhoiciméid inrochtana tríd an Files API agus is féidir iad a ath-innéacsú in áit eile. Cailleann tú an struchtúr cuardaigh, ní an t-amhábhar—rud a fhágann go bhfuil aththógáil bunna atá mí-eagraithe i bhfad níos lú riosca ná mar a shamhlaítear.
Príomhphointí
- Grúpáilíonn bailiúcháin do chuid comhad i mbunair eolais innéacsaithe le haghaidh RAG
- Déantar an bhainistíocht tríd an Management API (
management-api.x.ai), ní tríd an gcaighdeán-API - Teastaíonn Management API Key leis an gcead
AddFileToCollection - Is iad na teorainneacha ná 100,000 comhad agus 100 GB in aghaidh an chuntais
- Clúdaíonn na cúig oibríocht CRUD cruthú, léamh, nuashonrú agus scriosadh