Списание и возврат

Отметка после вызова модели, которая показывает, где рассчитывается его холд, — Slen рассчитывает холд сам, с узлом или без него.

2 мин чтения

Списание и возврат отмечает шаг, на котором рассчитывается холд вызова модели: то, во что обошёлся вызов, списывается, а остаток холда возвращается. Slen рассчитывает холд сам после вызова — есть этот узел во флоу или нет.

Узел
Списание и возврат
Тип
capture_release
Категория
Деньги
Порты
  • По умолчанию default подключение обязательно
Завершает путь
Нет

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

Узел стоит сразу после AI-модель, на его порту Успех. Когда выполнение проходит его, узел пишет в трассировку событие captured вызова с токенами вызова и пропускает выполнение дальше через По умолчанию.

Само списание делается в фоне, после того как провайдер ответил. Во что обошёлся вызов, становится известно вскоре после конца выполнения: это cost.actual выполнения. Когда вызов не удался или отклонён, его холд возвращается ещё до того, как выполнение выходит из узла модели, и до этого узла выполнение не доходит.

Узел также забирает себе стоимость вызова в метриках конструктора: когда узел есть во флоу, стоимость считается на нём, а без него — на узле модели. Попытки вызова остаются под узлом модели.

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

  • Чтобы показать на холсте и в трассировке, где рассчитываются деньги вызова.

  • Чтобы видеть стоимость вызова на отдельном узле в метриках конструктора.

  • Узел не решает, списывается вызов или возвращается, и флоу не нужен узел, чтобы холд был рассчитан.

Настройки

Настроек у узла нет.

Порты

У узла один порт, По умолчанию, и он обязательный.

Выход

JSON
{ "captured": true, "cost": "0.00048000" }

cost — это то, во что был оценён вызов, — сумма, на которую взят его холд, до множителя запаса, — а не то, что списано. Во что обошёлся вызов, — это cost.actual выполнения, когда списание сделано.

Ошибки

Своих ошибок узел не выдаёт, и проверять в его настройках нечего. Его место проверяется при публикации флоу: каждая связь, которая приходит в узел, идёт от порта Успех узла AI-модель. Любая другая — это misplaced_finance_node — Финансовая цепочка.

Пример

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

AI-модель резервирует деньги и вызывает модель. На его ответе выполнение проходит Списание и возврат, который пишет событие captured, а Вернуть ответ отвечает вызывающему. Холд списывается в фоне, а следом приходит cost.actual выполнения.

Собрано из openapi b070e1f, sdk contract 264812e, php ae4a53b, node 84bc62d, python 2370f9a