Inbyggda verktyg för Responses API
På denna sida
Lägg till funktioner i modellen
Grok-modeller är inte begränsade till textgenerering. Med parametern tools kan du ge dem tillgång till verktyg som avsevärt utökar deras förmågor: webbsökning i realtid, sökning på X (tidigare Twitter), körning av Python-kod och dina egna anpassade funktioner.
De fyra verktygstyperna
web_search
Låter modellen söka efter information på webben i realtid:
{
"model": "grok-4.20-0309-reasoning",
"input": "What's the latest news on AI in Europe?",
"tools": [{"type": "web_search"}]
}
Modellen avgör automatiskt när en sökning ska utföras. Resultaten integreras i svaret med källhänvisningar.
x_search
Söker efter inlägg på X (tidigare Twitter):
{
"model": "grok-4.20-0309-reasoning",
"input": "What is the tech community saying about the latest iPhone?",
"tools": [{"type": "x_search"}]
}
Särskilt användbart för att fånga allmän opinion, trender och reaktioner i realtid.
code_interpreter
Kör Python-kod på serversidan för beräkningar, dataanalys eller skapande av diagram:
{
"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-kod, kör den på xAI:s servrar och integrerar resultaten i sitt svar.
function
Dina egna funktioner som modellen kan anropa. Modellen genererar argumenten, men din kod kör 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"]
}
}]
}
Kombinera flera verktyg
Du kan skicka upp till 128 verktyg i en enda begäran. Modellen väljer det (eller de) som passar:
{
"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 detta exempel kan modellen först använda web_search för att hitta resultaten och sedan code_interpreter för att formatera dem till en tabell.
Verktyg på serversidan kontra clientsidan
Skillnaden är fundamental:
-
Verktyg på serversidan (
web_search,x_search,code_interpreter): Körs automatiskt av xAI:s servrar. Du behöver inte göra något – modellen startar sökningen eller kodkörningen, hämtar resultatet och integrerar det i sitt svar. -
Verktyg på clientsidan (
function): Modellen genererar ett funktionsanrop med argument och pausar sedan genereringen. Din kod kör funktionen, och du skickar tillbaka resultatet i en ny begäran.
Denna skillnad påverkar direkt din applikationsarkitektur, vilket du kommer att se i de kommande lektionerna.
Viktiga punkter
- Fyra verktygstyper:
web_search,x_search,code_interpreter,function - De tre första körs på serversidan – ingen infrastruktur krävs från din sida
- Verktyg av typen
functionkörs på clientsidan – din kod hanterar körningen - Du kan kombinera upp till 128 verktyg per begäran
- Modellen avgör automatiskt när och vilka verktyg som ska användas