Skip to main content

Schematy narzędzi (Tools & JSON Schema)

DLA AGENTÓW AIChatGPTClaude

Standard formalnego opisu interfejsów narzędzi (Tools) dla dużych modeli językowych przy użyciu standardu JSON Schema. Obejmuje nazwę funkcji, szczegółowy opis tekstowy jej przeznaczenia, listę wymaganych parametrów oraz typy wartości.

1. Przegląd koncepcji i przeznaczenia

Wyobraź sobie, że zatrudniłeś nowego asystenta w biurze i powiedziałeś mu: „Oto nasza specjalna aplikacja, korzystaj z niej”. Ale nie wyjaśniłeś, co robią poszczególne przyciski ani jakie pola należy wypełnić. Naturalnie, asystent będzie zagubiony.

Aby model językowy wiedział, jakimi cyfrowymi narzędziami dysponuje, programiści przekazują mu Schemat Narzędzia (Tool Schema).

Jest to zwięzły opis sporządzony zgodnie ze standardem JSON Schema:

  • Nazwa (Name): krótka nazwa akcji (np. book_hotel).
  • Opis (Description): cel działania wyrażony ludzkim językiem.
  • Parametry (Parameters): dane niezbędne do uruchomienia funkcji (miasto, data zameldowania, liczba gości).

Model mentalny: instrukcja stanowiskowa dla AI – lista narzędzi na pasie rzemieślnika z jasnym wskazaniem, kiedy użyć młotka, a kiedy śrubokręta.

2. Jak wygląda rzeczywisty schemat narzędzia

{
  "name": "calculate_mortgage",
  "description": "Розраховує щомісячний платіж за іпотечним кредитом.",
  "parameters": {
    "type": "object",
    "properties": {
      "loan_amount": {
        "type": "number",
        "description": "Повна сума кредиту в гривнях, наприклад 1500000"
      },
      "years": {
        "type": "integer",
        "description": "Термін кредиту в роках від 1 до 30"
      },
      "interest_rate": {
        "type": "number",
        "description": "Річна відсоткова ставка у відсотках, наприклад 7.5"
      }
    },
    "required": ["loan_amount", "years"]
  }
}

3. Cztery złote zasady tworzenia dobrego schematu

  1. Pisz opisy tak, jakbyś tłumaczył je stażyście: wskaż nie tylko, co robi narzędzie, ale także kiedy NIE należy go wywoływać.
  2. Podawaj przykłady w polu opisu: „format daty musi być ściśle YYYY-MM-DD, np. 2026-05-18”.
  3. Ograniczaj opcje za pomocą enum: jeśli status zamówienia może przyjmować tylko trzy wartości, zdefiniuj je sztywno: ["pending", "shipped", "delivered"].
  4. Oznaczaj obowiązkowe pola w tablicy required: jeśli funkcja nie może działać bez adresu e-mail klienta, nie pozwalaj modelowi uruchamiać jej „na oślep”.

4. Praktyczny wniosek

Jakość i autonomia Twojego agenta AI w 80% zależy nie od rozmiaru modelu, lecz od jakości i przejrzystości opisów w Twoich schematach narzędzi. Im bardziej precyzyjny opis, tym rzadziej agent popełnia błędy.

/ Najczęściej zadawane pytaniaSchema.org FAQPage

FAQ: Schematy narzędzi (Tools & JSON Schema)

To międzynarodowy standardowy „paszport” dla danych: ściśle określa, jakie pola muszą znajdować się w dokumencie, jaki mają typ (tekst, liczba całkowita, logiczna prawda/fałsz) oraz czy są one obowiązkowe.
/ Linki wewnętrzne

Powiązane pojęcia

Wszystkie hasła
Agenci i MCP

Wywoływanie funkcji (Function Calling / Tool Calling)

Protokół techniczny i standard interakcji LLM z zewnętrznym oprogramowaniem. Zamiast swobodnego tekstu model zwraca poprawny JSON zawierający nazwę funkcji oraz argumenty typowane zgodnie ze schemą JSON Schema, co umożliwia backendowi deterministyczne wykonywanie operacji w rzeczywistych API.

Czytaj hasło
Agenci i MCP

Dynamic Tool Selection

An architectural approach to building large-scale AI agents equipped with hundreds of tools. Instead of loading all function descriptions into the context simultaneously, the system uses semantic search or a router model to dynamically select only the 3–5 most relevant tools for a specific user query.

Czytaj hasło
Agenci i MCP

Cykl działania agenta (Myśl ➔ Działanie ➔ Obserwacja / ReAct)

Fundamentalny wzorzec algorytmiczny pracy autonomicznych agentów (znany jako ReAct: Reasoning + Acting). Składa się z nieskończonej pętli trzech kroków: 1) Myśl (Thought) – analiza sytuacji; 2) Działanie (Action) – wywołanie narzędzia; 3) Obserwacja (Observation) – analiza wyniku i korekta planu.

Czytaj hasło