Премини към основното съдържание
Български— Изберете език
Меню

Комбиниране на сървърни и клиентски инструменти

Урок 12 от 16 Обновен 30 юли 2026 г. Програмист
На тази страница
  1. Хибридни работни потоци
  2. Комбиниране на сървърни инструменти и функции
  3. Хибриден поток на изпълнение
  4. Чести модели на комбинации
  5. max_turns и хибридни инструменти
  6. Контекст с многократни цикли и съхранение
  7. Ключови изводи

Хибридни работни потоци

Истинската сила на 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"]
            }
        }
    ]
)

В този сценарий моделът:

  1. Автоматично задейства web_search (от страна на сървъра), за да открие резултатите
  2. Интегрира данните в обобщение
  3. Извиква 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 за работни потоци с многократни цикли