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

Serveri ja kliendi tööriistade kombineerimine

Õppetund 8 / 14 Värskendatud 29. juuli 2026 Arendajatele
Sellel lehel
  1. Kaks tööriistakategooriat samal platvormil
  2. Mõlema kombineerimine ühes päringus
  3. Hübriidne voog
  4. Reaalsed näited
  5. Serveri tööriistade arveldus
  6. Peamised punktid

Kaks tööriistakategooriat samal platvormil

Grok API eristab täitmise põhjal kahte fundamentaalselt erinevat tööriistatüüpi. Selle erinevuse mõistmine on hädavajalik töökindlate arhitektuuride loomisel.

Sisseehitatud tööriistad (serveripoolsed)

xAI täidab need tööriistad automaatselt oma serverites. Sa ei pea midagi haldama – ei kohalikku täitmist ega tulemuste edastamist. Mudel kutsub neid ja saab tulemused otse kätte.

Tööriist Identifikaator Kirjeldus
Web Search web_search Reaalajas veebiotsing
X Search x_search Otsing X-is/Twitteris
Code Interpreter code_interpreter Liivakastis Pythoni käivitamine
Collections Search collections_search Otsing üleslaaditud dokumentidest
Remote MCP mcp Ühendus väliste MCP-serveritega

Kohandatud funktsioonid (kliendipoolsed)

Need on sinu enda funktsioonid, mis on defineeritud funktsioonide kutsumise (function calling) kaudu. Mudel tagastab tool_call, sinu kood käivitab funktsiooni ja sa saadad tulemuse tagasi. See on mehhanism, mille õppisid eelmistes tundides.

Mõlema kombineerimine ühes päringus

Grok API võimsus peitub võimaluses kombineerida serveri ja kliendi tööriistu ühes päringus:

tools = [
    # Serveri tööriist — xAI täidab automaatselt
    {"type": "web_search"},

    # Kliendi tööriist — sinu kood täidab
    {
        "type": "function",
        "function": {
            "name": "save_to_database",
            "description": "Salvesta teave andmebaasi",
            "parameters": {
                "type": "object",
                "properties": {
                    "key": {"type": "string"},
                    "value": {"type": "string"}
                },
                "required": ["key", "value"]
            }
        }
    }
]

Kui mudel saab selle päringu, saab ta:

  1. Kasutada web_search info leidmiseks (automaatne serveripoolne täitmine)
  2. Kutsuda save_to_database tulemuse salvestamiseks (tagastatakse kliendile)

Hübriidne voog

Käitumine erineb sõltuvalt tööriista tüübist:

  • Serveri tööriist: mudel kutsub tööriista, xAI täidab selle, tulemus integreeritakse automaatselt ja mudel jätkab tööd.
  • Kliendi tööriist: mudel tagastab tool_call kliendile, täitmine peatub ja jätkub alles siis, kui saadad tulemuse tagasi.

Kui mudel kasutab mõlemat tüüpi samas päringus, täidetakse serveri tööriistad esimesena (sinu sekkumiseta). Seejärel, kui mudel vajab ka kliendi tööriista, tagastab ta sulle tool_call, olles juba integreerinud serveri tööriistade tulemused oma konteksti.

Reaalsed näited

Veebiotsing + äriloogika

# Kasutaja küsib: "Leia Bitcoini hind ja salvesta see"
# Mudel:
# 1. Kutsub web_search hinna leidmiseks (serveripoolne, automaatne)
# 2. Kutsub save_price(symbol="BTC", price=68432) (kliendipoolne)

X-i otsing + teavitus

# "Teavita mind tweetidest meie toote kohta alates eilsest"
# Mudel:
# 1. Kutsub x_search tweetide leidmiseks (serveripoolne)
# 2. Kutsub send_notification(count=12, summary="...") (kliendipoolne)

Koodi interpretaator + salvestamine

# "Arvuta nende andmete keskmine ja salvesta tulemus"
# Mudel:
# 1. Kutsub code_interpreter arvutuse tegemiseks (serveripoolne)
# 2. Kutsub save_result(key="avg", value="42.5") (kliendipoolne)

Serveri tööriistade arveldus

Sisseehitatud tööriistade eest arvestatakse tasu kahel viisil:

  • Tokenid: standardne tarbimine (sisend + väljund)
  • Kutsed: fikseeritud kulu iga tööriista kutse kohta

Mudel võib ühe päringu jaoks kutsuda mitut serveri tööriista – kulud liituvad. Pea seda silmas, kui lubad web_search: mudel võib tulemuste täpsustamiseks teha mitu otsingut.

Peamised punktid

  • Kaks tööriistatüüpi: server (automaatne) ja kliient (funktsioonide kutsumine)
  • Serveri tööriistad (web_search, x_search, code_interpreter) täidetakse ilma sinu sekkumiseta
  • Saad mõlemat tüüpi kombineerida ühes päringus
  • Serveri tööriistad täidetakse esimesena, seejärel saab mudel kutsuda sinu funktsioone
  • Iga serveri tööriista kutse on tasuline (tokenid + kulu kutse kohta)
  • Serveri tööriistadest pärit andmete jaoks genereeritakse viited automaatselt