Luathanna Uathoibríocha agus Dea-Chleachtais
Ar an leathanach seo
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éimse | Cur síos |
|---|---|
type | I gcónaí url_citation |
url | URL na foinse |
title | Teideal leathanaigh na foinse |
start_index | Suíomh tosaigh sa téacs |
end_index | Suí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.idle haghaidh inrianaitheachtausage.total_tokensle haghaidh tomhaltaisusage.cost_in_nano_usdle 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_searchnó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.