Indbyggede værktøjer til Responses API
På denne side
Tilføjelse af funktioner til modellen
Grok-modeller er ikke begrænset til tekstgenerering. Ved hjælp af parameteren tools kan du give dem adgang til værktøjer, der udvider deres evner markant: websøgning i realtid, søgning på X (tidligere Twitter), kørsel af Python-kode og dine egne brugerdefinerede funktioner.
De 4 værktøjstyper
web_search
Lader modellen søge efter information på nettet i realtid:
{
"model": "grok-4.20-0309-reasoning",
"input": "What's the latest news on AI in Europe?",
"tools": [{"type": "web_search"}]
}
Modellen beslutter automatisk, hvornår den skal udføre en søgning. Resultaterne integreres i svaret med kildehenvisninger.
x_search
Søger efter indlæg på X (tidligere Twitter):
{
"model": "grok-4.20-0309-reasoning",
"input": "What is the tech community saying about the latest iPhone?",
"tools": [{"type": "x_search"}]
}
Særligt nyttigt til at indfange offentlig mening, tendenser og reaktioner i realtid.
code_interpreter
Udfører Python-kode på serversiden til beregninger, dataanalyse eller oprettelse af diagrammer:
{
"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"}]
}
Modellen skriver Python-kode, udfører den på xAI-servere og integrerer resultaterne i sit svar.
function
Dine egne funktioner, som modellen kan kalde. Modellen genererer argumenterne, men din kode udfører funktionen:
{
"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"]
}
}]
}
Kombination af flere værktøjer
Du kan sende op til 128 værktøjer i en enkelt anmodning. Modellen vælger det (eller dem), der passer bedst:
{
"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"}
]
}
I dette eksempel kan modellen først bruge web_search til at finde resultaterne og derefter code_interpreter til at formatere dem i en tabel.
Værktøjer på serversiden kontra clientsiden
Distinktionen er fundamental:
-
Værktøjer på serversiden (
web_search,x_search,code_interpreter): Udføres automatisk af xAI-servere. Du behøver ikke gøre noget – modellen starter søgningen eller koden, henter resultatet og integrerer det i sit svar. -
Værktøjer på clientsiden (
function): Modellen genererer et funktionskald med argumenter og pauser derefter genereringen. Din kode udfører funktionen, og du sender resultatet tilbage i en ny anmodning.
Denne forskel påvirker direkte din applikationsarkitektur, som du vil se i de følgende lektioner.
Vigtige pointer
- Fire værktøjstyper:
web_search,x_search,code_interpreter,function - De første tre kører på serversiden – ingen infrastruktur kræves fra din side
function-værktøjer kører på clientsiden – din kode håndterer udførelsen- Du kan kombinere op til 128 værktøjer pr. anmodning
- Modellen beslutter automatisk, hvornår og hvilke værktøjer der skal bruges