Функции

Данная функция может быть использована для вызова любого внешнего API.

Бот помощник формирования примеров для API запросов: https://t.me/apollo_api_bot

Вот пример вызова функции для отправки сообщения через Telegram-бот:
Получи текст сообщения, токен бота у пользователя и ID пользователя в Telegram и вызови функцию `call_external_api` с параметрами: { "url": f'<https://api.telegram.org/bot{bot_token}/sendMessage>', "method": "POST", "data": { "chat_id": user_id, "text": "_ТЕКСТ_СООБЩЕНИЯ_" } }

Функция get_random_numbers принимает аргументы в виде словаря arguments, в котором необходимо указать количество случайных чисел (quantity), минимальное значение (min) и максимальное значение (max) для генерации случайных чисел.
Далее функция делает запрос к внешнему API по указанному URL, передавая параметры в запросе. Полученный ответ в виде случайных чисел в указанном диапазоне возвращается в виде текстового значения.

Для работы функции нужно указать токен от https://apiframe.pro/

Пример вызова функции:

"api: XXXXXXXXXXXXXXXXXXXXXX
нарисуй мне голубоглазую девушку в стиле фотореализм в формате 4:7"

💡Токен можно прописать внутри инструкций вашего бота и тогда будет достаточно только запроса на генерацию картинки.

https://documenter.getpostman.com/view/33976547/2sA35HXgaH

Данный расчет помогает получить сведения о своих кармических задачах. Предлагаем Вашему внимание интересную гипотезу
определения Вашей роли в семье.
Узнать предназначение вас в этой жизни. Определяем 2 числа: личное число и число родового имени. Личное число:
Согласно таблице, приведенной ниже, сложите все буквы и
цифры Вашей полной даты рождения имени, отчества и
фамилии, которые указаны в свидетельстве рождения.
То есть для такого определения берутся Ваши:
ИМЯ, ФАМИЛИЯ и ОТЧЕСТВО ДАННЫЕ ПРИ РОЖДЕНИИ!!!
Складывайте полученную сумму до простого числа.
Предлагаем Вам таблицу, которая укажет какому числу
соответствует определенная буква.
Сопоставьте каждую букву вашего имени с числом :
1-а,к,у
2-б,л,ф
3-в,м,х
4-г,н,ц
5-д,о,ч
6-е,ё,п,ш,э
7-ж,р,щ
8-з,с,ю
9-и,й,т,я,ы
Например, Шиляева Даша Петровна, 18 марта 2004
Ш-6
И-9
Л-2
Я-9
Е-6
В-3
А-1
Д-5
А-1
Ш-6
А-1
П-6
Е-6
Т-9
Р-7
О-5
В-3
Н-4
А-1
Итак: сложить все цифры : фамилия + имя + отчество + число, месяц, год рождения:
6+9+2+9+6+3+1+5+1+6+1+6+6+9+7+5+3+4+1=90 Складываем 90 : 9+0=9
Складываем дату рождения: 1+8+3+2+0+0+4=18 Складываем: 1+8=9
Теперь складываем число от фамилии имени и отчества с числом даты рождения: 9+9=18
Складываем: 1+8=9
Итого: Личное число: 9

Второе число, которое необходимо определить, это:
Число родового имени
Рассчитайте по выше размещенной таблице число имени Рода. Для этого возьмите имя Вашего самого старшего родственника, которого вы помните. Например, самого старшего родственника, которого вы помните зовут Анна.
Значит : 1+4+4+1 = 10 Складываем: 1+0 = 1
Сворачиваем полученные двузначные числа до простого числа.
Теперь определяем число Рода, и смотрим, какому числу
соответствует Ваша позиция в Роду
Число Рода:
Сложите личное число и число родового имени.
Личное число: 9
Число родового имени: 1
Складываем: 9+1=10 Складываем двузначное число до простого числа: 1+0=1
Это и есть Ваше личное

Функция get_element_content позволяет получить содержимое элемента на веб-странице, используя любую часть CSS селектора для поиска элементов.
Полученный контент очищается от HTML тегов.
Пользователь может указать, нужно ли возвращать HTML контент блока, а также количество блоков для возврата контента.

Например чтение 3-х новостей с главной страницы Lenta.RU выглядит так:
Прочитай 3 новости с сайта <https://lenta.ru> с селектором 'card-big _topnews _news' в текстовом виде.

Эта функция get_current_time принимает на вход словарь arguments с ключом "timezone", который указывает на необходимый часовой пояс. Функция возвращает текущее время в указанном формате hh.mm.ss в соответствии с выбранным часовым поясом. Внутри функции используется модуль datetime для работы с временем.

Получение товаров из категории на сайте Bitrix.

Для работы функции создайте в корне сайта файл `api_products.php` со следующим кодом:
```
<?php
require($_SERVER["DOCUMENT_ROOT"]."/bitrix/modules/main/include/prolog_before.php");

// Проверка, что запрос является POST
if ($_SERVER['REQUEST_METHOD'] !== 'POST') {
die(json_encode(array("error" => "Only POST requests are allowed")));
}

// Подключение необходимых модулей
CModule::IncludeModule("iblock");

// Получение параметров из POST-запроса
$postData = json_decode(file_get_contents('php://input'), true);

$site_url = $postData['site_url'] ?? null;
$searchName = $postData['name'] ?? '';
$categoryId = $postData['category_id'] ?? null;
$minPrice = $postData['min_price'] ?? null;
$maxPrice = $postData['max_price'] ?? null;

// Формирование фильтра
$arFilter = array(
"IBLOCK_ID" => 2,
"ACTIVE" => "Y"
);

if (!empty($searchName)) {
$arFilter["%NAME"] = $searchName;
}

if ($categoryId) {
$arFilter["SECTION_ID"] = $categoryId;
$arFilter["INCLUDE_SUBSECTIONS"] = "Y";
}

// Выборка товаров
//$arSelect = array("ID", "NAME", "DETAIL_PAGE_URL", "PREVIEW_PICTURE", "PROPERTY_PRICE", "CATALOG_QUANTITY");
$arSelect = array("*", "PROPERTY_*");
$arResult = array();

$res = CIBlockElement::GetList(array(), $arFilter, false, array("nPageSize" => 50), $arSelect);

while($ob = $res->GetNextElement()) {
$arFields = $ob->GetFields();
$arProps = $ob->GetProperties();
$imageUrl = CFile::GetPath($arFields["DETAIL_PICTURE"]);

$arFilter = array("PRODUCT_ID" => $arFields["ID"]);
$price = CPrice::GetList(array(), $arFilter)->Fetch();
$productPrice = $price["PRICE"];

if ($minPrice !== null) {
if ($productPrice < $minPrice) {
continue;
}
}

if ($maxPrice !== null) {
if ($productPrice > $maxPrice) {
continue;
}
}

// Проверяем, начинается ли URL с "/upload/"
if (strpos($imageUrl, '

Функция get_day_of_week принимает на вход словарь arguments, содержащий ключ "date" с датой в формате 'ГГГГ-ММ-ДД'.
Далее функция извлекает год, месяц и день из входной даты, затем определяет день недели для этой даты с помощью модуля datetime.
Наконец, функция возвращает текущий день недели в текстовом формате.

Функция позволяет боту публиковать любую информацию в ваш ТГ-канал. Для этого в целях боту пропишите эту команду:

"Сначала узнай токен бота и id телеграм канала для возможности публиковать посты и без этой информации ты не можешь отвечать ни на какие вопросы пользователя."

Не забудьте, что бот должен быть добавлен в администраторы вашего канала!

Функция получает ссылку на MP3 файл и с помощью методов асинхронного распознавания Яндекса возвращает текстовый файл с результатом.
Если ты получишь ссылку на файл .mp3, то сразу вызови функцию распознования с параметрами: { 'languageCode' : '', 'model' : 'general', 'profanityFilter' : False, 'literature_text' : False, 'audioEncoding' : 'MP3', 'audioChannelCount' : 1, 'rawResults' : False, } bucket_name = 'protalkstt'

С помощью функции бот может безопасно добавлять, просматривать, редактировать и удалять события в Google календаре. В поведении боту пропишите эти настройки:
1. Для твоей работы необходим ID календаря, который ты будешь передавать в функцию "google_calendar". ID календаря может быть предоставлен и в виде Email адреса. Без него ты не можешь отвечать ни на какие вопросы пользователя.
2. При показе запланированных событий после названия события указывай его "event_id".
--------------------------
Также необходимо в настройках вашего календаря с помощью браузера открыть доступ к этому пользователю: "dialogai@dialogai-385904.iam.gserviceaccount.com" с правами "Внесение изменений и предоставления доступа".

ID календаря может быть как в виде e-mail адреса, так и в виде собственного обозначения, если это не основной календарь (ID можно найти в настройках интеграции календаря). Если боту предоставить ID не верный, будет выходить ошибка.

Рефералы добавляются с помощью сгенерированной вами уникальной ссылки (делается через команду /share). Удалять или добавлять без ссылки рефералов нельзя, отдельно начислять токены тоже. Это делается по единому правилу для всех. Увидеть рефералов можно в меню бота (Действия/Статистика). Там же можно скачать отчет о рефералах.

Бот может отвечать голосовыми сообщениями. если в чате ему высылаются голосовые сообщения. Голос можно выбрать из списка, среди которого есть как мужские голоса, так и женские. Есть два провайдера онлайн озвучки текста: Eleveblabs и Yandex. Если выбран прочерк -, то бот всегда будет отвечать только текстовыми сообщениями. Это необязательный параметр.

У голосовых сообщений от провайдера ElevenLabs есть общий лимит для всех пользователей ProTalk, это сделано для тестирования такой возможности. Если вы подразумеваете использовать озвучку сообщений или клонирование голоса, зарегистрируйтесь в ElevenLabs, получите ключ и вы сможете использовать только свои личные лимиты.

Для полноценной работы рекомендуем подключить боту функцию «Озвучивание текста (ElevenLabs)», в настройках промпта нужно будет указать API ключ от вашего личного кабинета ElevenLabs и другие параметры:

"parameters": {
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "Текст для озвучки",
},
"elevellabs_api_key": {
"type": "string",
"description": "API ключ от ElevenLabs",
},
"voice_id": {
"type": "string",
"description": "ID голоса ElevenLabs",
},
"limit": {
"type": "integer",
"description": "Количество символов для озвучивания. По умолчанию равно 200.",
},
"stability": {
"type": "integer",
"description": "Стабильность голоса. По умолчанию равно 5.",
},
"similarity_boost": {
"type": "integer",
"description": "Похожесть голоса. По умолчанию равно 5.",
},

GPT-бот может активироваться по расписанию, например каждый день в нужное время или раз в 15 минут. При активации GPT-бота ему можно отправить несколько сообщений. При отправке таких автоматических сообщений GPT-бот будет как будто-бы общаться с живым пользователем и при необходимости будет запускать данные GPT-боту функции.

Основной провайдер для коммуникаций - сервис Uminico. Зарегистрируйтесь в нём по этой ссылке: https://umnico.com/ru/register/?referral=N4IgTgpgZiBcCsA2AHATgOwF8g Затем перейдите в личном кабинете Umnico на страницу настроек и среди каналов общения выберите "Чат на сайт", WhatsApp, Telegram личный и т.д. Стоимость услуги привязки одного номера 2500 руб. в месяц. Чат-виджет для сайта бесплатен. Затем, там же в разделе "Открытое API" скопируйте ваш API-токен и вставьте его в окно “API Umnico” в личном кабинете ProTalk на странице "Интеграции", нажмите сохранить. Выше вы увидите уникальный номер ID для канала, скопируйте его и вставьте в поле “ID каналы в Umnico” на этой странице настроек. Можно использовать сразу несколько каналов, разделяя их запятой (5432, 3456 и так далее)

Раздел квиза “Входящие каналы” позволяет подключать к вашему боту различные каналы коммуникаций, такие как: чат на сайте, whatsapp, персональный Telegram, Авито, ВК, Одноклассники и т.д. Для использования каналов коммуникаций необходимо выбрать один из сервисов, через который будет осуществляться данное подключение. На выбор предоставляются следующие сервисы: Umnico, Wazzup, Whapi, Jivosite, Wapico.

Настройка креативности в контексте работы с ботом ProTalk определяет, насколько творчески и непредсказуемо бот будет генерировать ответы. Чем выше уровень креативности, тем более разнообразными и оригинальными могут быть ответы бота. Если вы хотите, чтобы бот следовал инструкциям более строго и предсказуемо, рекомендуется уменьшить креативность. При использовании функций рекомендуется устанавливать креативность как можно ниже. Креативность - обязательный параметр. Настройки этого параметра могут варьироваться от 0 до 1.4

Первая фраза нужна, если бот начинает диалог первым. В режиме «жду обращения» при использовании каналов Umnico она выключена. Но если хотите, чтобы в режиме “жду обращения” бот мог приветствовать определённой фразой, пропишите её в поле «Поведение». Если в этом поле поставить прочерк “-”, то бот будет приветствовать собеседника, исходя из своей роли. Первая фраза - это обязательный параметр, но если это поле оставить пустым, то ниже появится еще одно поле, которое называется “Скрытое сообщение от пользователя”.

Функции и возможности