slen.ai
Почати

Що SDK робить для вашого застосунку

PHP

Що ваш застосунок робить через SDK — запускає флоу, чекає на них, веде клієнтів та їхні кредити, перевіряє вебхуки, — і що SDK робить сам під час кожного виклику.

3 хв читання

SDK — це код вашого застосунку, який працює зі Slen. Він запускає флоу вашого проєкту й читає, чим вони закінчилися, веде ваших клієнтів та їхні кредити й перевіряє вебхуки, які надсилає Slen. Slen має SDK для PHP і SDK для Node.js. Обидва звертаються до одного API, і виклики в них однакові.

Що з ним роблять

ЗавданняВикликиДокладніше
Запустити флоуoperations.execute(), operations.executeAsync()Надіслати запит
Дочекатися запуску й прочитати його трасуванняexecutions.wait(), executions.get(), executions.trace()Асинхронні запуски й очікування
Вести клієнтів та їхні кредитиcustomers.create(), customers.topUp(), customers.charge(), customers.entries()Клієнти та кредити
Приймати вебхукиwebhooks.constructEvent()Вебхуки

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

Що SDK робить сам

  • Він називає кожну одиницю роботи. Запуск і рух кредитів несуть ключ ідемпотентності, і SDK створює його, коли ви не передали свій. На повтор під вашим ключем відповідають, а не виконують його знову — Ключі ідемпотентності.

  • Він надсилає запит ще раз, коли це безпечно: коли відповіді не було, після 429 або 503, під тим самим ключем. 500, 502 і 504 він не повторює ніколи, бо провайдерові могли вже заплатити — Повтори й тайм-аути.

  • Він кидає свій тип помилки для кожного коду, той самий в обох SDK. Тип каже, чи могли бути витрачені гроші — Обробка помилок.

  • Він чекає на запуск у темпі, про який просить API — Асинхронні запуски й очікування.

  • Він пише журнал і спани в логер і записувач, які ви йому дали: маршрут, статус, ідентифікатори й гроші, але ніколи ключ, тіло чи промпт — Журнал, Спани.

Що лишається в консолі

Люди робочого простору налаштовують у консолі:

  • флоу та їхні версії, бюджети, політики, підключення провайдерів і пули, API-ключі, учасників;

  • ціни операцій у кредитах, які читає customers.prices();

  • вебхуки та їхні секрети підпису, на сторінці Вебхуки;

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

API-ключ зберігається на вашому сервері й ніколи не потрапляє до браузера. Випустіть його на сторінці Ключі та доступ.

PHP і Node.js

Два SDK мають однакові виклики, однакові типи помилок, однаковий журнал і однакові спани. PHP SDK постачається з інтеграцією для Laravel. Node.js SDK читає ключ із SLEN_API_KEY і надсилає спани в OpenTelemetry. Стаття PHP і Node.js порівнює їх.

Кожен виклик SDK, який доходить до Slen, — звичайний HTTP-запит API. Стаття Встановлення показує запит запуску через HTTP.

Що читати далі