Як налаштувати параметри MCP-інструменту сценарію

Якщо ви хочете, щоб AI-асистент при виклику секції міг передавати дані (наприклад, місто, дату, ідентифікатор), потрібно описати ці параметри в налаштуваннях MCP Tool і використовувати їх у логіці секції. Ця інструкція описує лише дії в сценарії та Конструкторі — без технічних деталей реалізації.

Коли знадобиться

  • Потрібно, щоб AI передавав значення при виклику інструменту (наприклад, місто для погоди, валюта для курсу).
  • Секція вже налаштована як MCP Tool, і ви хочете додати або змінити вхідні параметри.
  • Потрібно використовувати передані значення в повідомленнях, умовах або діях секції.

Що важливо знати

  • Input Schema — це перелік параметрів інструменту (назва, тип, обов’язковість, опис). Їх заповнюють у налаштуваннях тригера MCP Tool на ноді Старт секції.
  • Параметри, які ви додали в Input Schema, під час виклику MCP-інструменту заповнюються значеннями від AI-клієнта.
  • Ці значення доступні в сценарії: їх можна використовувати в текстах повідомлень, умовах та параметрах дій так само, як інші змінні сценарію (через підстановки за назвою параметра).

Перед початком

Покрокова інструкція

1. Додати або змінити параметри в Input Schema

  1. Перейдіть до модуля Сценарій через Меню -> Сценарій, відкрийте сценарій бота і виберіть секцію, яка є MCP-інструментом.
  2. Клацніть на ноду Старт (точку входу) цієї секції — справа відкриється панель налаштувань.
  3. У блоці налаштувань тригера MCP Tool знайдіть розділ Input Schema (схема вхідних параметрів).
  4. Додайте параметр: натисніть кнопку додавання параметра (якщо вона є) або заповніть форму для нового параметра.
  5. Для кожного параметра вкажіть:
    • Назва — ім’я параметра латиницею (наприклад, city, currency, date). Саме за цією назвою ви зможете використовувати значення в сценарії.
    • Тип — тип даних (рядок, число, логічний тощо), щоб AI-клієнт і платформа коректно перевіряли значення.
    • Обов’язковий — чи потрібно обов’язково передавати цей параметр при виклику.
    • Значення за замовчуванням (за потреби) — значення, яке використовуватиметься, якщо AI не передасть параметр.
    • Опис (за потреби) — короткий опис для AI, щоб було зрозуміло, що передавати.
  6. Повторіть кроки 4–5 для всіх параметрів, які має приймати інструмент.
  7. Збережіть зміни сценарію.

Після збереження платформа надасть ці параметри AI-клієнту; при виклику інструменту передані значення потраплять у сценарій.

2. Використати параметри в сценарії

Значення, які AI передав при виклику, доступні в межах цієї секції. Їх можна використовувати в усіх місцях, де редактор сценарію підтримує підстановки змінних.

  1. У текстах повідомлень — у нодах типу «Повідомлення» у текст можна додати підстановку значення параметра за його назвою з Input Schema (формат підстановки залежить від редактора; зазвичай це поле з підказкою або список доступних змінних).
  2. У умовах — у нодах умов можна порівнювати значення параметра з константою або іншою змінною і керувати переходом по гілках.
  3. У діях (actions) — у параметрах дій можна підставити значення параметра (наприклад, передати його в URL запиту або в тіло дії).

Порада: назви параметрів у підстановках мають збігатися з тими, що ви вказали в Input Schema. Якщо параметр називається city, у сценарії посилайтеся на нього за цією ж назвою.

3. Перевірити роботу

  1. У AI-клієнті (наприклад, Cursor) викличте інструмент і передайте тестові значення для параметрів.
  2. Переконайтеся, що відповідь секції містить очікувані дані і що в повідомленнях або результатах видно передані значення (якщо ви їх туди підставили).
  3. Якщо значення не з’являються — перевірте, що назви параметрів у Input Schema і в підстановках у сценарії збігаються і що зміни сценарію збережені.

Що далі

  • Додайте або змініть параметри в Input Schema при зміні логіки інструменту, щоб AI завжди передавав потрібні дані.
  • Використовуйте опис параметрів у Input Schema — це допомагає AI-клієнту коректно формувати виклики.

Пов’язані статті