Функция: get_rates

Платформа: NextBot
Тип действия: Python-скрипт (для получения данных из API)
Дата обновления: 2026-02-13

📝 Детали функции

Поле Значение
Название функции get_rates
Описание функции Получи актуальные курсы обмена валют. Вызывай эту функцию когда клиент спрашивает о курсах, ценах, стоимости валюты или хочет узнать текущий обменный курс.

⚙️ Параметры функции

Параметров нет. Не нажимать «+ Новый параметр».

Функция не требует входных данных от клиента — она запрашивает все актуальные курсы сразу.

🔔 Реакция на выполнение функции

Выбор Значение
◉ Инструкция для AI Сообщи клиенту актуальные курсы обмена из полученного ответа (переменная result). Отформатируй красиво в виде списка. Спроси в каком городе клиент хочет обменять и предложи рассчитать конкретную сумму.

Как это работает: Python-скрипт отправляет запрос к Supabase API, получает JSON с курсами и записывает его в result. NextBot автоматически передаёт содержимое result AI-агенту вместе с инструкцией выше. AI парсит данные и формирует ответ для клиента.

📋 Сценарий после выполнения

Выбор
◉ Продолжить диалог

⚡ Дополнительные настройки

Настройка Значение
Отключить отложенные сообщения ☐ (не включать)

🎯 Действия → + ДОБАВИТЬ ДЕЙСТВИЕ → Python

⚠️ Почему Python, а не Custom API?
Custom API — это односторонняя отправка данных наружу после выполнения функции. Ответ от API не возвращается в AI-агент.
Python-скрипт позволяет отправить запрос И получить ответ, записав его в переменную result, которая автоматически передаётся AI.

Python-скрипт:

import requests
import json

# Настройки API
url = "https://cvzsgjksswowqgfxvrsb.supabase.co/functions/v1/nextbot-api"

headers = {
    "Content-Type": "application/json",
    "x-bot-key": "eastpay-nextbot-2026"
}

payload = {
    "action": "get_rates"
}

# Отправляем запрос и ПОЛУЧАЕМ ответ
response = requests.post(url, headers=headers, json=payload)

if response.status_code == 200:
    data = response.json()
    result = json.dumps(data, ensure_ascii=False)
else:
    result = f"Ошибка получения курсов: {response.status_code}"

🔄 Схема передачи данных

┌─────────────────────────────────────────────────────┐
│  1. Клиент: «Какой сейчас курс?»                   │
└──────────────────┬──────────────────────────────────┘
                   ▼
┌─────────────────────────────────────────────────────┐
│  2. NextBot AI определяет намерение                 │
│     → Вызывает функцию get_rates (параметров нет)   │
└──────────────────┬──────────────────────────────────┘
                   ▼
┌─────────────────────────────────────────────────────┐
│  3. Python-скрипт выполняется:                      │
│     requests.post() → nextbot-api                   │
│     Body: { "action": "get_rates" }                 │
│     ← Получает JSON-ответ с курсами                 │
│     → Записывает в result                           │
└──────────────────┬──────────────────────────────────┘
                   ▼
┌─────────────────────────────────────────────────────┐
│  4. NextBot передаёт result + инструкцию → AI       │
│     AI форматирует курсы для клиента                │
│     AI спрашивает город и предлагает расчёт         │
└─────────────────────────────────────────────────────┘

⚠️ Важные замечания

  1. Python требует тариф «Бизнес» (0.01 BotCoin за выполнение, 0.05 в режиме отладки)
  2. result — обязательная переменная. Всё что в ней — уходит AI-агенту
  3. Custom API в секции «Действия» — НЕ подходит для получения данных. Используется только для односторонней отправки (логирование, CRM, уведомления)
  4. Если API вернёт ошибку, AI получит текст ошибки и должен корректно сообщить клиенту