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

Luathanna Uathoibríocha agus Dea-Chleachtais

Ceacht 16 as 16 Nuashonraithe 30 Iúil 2026 Forbróir
Ar an leathanach seo
  1. Freagraí Foinseáilte agus Iontaofa
  2. Conas a Oibríonn Luathanna
  3. Taispeáin Luathanna i d’Fheidhmchlár
  4. Dea-Chleachtais Táirgeachta
  5. Seicliosta Imscartha
  6. Príomhphointí
  7. Tástáil do Chuid Eolais

Freagraí Foinseáilte agus Iontaofa

Nuair a úsáideann an tsamhail cuardach gréasáin nó cuardach X, cuimsíonn an API Freagraí luathanna go huathoibríoch sa fhreagra. Ligeann na luathanna seo do d’úsáideoirí foinseí a fhíorú agus muinín a chruthú sna freagraí ginte.

Conas a Oibríonn Luathanna

Feictear luathanna san eagar annotations de gach mír ábhair:

{
  "output": [{
    "type": "message",
    "content": [{
      "type": "output_text",
      "text": "According to the latest data, the AI market...",
      "annotations": [
        {
          "type": "url_citation",
          "url": "https://example.com/article",
          "title": "AI Market Analysis in 2026",
          "start_index": 35,
          "end_index": 68
        }
      ]
    }]
  }]
}

Réimsí Luathana

RéimseCur síos
typeI gcónaí url_citation
urlURL na foinse
titleTeideal leathanaigh na foinse
start_indexSuíomh tosaigh sa téacs
end_indexSuíomh deiridh sa téacs

Taispeáin Luathanna i d’Fheidhmchlár

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="What are the latest advancements in AI?",
    tools=[{"type": "web_search"}]
)

text = response.output[0].content[0].text
annotations = response.output[0].content[0].annotations

# Tóg téacs le fonótaí
footnotes = []
for i, ann in enumerate(annotations, 1):
    footnotes.append(f"[{i}] {ann.title} — {ann.url}")

print(text)
print("\n--- Sources ---")
for fn in footnotes:
    print(fn)

I HTML

def render_with_citations(text, annotations):
    # Sórtáil de réir suímh (deireadh go dtí tús chun seachaint innéacsanna a athrú)
    sorted_anns = sorted(annotations, key=lambda a: a.start_index, reverse=True)
    html = text
    for i, ann in enumerate(sorted_anns):
        ref_num = len(sorted_anns) - i
        link = f'<a href="{ann.url}" title="{ann.title}" target="_blank">[{ref_num}]</a>'
        html = html[:ann.end_index] + link + html[ann.end_index:]
    return html

Dea-Chleachtais Táirgeachta

1. Fíoraigh an Stádas i gCónaí

response = client.responses.create(...)
if response.status != "completed":
    handle_error(response)
    return

2. Láimhseáil Freagraí Folmha

if not response.output or not response.output[0].content:
    return "The model did not generate a response."
text = response.output[0].content[0].text

3. Logáil Méadrachtaí

Do gach iarratas táirgeachta, déan logáil ar:

  • response.id le haghaidh inrianaitheachta
  • usage.total_tokens le haghaidh tomhaltais
  • usage.cost_in_nano_usd le haghaidh costais
  • Am freagartha taobh an chliaint
  • Stádas na freagartha

4. Slánaigh do Eochair API

  • Stóráil i athróg timpeallachta é, riamh sa chód
  • Úsáid bainisteoir rúnda i dtáirgeadh (Vault, AWS Secrets Manager)
  • Rothlaigh do chuid eochracha go rialta
  • Ná nocht iad riamh ar thaobh an chliaint (brabhsálaí)

5. Bainistigh Ábhar Ginte

D’fhéadfadh ábhar neamh-iomchuí a bheith i bhfreagraí na samhla d’ainneoin scagairí. Cuir sraithe measúnaithe i bhfeidhm má thaispeánann tú freagraí go poiblí.

6. Pleanáil le haghaidh Scálaitheachta

  • Úsáid sruthú chun an t-am feithimh dealraitheach a laghdú
  • Cuir córas ciúcháin i bhfeidhm d’iarratais thromchúiseacha
  • Déan freagraí minice a chur i dtaisce
  • Déan faireachán ar do chuótaí teorannaithe ráta

Seicliosta Imscartha

  • Teorainn ama socraithe go 3600 soicind
  • Atriail le cúlú easpónantúil
  • Teorannú ráta taobh an chliaint
  • Logáil méadrachtaí (tokain, costais, moille)
  • Láimhseáil earráidí (401, 429, 500, teorainn ama)
  • Eochair API shlán
  • Measúnú ábhair más gá
  • Faireachán costais agus foláirimh
  • Briseadh ciorcaid le haghaidh athléimneachta

Príomhphointí

  • Tá luathanna uathoibríoch nuair a úsáideann an tsamhail web_search nó x_search
  • Cuimsíonn siad an URL, an teideal, agus an suíomh sa téacs
  • Fíoraigh an stádas i gcónaí agus láimhseáil freagraí folmha
  • Slánaigh do eochair API—riamh sa chód foinse ná ar thaobh an chliaint
  • Cuir logáil, atriail, teorannú ráta, agus faireachán i bhfeidhm sula dtéann tú go táirgeadh

Tástáil do Chuid Eolais

An API Freagraí go mion: an seiceáil deiridh.

1. Cad a thairgeann an API Freagraí i gcomparáid le Críochnuithe Comhrá?

Freagra: An formáid nua-aimseartha: buanú freagartha taobh an fhreastalaí (GET/DELETE, slabhrú de réir ID), uirlisí ionsuite, agus gnéithe le déanaí—an API áit a bhfuil xAI ag díriú ar éabhlóid.

2. Conas a shlabhraíonn tú comhrá?

Freagra: Tríd an bhfreagra roimhe seo a thagairt: coinnítear an comhthéacs taobh an fhreastalaí—ní gá an stair iomlán a athsheoladh gach uair.

3. Cad é réasúnaíocht chriptithe?

Freagra: Réasúnaíocht inmheánach na samhla arna filleadh i bhfoirm chriptithe: in-athúsáidte i dtimthriallta ina dhiaidh sin gan a bheith inléite—taistealaíonn an próiseas smaointeoireachta, fanann an rúndacht.

4. Cad a cheadaíonn meascadh uirlisí freastalaí agus cliant?

Freagra: Comhcheangail uirlisí ionsuite arna ngníomhú ag xAI (cuardach gréasáin, srl.) agus do fheidhmeanna saincheaptha arna ngníomhú ag do chód—gach uirlis sa áit cheart, comhordaithe san iarratas céanna.

5. Cad iad na dea-chleachtais le haghaidh táirgeachta?

Freagra: Láimhseáil teorainn ama agus atriail, rianaigh billeáil (tokain, uirlisí), agus bain úsáid as luathanna uathoibríocha le haghaidh freagraí in-fhíoraithe—neart agus muinín le chéile.

Buanú, uirlisí, réasúnaíocht chriptithe, luathanna: is é an API Freagraí an bonn nua-aimseartha—tá d’fheidhmchláir Grok tógtha anseo.