Zbuduj definicję narzędzia, które model AI może wywołać, z jego nazwą, opisem i parametrami. Wyeksportuj ją jako zwykły JSON Schema albo w kształtach, jakich oczekują popularne API wywoływania narzędzi i serwery MCP, i zobacz problemy, zanim model się o nie potknie. Działa w przeglądarce, jest darmowe i prywatne.
Jak zbudować definicję narzędzia
- Podaj Nazwę narzędzia i jasny Opis.
- Naciśnij Dodaj parametr dla każdego wejścia i ustaw jego nazwę, typ, opis oraz czy jest wymagane.
- Naciśnij Dodaj kolejne narzędzie, aby mieć więcej niż jedno, lub Usuń to narzędzie, aby usunąć jedno. Zacznij od nowa czyści wszystko.
- Wybierz dane wyjściowe: JSON Schema, jeden z formatów dostawców albo MCP. Włącz Tryb ścisły (ustrukturyzowane wyniki), jeśli go potrzebujesz.
- Naciśnij Kopiuj JSON lub Pobierz. Kopiuj przykładowe argumenty daje przykładowe wywołanie.
Masz już definicję? Wklej ją w JSON do importu i naciśnij Importuj.
Pisanie narzędzi, których modele dobrze używają
Modele wybierają narzędzie, czytając jego nazwę i opis, więc napisz wprost, co robi i kiedy go używać, na przykład „Przeszukaj centrum pomocy. Użyj, gdy użytkownik pyta, jak coś zrobić w aplikacji.” Opisz każdy parametr, w tym jednostki i formaty, takie jak „data ISO, YYYY-MM-DD”. Używaj stałej listy dozwolonych wartości, gdy wybór jest ograniczony, i oznaczaj jako wymagane tylko pola naprawdę potrzebne.
Czym różnią się formaty
Schemat parametrów jest wszędzie tym samym JSON Schema; zmienia się opakowanie. Jeden dostawca zagnieżdża go pod function.parameters, inny nazywa go input_schema, inny wypisuje deklaracje funkcji, a serwery MCP zwracają inputSchema. Tryby ścisłe dodają reguły: każda właściwość musi być wypisana jako wymagana, a dodatkowe właściwości muszą być odrzucane, więc pola opcjonalne są zapisywane jako dopuszczające null.
Co wychwytują kontrole
Nazwy łamiące reguły API, takie jak spacje lub ponad 64 znaki, zduplikowane nazwy narzędzi lub parametrów, dozwolone wartości niepasujące do typu, obiekty bez właściwości i brakujące opisy. Błędy zatrzymają wywołanie API; ostrzeżenia to rzeczy, które zwykle sprawiają, że model wybiera złe narzędzie lub wypełnia złą wartość.
Wskazówki
- Używaj krótkich nazw opartych na czasownikach, takich jak search_orders lub get_weather, tylko z liter, cyfr i podkreślników.
- Utrzymuj małą liczbę narzędzi. Modele lepiej wybierają z krótkiej listy.
- Daj każdemu parametrowi przykład w opisie, gdy format nie jest oczywisty.
- Przetestuj schemat na prawdziwych odpowiedziach za pomocą sprawdzania schematu odpowiedzi AI.
Kto z tego korzysta
Programiści, freelancerzy budujący asystentów dla klientów i uczniowie uczący się, jak działa wywoływanie narzędzi. Aby zamienić przykładowy obiekt JSON na typy do kodu, zobacz JSON na typy.
Pytania
Czym jest tryb ścisły?
Sprawia, że model dokładnie przestrzega schematu. Wymaga, by każda właściwość była oznaczona jako wymagana, a dodatkowe właściwości były odrzucane.
Czy moja definicja jest przesyłana?
Nie. Jest budowana w Twojej przeglądarce.
Czy mogę edytować istniejącą definicję?
Tak. Wklej ją w polu importu, zmień i wyeksportuj ponownie.