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

Вградени инструменти за Responses API

Урок 9 от 16 Обновен 30 юли 2026 г. Програмист
На тази страница
  1. Добавяне на възможности към модела
  2. Четирите типа инструменти
  3. Комбиниране на няколко инструмента
  4. Инструменти от страната на сървъра срещу тези от страната на клиента
  5. Ключови изводи

Добавяне на възможности към модела

Моделите Grok не се ограничават само до генериране на текст. Чрез параметъра tools можете да им предоставите достъп до инструменти, които значително разширяват техните възможности: търсене в уеб в реално време, търсене в X (бившия Twitter), изпълнение на Python код и ваши собствени персонализирани функции.

web_search
Real-time web search
x_search
Search on X
code
Python Interpreter
function
Custom functions

Четирите типа инструменти

Позволява на модела да търси информация в уеб в реално време:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "What's the latest news on AI in Europe?",
  "tools": [{"type": "web_search"}]
}

Моделът автоматично решава кога да извърши търсене. Резултатите се интегрират в отговора му с цитати.

Търси публикации в X (бившия Twitter):

{
  "model": "grok-4.20-0309-reasoning",
  "input": "What is the tech community saying about the latest iPhone?",
  "tools": [{"type": "x_search"}]
}

Особено полезен за улавяне на общественото мнение, тенденциите и реакциите в реално време.

code_interpreter

Изпълнява Python код от страната на сървъра за изчисления, анализ на данни или създаване на графики:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Calculate the mean and standard deviation of these values: 12, 15, 18, 22, 9, 31",
  "tools": [{"type": "code_interpreter"}]
}

Моделът пише Python код, изпълнява го на сървърите на xAI и интегрира резултатите в своя отговор.

function

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

{
  "model": "grok-4.20-0309-reasoning",
  "input": "What's the weather in Paris?",
  "tools": [{
    "type": "function",
    "name": "get_weather",
    "description": "Retrieves the weather for a given city",
    "parameters": {
      "type": "object",
      "properties": {
        "city": {"type": "string", "description": "City name"},
        "unit": {"type": "string", "enum": ["celsius", "fahrenheit"]}
      },
      "required": ["city"]
    }
  }]
}

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

Можете да предадете до 128 инструмента в една заявка. Моделът избира този (или тези), които отговарят на нуждите:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Search for the latest Ligue 1 results and create a scoreboard.",
  "tools": [
    {"type": "web_search"},
    {"type": "code_interpreter"}
  ]
}

В този пример моделът може първо да използва web_search, за да открие резултатите, а след това code_interpreter, за да ги форматира в таблица.

Инструменти от страната на сървъра срещу тези от страната на клиента

Разликата е фундаментална:

  • Инструменти от страната на сървъра (web_search, x_search, code_interpreter): Изпълняват се автоматично от сървърите на xAI. Не е необходимо да правите нищо – моделът стартира търсенето или кода, получава резултата и го интегрира в своя отговор.

  • Инструменти от страната на клиента (function): Моделът генерира извикване на функция с аргументи, след което спира генерирането. Вашият код изпълнява функцията и вие изпращате резултата обратно в нова заявка.

Тази разлика оказва пряко влияние върху архитектурата на вашето приложение, както ще видите в следващите уроци.

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

  • Четири типа инструменти: web_search, x_search, code_interpreter, function
  • Първите три работят от страната на сървъра – не се изисква инфраструктура от ваша страна
  • Инструментите тип function работят от страната на клиента – вашият код се грижи за изпълнението
  • Можете да комбинирате до 128 инструмента на заявка
  • Моделът автоматично решава кога и кои инструменти да използва