Hivatkozások kihasználása a találatokban
Ezen az oldalon
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ő.

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