Cuir doiciméid le bailiúchán
Ar an leathanach seo
Nuashonraithe an 2 Samhain, 2026. Léiríonn an ceacht seo
xai-sdk1.21.0 agus doiciméadú xAI: éilíonn glaonnaawaitanAsyncClientneamhshioncrónach, déanann stádas innéacsaithe comparáid leis an tairiseachcollections_pb2.DOCUMENT_STATUS_PROCESSED(seachas teaghrán), agus úsáideann ionghabháil mhórbhaisceupload_document, a chumascann an dá chéim i nglao amháin. Foinse: Bailiúcháin tríd an API · xai-sdk-python.
Cén fáth a dtarlaíonn an cur leis i dhá chéim
D’fhéadfá a bheith ag súil go bhféadfá PDF a thit isteach i mbailiúchán go díreach, cosúil le comhad a tharraingt isteach i bhfillteán. Ní mar sin a oibríonn API xAI: téann an doiciméad tríd an API Comhad ar dtús, a stórálann é agus a shannann file_id dó, agus ansin tríd an API Bainistíochta, a nascann an t-aitheantóir sin leis an mbailiúchán. Dhá ghlao, dhá eochair, dhá chéim.
Tá toradh díreach agus úsáideach ag an deighilt seo: níl an comhad ann ach uair amháin ar an taobh stórála, ach is féidir é a nascadh le chomh líon bailiúchán agus is gá. Is féidir leis an tuarascáil theicniúil chéanna an bonn a chur faoi bhunachar sonraí an fhoirne táirge agus faoi bhunachar an fhoirne tacaíochta gan é a uaslódáil faoi dhó, gan cuóta a úsáid faoi dhó, agus gan riosca difríochta idir dhá chóip.
Céim 1: Uaslódáil an chomhaid
Níl aon rud nua anseo, seo an t-ionad a bhfuil máistreacht déanta agat air ón gcéad cheacht:
curl -X POST https://api.x.ai/v1/files \
-H "Authorization: Bearer $XAI_API_KEY" \
-F "[email protected]" \
-F "purpose=assistants"
Faigh an file_id ón bhfreagra: is é seo an eochair don chéad chéim eile.
Céim 2: Ceangail leis an mbailiúchán
Tagann an cur leis i bhfoirm POST chuig URL a chumascann an dá aitheantóir, ID an bhailiúcháin agus ID an chomhaid, agus ní éilíonn sé aon chorp iarratais:
curl -X POST https://management-api.x.ai/v1/collections/col_xyz789/documents/file_abc123 \
-H "Authorization: Bearer $XAI_MANAGEMENT_API_KEY"
Nuair a ghlactar leis an nglao seo, tosaíonn xAI ag innéacsú an ábhair. Ansin téann an doiciméad trí roinnt stádas próiseála sula mbeidh sé ar fáil go hiomlán le haghaidh cuardaigh.
Fan go mbeidh an t-innéacsú críochnaithe
Is coitianta an botún seo sa chéad phíblíne: filleann an t-iarratas cur leis rathúil, leanann tú leis cuardach láithreach, agus freagraíonn an bailiúchán nach bhfuil aon rud le fáil aige. Tá an doiciméad ann, ach níl sé innéacsaithe fós. Is é DOCUMENT_STATUS_PROCESSED an stádas le fanacht air, agus ligeann an SDK duit é a pholadh i gceart:
import asyncio
import os
from xai_sdk import AsyncClient
from xai_sdk.proto import collections_pb2
client = AsyncClient(
api_key=os.getenv("XAI_API_KEY"),
management_api_key=os.getenv("XAI_MANAGEMENT_API_KEY"),
)
async def wait_for_indexing(file_id, collection_id):
doc = await client.collections.get_document(file_id, collection_id)
while doc.status != collections_pb2.DOCUMENT_STATUS_PROCESSED:
if doc.status == collections_pb2.DOCUMENT_STATUS_FAILED:
raise RuntimeError(f"Indexing failed: {doc.error_message}")
await asyncio.sleep(3)
doc = await client.collections.get_document(file_id, collection_id)
print("Document indexed and ready for search")
asyncio.run(wait_for_indexing("file_abc123", "col_xyz789"))
Braitheann an mhoill go díreach ar an méid: innéacsítear PDF de chúpla leathanach i gceann cúpla soicind, ach d’fhéadfadh doiciméad 100 MB roinnt nóiméad a thógáil. Chun ionghabháil thar oíche, tá an lúb seo le sos trí shoicind leordhóthanach; i gcomhéadan ina n-uaslódálann úsáideoir comhad agus ina bhfanann sé, tabhair aiseolas amhairc seachas scáileán reoite.
Bain doiciméad gan é a chailleadh
Is oibríocht ar leith é comhad a dhícheangal ó bhailiúchán ná é a scriosadh:
curl -X DELETE \
https://management-api.x.ai/v1/collections/col_xyz789/documents/file_abc123 \
-H "Authorization: Bearer $XAI_MANAGEMENT_API_KEY"
Imíonn an comhad ó innéacs an bhailiúcháin seo ach fanann sé ar fáil tríd an API Comhad, agus is féidir é a nascáil in áit eile. Is é seo díreach an rud ba chóir duit a dhéanamh nuair a éiríonn bileog táirge as dáta don tacaíocht agus luach cartlainne á choinneáil aici: baintear as an mbunachar sonraí oibríochtúil é gan an doiciméad a scriosadh.
Líon bailiúchán i mórbhaisce
Agus tú ag tosú bunachar sonraí ó fhillteán iomlán, scríobh an lúb uair amháin; freastalóidh sé go maith ort ar feadh i bhfad:
import asyncio
import os
from pathlib import Path
from xai_sdk import AsyncClient
client = AsyncClient(
api_key=os.getenv("XAI_API_KEY"),
management_api_key=os.getenv("XAI_MANAGEMENT_API_KEY"),
)
files = [
"docs/guide-installation.pdf",
"docs/reference-api.pdf",
"docs/faq.md",
"docs/changelog.txt",
]
async def populate(collection_id):
for file_path in map(Path, files):
# Céimeanna 1 agus 2 i nglao amháin: uaslódáil tríd an API Comhad, ansin ceangail
await client.collections.upload_document(
collection_id=collection_id,
name=file_path.name,
data=file_path.read_bytes(),
)
print(f"Added: {file_path}")
asyncio.run(populate("col_xyz789"))
Tabhair faoi deara an meascán formáidí sa liosta—comhchónaíonn PDF, Markdown, agus gnáth-théacs gan fhadhb sa bhailiúchán céanna, rud a shábhálann duit caighdeánú a dhéanamh ar do fhoinsí roimh ionghabháil.
Dhá eochair, dhá scóip
Úsáideann an próiseas seo dhá aitheantóir rochtana nach chóir duit a mheascadh: an gnáth-eochair API (XAI_API_KEY) don uaslódáil i gcéim 1, agus an eochair Bainistíochta (XAI_MANAGEMENT_API_KEY) don cheangal i gcéim 2. Faigheann an SDK an dá cheann ag cruthú an chliaint, agus úsáideann upload_document iad ceann i ndiaidh a chéile. Deimhnigh go bhfuil an cead AddFileToCollection ag an gceann deireanach: gan é, éireoidh le d’uaslódáil, teipfidh ar do chur leis le hearráid 403, agus carnfaidh tú comhaid atá stóráilte i gceart ach as láthair ó aon bhailiúchán.
Príomhphointí
- Tarlaíonn an cur le bailiúchán i dhá chéim: uaslódáil ansin cur leis
- Is féidir le comhad bheith i roinnt bailiúchán ag an am céanna
- Caithfidh an doiciméad teacht ar an stádas
DOCUMENT_STATUS_PROCESSEDsula bhféadfar cuardach a dhéanamh air - Ní scriosann baint doiciméid as bailiúchán an bun-chomhad
- Teastaíonn dhá eochair API ar leith: gnáth-eochair don uaslódáil, Bainistíocht don bhailiúchán