Przejdź do głównej treści
Polski— Wybierz język
Menu

Wykorzystywanie cytowań w wynikach

Lekcja 3 z 14 Zaktualizowano 30 lipca 2026 Początkujący
Na tej stronie
  1. Odpowiedzi możliwe do zweryfikowania dzięki cytowaniom
  2. Cytowania globalne: kompletna lista źródeł
  3. Cytowania śródtekstowe: odniesienia w treści
  4. Ustrukturyzowany schemat adnotacji
  5. Zachowanie podczas streamingu
  6. Budowanie interfejsu ze źródłami
  7. Cytowania z kolekcji
  8. Ćwiczenia praktyczne
  9. Kluczowe wnioski

Odpowiedzi możliwe do zweryfikowania dzięki cytowaniom

Gdy użytkownik zadaje Twojej aplikacji pytanie faktograficzne, chce mieć możliwość weryfikacji podanych informacji. Cytowania w API Grok idealnie odpowiadają na tę potrzebę: każdy fakt uzyskany poprzez wyszukiwanie w sieci jest opatrzony źródłem. Pozwala to budować interfejsy, w których każde twierdzenie jest klikalne i możliwe do sprawdzenia.

Cytowania i źródła w odpowiedziach Grok

API oferuje dwa uzupełniające się mechanizmy cytowania: cytowania globalne i cytowania śródtekstowe. Zrozumienie ich działania pozwala tworzyć profesjonalne i przejrzyste doświadczenia użytkownika.

Cytowania globalne: kompletna lista źródeł

Cytowania globalne są zwracane domyślnie w atrybucie citations odpowiedzi. Zawierają listę wszystkich adresów URL consulted przez model, nawet tych, które nie zostały bezpośrednio przywołane w tekście odpowiedzi.

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

Nie jest wymagana żadna dodatkowa konfiguracja. Jest to natywne zachowanie API.

Cytowania śródtekstowe: odniesienia w treści

Cytowania śródtekstowe wstawiają linki Markdown bezpośrednio do tekstu odpowiedzi, używając formatu [[N]](url), gdzie N to numer sekwencyjny zaczynający się od 1. Jeśli to samo źródło jest cytowane wielokrotnie, oryginalny numer jest ponownie wykorzystywany.

Domyślne zachowanie zależy od używanego SDK:

  • Bezpośrednie API Responses: cytowania śródtekstowe włączone domyślnie
  • xAI SDK: cytowania śródtekstowe wyłączone domyślnie (opcjonalne włączenie)

Włączanie cytowań śródtekstowych w 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"]
)

Wyłączanie cytowań śródtekstowych w API Responses

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

Ustrukturyzowany schemat adnotacji

Każde cytowanie śródtekstowe generuje obiekt adnotacji zawierający precyzyjne metadane. Struktura ta umożliwia zaawansowane przetwarzanie programistyczne:

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

Pola start_index i end_index遵循 konwencję wycinania (slice) w Pythonie. Możesz ich użyć do wyodrębnienia dokładnie cytowanego tekstu lub stworzenia niestandardowego renderowania 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}")

Zachowanie podczas streamingu

Podczas korzystania ze streamingu, cytowania śródtekstowe pojawiają się stopniowo w fragmentach tekstu. Jednak kompletne adnotacje są dostępne wyłącznie w ostatecznej odpowiedzi. Zaplanuj przetwarzanie dwuetapowe, jeśli Twój interfejs wyświetla źródła w czasie rzeczywistym.

Budowanie interfejsu ze źródłami

Oto przykład przekształcania cytowań w ustrukturyzowany 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

Cytowania z kolekcji

Jeśli używasz narzędzia collections_search obok web_search, cytowania pochodzące z przesłanych przez Ciebie dokumentów używają specyficznego formatu URI: collections://collection_id/files/file_id. Rozróżniaj je od standardowych cytowań sieciowych, aby dostosować renderowanie front-endu.

Ćwiczenia praktyczne

Stwórz aplikację wyświetlającą wyniki wyszukiwania Grok z systemem przypisów dolnych. Każdy fakt powinien linkować z powrotem do swojego oryginalnego źródła. Przetestuj aplikację, zadając pytania dotyczące bieżących wydarzeń, i ręcznie zweryfikuj, czy linki są ważne i istotne.

Kluczowe wnioski

  • Cytowania globalne (lista URL) są zwracane domyślnie, bez konieczności konfiguracji
  • Cytowania śródtekstowe (linki w tekście) są włączane poprzez parametr include
  • Domyślne zachowanie cytowań śródtekstowych różni się w zależności od SDK
  • Każda adnotacja zawiera adres URL, indeksy pozycji oraz numer cytowania
  • W streamingu kompletne adnotacje są dostępne wyłącznie w ostatecznej odpowiedzi
  • Cytowania z kolekcji używają odrębnego formatu URI (collections://)