Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Citatų naudojimas rezultatuose

Paskaita 3 iš 14 Atnaujinta 2026 m. liepos 30 d. Pradedantisiems
Šiame puslapyje
  1. Atsekami atsakymai su citatomis
  2. Bendrosios citatos: pilnas šaltinių sąrašas
  3. Įterptinės citatos: nuorodos tekste
  4. Struktūruota anotacijų schema
  5. Srautinio perdavimo elgsena
  6. Sąsajos su šaltiniais kūrimas
  7. Kolekcijų citatos
  8. Praktinė užduotis
  9. Svarbiausi punktai

Atsekami atsakymai su citatomis

Kai naudotojas tavo programėlės klausia faktinio klausimo, jis nori patikrinti gautą informaciją. Grok API citatos tiksliai atitinka šį poreikį: kiekvienas faktas, gautas per interneto paiešką, turi savo šaltinį. Tai leidžia kurti sąsajas, kuriose kiekvienas teiginys yra paspaudžiamas ir patikrinamas.

Citatos ir šaltiniai Grok atsakymuose

API siūlo du papildančius citavimo mechanizmus: bendrąsias citatas ir įterptines citatas. Supratęs, kaip jos veikia, galėsi kurti profesionalią ir skaidrią naudotojo patirtį.

Bendrosios citatos: pilnas šaltinių sąrašas

Bendrosios citatos pagal nutylėjimą grąžinamos atsakymo atribute citations. Jose pateikiamas visų URL adresų, kuriuos modelis konsultavo, sąrašas, net jei jie nėra tiesiogiai minimi atsakymo tekste.

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

Jokios papildomos konfigūracijos nereikia. Tai yra natūralus API elgesys.

Įterptinės citatos: nuorodos tekste

Įterptinės citatos į atsakymo tekstą įtraukia „Markdown“ nuorodas naudodamos formatą [[N]](url), kur N yra eilės numeris, pradedant nuo 1. Jei tas pats šaltinis cituojamas kelis kartus, naudojamas originalus numeris.

Numatytasis elgesys priklauso nuo naudojamo SDK:

  • Tiesioginis „Responses“ API: įterptinės citatos įjungtos pagal nutylėjimą
  • xAI SDK: įterptinės citatos išjungtos pagal nutylėjimą (reikia aktyvuoti)

Įterptinių citatų įjungimas naudojant 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"]
)

Įterptinių citatų išjungimas „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"]
)

Struktūruota anotacijų schema

Kiekviena įterptinė citata sugeneruoja anotacijos objektą su tiksliomis metaduomenimis. Ši struktūra leidžia atlikti pažangų programinį apdorojimą:

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

Laukai start_index ir end_index laikosi „Python“ pjaustymo (slice) konvencijos. Gali juos naudoti norėdamas išgauti tikslų cituojamą tekstą arba sukurti tinkintą HTML atvaizdavimą:

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

Srautinio perdavimo elgsena

Naudojant srautinį perdavimą, įterptinės citatos teksto fragmentuose atsiranda palaipsniui. Tačiau pilnos anotacijos prieinamos tik galutiniame atsakyme. Jei tavo sąsaja šaltinius rodo realiuoju laiku, suplanuok dviejų etapų apdorojimą.

Sąsajos su šaltiniais kūrimas

Štai pavyzdys, kaip paversti citatas struktūruotu HTML kodu:

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

Kolekcijų citatos

Jei kartu su web_search naudoji įrankį collections_search, citatos iš tavo įkeltų dokumentų naudoja specifinį URI formatą: collections://collection_id/files/file_id. Atskirk jas nuo standartinių interneto citatų, kad galėtum pritaikyti front-endo atvaizdavimą.

Praktinė užduotis

Sukurk programėlę, kuri rodo Grok paieškos rezultatus su išnašų sistema. Kiekvienas faktas turi turėti nuorodą atgal į originalų šaltinį. Išbandyk ją su klausimais apie dabartinius įvykius ir rankiniu būdu patikrink, ar nuorodos galioja ir yra aktualios.

Svarbiausi punktai

  • Bendrosios citatos (URL sąrašas) grąžinamos pagal nutylėjimą, be konfigūracijos
  • Įterptinės citatos (nuorodos tekste) įjungiamos per parametrą include
  • Numatytasis įterptinių citatų elgesys skiriasi priklausomai nuo SDK
  • Kiekvienoje anotacijoje yra URL, pozicijos indeksai ir citatos numeris
  • Srautinio perdavimo metu pilnos anotacijos prieinamos tik galutiniame atsakyme
  • Kolekcijų citatos naudoja atskirą URI formatą (collections://)