Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Hivatkozások kihasználása a találatokban

3. lecke 14 közül Frissítve 2026. július 30. Kezdő
Ezen az oldalon
  1. Nyomon követhető válaszok hivatkozásokkal
  2. Globális hivatkozások: A teljes forráslista
  3. Szövegközi hivatkozások: Hivatkozások a szövegben
  4. A strukturált annotációs séma
  5. Streamelési viselkedés
  6. Forrásokkal rendelkező felület építése
  7. Gyűjtemény-hivatkozások
  8. Gyakorlati feladat
  9. Főbb megállapítások

Nyomon követhető válaszok hivatkozásokkal

Amikor a felhasználó ténykérdést tesz fel az alkalmazásodnak, ellenőrizni szeretné az információt. A Grok API hivatkozásai pontosan ezt a szükségletet elégítik ki: minden webes kereséssel retrieved tényhez tartozik egy forrás. Ez lehetővé teszi, hogy olyan felületeket építs, ahol minden állítás kattintható és ellenőrizhető.

Hivatkozások és források a Grok válaszaiban

Az API két kiegészítő hivatkozási mechanizmust kínál: globális hivatkozásokat és szövegközi hivatkozásokat. Ha megérted a működésüket, professzionális és átlátható felhasználói élményt teremthetsz.

Globális hivatkozások: A teljes forráslista

A globális hivatkozások alapértelmezés szerint megjelennek a válasz citations attribútumában. Tartalmazzák az összes URL-t, amelyet a modell megvizsgált, még azokat is, amelyekre közvetlenül nem hivatkozik a válaszs szöveg.

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

Nincs szükség további konfigurációra. Ez az API natív viselkedése.

Szövegközi hivatkozások: Hivatkozások a szövegben

A szövegközi hivatkozások Markdown linkeket illesztenek közvetlenül a válaszs szövegébe, a [[N]](url) formátumot használva, ahol az N egy 1-től induló sorszám. Ha ugyanarra a forrásra többször hivatkoznak, az eredeti számot használják újra.

Az alapértelmezett viselkedés a használt SDK-tól függ:

  • Közvetlen Responses API: a szövegközi hivatkozások alapértelmezés szerint be vannak kapcsolva
  • xAI SDK: a szövegközi hivatkozások alapértelmezés szerint ki vannak kapcsolva (opt-in)

Szövegközi hivatkozások engedélyezése az xAI SDK-val

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

Szövegközi hivatkozások letiltása a Responses API-n

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

A strukturált annotációs séma

Minden szövegközi hivatkozás létrehoz egy annotációs objektumot pontos metaadatokkal. Ez a struktúra lehetővé teszi a fejlett programozott feldolgozást:

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

A start_index és end_index mezők a Python szeletelési konvencióját követik. Használhatod őket a pontosan hivatkozott szöveg kinyerésére vagy egyedi HTML megjelenítés létrehozására:

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

Streamelési viselkedés

Streamelés használatakor a szövegközi hivatkozások progresszíven jelennek meg a szövegrészletekben. Azonban a teljes annotációk csak a végső válaszban érhetők el. Tervezd meg a kétfázisú feldolgozást, ha a felületed valós időben jeleníti meg a forrásokat.

Forrásokkal rendelkező felület építése

Íme egy példa arra, hogyan alakíthatsz át hivatkozásokat strukturált HTML-lé:

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

Gyűjtemény-hivatkozások

Ha a collections_search eszközt használod a web_search mellett, a feltöltött dokumentumaidból származó hivatkozások egy specifikus URI formátumot követnek: collections://collection_id/files/file_id. Különböztesd meg ezeket a szabványos webes hivatkozásoktól, hogy megfelelően testreszabhasd a front-end megjelenítést.

Gyakorlati feladat

Készíts egy alkalmazást, amely lábjegyzetrendszerrel jeleníti meg a Grok keresési találatokat. Minden ténynek vissza kell linkelnie az eredeti forrásához. Teszteld aktuális eseményekkel kapcsolatos kérdésekkel, és manuálisan ellenőrizd, hogy a linkek érvényesek és relevánsak-e.

Főbb megállapítások

  • A globális hivatkozások (URL-lista) alapértelmezés szerint, konfiguráció nélkül érkeznek vissza
  • A szövegközi hivatkozások (linkek a szövegben) az include paraméterrel engedélyezhetők
  • A szövegközi hivatkozások alapértelmezett viselkedése SDK-nként eltérő
  • Minden annotáció tartalmazza az URL-t, a pozícióindexeket és a hivatkozás számát
  • Streamelés esetén a teljes annotációk csak a végső válaszban érhetők el
  • A gyűjtemény-hivatkozások eltérő URI formátumot használnak (collections://)