Narzędzia wbudowane w API Responses
Na tej stronie
Dodawanie możliwości do modelu
Modele Grok nie ograniczają się tylko do generowania tekstu. Dzięki parametrowi tools możesz udostępnić im narzędzia, które znacznie rozszerzają ich możliwości: wyszukiwanie w internecie w czasie rzeczywistym, przeszukiwanie serwisu X (dawniej Twitter), wykonywanie kodu Python oraz Twoje własne funkcje niestandardowe.
Cztery typy narzędzi
web_search
Pozwala modelowi wyszukiwać informacje w internecie w czasie rzeczywistym:
{
"model": "grok-4.20-0309-reasoning",
"input": "What's the latest news on AI in Europe?",
"tools": [{"type": "web_search"}]
}
Model automatycznie decyduje, kiedy przeprowadzić wyszukiwanie. Wyniki są integrowane z jego odpowiedzią wraz z cytowaniami.
x_search
Wyszukuje wpisy w serwisie X (dawniej Twitter):
{
"model": "grok-4.20-0309-reasoning",
"input": "What is the tech community saying about the latest iPhone?",
"tools": [{"type": "x_search"}]
}
Narzędzie to jest szczególnie przydatne do wychwytywania opinii publicznej, trendów i reakcji na bieżąco.
code_interpreter
Wykonuje kod Python po stronie serwera w celu przeprowadzenia obliczeń, analizy danych lub tworzenia wykresów:
{
"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"}]
}
Model pisze kod w języku Python, wykonuje go na serwerach xAI i integruje wyniki ze swoją odpowiedzią.
function
Twoje własne funkcje, które model może wywołać. Model generuje argumenty, ale Twój kod wykonuje funkcję:
{
"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"]
}
}]
}
Łączenie wielu narzędzi
W jednym żądaniu możesz przekazać do 128 narzędzi. Model wybiera to (lub te), które najlepiej pasują:
{
"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"}
]
}
W tym przykładzie model może najpierw użyć web_search, aby znaleźć wyniki, a następnie code_interpreter, aby sformatować je w tabelę.
Narzędzia po stronie serwera a po stronie klienta
Rozróżnienie to jest fundamentalne:
-
Narzędzia po stronie serwera (
web_search,x_search,code_interpreter): Automatycznie wykonywane przez serwery xAI. Nie musisz nic robić – model uruchamia wyszukiwanie lub kod, pobiera wynik i integruje go ze swoją odpowiedzią. -
Narzędzia po stronie klienta (
function): Model generuje wywołanie funkcji z argumentami, a następnie wstrzymuje generowanie. Twój kod wykonuje funkcję, a Ty odsyłasz wynik w nowym żądaniu.
Różnica ta ma bezpośredni wpływ na architekturę Twojej aplikacji, co zobaczysz w kolejnych lekcjach.
Kluczowe wnioski
- Cztery typy narzędzi:
web_search,x_search,code_interpreter,function - Pierwsze trzy działają po stronie serwera – nie wymagają żadnej infrastruktury z Twojej strony
- Narzędzia typu
functiondziałają po stronie klienta – Twój kod obsługuje ich wykonanie - Możesz łączyć do 128 narzędzi w jednym żądaniu
- Model automatycznie decyduje, kiedy i których narzędzi użyć