Двете категории инструменти на Grok
На тази страница
Разберете екосистемата от инструменти на Grok API
Grok API прави повече от това просто да генерира текст. То предоставя набор от инструменти, които позволяват на модела да взаимодейства с външния свят: търсене на информация в реално време, анализ на данни в социалните мрежи или изпълнение на Python код. За да използвате пълноценно тези възможности, трябва да разберете как са организирани те.
Grok API разграничава две основни категории инструменти. Това разграничение определя кой изпълнява инструмента, къде се извършва обработката и какво трябва да управлявате като разработчик.
Вградени инструменти — От страна на сървъра
Вградените инструменти се изпълняват директно на сървърите на xAI. Когато моделът реши да използва един от тези инструменти, изпълнението е автоматично и прозрачно за Вас. Не е необходимо да управлявате никаква инфраструктура или да обработвате междинни резултати.
Ето петте налични вградени инструмента:
- Web Search (
web_search): Търсене в уеб в реално време с филтриране по домейни и автоматично цитиране - X Search (
x_search): Търсене в X/Twitter с филтриране по акаунт и дата - Code Execution (
code_interpreter/code_execution): Изпълнение на Python код в сигурна изолирана среда (sandbox) - Collections Search (
collections_search/file_search): Търсене в документи, които сте качили предварително - Remote MCP (
mcp): Свързване към външни MCP (Model Context Protocol) сървъри
За да активирате вграден инструмент, просто го добавете към масива tools във Вашата заявка:
{
"tools": [{"type": "web_search"}]
}
Извикване на функции — От страна на клиента
Извикването на функции (Function Calling) работи по различен начин. Вие дефинирате персонализирани функции, които моделът може да извика. Но за разлика от вградените инструменти, Вашият код от страна на клиента изпълнява функцията и връща резултата на модела.
Процесът протича по следния начин:
- Описвате Вашите функции (име, параметри, описание) в заявката
- Моделът анализира искането на потребителя
- Ако определи, че е необходима функция, той връща извикване на функция с аргументи
- Вашият код изпълнява функцията (API повикване, заявка към база данни, изчисление…)
- Изпращате резултата обратно към модела
- Моделът формулира крайния си отговор
Този подход Ви осигурява пълен контрол: Вие решавате какво правят Вашите функции, с какви данни работят и как се свързват с Вашата инфраструктура.
Кога да използвате всяка категория
Вградените инструменти са идеални, когато имате нужда от достъп до информация в реално време (уеб, социални мрежи) или трябва да изпълнявате изчисления без да управлявате инфраструктура. Извикването на функции е за предпочитане, когато трябва да взаимодействате със собствените си системи: вътрешни бази данни, бизнес API или всяка услуга, специфична за Вашето приложение.
Можете да комбинирате двете категории в една единствена заявка. Например, можете да активирате Web Search, докато дефинирате персонализирана функция, която запазва резултатите във Вашата база данни.
Ключови изводи
- Grok API предлага две категории инструменти: вградени инструменти (изпълнявани от xAI) и извикване на функции (изпълнявани от Вашия код)
- Вградените инструменти не изискват инфраструктура от страна на клиента
- Извикването на функции предлага пълен контрол, но изисква повече разработка
- Двете категории могат да бъдат комбинирани в една заявка
- Този курс се фокусира върху трите основни вградени инструмента: Web Search, X Search и Code Execution