Spring til hovedindhold
Dansk— Vælg et sprog
Menu

Udnyttelse af citater i resultater

Lektion 3 af 14 Opdateret 30. juli 2026 Begynder
På denne side
  1. Sporbar svar med citater
  2. Globale citater: Den komplette kildeliste
  3. Inline-citater: Referencer i teksten
  4. Det strukturerede annotationsskema
  5. Adfærd ved streaming
  6. Byg en grænseflade med kilder
  7. Samlingscitater
  8. Praktisk øvelse
  9. Vigtige pointer

Sporbar svar med citater

Når en bruger stiller din applikation et faktaspørgsmål, ønsker vedkommende at kunne verificere informationen. Grok API’s citater imødekommer præcis dette behov: hver faktaoplysning, der hentes via websøgning, leveres med sin kilde. Dette giver dig mulighed for at bygge grænseflader, hvor hvert udsagn er klikbart og verificerbart.

Citater og kilder i Grok-svar

API’et tilbyder to komplementære citatmekanismer: globale citater og inline-citater. Når du forstår, hvordan de fungerer, kan du skabe professionelle og transparente brugeroplevelser.

Globale citater: Den komplette kildeliste

Globale citater returneres som standard i attributten citations i svaret. De indeholder en liste over alle URL’er, som modellen har konsulteret, også dem der ikke er direkte refereret til i selve svarsteksten.

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

Der kræves ingen yderligere konfiguration. Dette er API’ets native adfærd.

Inline-citater: Referencer i teksten

Inline-citater indsætter Markdown-links direkte i svarsteksten ved hjælp af formatet [[N]](url), hvor N er et løbenummer startende fra 1. Hvis samme kilde citeres flere gange, genbruges det oprindelige nummer.

Standardadfærden afhænger af det SDK, du bruger:

  • Direct Responses API: inline-citater aktiveret som standard
  • xAI SDK: inline-citater deaktiveret som standard (skal aktiveres eksplicit)

Aktiver inline-citater med 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"]
)

Deaktiver inline-citater på 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"]
)

Det strukturerede annotationsskema

Hvert inline-citat genererer et annotationsobjekt med præcise metadata. Denne struktur muliggør avanceret programmatisk behandling:

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

Felterne start_index og end_index følger Pythons slice-konvention. Du kan bruge dem til at udtrække den præcist citerede tekst eller skabe custom HTML-rendering:

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

Adfærd ved streaming

Når du bruger streaming, vises inline-citater progressivt i tekstchunks. Komplette annotationer er dog kun tilgængelige i det endelige svar. Planlæg for totrinsbehandling, hvis din grænseflade skal vise kilder i realtid.

Byg en grænseflade med kilder

Her er et eksempel på, hvordan du transformerer citater til struktureret 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

Samlingscitater

Hvis du bruger værktøjet collections_search sammen med web_search, bruger citater fra dine uploadede dokumenter et specifikt URI-format: collections://collection_id/files/file_id. Skeln mellem disse og almindelige webcitater for at tilpasse front-end-renderingen.

Praktisk øvelse

Opret en applikation, der viser Grok-søgeresultater med et fodnotesystem. Hver faktaoplysning skal linke tilbage til sin oprindelige kilde. Test med spørgsmål om aktuelle begivenheder, og verificér manuelt, at linkene er gyldige og relevante.

Vigtige pointer

  • Globale citater (URL-liste) returneres som standard uden konfiguration
  • Inline-citater (links i tekst) aktiveres via parameteren include
  • Standardadfærd for inline-citater varierer afhængigt af SDK
  • Hver annotation indeholder URL, positionsindeks og citatnummer
  • Ved streaming er komplette annotationer kun tilgængelige i det endelige svar
  • Samlingscitater bruger et særskilt URI-format (collections://)