Запит

Вхідний вузол флоу — місце, куди приходить запит і звідки його вхід передається наступному вузлу.

2 хв читання

Запит — те місце, де флоу починається. Сюди приходить запит до флоу, і вузол передає його вхід наступному вузлу.

Вузол
Запит
Тип
sdk_request
Категорія
Вхід
Порти
  • Типовий default підключення обовʼязкове
Завершує шлях
Ні

Що робить вузол

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

  • У флоу рівно один вхідний вузол. Коли він стоїть на полотні, палітра вимикає його рядок.

  • Запит, надісланий в асинхронному режимі, приймається до того, як вузол виконається. Потім обробник починає виконання тут.

  • Контекст виклику не проходить через вузол: кожен вузол читає його за своїм шляхом. Контекст виконання та шляхи каже, що лежить у коренях.

Надіслати запит показує запит із боку застосунку: код операції, вхід і контекст.

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

З нього починається кожен флоу, і він є в кожному шаблоні галереї.

Вхід не має схеми. Першу перевірку робить перший вузол AI-модель, до якого доходить виконання: без непорожнього input.messages виконання закінчується з invalid_flow_input, а вузли до моделі на цей момент уже виконалися. Щоб відхилити запит без input.messages раніше, ніж виконається щось іще, поставте одразу після вхідного вузла Умова з оператором існує на цьому шляху і ведіть його Не виконано у Відхилити запит.

Налаштування

Вузол не має налаштувань.

Порти

Вузол має один порт, Типовий, і він обов’язковий. Флоу, в якому він нікуди не веде, не публікується. Жоден зв’язок не може вести у вхідний вузол: полотно не дає його провести.

Вихід

Вихід вузла — вхід запиту без змін. Наступний вузол читає nodes.<key>.output.<name>, де <key> — ключ цього вузла, — те саме значення, що й input.<name>.

Помилки

Власних помилок вузол не кидає. Два коди перевірки під час публікації стосуються його: no_entry_node, коли у флоу його немає, і multiple_entry_nodes, коли їх більше одного.

На запит, який не знайшов флоу для виконання, приходить 404 з кодом flow_not_found: до коду операції не прив’язано жодного флоу, або прив’язаний флоу не має опублікованої версії, або він в архіві.

Приклад

  • Запит — Типовий → Умова
  • Умова — Виконано → AI-модель
  • Умова — Не виконано → Відхилити запит
  • AI-модель — Успіх → Повернути відповідь

Умова перевіряє, що input.messages існує. Запит без них відхиляє Відхилити запит до виклику моделі; на будь-який інший відповідає Повернути відповідь тим, що сказала модель.

Зібрано з openapi b070e1f, sdk contract 5cc7055, php ae4a53b, node 84bc62d