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

Luach a bhaint as Athfhreagraí i dTorthaí

Ceacht 3 as 14 Nuashonraithe 30 Iúil 2026 Doicnéir
Ar an leathanach seo
  1. Freagraí Inrianaithe le hathfhreagraí
  2. Athfhreagraí Domhanda: An Liosta Iomlán Foinse
  3. Athfhreagraí Líne: Tagairtí sa Téacs
  4. An Scéima Anótála Struchtúrtha
  5. Iompar Sruthú
  6. Comhéadan a Thógáil le Foinsí
  7. Athfhreagraí Bailiúcháin
  8. Cleachtas Praicticiúil
  9. Príomhphointí

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.

Athfhreagraí agus foinsí i bhfreagraí Grok

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://)