Palvelin- ja asiakastyökalujen yhdistäminen
Tällä sivulla
Hybridityönkulut
Responses API:n todellinen voima paljastuu, kun yhdistät palvelintyökalut (joita xAI suorittaa automaattisesti) ja asiakastyökalut (omat funktiosi) samaan pyyntöön. Malli orkestroi nämä työkalut itsenäisesti ja luo monimutkaisia työnkulkuja vain muutamalla koodirivillä.
Palvelintyökalujen ja funktioiden yhdistäminen
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Search for the latest Ligue 1 soccer results and send a summary to my team.",
tools=[
{"type": "web_search"},
{
"type": "function",
"name": "send_team_message",
"description": "Sends a message to the team via Slack",
"parameters": {
"type": "object",
"properties": {
"channel": {"type": "string"},
"message": {"type": "string"}
},
"required": ["channel", "message"]
}
}
]
)
Tässä skenaariossa malli:
- Käynnistää
web_search-työkalun automaattisesti (palvelinpuolella) löytääkseen tulokset - Sisällyttää tiedot yhteenvetoon
- Kutsuu funktiota
send_team_message(asiakaspuolella), jotta koodisi lähettää Slack-viestin
Hybridi-suoritusvirta
Virta vaihtelee työkalutyypin mukaan:
Vain palvelintyökalut
Request → [model → web_search → result → model] → Final response
Kaikki tapahtuu xAI:n puolella. Saat lopullisen vastauksen suoraan integroitujen tulosten kera.
Vain asiakastyökalut
Request → [model → function_call] → PAUSE
Your code executes the function
Result → [model] → Final response
Malli keskeyttää toimintansa, koodisi suorittaa funktion, ja lähetät tuloksen takaisin.
Hybridi-virta
Request → [model → web_search → result → model → function_call] → PAUSE
Your code executes the function
Result → [model] → Final response
Malli käyttää ensin palvelintyökaluja (automaattisesti) ja kutsuu funktiotasi vasta, kun se tarvitsee infrastruktuuriasi.
Yleiset yhdistelmämallit
Haku + toiminto
Yhdistä web_search tai x_search toimintofunktioon:
tools = [
{"type": "web_search"},
{"type": "x_search"},
{
"type": "function",
"name": "create_report",
"description": "Creates a report in the CRM",
"parameters": {
"type": "object",
"properties": {
"title": {"type": "string"},
"content": {"type": "string"},
"tags": {"type": "array", "items": {"type": "string"}}
},
"required": ["title", "content"]
}
}
]
Laskenta + ilmoitus
Yhdistä code_interpreter ilmoitusfunktioon:
tools = [
{"type": "code_interpreter"},
{
"type": "function",
"name": "send_alert",
"description": "Sends an alert if a threshold is exceeded",
"parameters": {
"type": "object",
"properties": {
"metric": {"type": "string"},
"value": {"type": "number"},
"threshold": {"type": "number"}
},
"required": ["metric", "value"]
}
}
]
max_turns ja hybridityökalut
max_turns-parametrin käyttäytyminen on tärkeää hybridikontekstissa:
max_turnsrajoittaa palvelinpuoleisia kierroksia yhden pyynnön sisällä- Kun malli kutsuu asiakasfunktiota ja koodisi palauttaa tuloksen,
max_turns-kiintiö allokoidaan uudelleen
Käytännössä tämä tarkoittaa, että asiakaskutsut eivät kuluta palvelinkierrosten budjettiasi. Malli voi tehdä kolme verkkohakua, kutsua funktiotasi ja tehdä sen jälkeen tuloksen vastaanotettuaan vielä kolme lisähakua.
Monivaiheinen kontekti tallennuksen avulla
Monia vuorovaikutuksia kattavia monimutkaisia työnkulkuja varten yhdistä tallennus ja ketjutus:
# Kierros 1: alkuperäinen haku
r1 = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Analyze AI market trends.",
tools=[{"type": "web_search"}, {"type": "code_interpreter"}],
store=True,
max_turns=5
)
# Kierros 2: syvennä omilla sisäisillä tiedoillasi
r2 = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Compare with our internal data.",
tools=[{
"type": "function",
"name": "query_internal_db",
"description": "Queries the internal database",
"parameters": {"type": "object", "properties": {"query": {"type": "string"}}}
}],
previous_response_id=r1.id,
store=True
)
Keskeiset asiat
- Yhdistä palvelintyökalut ja asiakasfunktiot samaan pyyntöön luodaksesi hybridityönkulkuja
- Palvelintyökalut suoritetaan automaattisesti; asiakasfunktiot keskeyttävät generoinnin
max_turnsnollautuu jokaisen asiakaspuolisen edestakaisen viestin jälkeen- Yleiset mallit: haku + toiminto, laskenta + ilmoitus, usean lähteen aggregointi
- Käytä arvoa
store: trueja parametriaprevious_response_idmonivaiheisiin työnkulkuihin