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

Инструменти на сървъра и извикване на функции

Урок 10 от 12 Обновен 2 ноември 2026 г. Програмист
На тази страница
  1. Обогатяване на пакетни заявки с инструменти
  2. Инструменти на страната на сървъра
  3. Извикване на функции от страната на клиента
  4. Комбиниране на инструменти
  5. Ограничения на инструментите в пакетния режим
  6. Ключови изводи

Курсът е актуализиран на 2 ноември 2026 г. въз основа на документацията на xAI: отстъпката за пакетни заявки е 20% за допустимите текстови модели (не 50%), примерите следват REST API и официалния xai-sdk (client.batch.*; Пакетното API на xAI не използва формата на OpenAI, SDK на OpenAI не се прилага), а Responses API има предимство пред Chat Completions, което е остаряла крайна точка в xAI. Източници: Batch API · REST Reference · Batch Pricing.

Обогатяване на пакетни заявки с инструменти

Пакетните заявки не се ограничават до суров текст. Инструментите на сървъра и извикването на функции работят и в асинхронен режим, с ключова разлика: първите се изпълняват по време на обработката от xAI, докато вторите връщат контрола към Вас.

Инструменти на страната на сървъра

Инструментите на сървъра се изпълняват по време на пакетната обработка, точно както в реално време: Grok извиква инструмента, получава резултата, интегрира го в своите разсъждения и пакетът връща крайния отговор. Те работят с Responses API.

Уеб търсене

{"custom_id": "news-1", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": [{"role": "user", "content": "What are the latest developments in quantum computing?"}], "tools": [{"type": "web_search"}]}}

В пакетен режим уеб търсенето служи за обогатяване на данни: проверка на информация, събиране на скорошни факти, сравняване на профили с онлайн източници.

Търсене в X

Инструментът x_search прави заявки към публикации в X, което е полезно за проследяване на настроенията по дадена тема или марка:

{"custom_id": "x-1", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": [{"role": "user", "content": "What is the dominant sentiment on X regarding this product launch?"}], "tools": [{"type": "x_search"}]}}

Изпълнение на код

Grok може да пише и изпълнява Python код в изолирана среда. В Responses API инструментът се нарича code_interpreter (SDK на xAI го нарича code_execution):

{"custom_id": "calc-1", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": [{"role": "user", "content": "Calculate the 3-point moving average for this data: [12, 15, 18, 14, 22, 19, 25, 28, 30, 27]"}], "tools": [{"type": "code_interpreter"}]}}

Изпълнението на код е уместно за точни изчисления, статистика и трансформации на данни, които моделът би обработил по-малко надеждно от паметта си.

Отдалечени MCP сървъри

Инструментът mcp свързва Grok с отдалечен MCP сървър, описан в самата заявка: не е необходима предварителна конфигурация на акаунта. server_url и server_label са задължителни; allowed_tools ограничава изложените инструменти, а authorization предава токен на сървъра. Приема се само транспорт чрез Streamable HTTP и SSE.

{"custom_id": "mcp-1", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": [{"role": "user", "content": "What does the xai-sdk-python repository do?"}], "tools": [{"type": "mcp", "server_label": "deepwiki", "server_url": "https://mcp.deepwiki.com/mcp"}]}}

Без allowed_tools, всички дефиниции на инструменти от сървъра се инжектират в контекста на модела и се таксуват като входни токени при всяка пакетна заявка: при 50 000 заявки, ограничаването на списъка се изплаща бързо.

Извикване на функции от страната на клиента

Извикването на функции е инструмент от страната на клиента: Grok произвежда структурирано извикване на функция, но Вашият код го изпълнява. В пакетния режим моделът връща тези извиквания в своите резултати за офлайн обработка.

Дефиниции на функции

В Responses API декларирайте функцията плоско, с name, description и parameters на най-горно ниво. tool_choice: "required" принуждава модела да извика поне един инструмент, което е подходящо за извличане:

{"custom_id": "extract-1", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": [{"role": "user", "content": "Extract the contact: Jean Dupont, 01 23 45 67 89, [email protected]"}], "tools": [{"type": "function", "name": "save_contact", "description": "Saves a contact extracted from text", "parameters": {"type": "object", "properties": {"name": {"type": "string"}, "phone": {"type": "string"}, "email": {"type": "string"}}, "required": ["name"]}}], "tool_choice": "required"}}

Обработка на резултатите

Чрез SDK прочетете извикванията на функции в tool_calls на всеки успешен резултат:

import json

for r in page.succeeded:
    for call in r.response.tool_calls:
        if call.function.name == "save_contact":
            contact = json.loads(call.function.arguments)
            save_to_database(r.batch_request_id, contact)

Пакетното извикване на функции е идеално за структурирано извличане: Вие дефинирате схемата на данните, Grok чете документите и произвежда извикванията, след което Вие ги обработвате масово.

Комбиниране на инструменти

Можете да комбинирате няколко инструмента на сървъра в една заявка:

{"custom_id": "multi-1", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": [{"role": "user", "content": "Find the Bitcoin closing price for the last seven days and calculate its change"}], "tools": [{"type": "web_search"}, {"type": "code_interpreter"}]}}

Grok използва инструментите в реда, който счита за подходящ: тук уеб търсене за получаване на данните, след това изпълнение на код за изчислението.

Ограничения на инструментите в пакетния режим

  • Инструментите на сървъра удължават времето за обработка на всяка заявка, а следователно и на целия пакет
  • Заявките с търсене зависят от това какво публикуват източниците по време на обработката, а не на подаването
  • Извикването на функции прави само едно пътуване туда-обратно на заявка: за да продължите, подайте нова пакетна заявка, съдържаща разговора и Вашите резултати от функциите
  • Нефилтрираните дефиниции на MCP инструменти уголемяват всяка заявка

Ключови изводи

  • Инструментите на сървъра (уеб, X, код, MCP) се изпълняват от xAI по време на обработката чрез Responses API
  • Опишете MCP сървър в заявката (server_url, server_label) без предварителна конфигурация
  • Извикването на функции връща структурирани извиквания, които изпълнявате от страната на клиента
  • Многократният обмен изисква нова пакетна заявка за всеки ход
  • Ограничете изложените инструменти, за да избегнете плащане за техните дефиниции при всяка заявка