Схеми інструментів (Tools & JSON Schema)(Схеми інструментів для ШІ: як пояснити нейромережі правила виклику ваших функцій)

1. Огляд концепції та призначення

Уявіть, що ви запросили нового помічника в офіс і сказали йому: «Ось тут у нас є спеціальна програма, користуйся нею». Але не пояснили, які кнопки що роблять і які поля треба заповнювати. Звісно, помічник розгубиться.

Щоб мовна модель знала, якими цифровими інструментами вона володіє, розробники передають їй Схему інструментів (Tool Schema).

Це компактний опис, складений за стандартом JSON Schema:

• Назва (Name): коротке ім'я кнопки (наприклад, book_hotel).
• Опис (Description): навіщо потрібна ця дія людськими словами.
• Параметри (Parameters): які дані потрібні для запуску (місто, дата заїзду, кількість гостей).

Ментальна модель: посадова інструкція для ШІ: список інструментів на поясі майстра із чітким описом, коли використовувати молоток, а коли викрутку.

2. Як виглядає реальна схема інструменту

{
  "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. Чотири золоті правила складання гарної схеми

1. Пишіть опис так, ніби пояснюєте стажеру: вкажіть не лише що робить інструмент, але й коли його НЕ слід викликати.
2. Наводьте приклади у полі опису: «формат дати строго YYYY-MM-DD, наприклад 2026-05-18».
3. Обмежуйте варіанти за допомогою enum: якщо статус замовлення може бути тільки трьох видів, пропишіть строго: ["pending", "shipped", "delivered"].
4. Позначайте обов'язкові поля в масиві required: якщо функція не може працювати без email клієнта, не дозволяйте моделі запускати її наосліп.

4. Практичний висновок

Якість та автономність вашого AI-агента на 80% залежить не від розміру моделі, а від якості та ясності описів у ваших схемах інструментів. Чим чіткіший опис — тим рідше агент помиляється.