De två kategorierna av Grok-verktyg
På denna sida
Förstå ekosystemet för Grok API-verktyg
Grok API gör mer än att bara generera text. Det tillhandahåller en uppsättning verktyg som låter modellen interagera med omvärlden: söka efter information i realtid, analysera data på sociala medier eller köra Python-kod. För att utnyttja dessa möjligheter måste du förstå hur de är organiserade.
Grok API skiljer mellan två grundläggande kategorier av verktyg. Denna åtskillnad avgör vem som kör verktyget, var bearbetningen sker och vad du behöver hantera som utvecklare.
Inbyggda verktyg – Serversidan
Inbyggda verktyg körs direkt på xAI:s servrar. När modellen bestämmer sig för att använda ett av dessa verktyg sker körningen automatiskt och transparent. Du behöver inte hantera någon infrastruktur eller bearbeta mellanliggande resultat.
Här är de fem tillgängliga inbyggda verktygen:
- Web Search (
web_search): Websökning i realtid, med filtrering av domäner och automatiska källhänvisningar - X Search (
x_search): Sökning på X/Twitter, med filtrering efter konto och datum - Code Execution (
code_interpreter/code_execution): Körning av Python-kod i en säker, isolerad sandlådemiljö - Collections Search (
collections_search/file_search): Sökning i dokument du tidigare har laddat upp - Remote MCP (
mcp): Anslutning till externa MCP-servrar (Model Context Protocol)
För att aktivera ett inbyggt verktyg behöver du bara lägga till det i tools-arrayen i din begäran:
{
"tools": [{"type": "web_search"}]
}
Funktionsanrop – Klientsidan
Funktionsanrop fungerar annorlunda. Du definierar anpassade funktioner som modellen kan anropa. Till skillnad från inbyggda verktyg är det dock din kod på klientsidan som kör funktionen och returnerar resultatet till modellen.
Flödet ser ut så här:
- Du beskriver dina funktioner (namn, parametrar, beskrivning) i begäran
- Modellen analyserar användarens förfrågan
- Om den avgör att en funktion behövs returnerar den ett funktionsanrop med argument
- Din kod kör funktionen (API-anrop, databasfråga, beräkning…)
- Du skickar tillbaka resultatet till modellen
- Modellen formulerar sitt slutgiltiga svar
Detta tillvägagångssätt ger dig full kontroll: du bestämmer vad dina funktioner gör, vilken data de hanterar och hur de kopplas till din infrastruktur.
När ska varje kategori användas?
Inbyggda verktyg är idealiska när du behöver tillgång till information i realtid (webben, sociala medier) eller behöver köra beräkningar utan att hantera infrastruktur. Funktionsanrop är att föredra när du behöver interagera med dina egna system: interna databaser, affärs-API:er eller tjänster som är specifika för din applikation.
Du kan kombinera båda kategorierna i en och samma begäran. Du kan till exempel aktivera Web Search samtidigt som du definierar en anpassad funktion som sparar resultaten i din databas.
Viktiga punkter
- Grok API erbjuder två kategorier av verktyg: inbyggda verktyg (körs av xAI) och funktionsanrop (körs av din kod)
- Inbyggda verktyg kräver ingen infrastruktur på klientsidan
- Funktionsanrop erbjuder full kontroll men kräver mer utvecklingsarbete
- Båda kategorierna kan kombineras i en enda begäran
- Denna kurs fokuserar på de tre huvudsakliga inbyggda verktygen: Web Search, X Search och Code Execution