Lanka Документація Ланки

ШІ

Питає модель Claude, ChatGPT чи Gemini і записує відповідь у змінну. Людині крок сам нічого не пише: відповідь можна показати наступним кроком через токен.

Коли використовувати

  • Відповісти на вільне запитання людини.
  • Зрозуміти, чого хоче людина, і повести діалог потрібною гілкою.
  • Витягти з тексту ім'я, адресу чи замовлення у вигляді JSON.

Як налаштувати

  1. Ключ API. Крок питає модель вашим ключем, тож за запити платите ви напряму провайдеру. Ключ додається в «Налаштування → Секрети» під такою назвою: ANTHROPIC_API_KEY для Claude, OPENAI_API_KEY для ChatGPT, GEMINI_API_KEY для Gemini. Поки ключа немає, форма кроку про це попереджає.
  2. Спитати. Оберіть провайдера і модель. Якщо модель не обрано, крок питає типову модель провайдера. Можна вписати назву будь-якої моделі, яку знає провайдер.
  3. Запитання. Текст для моделі. Токени підставляються значеннями змінних.
  4. Як відповідати. Необов'язкові вказівки для моделі: роль, тон, правила. Токени тут теж працюють.
  5. Поки думає. Повідомлення, яке людина бачить одразу, поки модель думає. Наступне повідомлення бота з'явиться на його місці: відповідь або повідомлення гілки помилки. Новий крок пише тут 🤔, і Telegram показує одне емодзі великим і анімованим. Порожнє поле — без повідомлення, лише «друкує…».
  6. Пам'ять. Скільки останніх повідомлень людини й бота модель побачить перед запитанням, до 50. Можна обмежити їх годинами: тоді старші повідомлення не потраплять. Так модель пам'ятає, про що вже йшла розмова. 0 — без пам'яті: кожне запитання модель бачить як перше.
  7. Зберегти в. Змінна для відповіді, поруч формат: «текстом» або «як JSON». JSON буде записано як об'єкт, і його поля можна читати окремо.

Як записати текстову відповідь, вирішує назва змінної. Якщо вона закінчується на _html, як answer_html у новому кроці, відповідь буде з форматуванням Telegram: жирним, курсивом, списками, посиланнями й кодом. Токен такої змінної в повідомленні покаже відповідь так, як її оформила модель. В іншу змінну відповідь записується простим текстом, без позначок форматування: так зручніше порівнювати її в умовах.

Важливо

Поки модель думає, людина бачить «друкує…». Модель має до 60 секунд на відповідь.

Якщо запит не вдався, діалог піде гілкою «Модель не відповіла». Так буває, коли немає ключа, провайдер повернув помилку, модель не встигла за 60 секунд, відповідь порожня або JSON не вдалося розібрати. Без цієї гілки людина отримає повідомлення «Щось пішло не так», а вам прийде причина помилки.

Невдалий запит крок не повторює.