Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

L-I sfruttar taċ-Ċitazzjonijiet fir-Riżultati

Lezzjoni 3 / 14 Aġġornat 30 ta’ Lulju 2026 Bidbieni
F'din il-paġna
  1. Tweġibiet Traċċabbli b’Ċitazzjonijiet
  2. Ċitazzjonijiet Globali: Il-Lista Sħiħa tas-Sorsi
  3. Ċitazzjonijiet Inline: Referenzi fit-Test
  4. L-Iskema ta’ Annotazzjoni Strutturata
  5. Imġiba waqt l-Istreamjar (Streaming)
  6. Bini ta’ Interfaċċa bis-Sorsi
  7. Ġbir ta’ Ċitazzjonijiet (Collection Citations)
  8. Prattika Pratika
  9. Punti Ewlenin

Tweġibiet Traċċabbli b’Ċitazzjonijiet

Meta utent jistaqsi lill-applikazzjoni tiegħek mistoqsija fattwali, irid jivverifika l-informazzjoni. Iċ-ċitazzjonijiet tal-API ta’ Grok jissodisfaw eżattament din il-ħtieġa: kull fatt miksub permezz tat-tiftix fil-web jiġi bis-sors tiegħu. Dan jippermettilek tibni interfaċċi fejn kull affermazzjoni tkun tista’ tiġi kklikkjata u vverifikata.

Ċitazzjonijiet u sorsi fir-risponsi ta' Grok

L-API toffri żewġ mekkaniżmi ta’ ċitazzjoni kumplimentari: ċitazzjonijiet globali u ċitazzjonijiet inline. Li tifhem kif jaħdmu jippermettilek toħloq esperjenzi tal-utent professjonali u trasparenti.

Ċitazzjonijiet Globali: Il-Lista Sħiħa tas-Sorsi

Iċ-ċitazzjonijiet globali jiġu rritornati b’mod awtomatiku fl-attribut citations tar-rispons. Dawn fihom lista tal-URLs kollha kkonsultati mill-mudell, anke dawk mhux imsemmija direttament fit-test tar-rispons.

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}")

M’hemm bżonn l-ebda konfigurazzjoni addizzjonali. Dan huwa l-imġiba nattiva tal-API.

Ċitazzjonijiet Inline: Referenzi fit-Test

Iċ-ċitazzjonijiet inline jdaħħlu links Markdown direttament fit-test tar-rispons, bl-użu tal-format [[N]](url) fejn N huwa numru sekwenzjali li jibda minn 1. Jekk l-istess sors jiġi ċċitat diversi drabi, in-numru oriġinali jerġa’ jintuża.

L-imġiba default tiddependi mill-SDK użat:

  • Direct Responses API: ċitazzjonijiet inline attivati b’mod awtomatiku
  • xAI SDK: ċitazzjonijiet inline diżattivati b’mod awtomatiku (opt-in)

Attiva ċ-Ċitazzjonijiet Inline bl-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"]
)

Diżattiva ċ-Ċitazzjonijiet Inline fuq ir-Responses API

response = client.responses.create(
    model="grok-4.5",
    input="Current status of the European AI Act",
    tools=[{"type": "web_search"}],
    include=["no_inline_citations"]
)

L-Iskema ta’ Annotazzjoni Strutturata

Kull ċitazzjoni inline tiġġenera oġġett ta’ annotazzjoni b’metadata preċiża. Din l-istruttura tippermetti pproċessar avvanzat programmatiku:

{
  "type": "url_citation",
  "url": "https://eur-lex.europa.eu/eli/reg/2024/1689",
  "start_index": 145,
  "end_index": 178,
  "title": "1"
}

Il-kampi start_index u end_index isegwu l-konvenzjoni tas-slicing ta’ Python. Tista’ tużahom biex testraċċa eżattament it-test iċċitat jew toħloq rendering HTML personalizzat:

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}")

Imġiba waqt l-Istreamjar (Streaming)

Meta tuża l-istreamjar, iċ-ċitazzjonijiet inline jidhru progressivament fil-biċċiet (chunks) tat-test. Madankollu, l-annotazzjonijiet sħaħ huma disponibbli biss fir-rispons finali. Ippjana għal ipproċessar f’żewġ fażijiet jekk l-interfaċċa tiegħek turi s-sorsi f’ħin reali.

Bini ta’ Interfaċċa bis-Sorsi

Hawnhekk eżempju ta’ kif tikkonverti ċ-ċitazzjonijiet f’HTML strutturat:

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

Ġbir ta’ Ċitazzjonijiet (Collection Citations)

Jekk tuża l-għodda collections_search flimkien ma’ web_search, iċ-ċitazzjonijiet mid-dokumenti mħallgħa tiegħek jużaw format URI speċifiku: collections://collection_id/files/file_id. Agħmel distinzjoni bejn dawn u ċ-ċitazzjonijiet standard tal-web biex tadatta r-rendering tal-front-end.

Prattika Pratika

Oħloq applikazzjoni li turi r-riżultati tat-tiftix ta’ Grok b’sistema ta’ noti f’qiegħ il-paġna. Kull fatt għandu jkollu link lura għas-sors oriġinali tiegħu. Ittestja b’mistoqsijiet dwar l-aħbarijiet attwali u vverifika manwalment li l-links huma validi u rilevanti.

Punti Ewlenin

  • Iċ-ċitazzjonijiet globali (lista ta’ URLs) jiġu rritornati b’mod awtomatiku, mingħajr konfigurazzjoni
  • Iċ-ċitazzjonijiet inline (links fit-test) jiġu attivati permezz tal-parametru include
  • L-imġiba default taċ-ċitazzjonijiet inline tvarja skont l-SDK
  • Kull annotazzjoni fiha l-URL, l-indiċijiet tal-pożizzjoni, u n-numru taċ-ċitazzjoni
  • Fl-istreamjar, l-annotazzjonijiet sħaħ huma disponibbli biss fir-rispons finali
  • Iċ-ċitazzjonijiet tal-kollezzjonijiet jużaw format URI distint (collections://)