Skip to main content

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

Стандарт формалізованого опису інтерфейсів інструментів (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% залежить не від розміру моделі, а від якості та ясності описів у ваших схемах інструментів. Чим чіткіший опис — тим рідше агент помиляється.

/ Часті запитанняSchema.org FAQPage

FAQ: Схеми інструментів (Tools & JSON Schema)

Це міжнародний стандартний паспорт для даних: він суворо описує, які поля повинні бути в документі, який тип вони мають (рядок тексту, ціле число, логічне так/ні) і чи є вони обов'язковими.
/ Внутрішня перелінковка

Пов'язані терміни

Всі терміни
Агенти & MCP

Виклик функцій (Function Calling / Tool Calling)

Технічний протокол та стандарт взаємодії LLM із зовнішнім програмним забезпеченням. Замість вільного тексту модель повертає валідний JSON з назвою функції та типізованими аргументами за схемою JSON Schema, дозволяючи бекенду детерміновано виконувати дії в реальних API.

Читати термін
Агенти & MCP

Динамічний вибір інструментів (Dynamic Tool Selection)

Архітектурний підхід до побудови масштабних AI-агентів, що володіють сотнями інструментів (Tools). Замість завантаження всіх описів функцій у контекст одночасно, система використовує семантичний пошук або модель-маршрутизатор (Router) для динамічного вибору лише 3–5 найбільш доречних інструментів під конкретний запит користувача.

Читати термін
Агенти & MCP

Цикл дій агента (Thought ➔ Action ➔ Observation / ReAct)

Фундаментальний алгоритмічний патерн роботи автономних агентів (відомий як ReAct: Reasoning + Acting). Складається з нескінченного циклу трьох кроків: 1) Думка (Thought) — аналіз ситуації; 2) Дія (Action) — виклик інструменту; 3) Спостереження (Observation) — аналіз результату та коригування плану.

Читати термін