De to kategorier af Grok-værktøjer
På denne side
Forstå økosystemet for Grok API-værktøjer
Grok API gør mere end blot at generere tekst. Det tilbyder et sæt værktøjer, der lader modellen interagere med omverdenen: søgning efter information i realtid, analyse af data på sociale medier eller kørsel af Python-kode. For at udnytte disse funktioner skal du forstå, hvordan de er organiseret.
Grok API skelner mellem to grundlæggende kategorier af værktøjer. Denne sondring afgør, hvem der udfører værktøjet, hvor behandlingen finder sted, og hvad du skal administrere som udvikler.
Indbyggede værktøjer — Serverside
Indbyggede værktøjer kører direkte på xAI’s servere. Når modellen beslutter at bruge et af disse værktøjer, sker eksekveringen automatisk og transparent. Du behøver ikke at administrere nogen infrastruktur eller behandle mellemresultater.
Her er de fem tilgængelige indbyggede værktøjer:
- Web Search (
web_search): Websøgning i realtid med filtrering af domæner og automatiske kildehenvisninger - X Search (
x_search): Søgning på X/Twitter med filtrering af konto og dato - Code Execution (
code_interpreter/code_execution): Kørsel af Python-kode i et sikkert, isoleret sandkassemiljø - Collections Search (
collections_search/file_search): Søgning i dokumenter, du tidligere har uploadet - Remote MCP (
mcp): Opret forbindelse til eksterne MCP-servere (Model Context Protocol)
For at aktivere et indbygget værktøj skal du blot tilføje det til tools-arrayet i din anmodning:
{
"tools": [{"type": "web_search"}]
}
Funktionskald — Clientside
Funktionskald fungerer anderledes. Du definerer brugerdefinerede funktioner, som modellen kan kalde. Men i modsætning til indbyggede værktøjer er det din kode på clientsiden, der udfører funktionen og returnerer resultatet til modellen.
Flowet ser således ud:
- Du beskriver dine funktioner (navn, parametre, beskrivelse) i anmodningen
- Modellen analyserer brugerens forespørgsel
- Hvis den konkluderer, at en funktion er nødvendig, returnerer den et funktionskald med argumenter
- Din kode udfører funktionen (API-kald, databaseforespørgsel, beregning osv.)
- Du sender resultatet tilbage til modellen
- Modellen formulerer sit endelige svar
Denne tilgang giver dig fuld kontrol: Du beslutter, hvad dine funktioner gør, hvilke data de håndterer, og hvordan de kobles til din infrastruktur.
Hvornår skal du bruge hvilken kategori?
Indbyggede værktøjer er ideelle, når du har brug for adgang til information i realtid (web, sociale medier) eller skal udføre beregninger uden at administrere infrastruktur. Funktionskald er at foretrække, når du skal interagere med dine egne systemer: interne databaser, forretnings-API’er eller enhver tjeneste, der er specifik for din applikation.
Du kan kombinere begge kategorier i en enkelt anmodning. Du kan f.eks. aktivere Web Search, mens du definerer en brugerdefineret funktion, der gemmer resultaterne i din database.
Vigtige pointer
- Grok API tilbyder to kategorier af værktøjer: indbyggede værktøjer (udført af xAI) og Funktionskald (udført af din kode)
- Indbyggede værktøjer kræver ingen infrastruktur på clientsiden
- Funktionskald giver fuld kontrol, men kræver mere udviklingsarbejde
- Begge kategorier kan kombineres i en enkelt anmodning
- Dette kursus fokuserer på de tre vigtigste indbyggede værktøjer: Web Search, X Search og Code Execution