Automaattiset viitteet ja lähteet
Tällä sivulla
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.