Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Izkoriščanje navajanj v rezultatih

Lekcija 3 od 14 Posodobljeno 30. julij 2026 Začetnik
Na tej strani
  1. Sledljivi odgovori z navajanji
  2. Globalna navajanja: Celoten seznam virov
  3. Vstavljena navajanja: Sklici v besedilu
  4. Shema strukturirane anotacije
  5. Vedenje pri pretakanju
  6. Gradnja vmesnika z viri
  7. Navajanja zbirk
  8. Praktična vaja
  9. Ključne ugotovitve

Sledljivi odgovori z navajanji

Ko uporabnik tvoji aplikaciji zastavi dejansko vprašanje, želi preveriti informacije. Navajanja API-ja Grok to potrebo natančno zadovoljijo: vsako dejstvo, pridobljeno prek spletnega iskanja, ima svoj vir. To ti omogoča gradnjo vmesnikov, kjer je vsaka trditev klikabilna in preverljiva.

Navajanja in viri v odgovorih Grok

API ponuja dva dopolnjujoča mehanizma za navajanje: globalna navajanja in vstavljena navajanja. Razumevanje njihovega delovanja ti omogoča ustvarjanje profesionalnih in preglednih uporabniških izkušenj.

Globalna navajanja: Celoten seznam virov

Globalna navajanja so privzeto vrnjena v atributu citations odgovora. Vsebujejo seznam vseh URL-jev, ki jih je model uporabil, tudi tistih, na katere se besedilo odgovora ne sklicuje neposredno.

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

Dodatna konfiguracija ni potrebna. To je osnovno vedenje API-ja.

Vstavljena navajanja: Sklici v besedilu

Vstavljena navajanja vstavijo povezave Markdown neposredno v besedilo odgovora z uporabo zapisa [[N]](url), kjer je N zaporedna številka, ki se začne z 1. Če se na isti vir sklicujemo večkrat, se ponovno uporabi prvotna številka.

Privzeto vedenje je odvisno od uporabljenega SDK:

  • Neposredni API za odgovore: vstavljena navajanja so privzeto omogočena
  • xAI SDK: vstavljena navajanja so privzeto onemogočena (po izbiri)

Omogoči vstavljena navajanja z 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"]
)

Onemogoči vstavljena navajanja v API-ju za odgovore

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

Shema strukturirane anotacije

Vsako vstavljeno navajanje ustvari predmet anotacije s preciznimi metapodatki. Ta struktura omogoča napredno programsko obdelavo:

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

Polji start_index in end_index sledita konvenciji rezanja v Pythonu. Uporabiš ju lahko za ekstrakcijo točno citiranega besedila ali ustvarjanje prilagojenega upodabljanja 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}")

Vedenje pri pretakanju

Pri uporabi pretakanja se vstavljena navajanja postopoma pojavljajo v delčkih besedila. Vendar so popolne anotacije na voljo šele v končnem odgovoru. Načrtuj dvostopenjsko obdelavo, če tvoj vmesnik vire prikazuje v realnem času.

Gradnja vmesnika z viri

Tukaj je primer pretvorbe navajanj v strukturirani 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

Če orodje collections_search uporabljaš skupaj z web_search, navajanja iz tvojih naloženih dokumentov uporabljajo določeno obliko URI: collections://collection_id/files/file_id. Razlikuj jih od standardnih spletnih navajanj, da prilagodiš upodabljanje v ospredju.

Praktična vaja

Ustvari aplikacijo, ki prikazuje rezultate iskanja Grok s sistemom opomb. Vsako dejstvo naj bo povezano nazaj na svoj izvirni vir. Preizkusi z vprašanji o trenutnih dogodkih in ročno preveri, ali so povezave veljavne in ustrezne.

Ključne ugotovitve

  • Globalna navajanja (seznam URL-jev) so vrnjena privzeto, brez konfiguracije
  • Vstavljena navajanja (povezave v besedilu) so omogočena prek parametra include
  • Privzeto vedenje vstavljenih navajanj se razlikuje glede na SDK
  • Vsaka anotacija vsebuje URL, indeksa položaja in številko navajanja
  • Pri pretakanju so popolne anotacije na voljo šele v končnem odgovoru
  • Navajanja zbirk uporabljajo drugačno obliko URI (collections://)