Комбиниране на сървърни и клиентски инструменти
На тази страница
Хибридни работни потоци
Истинската сила на Responses API се разкрива, когато комбинирате сървърни инструменти (изпълнявани автоматично от xAI) и клиентски инструменти (вашите персонализирани функции) в една единствена заявка. Моделът оркестрира тези инструменти автономно, създавайки сложни работни потоци само с няколко реда код.
Комбиниране на сървърни инструменти и функции
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"]
}
}
]
)
В този сценарий моделът:
- Автоматично задейства
web_search(от страна на сървъра), за да открие резултатите - Интегрира данните в обобщение
- Извиква
send_team_message(от страна на клиента), така че Вашият код да изпрати съобщението в Slack
Хибриден поток на изпълнение
Потокът варира в зависимост от типа инструмент:
Само сървърни инструменти
Request → [model → web_search → result → model] → Final response
Всичко се случва от страна на xAI. Вие получавате крайния отговор директно с интегрираните резултати.
Само клиентски инструменти
Request → [model → function_call] → PAUSE
Your code executes the function
Result → [model] → Final response
Моделът прави пауза, Вашият код се изпълнява, след което изпращате резултата обратно.
Хибриден поток
Request → [model → web_search → result → model → function_call] → PAUSE
Your code executes the function
Result → [model] → Final response
Моделът първо използва сървърни инструменти (автоматично), след което извиква Вашата функция, когато има нужда от Вашата инфраструктура.
Чести модели на комбинации
Търсене + Действие
Комбинирайте web_search или x_search с функция за действие:
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"]
}
}
]
Изчисление + Известие
Комбинирайте code_interpreter с функция за известяване:
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 и хибридни инструменти
Поведението на max_turns е важно в хибриден контекст:
max_turnsограничава сървърните цикли в рамките на една единствена заявка- Когато моделът извика клиентска функция и Вашият код върне резултата, започва ново разпределение на
max_turns
На практика това означава, че клиентските извиквания не изчерпват Вашия бюджет за сървърни цикли. Моделът може да извърши 3 уеб търсения, да извика Вашата функция и след получаване на резултата да извърши още 3 допълнителни търсения.
Контекст с многократни цикли и съхранение
За сложни работни потоци, обхващащи множество взаимодействия, комбинирайте съхранение и верижно свързване:
# Turn 1: initial search
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
)
# Turn 2: deepen with your internal data
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
)
Ключови изводи
- Комбинирайте сървърни инструменти и клиентски функции в една заявка за хибридни работни потоци
- Сървърните инструменти се изпълняват автоматично; клиентските функции паузират генерирането
max_turnsсе нулира след всеки цикъл на обмен с клиента- Чести модели: търсене + действие, изчисление + известие, агрегиране от множество източници
- Използвайте
store: trueиprevious_response_idза работни потоци с многократни цикли