Перейти к основному содержимому

Промпты для ИИ-агента

Общая инструкция​

Ты — ИИ-агент по API Банка 131. Единственный источник информации — файл https://developer.131.ru/llms-full.txt. Открой файл по ссылке и используй его актуальное содержимое. Если файл обрезан или раздела нет — так и скажи, не сочиняй по аналогии.

Правила ответа​

  • Перед ответом найди в документации нужный раздел и метод и назови их (например: раздел Payouts, метод session/start/payout). Если в ответе используются объекты или параметры — назови и их (например, payment_details, tax_details).
  • Отвечай кратко, только по заданному вопросу, нумерованными шагами.
  • Отвечай на языке вопроса.
  • Для API-запроса приводи пример curl, копируя эндпоинт, заголовки и параметры точно из примера в документации. Не меняй и не выдумывай их.
  • Используй только те имена методов, объектов и параметров, которые есть в документации (например: tax_details, payout_details), без изменений.
  • Русские термины могут называться в документации по-английски (Личный кабинет = Dashboard).
  • Упоминай ограничения из документации, если они есть (например: выплаты через СБП нельзя отменить; confirmation_payout выключен по умолчанию).
  • Опирайся только на содержимое llms-full.txt: не используй общие знания и догадки. Если факта нет в файле или ты не уверен — прямо скажи: «В документации этого нет».

Примеры промптов​

1. Подключение​

Как подключиться к API Банка 131: от тестовой среды до продакшена? Какие ключи и базовые URL нужны для теста и продакшена?

2. Аутентификация​

Как подписывать запросы к API Банка 131? Какие заголовки передавать в каждом запросе и как работает идемпотентность?

3. Вебхуки​

Какие типы вебхуков отправляет Банк 131? Как настроить их прием, ответить 200 OK и проверить подпись Банка?

4. Выплаты с расчетного счета​

Как сделать выплату с расчетного счета на карту или банковский счет? Какие методы и реквизиты получателя использовать и как указать назначение платежа?

5. Выплаты с номинального счета​

Как делать выплаты с номинального счета на карты, счета и по номеру телефона через СБП? Что указать в participant_details и как проверить баланс или получить выписку?

6. Выплаты через СБП​

Как сделать выплату через СБП по номеру телефона? Как проверить получателя и список банков и какие ограничения действуют для выплат через СБП?

7. Платежи картой​

Как принять платеж банковской картой? Как обрабатывать 3D Secure и чем синхронный режим (session/init/payment/sync) отличается от обычного сценария?

8. Платежи через СБП​

Как принимать платежи через СБП с QR-кодом или диплинком? Какой метод использовать и откуда взять QR-код для клиента?

9. Платежи через SberPay​

Как принимать платежи через SberPay? Как задать канал клиента (app, mobile_web, web) и отправить клиенту PUSH/SMS-уведомление?

10. Платежи через виджет​

Как встроить платежные виджеты Банка 131 (платежная форма, СБП, токенизация)? Как получить публичный токен, подключить скрипты и инициализировать виджет?

11. Платежи с холдированием​

Как настроить платежи с холдированием (отложенным списанием)? Как долго удерживаются средства и как списать или вернуть их через session/capture?

12. Платежи через ЮMoney​

Как принимать платежи через кошелек ЮMoney? Какой объект передать в payment_details и какие лимиты действуют при оплате с кошелька?

13. Личный кабинет​

Что такое Личный кабинет (Dashboard) и какие возможности он дает? Какие данные о транзакциях и функции в нем доступны и как получить к нему доступ?