Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Využití citací ve výsledcích

Lekce 3 z 14 Aktualizováno 30. července 2026 Začátečník
Na této stránce
  1. Vysledovatelné odpovědi s citacemi
  2. Globální citace: Kompletní seznam zdrojů
  3. Inline citace: Reference v textu
  4. Strukturované schéma anotací
  5. Chování při streamování
  6. Vytvoření rozhraní se zdroji
  7. Citace z kolekcí
  8. Praktické cvičení
  9. Klíčové poznatky

Vysledovatelné odpovědi s citacemi

Když se uživatel zeptá tvé aplikace na faktickou otázku, chce si informace ověřit. Citace v API Grok tento požadavek přesně splňují: každý fakt získaný prostřednictvím vyhledávání na webu je opatřen zdrojem. To ti umožňuje budovat rozhraní, kde je každé tvrzení klikací a ověřitelné.

Citace a zdroje v odpovědích Grok

API nabízí dva doplňkové mechanismy citací: globální citace a inline citace. Pochopení jejich fungování ti umožní vytvářet profesionální a transparentní uživatelské zážitky.

Globální citace: Kompletní seznam zdrojů

Globální citace jsou vráceny ve výchozím nastavení v atributu citations odpovědi. Obsahují seznam všech URL adres, které model konzultoval, včetně těch, které nejsou přímo uvedeny v textu odpovědi.

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

Není vyžadována žádná další konfigurace. Toto je nativní chování API.

Inline citace: Reference v textu

Inline citace vkládají odkazy Markdown přímo do textu odpovědi pomocí formátu [[N]](url), kde N je sekvenční číslo začínající od 1. Pokud je stejný zdroj citován vícekrát, původní číslo se znovu použije.

Výchozí chování závisí na použitém SDK:

  • Přímé Responses API: inline citace jsou ve výchozím nastavení povoleny
  • xAI SDK: inline citace jsou ve výchozím nastavení zakázány (nutné explicitní povolení)

Povolení inline citací pomocí 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"]
)

Zakázání inline citací v 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"]
)

Strukturované schéma anotací

Každá inline citace generuje objekt anotace s přesnými metadaty. Tato struktura umožňuje pokročilé programové zpracování:

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

Pole start_index a end_index se řídí konvencí řezů (slice) v Pythonu. Můžeš je využít k extrakci přesně citovaného textu nebo k vytvoření vlastního vykreslování HTML:

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

Chování při streamování

Při použití streamování se inline citace objevují postupně v textových blocích (chunks). Kompletní anotace jsou však k dispozici až ve finální odpovědi. Pokud tvé rozhraní zobrazuje zdroje v reálném čase, naplánuj si dvoufázové zpracování.

Vytvoření rozhraní se zdroji

Zde je příklad transformace citací na strukturované HTML:

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

Citace z kolekcí

Pokud používáš nástroj collections_search společně s web_search, citace z tvých nahraných dokumentů používají specifický formát URI: collections://collection_id/files/file_id. Rozlišuj tyto citace od standardních webových citací, abys mohl přizpůsobit vykreslování na straně klienta (front-end).

Praktické cvičení

Vytvoř aplikaci, která zobrazuje výsledky vyhledávání Grok se systémem poznámek pod čarou. Každý fakt by měl odkazovat zpět na svůj původní zdroj. Otestuj to na otázkách týkajících se aktuálního dění a ručně ověř, zda jsou odkazy platné a relevantní.

Klíčové poznatky

  • Globální citace (seznam URL) jsou vráceny ve výchozím nastavení bez nutnosti konfigurace
  • Inline citace (odkazy v textu) jsou povoleny prostřednictvím parametru include
  • Výchozí chování inline citací se liší podle použitého SDK
  • Každá anotace obsahuje URL, indexy pozic a číslo citace
  • Při streamování jsou kompletní anotace k dispozici až ve finální odpovědi
  • Citace z kolekcí používají odlišný formát URI (collections://)