Hoppa till huvudinnehåll
Svenska— Välj ett språk
Meny

Utnyttja citeringar i svar

Lektion 3 av 14 Uppdaterad 30 juli 2026 Nybörjare
På denna sida
  1. Spårbara svar med citeringar
  2. Globala citeringar: Den kompletta källförteckningen
  3. Inline-citeringar: Referenser i texten
  4. Det strukturerade annotationsschemat
  5. Beteende vid strömning
  6. Bygga ett gränssnitt med källor
  7. Samlingsciteringar
  8. Praktisk övning
  9. Viktiga punkter

Spårbara svar med citeringar

När en användare ställer en faktabaserad fråga till din applikation vill hen kunna verifiera informationen. Grok API:s citeringar möter exakt detta behov: varje faktauppgift som hämtas via webbsökning levereras tillsammans med sin källa. Detta låter dig bygga gränssnitt där varje påstående är klickbart och verifierbart.

Citeringar och källor i Grok-svar

API:et erbjuder två komplementära citeringsmekanismer: globala citeringar och inline-citeringar. Att förstå hur de fungerar låter dig skapa professionella och transparenta användarupplevelser.

Globala citeringar: Den kompletta källförteckningen

Globala citeringar returneras som standard i attributet citations i svaret. De innehåller en lista över alla URL:er som modellen har konsulterat, även de som inte refereras till direkt i svarstexten.

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

Ingen ytterligare konfiguration krävs. Detta är API:ets naturliga beteende.

Inline-citeringar: Referenser i texten

Inline-citeringar infogar Markdown-länkar direkt i svarstexten, med formatet [[N]](url) där N är ett löpande nummer som börjar på 1. Om samma källa citeras flera gånger återanvänds det ursprungliga numret.

Standardbeteendet beror på vilken SDK du använder:

  • Direct Responses API: inline-citeringar aktiverade som standard
  • xAI SDK: inline-citeringar inaktiverade som standard (måste aktiveras manuellt)

Aktivera inline-citeringar 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"]
)

Inaktivera inline-citeringar 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 strukturerade annotationsschemat

Varje inline-citering genererar ett annotationsobjekt med exakt metadata. Denna struktur möjliggör avancerad programmatisk bearbetning:

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

Fälten start_index och end_index följer Pythons slice-konvention. Du kan använda dem för att extrahera den exakta citerade texten eller skapa anpassad 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}")

Beteende vid strömning

När du använder strömning visas inline-citeringar progressivt i textblocken. Fullständiga annotationer finns dock endast tillgängliga i det slutgiltiga svaret. Planera för tvåstegsbearbetning om ditt gränssnitt visar källor i realtid.

Bygga ett gränssnitt med källor

Här är ett exempel på hur du omvandlar citeringar till strukturerad 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

Samlingsciteringar

Om du använder verktyget collections_search tillsammans med web_search använder citeringar från dina uppladdade dokument ett specifikt URI-format: collections://collection_id/files/file_id. Skilj dessa från vanliga webbciteringar för att anpassa renderingen i front-end.

Praktisk övning

Skapa en applikation som visar Grok-sökresultat med ett fotnotssystem. Varje faktauppgift ska länka tillbaka till sin ursprungliga källa. Testa med frågor om aktuella händelser och verifiera manuellt att länkarna är giltiga och relevanta.

Viktiga punkter

  • Globala citeringar (URL-lista) returneras som standard, utan konfiguration
  • Inline-citeringar (länkar i text) aktiveras via parametern include
  • Standardbeteendet för inline-citeringar varierar beroende på SDK
  • Varje annotation innehåller URL, positionsindex och citeringsnummer
  • Vid strömning finns fullständiga annotationer endast tillgängliga i det slutgiltiga svaret
  • Samlingsciteringar använder ett distinkt URI-format (collections://)