Списание и возврат
Отметка после вызова модели, которая показывает, где рассчитывается его холд, — Slen рассчитывает холд сам, с узлом или без него.
2 мин чтения
Списание и возврат отмечает шаг, на котором рассчитывается холд вызова модели: то, во что обошёлся вызов, списывается, а остаток холда возвращается. Slen рассчитывает холд сам после вызова — есть этот узел во флоу или нет.
- Узел
- Списание и возврат
- Тип
capture_release- Категория
- Деньги
- Порты
- По умолчанию
defaultподключение обязательно
- По умолчанию
- Завершает путь
- Нет
Что делает узел
Узел стоит сразу после AI-модель, на его порту Успех. Когда выполнение проходит его, узел пишет в трассировку событие captured вызова с токенами вызова и пропускает выполнение дальше через По умолчанию.
Само списание делается в фоне, после того как провайдер ответил. Во что обошёлся вызов, становится известно вскоре после конца выполнения: это cost.actual выполнения. Когда вызов не удался или отклонён, его холд возвращается ещё до того, как выполнение выходит из узла модели, и до этого узла выполнение не доходит.
Узел также забирает себе стоимость вызова в метриках конструктора: когда узел есть во флоу, стоимость считается на нём, а без него — на узле модели. Попытки вызова остаются под узлом модели.
Когда использовать
Чтобы показать на холсте и в трассировке, где рассчитываются деньги вызова.
Чтобы видеть стоимость вызова на отдельном узле в метриках конструктора.
Узел не решает, списывается вызов или возвращается, и флоу не нужен узел, чтобы холд был рассчитан.
Настройки
Настроек у узла нет.
Порты
У узла один порт, По умолчанию, и он обязательный.
Выход
{ "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