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

Cuir doiciméid le bailiúchán

Ceacht 6 as 16 Nuashonraithe 2 Samhain 2026 Forbróir
Ar an leathanach seo
  1. Cén fáth a dtarlaíonn an cur leis i dhá chéim
  2. Céim 1: Uaslódáil an chomhaid
  3. Céim 2: Ceangail leis an mbailiúchán
  4. Fan go mbeidh an t-innéacsú críochnaithe
  5. Bain doiciméad gan é a chailleadh
  6. Líon bailiúchán i mórbhaisce
  7. Dhá eochair, dhá scóip
  8. Príomhphointí

Nuashonraithe an 2 Samhain, 2026. Léiríonn an ceacht seo xai-sdk 1.21.0 agus doiciméadú xAI: éilíonn glaonna await an AsyncClient neamhshioncrónach, déanann stádas innéacsaithe comparáid leis an tairiseach collections_pb2.DOCUMENT_STATUS_PROCESSED (seachas teaghrán), agus úsáideann ionghabháil mhórbhaisce upload_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_PROCESSED sula 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