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

Rajat, kustannukset ja parhaat käytännöt

Oppitunti 14 / 14 Päivitetty 30. heinäkuuta 2026 Aloittelija
Tällä sivulla
  1. Käytä hakua vastuullisesti
  2. Kustannusrakenne
  3. Tekniset rajoitukset
  4. Kehityksen parhaat käytännöt
  5. Turvallisuus ja yksityisyys
  6. Ennen tuotantoon siirtymistä - tarkistuslista
  7. Käytännön harjoitus
  8. Keskeiset asiat
  9. Testaa tietämyksesi

Käytä hakua vastuullisesti

Grok API:n hakutoimintojen hallitseminen ei riitä. Sinun on myös ymmärrettävä tekniset rajat, ennakoitava tuotantokustannukset ja sovellettava parhaita käytäntöjä luodaksesi luotettavia ja kustannustehokkaita sovelluksia.

Kustannusrakenne

Haun laskutus perustuu kahteen erilliseen osaan:

Kustannus työkalukutsua kohden

Jokainen web_search- tai x_search-kutsu maksaa 5 dollaria 1 000 kutsua kohden, eli 0,005 dollaria kutsulta. Tämä kustannus on kiinteä riippumatta palautettujen tulosten määrästä tai haun monimutkaisuudesta.

Token-kustannukset

Kutsukustannusten lisäksi syöte- ja tulostetokenit laskutetaan normaalisti. Hakutulokset, jotka injektoidaan mallin kontekstiin, lisäävät syötetokenien kulutusta. Yksityiskohtaiset vastaukset lähdeviitteineen lisäävät tulostetokenien määrää.

Budjetin arviointi

Päivittäiselle seurantasovellukselle, joka跟踪oi 5 aihetta:

Hakuja päivässä:
  5 aihetta x 2 työkalua (web + X) = 10 kutsua
  10 x 0,005 $ = 0,05 $/pv

Tokenia hakua kohden (arvio):
  ~2 000 syötetokenia + ~1 000 tulostetokenia = ~3 000 tokenia
  10 hakua x 3 000 tokenia ≈ 30 000 tokenia/pv

Kuukausibudjetti:
  Kutsut: 0,05 $ x 30 = 1,50 $
  Tokenit: vaihtelevat käytetyn mallin mukaan
  Arvioitu yhteensä: 5–15 $/kk laajuudesta riippuen

Tekniset rajoitukset

Tulosten ajantasaisuus

Web-haku palauttaa tuoreita tuloksia, mutta sisällön julkaisun ja xAI:n hakukoneen indeksoinnin välillä voi olla viivettä. Käynnissä olevien tapahtumien osalta X on yleensä reagoivampi kuin web.

Kielikattavuus

Tulokset ovat englanninkielisissä hauissa parempia kuin ranskankielisissä tai muilla kielillä tehdyissä hauissa. Ranskankielisissä hauissa muotoile kehote ranskaksi, mutta tiedosta, että englanninkieliset lähteet ovat usein yliedustettuina.

Haun syvyys

Malli ei indeksoi koko webbiä. Se kysyy hakukoneelta ja analysoi parhaat tulokset. Kapeille aihealueille tulokset voivat olla rajallisia.

Lähdeviitteiden luotettavuus

Lähdeviitteet ovat automaattisia, mutta eivät erehtymättömiä. URL-osoituksen sisältö voi muuttua hakuhetken ja käyttäjän tarkistuksen välillä. Tarkista linkit aina ennen niiden liittämistä virallisiin dokumentteihin.

Kehityksen parhaat käytännöt

Käsittele virheet ja reunatapaukset

def recherche_robuste(query, max_retries=2):
    for attempt in range(max_retries + 1):
        try:
            response = client.responses.create(
                model="grok-4.5",
                input=query,
                tools=[{"type": "web_search"}],
                timeout=30
            )
            if response.output_text:
                return response.output_text
        except Exception as e:
            if attempt == max_retries:
                return f"Search failed after {max_retries + 1} attempts: {e}"
    return "No results obtained"

Välimuistita tulokset

Toistuville kyselyille toteuta välimuisti välttääksesi tarpeettomia kutsuja:

from datetime import datetime, timedelta

cache = {}

def recherche_avec_cache(query, ttl_minutes=60):
    now = datetime.now()

    if query in cache:
        result, timestamp = cache[query]
        if now - timestamp < timedelta(minutes=ttl_minutes):
            return result

    result = client.responses.create(
        model="grok-4.5",
        input=query,
        tools=[{"type": "web_search"}]
    ).output_text

    cache[query] = (result, now)
    return result

Jäsennä kehotteet hakua varten

Hyvin jäsennellyt kehotteet tuottavat parempia hakutuloksia:

  • Ole spesifi: kysely ohjaa mallia sen hakutermeissä
  • Pyydä lähteitä: lähdeviitteiden eksplisiittinen mainitseminen parantaa niiden sisällyttämistä
  • Määritä muoto: jäsennelty tulostemuoto helpottaa ohjelmallista käyttöä
  • Rajoita laajuutta: liian laaja aihealue vesittää relevanssin

Vältä yhden kutsun ylikuormittamista

Vastusta kiusausta pyytää kaikkea yhdessä kehotteessa. Kutsu, joka pyytää 10 eri analyysiä 5 aiheesta, tuottaa pinnallisia tuloksia. Suosi useita kohdennettuja kutsuja yhden massiivisen kutsun sijaan.

Turvallisuus ja yksityisyys

Arkaluonteinen data kehotteissa

API:lle lähetetyt pyynnöt sisältävät kehoteesi. Älä lähetä luottamuksellista dataa hakutermeissä. Jos seurantas sovelluksesi kattaa arkaluonteisia aiheita (ei-julkiset yrityskaupat, tietoturvahaavoittuvuudet), muotoile kyselyt paljastamatta sisäistä informaatiota.

Suodattamattomat tulokset

Web- ja X-hakutuloksia ei moderoida sovelluksessasi. Toteuta suodatuskerros, jos tulokset näytetään suoraan loppukäyttäjille, erityisesti ammattimaisessa tai koulutuksellisessa kontekstissa.

Ennen tuotantoon siirtymistä - tarkistuslista

Ennen Grok-hakua käyttävän sovelluksen käyttöönottoa:

  • Oletko arvioinut kuukausikustannukset kutsujen ja tokenien osalta?
  • Ovatko aikakatkaisusi sovitettu hakukyselyihin (pidemmät)?
  • Käsitteletkö verkkovirheet ja tyhjät vastaukset?
  • Onko sinulla välimuisti usein toistuville kyselyille?
  • Tarkistetaanko lähdeviitteet ennen näyttämistä?
  • Onko arkaluonteinen data suljettu pois kehotteista?
  • Onko tulossuodatus käytössä loppukäyttäjiä varten?

Käytännön harjoitus

Rakenna完整的 seurantasovellus soveltaen kaikkia tämän oppitunnin parhaita käytäntöjä: virheenkäsittely, välimuistitus, kustannusarvio ja lähdeviitteiden tarkistus. Aja sitä viikon ajan ja mittaa todelliset kustannukset verrattuna alkuperäiseen arvioosi.

Keskeiset asiat

  • Haun kustannus on 5 dollaria 1 000 kutsua kohden plus kulutetut tokenit
  • Web-tulosten ajantasaisuus voi vaihdella; X on reagoivampi välittömissä uutisissa
  • Toteuta välimuisti toistuville kyselyille kustannusten hallitsemiseksi
  • Käsittele virheet ja sovita aikakatkaisut hakukyselyihin
  • Älä lähetä luottamuksellista dataa hakutermeissä
  • Tarkista lähdeviitteet aina ennen niiden liittämistä virallisiin dokumentteihin
  • Suosi useita kohdennettuja kutsuja yhden liian kunnianhimoisen kutsun sijaan

Testaa tietämyksesi

Web + X: Reaaliaikainen haku Grokilla, viidessä tarkistuksessa.

1. Mitä web-haku mahdollistaa Grok API:ssa?

Vastaus: Web-pohjaiset vastaukset kyselyhetkellä lähdeviitteineen – ja hallinta verkkotunnussuodatuksen kautta hyväksyttävien lähteiden rajaamiseksi.

2. Mitä X-haku lisää web-hakuun verrattuna?

Vastaus: Pääsyn X:n keskustelulliseen reaaliaikaiseen syötteeseen: viestit, trendit, heikot signaalit – suodatettavissa käyttäjätunnuksilla ja päivämäärillä, maaperää jota klassinen web-haku ei kata.

3. Miten lähdeviitteitä hyödynnetään oikein?

Vastaus: Tarkistamalla ne: lähdeviite todistaa alkuperän, ei totuutta – faktantarkistusta varten palaa lähteelle ja ristiviittaa useisiin referensseihin.

4. Nimeä kaksi tyypillistä käyttötapausta Web + X -yhdistelmälle.

Vastaus: Automatisoitu kilpailija-analyysi (viralliset ilmoitukset webissä + reaktiot X:ssä) ja nousevien trendien havaitseminen – kumpikin kanava tallentaa sen, mitä toinen ei huomaa.

5. Mitkä rajoitukset ja parhaat käytännöt tulee pitää mielessä?

Vastaus: Hauilla on kustannus kyselyä kohden: kohdenna suodattimet, rajoita syvyys todelliseen tarpeeseen ja välimuistita uudelleenkäytettävä tieto – tehokas seuranta on rajattua seurantaa.

Lähteistetty reaaliaika, hallitut suodattimet, systemaattinen tarkistus: Grok-hakusta tulee seurantainstrumentti – ei oraakkeli.