Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Automaatsed viited ja allikad

Õppetund 6 / 16 Värskendatud 30. juuli 2026 Arendajatele
Sellel lehel
  1. Teabe jälgitavus
  2. Kuidas viited toimivad
  3. Viidete kasutamine oma rakenduses
  4. Viidete kasutusjuhtumid
  5. Viidete ja domeenifiltri kombineerimine
  6. Piirangud, mida tasub teada
  7. Peamised punktid

Teabe jälgitavus

Üks veebiotsingu peamisi eeliseid lihtsa teksti genereerimise ees on jälgitavus. Kui mudel kasutab teavet veebiotsingust, tagastab API automaatselt viited koos URL-idega allikatele, mida ta konsulteeris. See võimaldab sul teavet kontrollida ja esitada seda oma rakenduses koos viidetega.

Kuidas viited toimivad

API genereerib viited automaatselt, ilma et sa peaksid midagi seadistama. Kui veebiotsing on lubatud ja mudel kasutab oma vastuses otsingutulemusi, lisatakse allikad vastuse objekti.

Pääsed viidetele juurde välja citations kaudu vastuses. Iga viide sisaldab allika URL-i ja konteksti, milles seda kasutati.

Viidete kasutamine oma rakenduses

Allikate kuvamine

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="What are the latest advancements in quantum computing?",
    tools=[{"type": "web_search"}]
)

# Display the response
print(response.output_text)

# Display the citations
if hasattr(response, 'citations') and response.citations:
    print("\nSources:")
    for citation in response.citations:
        print(f"  - {citation.url}")

Allikate integreerimine kasutajaliidesesse

Veebirakenduses saad muuta viited klõpsatavateks linkideks. See suurendab sinu rakenduse usaldusväärsust ja võimaldab lõppkasutajal teavet kontrollida.

def format_response_with_sources(response):
    output = response.output_text

    if hasattr(response, 'citations') and response.citations:
        output += "\n\n---\n**Sources:**\n"
        for i, citation in enumerate(response.citations, 1):
            output += f"{i}. [{citation.url}]({citation.url})\n"

    return output

Viidete kasutusjuhtumid

Ettevõtete vestlusrobotid

Klientidele loodud tehisintellekti assistendi puhul lisavad viited läbipaistvust. Kasutaja saab kontrollida, et teave pärineb usaldusväärsest allikast, mis suurendab usaldust vastuste vastu.

Jälgimisrakendused

Automatiseeritud jälgimistööriistas on viited hädavajalikud teabe päritolu jälitamiseks. Need võimaldavad seostada iga tähelepaneku selle allikaga ja hõlbustavad põhjalikku analüüsi.

Aruannete genereerimine

Kui kasutad API-t automatiseeritud aruannete koostamiseks, toimivad viited bibliograafiana. Need dokumenteerivad kasutatud allikad ja lisavad aruandele rangust.

Viidete ja domeenifiltri kombineerimine

Kombineerides allowed_domains viidetega, saad kontrollitud ja jälgitava otsingusüsteemi:

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Current state of AI regulation in Europe",
    tools=[{
        "type": "web_search",
        "allowed_domains": [
            "ec.europa.eu",
            "eur-lex.europa.eu",
            "legifrance.gouv.fr"
        ]
    }]
)

Viited kinnitavad, et teave pärineb eranditult lubatud allikatest.

Piirangud, mida tasub teada

  • Viited ei pruugi alati olemas olla: kui mudel vastab ilma otsingutulemusi kasutamata, viiteid ei genereerita
  • Viidete täpne vorming võib sõltuvalt kasutatavast SDK-st varieeruda
  • Viited viitavad konsulteeritud lehekülgedele, mitte tingimata täpselt kasutatud lõikudele
  • Viidete arv sõltub allikate arvust, mida mudel tegelikult kasutas

Peamised punktid

  • Viited on automaatsed: seadistamine pole vajalik
  • Need on kättesaadavad vastuse välja citations kaudu
  • Viited toovad sinu rakendusse jälgitavuse ja usaldusväärsuse
  • Neid saab kombineerida domeenifiltriga täielikuks kontrolliks
  • Integreeri need oma liidesesse, et võimaldada allikate kontrollimist