Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Cruthaigh agus bainistigh bailiúcháin

Ceacht 5 as 16 Nuashonraithe 29 Iúil 2026 Forbróir
Ar an leathanach seo
  1. Ó chomhaid ar leithligh go dtí bonn eolais
  2. API ar leith, agus cén fáth
  3. Do chéad bhailiúchán a chruthú
  4. Na cúig oibríocht atá ar fáil
  5. Príomhphointí

Ó 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.

100k
Comhaid in aghaidh an chuntais
100 GB
Toilleadh iomlán
CRUD
Oibríochtaí iomlána
$2.50
In aghaidh gach 1,000 cuardach

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íochtModhCríochphointe
CruthaighPOST/v1/collections
LiostaighGET/v1/collections
SonraíGET/v1/collections/{collection_id}
NuashonraighPUT/v1/collections/{collection_id}
ScriosDELETE/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