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

Comhoiriúnacht SDK OpenAI

Ceacht 6 as 14 Nuashonraithe 29 Iúil 2026 Forbróir
Ar an leathanach seo
  1. Ilghníomhaire a úsáid tríd an SDK OpenAI
  2. Cumraíocht an chliaint
  3. Líon na ngníomhairí a rialú le reasoning.effort
  4. An mapáil iarracht → gníomhairí
  5. Níl Comhlánuithe Comhrá (Chat Completions) tacaithe
  6. Sruthú leis an SDK OpenAI
  7. Sochair agus teorainneacha an chur chuige seo
  8. Príomhphointí

Ilghníomhaire a úsáid tríd an SDK OpenAI

Tá sraitheanna glaotha tógtha cheana féin ag go leor foirne timpeall ar an SDK OpenAI, lena gcuid fillteáin, tástálacha, agus coinbhinsiúin logála. Dea-scéal: ní gá duit gach rud a athscríobh chun rochtain a fháil ar mhód ilghníomhaire Grok. Nochtann xAI API atá comhoiriúnach le formáid Freagraí OpenAI, ionas gur féidir leat an cliant OpenAI a choinneáil agus é a dhíriú ar an API xAI go simplí.

Cumraíocht an chliaint

Níl de dhíth ort ach dhá shocrú: bun-URL xAI agus do chlé API xAI.

from openai import OpenAI

client = OpenAI(
    api_key=os.getenv("XAI_API_KEY"),
    base_url="https://api.x.ai/v1",
)

Ón bpointe sin amach, úsáideann tú an API Freagraí mar is gnách, ag sonrú grok-4.20-multi-agent-0309 mar an tsamhail. Fanann an chuid eile de do chód glaotha gan athrú.

Líon na ngníomhairí a rialú le reasoning.effort

Seo áit a dtarlaíonn an t-aistriú idir an dá shaol. Áit a nochtann an SDK xAI agent_count go sainráite, ní thairgeann an SDK OpenAI ach reasoning.effort—mar sin, ní iarrann tú líon na ngníomhairí; iarrann tú leibhéal iarrachta a thiontaíonn xAI ina líon gníomhairí.

# 4 ghníomhaire (iarracht íseal)
response = client.responses.create(
    model="grok-4.20-multi-agent-0309",
    reasoning={"effort": "low"},
    input=[{"role": "user", "content": "What are the latest open source models from 2026?"}],
)
print(response.output_text)
# 16 ghníomhaire (iarracht ard)
response = client.responses.create(
    model="grok-4.20-multi-agent-0309",
    reasoning={"effort": "high"},
    input=[{"role": "user", "content": "Compare the EU and US AI strategies in 2026"}],
)
print(response.output_text)

An mapáil iarracht → gníomhairí

Glacann an réimse le ceithre luach, ach ní chruthaíonn siad ach dhá mhéid foirne: úsáideann "low" agus "medium" 4 ghníomhaire, fad is a úsáideann "high" agus "xhigh" 16.

Tuillfidh an mionsonra seo do aire chúramach. Ní athraíonn an t-aistriú ó low go medium, nó ó high go xhigh, líon na ngníomhairí: d’fhéadfadh na leibhéil idirmheánacha seo tionchar a imirt ar ghnéithe eile d’iompar na samhla, ach laistigh de gach péire, fanann an fhoireann mar an gcéanna. Samhlaigh comhéadan ina dtairgeann tú ceithre leibhéal doimhneachta taighde don úsáideoir—bheadh dhá leibhéal le feiceáil acu, agus ní dhéanfadh do dhá chnaipe bhreise ach cur amú ar a rogha.

Níl Comhlánuithe Comhrá (Chat Completions) tacaithe

Seo an srian a chuireann bac ar an gcuid is mó de fhorbróirí ar a gcéad iarracht: Níl Comhlánuithe Comhrá (Chat Completions) tacaithe le haghaidh ilghníomhaire. Caithfidh tú an API Freagraí a úsáid, rud a chiallaíonn client.responses.create, seachas client.chat.completions.create.

# NÍ OIBRÍONN SÉ SEO
response = client.chat.completions.create(
    model="grok-4.20-multi-agent-0309",
    messages=[{"role": "user", "content": "..."}],
)

Tugann an glao seo earráid ar ais. Má bhraitheann do chód atá ann cheana go hiomlán ar Chomhlánuithe Comhrá—mar a dhéanann go leor bunús cód atá ann—ní malartú ainm samhla amháin atá i gceist leis an athrú: caithfidh tú an glao a aistriú go formáid ionchuir agus aschuir difriúil. Déan meastóireacht ar an iarracht sin sula ngeallann tú an comhtháthú.

Sruthú leis an SDK OpenAI

Tá sruthú ar fáil fós, arís tríd an API Freagraí:

stream = client.responses.create(
    model="grok-4.20-multi-agent-0309",
    reasoning={"effort": "low"},
    input=[{"role": "user", "content": "Summarize this week's tech announcements"}],
    stream=True,
)

for event in stream:
    if hasattr(event, 'delta') and event.delta:
        print(event.delta, end="", flush=True)

Fiú an tástáil hasattr(event, 'delta'), is fiú í a choinneáil mar atá sí: tá níos mó ná téacs i sruth imeachtaí an API Freagraí, agus d’ardódh léamh dall ar event.delta ar gach imeacht eisceacht.

Sochair agus teorainneacha an chur chuige seo

Is é an príomhbhuntáiste a bhaineann leis an mbealach seo ná go sábhálann sé am: ní shuiteálann tú SDK eile, faigheann do fhorbróirí comhréir ghábhálach, agus éiríonn sé suarach aistriú idir samhlacha xAI agus OpenAI sa bhunús cód céanna. Do fhoireann ar mian léi an mód ilghníomhaire a mheas gan tiomnú do thionscadal iomlán, is é seo an bealach is giorra.

Eascraíonn na teorainneacha go léir ón gcúis chéanna: tá tú ag dul trí shraithe comhoiriúnachta, mar sin cailleann tú na gnéithe atá sainiúil do xAI. Ní fhaigheann tú agent_count (curtha in ionad ag rialú indíreach trí reasoning.effort), verbose_streaming, ná use_encrypted_content. Ina theannta sin, tagann an mapáil iarracht → gníomhairí ó API béite agus d’fhéadfadh sé athrú: má bhraitheann do tháirge go sonrach ar líon na ngníomhairí a úsáidtear, is é an SDK dúchasach an rogha chiallmhar.

Príomhphointí

  • Oibríonn an SDK OpenAI le ilghníomhaire trí base_url="https://api.x.ai/v1"
  • Rialaíonn tú líon na ngníomhairí trí reasoning.effort (low/medium = 4, high/xhigh = 16)
  • Níl Comhlánuithe Comhrá (Chat Completions) TACAITHE—ná húsáid ach an API Freagraí
  • Níl roinnt paraiméadar atá eisiach don SDK xAI (agent_count, verbose_streaming) ar fáil