Вградени инструменти за Responses API
На тази страница
Добавяне на възможности към модела
Моделите Grok не се ограничават само до генериране на текст. Чрез параметъра tools можете да им предоставите достъп до инструменти, които значително разширяват техните възможности: търсене в уеб в реално време, търсене в X (бившия Twitter), изпълнение на Python код и ваши собствени персонализирани функции.
Четирите типа инструменти
web_search
Позволява на модела да търси информация в уеб в реално време:
{
"model": "grok-4.20-0309-reasoning",
"input": "What's the latest news on AI in Europe?",
"tools": [{"type": "web_search"}]
}
Моделът автоматично решава кога да извърши търсене. Резултатите се интегрират в отговора му с цитати.
x_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 инструмента на заявка
- Моделът автоматично решава кога и кои инструменти да използва