Запрос

Запрос — то место, где флоу начинается. Сюда приходит запрос к флоу, и узел передаёт его вход следующему узлу.

Что делает узел

Запрос называет код операции, и флоу, привязанный к этому коду, выполняется с этого узла. Узел передаёт вход запроса дальше таким, каким он пришёл, и выходит через По умолчанию. Он ничего не проверяет и ничего не тратит.

• Во флоу ровно один входной узел. Когда он стоит на холсте, палитра выключает его строку.

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

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

Отправить запрос показывает запрос со стороны приложения: код операции, вход и контекст.

Когда использовать

С него начинается каждый флоу, и он есть в каждом шаблоне галереи.

У входа нет схемы. Первую проверку делает первый узел 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: к коду операции не привязан ни один флоу, или у привязанного флоу нет опубликованной версии, или он в архиве.

Пример

Условие проверяет, что input.messages существует. Запрос без них отклоняет Отклонить запрос до вызова модели; на любой другой отвечает Вернуть ответ тем, что сказала модель.

См. также

• Контекст выполнения и пути — что лежит во входе, контексте и выходах узлов.

• Отправить запрос — запрос, который начинает выполнение.

• Как устроен флоу — входной узел среди остальных узлов.

• AI-модель — узел, который берёт сообщения из input.messages.