Повернути відповідь

Кінцевий вузол, який завершує виконання статусом completed і відповідає тому, хто викликає, — тим, що сказала модель, входом, фіксованим об’єктом або виходом вузла.

3 хв читання

Повернути відповідь завершує шлях відповіддю. Виконання, яке до нього дійшло, отримує статус completed, а той, хто викликає, отримує в output відповідь, на яку налаштовано вузол.

Вузол
Повернути відповідь
Тип
return_response
Категорія
Вихід
Порти
Немає
Завершує шлях
Так

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

Вузол бере відповідь зі свого джерела, робить її output виконання і завершує виконання статусом completed. Після нього нічого не виконується.

Відповісти за допомогоюВідповідь
Останній вивід моделіОстання відповідь на шляху: те, що відповів останній вузол AI-модель, або збережена відповідь вузла Пошук у кеші, який влучив, — залежно від того, що було пізніше. Якщо на шляху немає ні того, ні іншого, — порожній об’єкт
Вхід запитуВхід запиту, яким він прийшов
Фіксоване значенняОб’єкт, збережений у вузлі
Вихід вузлаВесь вихід обраного вузла — найчастіше те, що склав Перетворення

Коли відповідь — збережена відповідь вузла Пошук у кеші, який влучив, виконання несе cache.hit, що дорівнює true. Відповідь моделі, викликаної після влучання, оплачено, і cache.hit дорівнює false.

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

Тут закінчується кожен шлях, який відповідає тому, хто викликає. Шлях, який відмовляє, закінчується натомість у Відхилити запит. У флоу може бути по кілька тих та інших: по одному на кожен спосіб завершення.

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

НалаштуванняДля чого воно
sourceЗвідки береться відповідь — last_model_output, остання відповідь моделі на шляху; input, вхід запиту; literal, об’єкт із value; node, вихід вузла з node_key. Вузол без source відповідає останнім виводом моделі.
valueОб’єкт, яким вузол відповідає, коли source — literal. Задається через API.
node_keyКлюч вузла, весь вихід якого стає відповіддю, коли source — node; це інший вузол флоу, не кінцевий.

У конструкторі налаштування — Відповісти за допомогою. Новий вузол відповідає останнім виводом моделі. Фіксоване значення задається через API: конструктор його не редагує. Із джерелом Вихід вузла вузол називає інший вузол за ключем:

JSON
{ "source": "node", "node_key": "build" }

Порти

Вузол не має портів: він завершує шлях. Порти й розгалуження каже, чому кожен шлях закінчується в кінцевому вузлі.

Вихід

Відповідь — це output виконання, те, що читає Надіслати запит. Відповідь без ключів доходить до того, хто викликає, як {}.

Помилки

Помилок вузол не кидає. Коли він відповідає виходом вузла, через який виконання не пройшло, відповідь — порожній об’єкт, а подія warning у трасуванні називає шлях.

JSON
{ "type": "warning", "node_key": "answer", "payload": { "reason": "unknown_path", "paths": ["nodes.build.output"] } }

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

В API запис issues називає таку перевірку в params.detail; його code — invalid_node_config.

ПеревіркаПовідомлення в конструкторі
return_unsupported_source«{node}» відповідає з джерела, якого не існує.
return_literal_not_object«{node}» відповідає фіксованим значенням, і це значення має бути обʼєктом.
return_needs_node«{node}» відповідає виходом вузла і має назвати інший вузол флоу.
return_unknown_node«{node}» відповідає виходом вузла «{ref}», але вузла «{ref}» у флоу немає.
return_terminal_node«{node}» відповідає виходом вузла «{ref}», але «{ref}» сам завершує флоу і ніколи не виконується раніше за цю відповідь. Назвіть вузол, який виконується раніше.

Приклад

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

Повернути відповідь відповідає тим, що сказала модель, і виконання отримує статус completed. Відмовлений виклик іде в Відхилити запит, і таке виконання отримує статус rejected.

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