Luach a bhaint as Athfhreagraí i dTorthaí
Ar an leathanach seo
Freagraí Inrianaithe le hathfhreagraí
Nuair a chuireann úsáideoir ceist fhíriciúil ar d’fheidhmchlár, ba mhaith leis an eolas a fhíorú. Freagraíonn athfhreagraí an API Grok don riachtanas seo go díreach: tagann foinse le gach fíric a fhaightear trí chuardach gréasáin. Ligeann sé seo duit comhéadain a thógáil ina bhfuil gach maíomh inchliceáilte agus infhíoraithe.

Tairgeann an API dhá mheicníocht athfhreagraí atá comhlántach: athfhreagraí domhanda agus athfhreagraí líne. Trí thuiscint a bheith agat ar an gcaoi a n-oibríonn siad, is féidir leat taithí úsáideora ghairmiúil thrédhearcach a chruthú.
Athfhreagraí Domhanda: An Liosta Iomlán Foinse
Seoltar athfhreagraí domhanda de réir réamhshocraithe san attribúid citations den fhreagra. Tá liosta de gach URL a d’úsáid an tsamhail iontu, fiú iad siúd nach ndéantar tagairt dhíreach dóibh i dtéacs na freagra.
response = client.responses.create(
model="grok-4.5",
input="What are the latest AI regulations in Europe?",
tools=[{"type": "web_search"}]
)
# Access global citations
for citation in response.citations:
print(f"Source: {citation.url}")
Níl aon chumraíocht bhreise ag teastáil. Is é seo iompar dúchasach an API.
Athfhreagraí Líne: Tagairtí sa Téacs
Cuirtear naisc Markdown isteach go díreach i dtéacs na freagra le hathfhreagraí líne, ag baint úsáide as an bhformáid [[N]](url) áit a bhfuil N ina uimhir sheicheamhach ag tosú ag 1. Má dhéantar tagairt don fhoinse chéanna níos mó ná uair amháin, athúsáidtear an uimhir bhunaidh.
Braitheann an t-iompar réamhshocraithe ar an SDK a úsáidtear:
- API Freagraí Díreacha: athfhreagraí líne cumasaithe de réir réamhshocraithe
- xAI SDK: athfhreagraí líne díchumasaithe de réir réamhshocraithe (rogha isteach)
Athfhreagraí Líne a Chumasú leis an xAI SDK
response = client.responses.create(
model="grok-4.5",
input="Current status of the European AI Act",
tools=[{"type": "web_search"}],
include=["inline_citations"]
)
Athfhreagraí Líne a Dhíchumasú ar an API Freagraí
response = client.responses.create(
model="grok-4.5",
input="Current status of the European AI Act",
tools=[{"type": "web_search"}],
include=["no_inline_citations"]
)
An Scéima Anótála Struchtúrtha
Gineann gach athfhreagra líne oibiacht anótála le meiteashonraí cruinne. Cuireann an struchtúr seo ar chumas próiseála cláir chasta:
{
"type": "url_citation",
"url": "https://eur-lex.europa.eu/eli/reg/2024/1689",
"start_index": 145,
"end_index": 178,
"title": "1"
}
Leanann na réimsí start_index agus end_index coinbhinsiún slice Python. Is féidir leat iad a úsáid chun an téacs luaite beacht a eastósctha nó chun renderáil HTML saincheaptha a chruthú:
text = response.output_text
for annotation in response.annotations:
cited_text = text[annotation.start_index:annotation.end_index]
print(f"Cited text: {cited_text}")
print(f"Source: {annotation.url}")
Iompar Sruthú
Agus sruthú á úsáid agat, feictear athfhreagraí líne de réir a chéile i smután téacs. Mar sin féin, níl anótálacha iomlána ar fáil ach sa fhreagra dheireanach. Pleanáil próiseáil dhá chéim má thaispeánann do chomhéadan foinsí i bhfíor-am.
Comhéadan a Thógáil le Foinsí
Seo sampla de conas athfhreagraí a thiontú go HTML struchtúrtha:
def format_response_with_sources(response):
text = response.output_text
sources = []
# Collect unique sources
seen_urls = set()
for citation in response.citations:
if citation.url not in seen_urls:
sources.append(citation.url)
seen_urls.add(citation.url)
# Build the render
html = f"<div class='response'>{text}</div>"
html += "<div class='sources'><h4>Sources</h4><ul>"
for i, url in enumerate(sources, 1):
html += f"<li><a href='{url}'>[{i}] {url}</a></li>"
html += "</ul></div>"
return html
Athfhreagraí Bailiúcháin
Má úsáideann tú an uirlis collections_search in éineacht le web_search, úsáideann athfhreagraí ó do dhoiciméid uaslódáilte formáid URI shainiúil: collections://collection_id/files/file_id. Déan idirdhealú idir iad seo agus athfhreagraí gréasáin chaighdeánacha chun an renderáil front-end a oiriúnú.
Cleachtas Praicticiúil
Cruthaigh feidhmchlár a thaispeánann torthaí cuardaigh Grok le córas fonótaí. Ba chóir nasc a bheith ag gach fíric ar ais go dtí a fhoinse bhunaidh. Déan tástáil le ceisteanna faoi imeachtaí reatha agus fíoraigh de láimh go bhfuil na naisc bailí agus ábhartha.
Príomhphointí
- Seoltar athfhreagraí domhanda (liosta URL) de réir réamhshocraithe, gan cumraíocht
- Cuirtear athfhreagraí líne (naisc sa téacs) ar chumas tríd an bparaiméadar
include - Athraíonn an t-iompar réamhshocraithe d’athfhreagraí líne de réir an SDK
- Tá an URL, innéacsanna suímh, agus uimhir an athfhreagra i ngach anótáil
- I sruthú, níl anótálacha iomlána ar fáil ach sa fhreagra dheireanach
- Úsáideann athfhreagraí bailiúcháin formáid URI ar leith (
collections://)