Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Automaattiset viitteet ja lähteet

Oppitunti 6 / 16 Päivitetty 30. heinäkuuta 2026 Kehittäjä
Tällä sivulla
  1. Tietojen jäljitettävyys
  2. Miten viitteet toimivat
  3. Viitteiden käyttö sovelluksessasi
  4. Viitteiden käyttötarkoituksia
  5. Viitteiden ja toimialasuodatuksen yhdistäminen
  6. Huomioitavat rajoitukset
  7. Keskeiset asiat

Tietojen jäljitettävyys

Yksi verkkohaun suurimmista eduista pelkkään tekstin tuottamiseen verrattuna on jäljitettävyys. Kun malli hyödyntää verkkohausta saatua tietoa, API palauttaa automaattisesti viitteet käytettyjen lähteiden URL-osoitteineen. Tämä mahdollistaa tietojen varmentamisen ja niiden esittämisen lähdeviitteiden kera sovelluksessasi.

Miten viitteet toimivat

API luo viitteet automaattisesti ilman, että sinun tarvitsee tehdä mitään asetuksia. Kun verkkohaku on otettu käyttöön ja malli käyttää hakutuloksia vastauksessaan, lähteet sisällytetään vastausolioon.

Pääset käsiksi viitteisiin vastauksen citations-kentän kautta. Jokainen viite sisältää lähde-URL-osoitteen ja kontekstin, jossa sitä on käytetty.

Viitteiden käyttö sovelluksessasi

Lähteiden näyttäminen

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

Lähteiden integrointi käyttöliittymään

Verkkosovelluksessa voit muuttaa viitteet napsautettaviksi linkeiksi. Tämä vahvistaa sovelluksesi uskottavuutta ja antaa loppukäyttäjälle mahdollisuuden varmentaa tiedot.

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

Viitteiden käyttötarkoituksia

Yritysten chatbotit

Asiakkaillesi suunnatussa tekoälyavustajassa viitteet lisäävät läpinäkyvyyttä. Käyttäjä voi varmistaa, että tieto perustuu luotettavaan lähteeseen, mikä kasvattaa luottamusta annettuihin vastauksiin.

Valvontasovellukset

Automatisoidussa valvontatyökalussa viitteet ovat välttämättömiä tiedon alkuperän jäljittämiseksi. Ne mahdollistavat jokaisen oivalluksen yhdistämisen lähteeseensä ja helpottavat syvällistä analyysiä.

Raporttien generointi

Jos käytät API:a automatisoitujen raporttien luomiseen, viitteet toimivat lähdeluettelona. Ne dokumentoivat käytetyt lähteet ja lisäävät raportin tarkkuutta.

Viitteiden ja toimialasuodatuksen yhdistäminen

Yhdistämällä allowed_domains-parametrin viitteisiin saat hallitun ja jäljitettävän hakujärjestelmän:

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

Vitteet vahvistavat, että tieto on peräisin yksinomaan hyväksytyistä lähteistä.

Huomioitavat rajoitukset

  • Viitteitä ei aina ole: jos malli vastaa käyttämättä hakutuloksia, viitteitä ei luoda.
  • Viitteiden tarkka muoto voi vaihdella käytetyn SDK:n mukaan.
  • Viitteet viittaavat tarkasteltuihin sivuihin, eivät välttämättä tarkalleen käytettyihin kohtiin.
  • Viitteiden määrä riippuu siitä, kuinka monta lähdettä malli on todella käyttänyt.

Keskeiset asiat

  • Viitteet ovat automaattisia: asetuksia ei tarvita.
  • Ne ovat saatavilla vastauksen citations-kentän kautta.
  • Viitteet tuovat sovellukseesi jäljitettävyyttä ja uskottavuutta.
  • Ne yhdistyvät toimialasuodatukseen täydellistä hallintaa varten.
  • Integroi ne käyttöliittymääsi, jotta käyttäjät voivat varmentaa lähteet.