Integruoti įrankiai „Responses“ API
Šiame puslapyje
Modelio galimybių plėtimas
„Grok“ modeliai nėra apriboti vien teksto generavimu. Naudodamas parametrą tools, gali suteikti jiems prieigą prie įrankių, kurie žymiai praplečia jų galimybes: realaus laiko paieška internete, paieška „X“ platformoje (buvusiame „Twitter“), Python kodo vykdymas ir tavo pačių sukurtos funkcijos.
Keturi įrankių tipai
web_search
Leidžia modeliui realiuoju laiku ieškoti informacijos internete:
{
"model": "grok-4.20-0309-reasoning",
"input": "What's the latest news on AI in Europe?",
"tools": [{"type": "web_search"}]
}
Modelis automatiškai nusprendžia, kada atlikti paiešką. Rezultatai integruojami į jo atsakymą su nuorodomis.
x_search
Ieško įrašų „X“ platformoje (buvusiame „Twitter“):
{
"model": "grok-4.20-0309-reasoning",
"input": "What is the tech community saying about the latest iPhone?",
"tools": [{"type": "x_search"}]
}
Ypač naudinga fiksuojant visuomenės nuomonę, tendencijas ir reakcijas realiuoju laiku.
code_interpreter
Vykdė Python kodą serverio pusėje skaičiavimams, duomenų analizei arba diagramų kūrimui:
{
"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"}]
}
Modelis parašo Python kodą, jį įvykdo xAI serveriuose ir integruoja rezultatus į savo atsakymą.
function
Tavo pačių sukurtos funkcijos, kurias modelis gali iškviesti. Modelis sugeneruoja argumentus, tačiau funkciją vykdo tavo kodas:
{
"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"]
}
}]
}
Kelių įrankių derinimas
Viename užklausoje gali pateikti iki 128 įrankių. Modelis pasirenka tą (ar tuos), kuris(-ie) tinka:
{
"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"}
]
}
Šiame pavyzdyje modelis gali pirmiausia naudoti web_search rezultatams rasti, o tada code_interpreter – jiems suformatuoti į lentelę.
Serverio pusės ir kliento pusės įrankiai
Šis skirtumas yra esminis:
-
Serverio pusės įrankiai (
web_search,x_search,code_interpreter): automatiškai vykdomi xAI serverių. Tau nereikia nieko daryti – modelis paleidžia paiešką arba kodą, gauna rezultatą ir jį integruoja į savo atsakymą. -
Kliento pusės įrankiai (
function): modelis sugeneruoja funkcijos iškvietimą su argumentais, tada sustabdo generavimą. Tavo kodas įvykdo funkciją, o tu siunči rezultatą atgal naujoje užklausoje.
Šis skirtumas tiesiogiai veikia tavo programos architektūrą, kaip pamatysi kitose pamokose.
Svarbiausi punktai
- Keturi įrankių tipai:
web_search,x_search,code_interpreter,function - Pirmieji trys veikia serverio pusėje – tau nereikia jokios infrastruktūros
functionįrankiai veikia kliento pusėje – vykdymą tvarko tavo kodas- Vienoje užklausoje gali derinti iki 128 įrankių
- Modelis automatiškai nusprendžia, kada ir kuriuos įrankius naudoti