Serveri ja kliendi tööriistade kombineerimine
Sellel lehel
Hübriidsed töövood
Responses API tegelik jõudus avaldub siis, kui kombineerid ühes päringus serveritööriistad (mida xAI automaatselt käivitab) ja klienditööriistad (sinu kohandatud funktsioonid). Mudel orkestreerib neid tööriistu autonoomselt, luues keerukaid töövood vaid paari koodireaga.
Serveritööriistade ja funktsioonide ühendamine
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Otsi värskeimad Ligue 1 jalgpallitulemused ja saada kokkuvõte mu meeskonnale.",
tools=[
{"type": "web_search"},
{
"type": "function",
"name": "send_team_message",
"description": "Saadab sõnumi meeskonnale Slacki kaudu",
"parameters": {
"type": "object",
"properties": {
"channel": {"type": "string"},
"message": {"type": "string"}
},
"required": ["channel", "message"]
}
}
]
)
Selles stsenaariumis mudel:
- Käivitab automaatselt
web_search(serveripoolselt), et leida tulemused - Lisab andmed kokkuvõttesse
- Kutsub välja
send_team_message(kliendipoolselt), nii et sinu kood saadab Slacki sõnumi
Hübriidse täitmise voog
Voog erineb sõltuvalt tööriista tüübist:
Ainult serveritööriistad
Päring → [mudel → web_search → tulemus → mudel] → Lõppvastus
Kõik toimub xAI poolel. Saad lõppvastuse otse, kus tulemused on juba integreeritud.
Ainult klienditööriistad
Päring → [mudel → function_call] → PAUS
Sinu kood käivitab funktsiooni
Tulemus → [mudel] → Lõppvastus
Mudel teeb pausi, sinu kood käivitub ja seejärel saadad tulemuse tagasi.
Hübriidne voog
Päring → [mudel → web_search → tulemus → mudel → function_call] → PAUS
Sinu kood käivitab funktsiooni
Tulemus → [mudel] → Lõppvastus
Mudel kasutab esmalt serveritööriistu (automaatselt) ja kutsub sinu funktsiooni välja alles siis, kui tal on vaja sinu taristut.
Levinud kombinatsioonimustrid
Otsing + tegevus
Kombineeri web_search või x_search tegevusfunktsiooniga:
tools = [
{"type": "web_search"},
{"type": "x_search"},
{
"type": "function",
"name": "create_report",
"description": "Loob aruande CRM-is",
"parameters": {
"type": "object",
"properties": {
"title": {"type": "string"},
"content": {"type": "string"},
"tags": {"type": "array", "items": {"type": "string"}}
},
"required": ["title", "content"]
}
}
]
Arvutus + teavitus
Kombineeri code_interpreter teavitamisfunktsiooniga:
tools = [
{"type": "code_interpreter"},
{
"type": "function",
"name": "send_alert",
"description": "Saadab hoiatuse, kui lävend on ületatud",
"parameters": {
"type": "object",
"properties": {
"metric": {"type": "string"},
"value": {"type": "number"},
"threshold": {"type": "number"}
},
"required": ["metric", "value"]
}
}
]
max_turns ja hübriidsed tööriistad
max_turns käitumine on hübriidses kontekstis oluline:
max_turnspiirab serveripoolseid pöördeid ühe päringu sees- Kui mudel kutsub kliendifunktsiooni ja sinu kood tagastab tulemuse, algab
max_turnsuus eraldamine
Praktikas tähendab see, et kliendipoolsed väljakutsed ei kuluta ära sinu serveripoolset pöörete eelarvet. Mudel saab teha 3 veebiotsingut, kutsuda sinu funktsiooni ja seejärel pärast tulemuse saamist teha veel 3 otsingut.
Mitme pöördega kontekst salvestusega
Keerukate, mitut interaktsiooni hõlmavate töövoodede jaoks kombineeri salvestust ja aheldamist:
# 1. pööre: esmane otsing
r1 = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Analüüsi tehisintellekti turusuundumusi.",
tools=[{"type": "web_search"}, {"type": "code_interpreter"}],
store=True,
max_turns=5
)
# 2. pööre: süvenda oma sisemiste andmetega
r2 = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Võrdle meie sisemiste andmetega.",
tools=[{
"type": "function",
"name": "query_internal_db",
"description": "Päring sisemisse andmebaasi",
"parameters": {"type": "object", "properties": {"query": {"type": "string"}}}
}],
previous_response_id=r1.id,
store=True
)
Peamised punktid
- Kombineeri serveritööriistu ja kliendifunktsioone ühes päringus hübriidsete töövoodede loomiseks
- Serveritööriistad käivituvad automaatselt; kliendifunktsioonid peatavad genereerimise
max_turnslähtestatakse pärast iga kliendipoolset edasi-tagasi suhtlust- Levinud mustrid: otsing + tegevus, arvutus + teavitus, mitme allika agregeerimine
- Kasuta mitme pöördega töövoodede jaoks
store: truejaprevious_response_id