# О нас Для лучшей навигации по документации, используйте поиск. **iiAgent.pro -** мощная платформа для автоматизации бизнеса, увеличения вашей прибыли и эффективности. С возможностью создавать автоматизации не используя программирование. Для профессиональных разработчиков открыли возможность создавать свой функционал. [Возможности](#vozmozhnosti) [Преимущества](#preimushestva) [Как научиться создавать автоматизации на базе ИИ с помощью iiAgent.pro?](#kak-nauchitsya-sozdavat-avtomatizacii-na-baze-ii-s-pomoshyu-iiagent.pro) [Что делать если нужна автоматизация, но нет времени учиться?](#chto-delat-esli-nuzhna-avtomatizaciya-no-net-vremeni-uchitsya) [Отзывы](#otzyvy-1) ### **Возможности** С помощью iiAgent.pro можно создавать * "новичкам" простые чат боты на базе искусственного интеллекта с удобной панелью управлению * "опытным" профильных нейро-сотрудников с простым и сложным функционалом * "экспертам" связывать созданных AI -помощников в целые отделы и ставить AI - руководителя для их управления ### Преимущества * Возможность тонких настроек каждого ИИ Агента которую не предоставляют похожие сервисы. * Уникальная разработка это многозадачный AI - руководитель с возможностью управления армией нейро-сотрудников. Позволяет автоматизировать целые отделы: продажи, маркетинг, закупки, логистика, смм, и тд. * Доступность в создании и внедрении своих функций * Разработка и продажа ИИ Агентов внутри сервиса ### Как научиться создавать автоматизации на базе ИИ с помощью iiAgent.pro? Для тех кому хочется научиться создавать автоматизации на базе ИИ с помощью iiAgent.pro мы создали университет профильной подготовки и приглашаем всех желающих пройти путь от базовых навыков до профессиональных. Заходите на сайт [https://](https://salebot.pro/)[iiAgent.pro](https://iiagent.pro/) и оставляйте заявку на обучение в нашем университете. ### Что делать если нужна автоматизация, но нет времени учиться? Если Вам нужна автоматизация, а сделать самому нет времени или желания, обратитесь к нам и профессионал Вам с радостью поможет! Заходите на сайт [https://](https://salebot.pro/)[iiAgent.pro](https://iiagent.pro/) и оставляйте заявку на создание автоматизации. ### Отзывы Оставляйте свои честные отзывы и получайте **промокод на 10 дней с полным функционалом iiAgent.pro** За промокодом и со скриншотами 4 отзывов (на разных площадках) обращайтесь в техническую поддержку. Список сайтов, где можно оставить отзывы, 👉 здесь👈 # Рабочее пространство Описание блоков в панели управления [Панель управления](/rabochee-prostranstvo#panel-upravleniya) * [настройка языка](#nastroiki-yazyka) * [настройка профиля](#nastroiki-profilya) * [режим темы](#rezhim-temy) * [карточки с ботами](#kartochki-s-botami) [Левое меню](#levoe-menyu) * [руководители](#rukovoditeli) * [база знаний](#bazy-znanii) * [функции](#funkcii) * [интеграции](#integracii) * [шаблоны ботов](#shablony-botov) * [биржа проектов](#birzha-proektov) * [мой тариф](#moi-tarif) [Карточка бота](#kartochka-bota) * [мощность бота (AiE)](#moshnost-bota-aie) [Меню бота](#menyu-bota) * [редактирование бота](#redaktirovanie-bota) * [поделиться ботом](#podelitsya-botom) * [статистика](#statistika) * [API и Веб-хуки](#api-i-veb-khuki) * [виджет на сайт](#vidzhet-na-sait) * [остановить все диалоги](#ostanovit-vse-dialogi) * [экспорт диалогов](#eksport-dialogov) ## Панель управления
### Настройки языка Здесь вы можете выбрать язык для всех подписей меню и подсказок на необходимом вам языке. Настройки локализации автоматически могут меняться в зависимости от вашего местонахождения или от настроек VPN.
### Настройки профиля Здесь можно изменить свой пароль, введя новый пароль и его подтверждение в соответствующее окно и нажав кнопку “Сохранить”. Для автоматической отправки текстовых записей всех завершенных диалогов установите галочку в соответствующем квадратике.
### Режим темы Можно менять настройки темы пространства личного кабинета и всех меню настроек.. Есть два варианта для темы: светлая и темная.
### Карточки с ботами Посередине главной страницы вы видите карточки ваших Ai ботов (сотрудников). По умолчанию это главная страница личного кабинета платформы ProTalk.
## Левое меню ### Руководители Руководители отличаются от сотрудников тем, что они способны выполнять более сложные задачи, требующие взаимодействия с подчиненными. Например, в процессе публикации новостей в Telegram-канале руководитель выступает в качестве основного координатора, в то время как его подчиненные занимаются сбором информации, подбором изображений и контекстом.
Все задачи организованы в виде цепочек, что позволяет эффективно распределять обязанности и достигать поставленных целей. Визуально раздел "Руководители" представлен в виде карточек, аналогичных тем, что используются для сотрудников. Эти карточки содержат настройки, которые мы подробно рассмотрим в разделе о настройке БОТов. ### Базы знаний В разделе "Базы знаний" вы можете загружать и управлять своими базами данных. Каждая база представлена в виде отдельной карточки, где отображается параметр качества. Этот параметр важен для оценки корректности формирования базы. Если качество низкое, это будет указано красным цветом, и вам следует пересмотреть базу, чтобы улучшить ее работу. Бот может работать с базой низкого качества, но его эффективность будет снижен
В карточке базы знаний вы увидите исходный объем данных и количество данных, попавших в базу. Также отображается количество блоков, на которые разбивается база. Чем больше база, тем больше блоков. Важно, чтобы количество разделителей соответствовало количеству блоков, иначе это может ухудшить работу с базой.
Разделитель для блоков может быть любым, для этого измените его в соответствующем окошке. Самое главное, чтобы он был точно таким же в самом документе. Небольшое отличие не позволит его найти системе и база будет плохого качества. 1\. Проверьте в текстовом редакторе через поиск сколько находится разделителей в вашей базе. Оно должно совпасть с числом, которое отобразится в карточке базы знаний. Низкое качество - это значит много данных и мало блоков (либо вообще один). 2\. Убедитесь что разделитель идентичен тому, что вписано в настройках. 3\. Воспользуйтесь средним значением блока, чтобы отрегулировать количество найденных блоков. Меняйте и смотрите как меняется количество. Вы можете загружать файлы в форматах PDF, текст, XLS, DOC и PPTX. Обратите внимание на максимальный доступный объем базы знаний, который зависит от количества токенов на вашем балансе. Токены необходимы для разметки базы, и их количество можно проверить в разделе "Мой тариф".
Вы можете редактировать и удалять базы знаний, а также тестировать их. Для тестирования задайте вопрос, чтобы проверить, как база реагирует на запросы. Это поможет оценить корректность разметки и работу базы в реальном диалоге. ![](https://1389071903-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmgaG4ePuhIcI3pwDYuT9%2Fuploads%2FeS6eXavgXb0Z7GLhJboc%2Fimage.png?alt=media\&token=4bb10958-0359-4f6f-9518-9081857cfee8)![](https://1389071903-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmgaG4ePuhIcI3pwDYuT9%2Fuploads%2FtkrzgV02an75GXdWvPji%2Fimage.png?alt=media\&token=d9e166c3-ed7d-447e-aa93-f558417cd951)\
### Функции В разделе "Функции" вы найдете два основных подраздела: "Каталог функций" и "Добавить функцию". Каталог содержит все доступные функции на нашей платформе. Уникальность нашего поиска заключается в том, что он основан на искусственном интеллекте. Вы можете вводить не только названия или номера функций, но и формулировать задачи, которые хотите решить. Например, если вам нужно сгенерировать изображения и распознать документы, наш поиск предложит функции, которые помогут в решении этих задач. Это делает поиск более интуитивным и удобным.
Каждая функция снабжена описанием, которое включает название, определение и параметры, необходимые для ее использования. Это особенно полезно для тех, кто хочет глубже разобраться в настройке своих ботов. Также доступны видео обзоры функций и информация о частоте их использования другими пользователями.
Функции в каталоге расположены по возрастанию популярности. Это позволяет быстро находить наиболее востребованные решения. Если вы не уверены, какая функция вам нужна, нейросеть подскажет, исходя из вашего запроса. Мы постоянно расширяем наш каталог, который уже насчитывает около 200 функций. Если вы не нашли нужную функцию, вы всегда можете предложить свою и стать частью нашего проекта. Если у вас есть идея для новой функции, вы можете предложить ее через вкладку "Добавить функцию". Мы предоставляем возможность создать функцию с помощью нашего мастера бота в Telegram. После создания вы можете прикрепить описание, название и другие детали, отправив их на модерацию. Если ваша функция будет одобрена и интересна, вы получите бонус в виде 500.000 токенов.
### Интеграции Здесь расположены поля для ввода API ключей от различных сервисов, которые можно интегрировать с ProTalk: OpenAi, ElevenLabs, Notion, YoNote, Umnico, Groq, Chat2Desk, Битрикс24, amoCRM, Робокасса, CloudPayments, Юкасса.
### Шаблоны ботов В разделе "Шаблоны ботов" вы можете создавать ботов с нуля или использовать готовые шаблоны. Если вы хотите создать бота с чистого листа, у вас есть возможность самостоятельно заполнить все необходимые поля. Это позволяет вам полностью контролировать процесс создания и адаптировать бота под ваши конкретные нужды.
Для тех, кто предпочитает автоматизацию, доступна функция генерации бота. Вам нужно лишь описать, каким вы видите своего бота и какие функции он должен выполнять. На основе вашего запроса система предложит варианты заполнения полей и функций, которые можно подключить. Чем подробнее вы опишете функционал бота, тем меньше потребуется последующих правок. Также доступны готовые шаблоны для различных ролей, таких как программист или администратор клиники. Эти шаблоны уже содержат предварительно настроенные параметры и функции, которые были протестированы и успешно работают. Вы можете использовать их как основу для создания своего бота, адаптируя под свои нужды.
Если вы хотите создать уникального бота, рекомендуется начать с генерации или с чистого листа, чтобы избежать ненужных настроек, которые могут быть в шаблонах. Выбирайте шаблон, который наиболее близок к вашему кейсу, и настраивайте его под свои требования. Это позволит вам эффективно использовать возможности шаблонов и создать бота, который идеально соответствует вашим задачам. ### Магазин ботов Это магазин ботов, где вы можете найти как бесплатные, так и платные решения для автоматизации ваших задач. Платежи осуществляются в нашей внутренней валюте — токенах, что делает процесс покупки удобным и безопасным. В магазине представлены различные категории ботов, что позволяет легко находить нужные решения. Каждый бот имеет свою карточку, где указана информация о его функциональности и возможностях. Вы можете ознакомиться с описанием бота, наведя курсор на его изображение. Некоторые боты доступны бесплатно, и вы можете добавить их в свой раздел "Сотрудники" одним нажатием кнопки "Купить". Если бот платный, его стоимость указана в токенах. Например, бот "Друг Отличник" стоит 1000 токенов, что является доступной ценой по меркам нашей платформы. При покупке токены списываются с вашего аккаунта.
Наш магазин предоставляет возможность не только приобретать, но и выкладывать собственные боты. Это отличная возможность для опытных разработчиков зарабатывать токены, предлагая свои решения другим пользователям. Вы можете делиться своими шаблонами и получать доход от их использования. На каждой карточке бота есть ссылка на контакт с продавцом. Если у вас возникнут вопросы или потребуется помощь, вы всегда можете связаться с создателем бота для получения дополнительной информации. Мы стремимся поддерживать оригинальность и качество ботов. Популярные и уникальные боты получают более высокие позиции в рейтинге, что делает их более заметными для пользователей. Это стимулирует разработчиков создавать инновационные решения и поддерживать их актуальность. ### Биржа проектов Биржа проектов — это платформа, где заказчики могут создавать и размещать свои проекты, а исполнители — находить и откликаться на них. Например, если вам нужно заказать разработку бота, вы можете создать проект, подробно описав задачи, которые должен выполнять бот, каналы коммуникации и другие требования. Разработчики, заинтересованные в выполнении таких заказов, могут откликнуться на вашу заявку. Таким образом, биржа проектов соединяет заказчиков с исполнителями, облегчая процесс поиска подходящих специалистов.
Заказчик сам контролирует процесс сбора предложений и может приостановить его в любой момент, как только определится с исполнителем. До тех пор, пока проект открыт для предложений, разработчики могут откликаться на него. Если проект долгое время остается без исполнителя, это может означать, что задача сложная и требует больше времени для поиска подходящего специалиста. Если вы разработчик, заходите в раздел биржи проектов, чтобы найти интересные заказы и откликнуться на них. Это отличный способ найти работу и расширить свою клиентскую базу. ### Мой тариф В разделе "Мой Тариф" вы найдете всю необходимую информацию о вашем текущем тарифном плане и возможностях его изменения. В верхней части карточки отображается статистика вашего аккаунта. Здесь вы можете увидеть: \- Количество сотрудников-ботов \- Остаток токенов \- Количество клиентов: Это все уникальные контакты, которые взаимодействовали с вашими ботами за всю историю, включая чаты в личном кабинете, Telegram и другие каналы связи.
Слева отображается ваш текущий тариф и его ограничения. Подробную информацию о тарифах можно найти в разделе "Прайс" на нашем сайте. Справа вы можете выбрать и купить новый тариф, например, перейти с "Профи" на "Базовый". Также доступна покупка тарифа на год с предоставлением скидки. В специальном окне вы можете приобрести пакеты токенов различного объема: 5 миллионов, 10 миллионов и 50 миллионов токенов. Цены от 350 до 3000 рублей. Ваш уникальный реферальный код и ссылка позволяют привлекать новых пользователей. Все покупки, совершенные вашими рефералами, будут отображаться в графе бонусов, и вы получите 30% от их покупок. Эти средства можно использовать для покупки тарифов или токенов. При накоплении значительных сумм возможен вывод средств через тех.поддержку. Вы можете создать свой уникальный промокод для привлечения пользователей. Рефералы, использующие ваш промокод, получат скидку на первую покупку тарифа. Это удобный способ привлечения клиентов, особенно в аудио формате, например, в подкастах или видео. Таким образом, раздел "Мой Тариф" предоставляет все инструменты для управления вашим аккаунтом, покупки токенов и привлечения новых пользователей через реферальные программы и промо-коды. ## Карточка бота На карточке вашего бота размещены следующие элементы: \- Изображение аватара \- Мощность бота AiE \- Должность и имя \- Уникальный номер \- Подключенные функции \- Чат для тестирования бота \- Подключенная LLM-модель \- Пол \- Язык \- Публикация в магазине ботов \- Режим работы \- Теги для сортировки \- Кнопка включение/выключение бота
### Мощность бота (AiE) Исчисляется она так = (объем промпта + функции + базы знаний + скрытые инструкции) \* коэфф. LLM / 1000 Чем ниже это значение, тем экономичнее в расходах токенов будет ваш бот и наоборот. Когда изменяете настройки бота значение обновится только после двух сообщений боту. ## Меню бота ![](https://1389071903-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmgaG4ePuhIcI3pwDYuT9%2Fuploads%2F3sw5QoNq4Xivm90UQmvg%2Fimage.png?alt=media\&token=7c48cff6-3c66-4fa6-9cf0-a8a28b2b037b) ### Редактирование бота В меню доступен режим редактирования, позволяющий вносить изменения в функционал и настройки бота.
### Поделиться ботом Нажмите в меню бота. Поделиться ботом. Вы можете скопировать ссылку на бота и отправить ее другу. Друг сможет вставить эту ссылку в строку браузера в своём личном кабинете, чтобы получить точную копию бота. Это также позволяет продавать ботов, передавая их через наш магазин за токены или напрямую за деньги.
### Статистика В меню доступна статистика, показывающая уникальный ID бота, количество потраченных токенов, число пользователей, взаимодействовавших с ботом, и реферальные бонусы. Вы можете отслеживать активность пользователей и скачивать отчеты по реферальной программе.
### API и Веб-хуки Каждый бот имеет уникальный API-ключ, который позволяет интегрировать его с другими сервисами. Документация по API доступна для расширения возможностей бота. Вы также можете использовать веб-хуки для интеграции с такими сервисами, как Алиса, Маруся, BootHelp, SaleBot и Wapico.
### Виджет на сайт Вы можете установить виджет чата с ботом на ваш сайт, скопировав соответствующий код. Это позволяет пользователям взаимодействовать с ботом прямо на вашем сайте.
### Остановить все диалоги Если необходимо прекратить текущие взаимодействия бота, например, для внесения изменений, вы можете остановить все диалоги с помощью этой кнопки. После этого они начнутся заново с учетом новых настроек.
### Экспорт диалогов Все взаимодействия бота с пользователями сохраняются в виде логов, которые можно экспортировать в формате CSV для анализа (только для тарифа Профи). Рекомендуем настроить автоматическую отправку логов в Google Таблицы для онлайн-мониторинга.
# Панель управления [Панель управления](/rabochee-prostranstvo#panel-upravleniya) * [настройка языка](#nastroiki-yazyka) * [настройка профиля](#nastroiki-profilya) * [режим темы](#rezhim-temy) * [карточки с ботами](#kartochki-s-botami)
### Настройки языка Здесь вы можете выбрать язык для всех подписей меню и подсказок на необходимом вам языке. Настройки локализации автоматически могут меняться в зависимости от вашего местонахождения или от настроек VPN.
### Настройки профиля Здесь можно изменить свой пароль, введя новый пароль и его подтверждение в соответствующее окно и нажав кнопку “Сохранить”. Для автоматической отправки текстовых записей всех завершенных диалогов установите галочку в соответствующем квадратике.
### Режим темы Можно менять настройки темы пространства личного кабинета и всех меню настроек.. Есть два варианта для темы: светлая и темная.
### Карточки с ботами Посередине главной страницы вы видите карточки ваших Ai ботов (сотрудников). По умолчанию это главная страница личного кабинета платформы ProTalk.
# Левое меню [Левое меню](#levoe-menyu) * [руководители](#rukovoditeli) * [база знаний](#bazy-znanii) * [функции](#funkcii) * [интеграции](#integracii) * [шаблоны ботов](#shablony-botov) * [биржа проектов](#birzha-proektov) * [мой тариф](#moi-tarif) ### Руководители Руководители отличаются от сотрудников тем, что они способны выполнять более сложные задачи, требующие взаимодействия с подчиненными. Например, в процессе публикации новостей в Telegram-канале руководитель выступает в качестве основного координатора, в то время как его подчиненные занимаются сбором информации, подбором изображений и контекстом.
Все задачи организованы в виде цепочек, что позволяет эффективно распределять обязанности и достигать поставленных целей. Визуально раздел "Руководители" представлен в виде карточек, аналогичных тем, что используются для сотрудников. Эти карточки содержат настройки, которые мы подробно рассмотрим в разделе о настройке БОТов. ### Базы знаний В разделе "Базы знаний" вы можете загружать и управлять своими базами данных. Каждая база представлена в виде отдельной карточки, где отображается параметр качества. Этот параметр важен для оценки корректности формирования базы. Если качество низкое, это будет указано красным цветом, и вам следует пересмотреть базу, чтобы улучшить ее работу. Бот может работать с базой низкого качества, но его эффективность будет снижен
В карточке базы знаний вы увидите исходный объем данных и количество данных, попавших в базу. Также отображается количество блоков, на которые разбивается база. Чем больше база, тем больше блоков. Важно, чтобы количество разделителей соответствовало количеству блоков, иначе это может ухудшить работу с базой.
Разделитель для блоков может быть любым, для этого измените его в соответствующем окошке. Самое главное, чтобы он был точно таким же в самом документе. Небольшое отличие не позволит его найти системе и база будет плохого качества. 1\. Проверьте в текстовом редакторе через поиск сколько находится разделителей в вашей базе. Оно должно совпасть с числом, которое отобразится в карточке базы знаний. Низкое качество - это значит много данных и мало блоков (либо вообще один). 2\. Убедитесь что разделитель идентичен тому, что вписано в настройках. 3\. Воспользуйтесь средним значением блока, чтобы отрегулировать количество найденных блоков. Меняйте и смотрите как меняется количество. Вы можете загружать файлы в форматах PDF, текст, XLS, DOC и PPTX. Обратите внимание на максимальный доступный объем базы знаний, который зависит от количества токенов на вашем балансе. Токены необходимы для разметки базы, и их количество можно проверить в разделе "Мой тариф".
Вы можете редактировать и удалять базы знаний, а также тестировать их. Для тестирования задайте вопрос, чтобы проверить, как база реагирует на запросы. Это поможет оценить корректность разметки и работу базы в реальном диалоге. ![](https://1389071903-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmgaG4ePuhIcI3pwDYuT9%2Fuploads%2FeS6eXavgXb0Z7GLhJboc%2Fimage.png?alt=media\&token=4bb10958-0359-4f6f-9518-9081857cfee8)![](https://1389071903-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmgaG4ePuhIcI3pwDYuT9%2Fuploads%2FtkrzgV02an75GXdWvPji%2Fimage.png?alt=media\&token=d9e166c3-ed7d-447e-aa93-f558417cd951)\
### Функции В разделе "Функции" вы найдете два основных подраздела: "Каталог функций" и "Добавить функцию". Каталог содержит все доступные функции на нашей платформе. Уникальность нашего поиска заключается в том, что он основан на искусственном интеллекте. Вы можете вводить не только названия или номера функций, но и формулировать задачи, которые хотите решить. Например, если вам нужно сгенерировать изображения и распознать документы, наш поиск предложит функции, которые помогут в решении этих задач. Это делает поиск более интуитивным и удобным.
Каждая функция снабжена описанием, которое включает название, определение и параметры, необходимые для ее использования. Это особенно полезно для тех, кто хочет глубже разобраться в настройке своих ботов. Также доступны видео обзоры функций и информация о частоте их использования другими пользователями.
Функции в каталоге расположены по возрастанию популярности. Это позволяет быстро находить наиболее востребованные решения. Если вы не уверены, какая функция вам нужна, нейросеть подскажет, исходя из вашего запроса. Мы постоянно расширяем наш каталог, который уже насчитывает около 200 функций. Если вы не нашли нужную функцию, вы всегда можете предложить свою и стать частью нашего проекта. Если у вас есть идея для новой функции, вы можете предложить ее через вкладку "Добавить функцию". Мы предоставляем возможность создать функцию с помощью нашего мастера бота в Telegram. После создания вы можете прикрепить описание, название и другие детали, отправив их на модерацию. Если ваша функция будет одобрена и интересна, вы получите бонус в виде 500.000 токенов.
### Интеграции Здесь расположены поля для ввода API ключей от различных сервисов, которые можно интегрировать с ProTalk: OpenAi, ElevenLabs, Notion, YoNote, Umnico, Groq, Chat2Desk, Битрикс24, amoCRM, Робокасса, CloudPayments, Юкасса.
### Шаблоны ботов В разделе "Шаблоны ботов" вы можете создавать ботов с нуля или использовать готовые шаблоны. Если вы хотите создать бота с чистого листа, у вас есть возможность самостоятельно заполнить все необходимые поля. Это позволяет вам полностью контролировать процесс создания и адаптировать бота под ваши конкретные нужды.
Для тех, кто предпочитает автоматизацию, доступна функция генерации бота. Вам нужно лишь описать, каким вы видите своего бота и какие функции он должен выполнять. На основе вашего запроса система предложит варианты заполнения полей и функций, которые можно подключить. Чем подробнее вы опишете функционал бота, тем меньше потребуется последующих правок. Также доступны готовые шаблоны для различных ролей, таких как программист или администратор клиники. Эти шаблоны уже содержат предварительно настроенные параметры и функции, которые были протестированы и успешно работают. Вы можете использовать их как основу для создания своего бота, адаптируя под свои нужды.
Если вы хотите создать уникального бота, рекомендуется начать с генерации или с чистого листа, чтобы избежать ненужных настроек, которые могут быть в шаблонах. Выбирайте шаблон, который наиболее близок к вашему кейсу, и настраивайте его под свои требования. Это позволит вам эффективно использовать возможности шаблонов и создать бота, который идеально соответствует вашим задачам. ### Магазин ботов Это магазин ботов, где вы можете найти как бесплатные, так и платные решения для автоматизации ваших задач. Платежи осуществляются в нашей внутренней валюте — токенах, что делает процесс покупки удобным и безопасным. В магазине представлены различные категории ботов, что позволяет легко находить нужные решения. Каждый бот имеет свою карточку, где указана информация о его функциональности и возможностях. Вы можете ознакомиться с описанием бота, наведя курсор на его изображение. Некоторые боты доступны бесплатно, и вы можете добавить их в свой раздел "Сотрудники" одним нажатием кнопки "Купить". Если бот платный, его стоимость указана в токенах. Например, бот "Друг Отличник" стоит 1000 токенов, что является доступной ценой по меркам нашей платформы. При покупке токены списываются с вашего аккаунта.
Наш магазин предоставляет возможность не только приобретать, но и выкладывать собственные боты. Это отличная возможность для опытных разработчиков зарабатывать токены, предлагая свои решения другим пользователям. Вы можете делиться своими шаблонами и получать доход от их использования. На каждой карточке бота есть ссылка на контакт с продавцом. Если у вас возникнут вопросы или потребуется помощь, вы всегда можете связаться с создателем бота для получения дополнительной информации. Мы стремимся поддерживать оригинальность и качество ботов. Популярные и уникальные боты получают более высокие позиции в рейтинге, что делает их более заметными для пользователей. Это стимулирует разработчиков создавать инновационные решения и поддерживать их актуальность. ### Биржа проектов Биржа проектов — это платформа, где заказчики могут создавать и размещать свои проекты, а исполнители — находить и откликаться на них. Например, если вам нужно заказать разработку бота, вы можете создать проект, подробно описав задачи, которые должен выполнять бот, каналы коммуникации и другие требования. Разработчики, заинтересованные в выполнении таких заказов, могут откликнуться на вашу заявку. Таким образом, биржа проектов соединяет заказчиков с исполнителями, облегчая процесс поиска подходящих специалистов.
Заказчик сам контролирует процесс сбора предложений и может приостановить его в любой момент, как только определится с исполнителем. До тех пор, пока проект открыт для предложений, разработчики могут откликаться на него. Если проект долгое время остается без исполнителя, это может означать, что задача сложная и требует больше времени для поиска подходящего специалиста. Если вы разработчик, заходите в раздел биржи проектов, чтобы найти интересные заказы и откликнуться на них. Это отличный способ найти работу и расширить свою клиентскую базу. ### Мой тариф В разделе "Мой Тариф" вы найдете всю необходимую информацию о вашем текущем тарифном плане и возможностях его изменения. В верхней части карточки отображается статистика вашего аккаунта. Здесь вы можете увидеть: \- Количество сотрудников-ботов \- Остаток токенов \- Количество клиентов: Это все уникальные контакты, которые взаимодействовали с вашими ботами за всю историю, включая чаты в личном кабинете, Telegram и другие каналы связи.
Слева отображается ваш текущий тариф и его ограничения. Подробную информацию о тарифах можно найти в разделе "Прайс" на нашем сайте. Справа вы можете выбрать и купить новый тариф, например, перейти с "Профи" на "Базовый". Также доступна покупка тарифа на год с предоставлением скидки. В специальном окне вы можете приобрести пакеты токенов различного объема: 5 миллионов, 10 миллионов и 50 миллионов токенов. Цены от 350 до 3000 рублей. Ваш уникальный реферальный код и ссылка позволяют привлекать новых пользователей. Все покупки, совершенные вашими рефералами, будут отображаться в графе бонусов, и вы получите 30% от их покупок. Эти средства можно использовать для покупки тарифов или токенов. При накоплении значительных сумм возможен вывод средств через тех.поддержку. Вы можете создать свой уникальный промокод для привлечения пользователей. Рефералы, использующие ваш промокод, получат скидку на первую покупку тарифа. Это удобный способ привлечения клиентов, особенно в аудио формате, например, в подкастах или видео. Таким образом, раздел "Мой Тариф" предоставляет все инструменты для управления вашим аккаунтом, покупки токенов и привлечения новых пользователей через реферальные программы и промо-коды. # Карточка бота [Карточка бота](#kartochka-bota) * [мощность бота (AiE)](#moshnost-bota-aie) * [меню бота](#menyu-bota) ### Карточка бота На карточке вашего бота размещены следующие элементы: \- Изображение аватара \- Мощность бота AiE \- Должность и имя \- Уникальный номер \- Подключенные функции \- Чат для тестирования бота \- Подключенная LLM-модель \- Пол \- Язык \- Публикация в магазине ботов \- Режим работы \- Теги для сортировки \- Кнопка включение/выключение бота
### Мощность бота (AiE) Исчисляется она так = (объем промпта + функции + базы знаний + скрытые инструкции) \* коэфф. LLM / 1000 Чем ниже это значение, тем экономичнее в расходах токенов будет ваш бот и наоборот. Когда изменяете настройки бота значение обновится только после двух сообщений боту. ### Меню бота ![](https://1389071903-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmgaG4ePuhIcI3pwDYuT9%2Fuploads%2F3sw5QoNq4Xivm90UQmvg%2Fimage.png?alt=media\&token=7c48cff6-3c66-4fa6-9cf0-a8a28b2b037b) # Меню бота [Меню бота](#menyu-bota) * [редактирование бота](#redaktirovanie-bota) * [поделиться ботом](#podelitsya-botom) * [статистика](#statistika) * [API и Веб-хуки](#api-i-veb-khuki) * [виджет на сайт](#vidzhet-na-sait) * [остановить все диалоги](#ostanovit-vse-dialogi) * [экспорт диалогов](#eksport-dialogov) ### Меню бота ![](https://1389071903-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmgaG4ePuhIcI3pwDYuT9%2Fuploads%2F3sw5QoNq4Xivm90UQmvg%2Fimage.png?alt=media\&token=7c48cff6-3c66-4fa6-9cf0-a8a28b2b037b) ### Редактирование бота В меню доступен режим редактирования, позволяющий вносить изменения в функционал и настройки бота.
### Поделиться ботом Нажмите в меню бота. Поделиться ботом. Вы можете скопировать ссылку на бота и отправить ее другу. Друг сможет вставить эту ссылку в строку браузера в своём личном кабинете, чтобы получить точную копию бота. Это также позволяет продавать ботов, передавая их через наш магазин за токены или напрямую за деньги.
### Статистика В меню доступна статистика, показывающая уникальный ID бота, количество потраченных токенов, число пользователей, взаимодействовавших с ботом, и реферальные бонусы. Вы можете отслеживать активность пользователей и скачивать отчеты по реферальной программе.
### API и Веб-хуки Каждый бот имеет уникальный API-ключ, который позволяет интегрировать его с другими сервисами. Документация по API доступна для расширения возможностей бота. Вы также можете использовать веб-хуки для интеграции с такими сервисами, как Алиса, Маруся, BootHelp, SaleBot и Wapico.
### Виджет на сайт Вы можете установить виджет чата с ботом на ваш сайт, скопировав соответствующий код. Это позволяет пользователям взаимодействовать с ботом прямо на вашем сайте.
### Остановить все диалоги Если необходимо прекратить текущие взаимодействия бота, например, для внесения изменений, вы можете остановить все диалоги с помощью этой кнопки. После этого они начнутся заново с учетом новых настроек.
### Экспорт диалогов Все взаимодействия бота с пользователями сохраняются в виде логов, которые можно экспортировать в формате CSV для анализа (только для тарифа Профи). Рекомендуем настроить автоматическую отправку логов в Google Таблицы для онлайн-мониторинга.
# Настройка бота Для создания рабочей версии достаточно выбрать LLM модель, задать промт и подключить бот к нужному сервису. Для более тонких настроек используется прочий функционал платформы. [Базовые параметры](https://docs.iiagent.pro/nastroika-bota#bazovye-parametry) * [Выбор LLM модели или провайдера](https://docs.iiagent.pro/nastroika-bota#vybor-llm-modeli-ili-provaidera) * [Режим работы](https://docs.iiagent.pro/nastroika-bota#rezhim-raboty) * [Предупреждения для пользователей](https://docs.iiagent.pro/nastroika-bota#preduprezhdeniya-dlya-polzovatelei) * [Личность и промт](https://docs.iiagent.pro/nastroika-bota#lichnost-i-promt) * [Озвучка голосовых сообщений](https://docs.iiagent.pro/nastroika-bota#ozvuchka-golosovykh-soobshenii) * [Внешний промпт](https://docs.iiagent.pro/nastroika-bota#vneshnii-prompt) * [Первая фраза "приветствие бота"](https://docs.iiagent.pro/nastroika-bota#pervaya-fraza-privetstvie-bota) * [Скрытое сообщение от пользователя](https://docs.iiagent.pro/nastroika-bota#skrytoe-soobshenie-ot-polzovatelya) * [Роль, цель и поведение](https://docs.iiagent.pro/nastroika-bota#rol-cel-i-povedenie) * [Креативность](https://docs.iiagent.pro/nastroika-bota#kreativnost) * [Изображение аватара](https://docs.iiagent.pro/nastroika-bota#izobrazhenie-avatara) * [Теги](https://docs.iiagent.pro/nastroika-bota#tegi) [Навыки](https://docs.iiagent.pro/nastroika-bota#navyki) * [Функции](https://docs.iiagent.pro/nastroika-bota#funkcii) * [Выбор функций](https://docs.iiagent.pro/nastroika-bota#vybor-funkcii) * [При каждом ответе запускать одну из функций](https://docs.iiagent.pro/nastroika-bota#pri-kazhdom-otvete-zapuskat-odnu-iz-funkcii) * [Запускать несколько функций одновременно](https://docs.iiagent.pro/nastroika-bota#zapuskat-neskolko-funkcii-odnovremenno) * [Использовать каждую функцию только один раз в новом диалоге](https://docs.iiagent.pro/nastroika-bota#ispolzovat-kazhduyu-funkciyu-tolko-odin-raz-v-novom-dialoge) [Базы знаний и (Embedding)](#bazy-znanii-i-embedding) * [Подключение баз знаний](https://docs.iiagent.pro/nastroika-bota#podklyuchenie-baz-znanii) * [Включить режим отладки](https://docs.iiagent.pro/nastroika-bota#vklyuchit-rezhim-otladki) * [Количество блоков из базы](https://docs.iiagent.pro/nastroika-bota#kolichestvo-blokov-iz-bazy) * [Файл со знаниями в формате PDF при прямой интеграции с Assistant от OpenAi](https://docs.iiagent.pro/nastroika-bota#fail-so-znaniyami-v-formate-pdf-pri-pryamoi-integracii-s-assistant-ot-openai) * [База знаний Fine-Tune из файла Google sheets](https://docs.iiagent.pro/nastroika-bota#baza-znanii-fine-tune-iz-faila-google-sheets) * [Источники знаний из интернета](https://docs.iiagent.pro/nastroika-bota#istochniki-znanii-iz-interneta) * [Постоянная память](https://docs.iiagent.pro/nastroika-bota#postoyannaya-pamyat) [Каналы коммуникаций](https://docs.iiagent.pro/nastroika-bota#kanaly-kommunikacii) * [Входящие](https://docs.iiagent.pro/nastroika-bota#vkhodyashie) * [Umnico](https://docs.iiagent.pro/nastroika-bota#umnico) * [Wazzup](https://docs.iiagent.pro/nastroika-bota#wazzup) * [Whapi](https://docs.iiagent.pro/nastroika-bota#whapi) * [Wapico](https://docs.iiagent.pro/nastroika-bota#wapico) * [Green-api](https://docs.iiagent.pro/nastroika-bota#green-api) * [Chat2Desk](https://docs.iiagent.pro/nastroika-bota#chat2desk) * [Jivosite](https://docs.iiagent.pro/nastroika-bota#jivosite) * [WILDBERRIES](https://docs.iiagent.pro/nastroika-bota#wildberries) [Исходящие](https://docs.iiagent.pro/nastroika-bota#iskhodyashie) * [Выбор Whatsapp, Телеграмм или Телергамм бот](https://docs.iiagent.pro/nastroika-bota#vybor-whatsapp-telegramm-ili-telergamm-bot) * [Телеграмм бот](https://docs.iiagent.pro/nastroika-bota#telegramm-bot) * [Меню](https://docs.iiagent.pro/nastroika-bota#menyu) * [Обязательная подписка на канал](https://docs.iiagent.pro/nastroika-bota#obyazatelnaya-podpiska-na-kanal) * [Автоматически переводить текст кнопок в меню бота и готовые ответы на язык пользователя](https://docs.iiagent.pro/nastroika-bota#avtomaticheski-perevodit-tekst-knopok-v-menyu-bota-i-gotovye-otvety-na-yazyk-polzovatelya) [Еще настройки](https://docs.iiagent.pro/nastroika-bota#eshe-nastroiki) * [Монетизация](https://docs.iiagent.pro/nastroika-bota#monetizaciya) * [Продажа пакетов токенов](https://docs.iiagent.pro/nastroika-bota#prodazha-paketov-tokenov) * [Регулярные платежи по подписке](https://docs.iiagent.pro/nastroika-bota#regulyarnye-platezhi-po-podpiske) * [Кто может делать копии вашего бота](https://docs.iiagent.pro/nastroika-bota#kto-mozhet-delat-kopii-vashego-bota) * [Лидогенерация](https://docs.iiagent.pro/nastroika-bota#lidogeneraciya) * [Настройки для групповых чатов Телеграмм](https://docs.iiagent.pro/nastroika-bota#nastroiki-dlya-gruppovykh-chatov-telegramm) * [Защита бота](https://docs.iiagent.pro/nastroika-bota#zashita-bota) * [Роль корректора](https://docs.iiagent.pro/nastroika-bota#rol-korrektora) * [Управление ботом по эмодзи](https://docs.iiagent.pro/nastroika-bota#upravlenie-botom-po-emodzi) * [Активация по расписанию](https://docs.iiagent.pro/nastroika-bota#aktivaciya-po-raspisaniyu) ## Базовые параметры ### Выбор LLM модели или провайдера В верхней части карточки представлены базовые параметры, на которых работает ваш бот. В данном примере, интеллект бота функционирует на платформе chatGPT-4-o-mini. В меню вы можете выбрать другую модель, включая ассистентов от Open AI.
Если у вас есть ассистенты от OpenAI и вы хотите использовать их на нашей платформе, выберите соответствующую опцию. Вам потребуется ввести ключ OpenAI и уникальный ID ассистента. Если вы работали с платформой Cozy, вы также можете интегрировать их ботов, указав ключ и уникальный ID. Наша платформа поддерживает различные модели, включая OpenAI, Claude, Llama, Groq, Яндекс-GPT, DeepSeek, Gemini и Giga-chat от Cбера. Вы можете выбрать любую из них в зависимости от ваших потребностей. Если вы хотите использовать свои собственные токены OpenAI, введите свой ключ в левом окошке. В этом случае конкретный бот будет использовать ваши личные токены OpenAI. Если поле остается пустым, будут использоваться токены нашей платформы, которые вы можете приобрести в разделе "Мой тариф".
Разные LLM модели имеют различные коэффициенты. Например, базовая модель chatGPT 3.5 turbo 0125 имеет коэффициент 1, что означает, что токены тратятся один к одному. Другие модели могут иметь разные коэффициенты, например, более дорогие модели могут умножаться на коэффициент 7, а некоторые, как chatGPT-o-4 mini, могут иметь коэффициент 0.33. Мы предоставляем полную прозрачность в расчетах и статистике. ### Режим работы В разделе "Режим работы" вы можете настроить, как ваш бот будет взаимодействовать с пользователями. Здесь вы найдете следующие параметры: \- Бот может находиться в режиме ожидания обращений от пользователей; \- Если необходимо, чтобы бот инициировал общение первым, вы можете изменить эту настройку; Вы можете задать время начала и окончания работы бота. Это позволяет, например, отключать бота в ночное время или в периоды, когда его работа не требуется.
### Предупреждения для пользователей Если бот настроен на определенный режим работы, рекомендуется добавить предупреждение для пользователей. Это предупреждение будет отображаться, если пользователь попытается обратиться к боту в нерабочее время. После настройки режима работы, информация о текущем режиме будет отображаться в этом разделе. Это позволит вам быстро проверить, в каком режиме работает бот, даже если вкладка свернута.
### Личность и промт Эта вкладка является ключевой для настройки уникальности вашего бота. Здесь вы можете задать основные параметры, которые определяют, как бот будет взаимодействовать с пользователями.
### Озвучка голосовых сообщений Вы можете выбрать голос для озвучки сообщений, которые бот отправляет в Telegram или WhatsApp. Если включена функция голосового ответа, бот будет отвечать как текстом, так и аудио сообщениями, при условии, что в ответе нет ссылок. Это сделано для того, чтобы избежать неуклюжего озвучивания URL-адресов. Если вы хотите использовать собственный голос, вы можете зарегистрироваться в сервисе Eleven Labs и указать уникальный ID голоса. Не забудьте также прописать ключ интеграции в разделе интеграций.
### Внешний промпт Вы можете использовать внешний промпт, разместив его в Google Документе или Notion. Это удобно для совместного редактирования и управления длинными текстами, которые могут превышать 100 тысяч символов. Внешний промпт позволяет команде экспертов работать над настройками бота в одном документе, добавляя комментарии и правки. Вы можете отделить промпт от комментариев к нему: \##ROLE\_START## Тут промпт целиком \##ROLE\_END## Тут можно комментировать, это в промт не попадет
### Первая фраза "приветствие бота" Можете задать первую фразу, с которой бот будет приветствовать пользователя.
### Скрытое сообщение от пользователя Есть возможность отправлять скрытые сообщения от имени пользователя, которые не будут видны пользователю, но на которые бот ответит. Это позволяет начать диалог с определенной темы или настроить бота на нужную волну.
### Роль, цель и поведение Эти параметры составляют основу промпта и помогают структурировать инструкции для бота. В разделе "Роль" указывается, кем является бот, "Цель" определяет, к чему он должен стремиться, а "Поведение" описывает условия, при которых бот действует определенным образом. Эти блоки помогают новичкам понять, как формируется промпт, а профессионалы могут использовать внешний промпт для более гибкой настройки.
### Креативность Если бот выполняет функции, требующие точности, рекомендуется установить креативность на ноль. Если же бот занимается созданием креативного контента, вы можете выбрать любое значение креативности.
### Изображение аватара Здесь можно загрузить изображение для карточки бота
### Теги Установите тег, чтобы легко находить и сортировать ваших ботов среди всех карточек на странице Сотрудники.
## Навыки ### Функции ### Выбор функций Функции позволяют расширять возможности наших ботов, добавляя им новые способности. В этом разделе вы можете найти и подключить необходимые функции. Поиск функций здесь осуществляется по названию или номеру, но он менее интеллектуален, чем в левом меню во вкладке функций. Просто введите название или номер функции, и она будет найдена. Вы можете выбрать несколько функций для подключения к боту, что позволит ему использовать новые возможности. Изначально функции поддерживаются моделями OpenAI, но на нашей платформе вы можете экспериментировать с другими моделями, такими как Yandex GPT или Gigachat от Сбера. Однако, стабильность работы функций с этими моделями не гарантируется. Рекомендуется сначала протестировать функции на моделях OpenAI, а затем переключиться на другие модели для экспериментов. Анализируйте логи и экспорт диалогов, чтобы убедиться в корректности работы функций.
### При каждом ответе запускать одну из функций Эта опция полезна, если каждый ответ бота должен сопровождаться вызовом функции. Однако, вы не можете контролировать, какую именно функцию он выберет. Если подключена только одна функция, она будет запускаться при каждом запросе. Это может быть полезно, например, для записи данных в таблицу или базу данных. Эти параметры доступны только на максимальном тарифе.
### Запускать несколько функций одновременно Позволяет запускать несколько функций одновременно, но без передачи результатов между ними. Например, можно одновременно отправить лид на e-mail и в Telegram. Однако, если вы хотите, чтобы одна функция использовала результат другой, эта опция не подойдет. Эти параметры доступны только на максимальном тарифе.
### Использовать каждую функцию только один раз в новом диалоге Эта настройка позволяет запускать функции в определенной последовательности. Например, если у вас есть три шага: парсинг, генерация картинки и публикация, то каждая функция будет использоваться только один раз в заданной последовательности. Это исключает возможность повторного запуска одной и той же функции в рамках одного диалога. Эти параметры доступны только на максимальном тарифе.
## Базы знаний и (Embedding) ### Подключение баз знаний В этом разделе вы можете подключить базы знаний, которые ранее загружали на платформу. Для этого используйте кнопку "Добавить" и выберите нужную базу. После выбора база будет доступна вашему боту для работы.
### Включить режим отладки Вы можете включить режим отладки, чтобы протестировать, как бот взаимодействует с базой знаний. В этом режиме бот не будет работать с реальными клиентами, а позволит вам проверить корректность выдачи информации. Эти параметры доступны только на максимальном тарифе.
### Количество блоков из базы По умолчанию база знаний разбивается на блоки, что помогает находить нужную информацию. Вы можете настроить количество блоков, которое будет брать бот из найденных по смыслу блоков. Это важно для оптимизации расхода токенов и повышения точности ответов. Эти параметры доступны только на максимальном тарифе.
### Файл со знаниями в формате PDF при прямой интеграции с Assistant от OpenAi Если вы используете ассистентов от OpenAI, вы можете загрузить PDF-файл со знаниями. Обратите внимание, что документы, прикрепленные на стороне OpenAi, должны быть также прикреплены здесь для корректной работы. Эти параметры доступны только на максимальном тарифе.
### База знаний Fine-Tune из файла Google sheets Вы можете использовать файн-тюнинг для улучшения модели. Для этого создайте таблицу в Google Документах с вопросами и ответами (не менее 100 пар) и предоставьте открытую ссылку. После обучения модель получит уникальный номер и будет адаптирована под ваши данные. Учтите, что процесс обучения может занять от 30 минут до нескольких часов. Эти параметры доступны только на максимальном тарифе.
Важные замечания \- Галочку "Включить файн-тюнинг" следует использовать только при изменении данных в документе. \- Обучение доступно только для моделей OpenAI. \- Базы знаний embedding могут использоваться с любыми моделями, независимо от их типа. ### Источники знаний из интернета В этом разделе мы рассмотрим, как использовать интернет-источники для обогащения знаний вашего бота. Основной инструмент, который вам понадобится, — это функция поиска по сайту в Яндексе. Убедитесь, что у вашего бота активирована функция поиска в Яндексе по конкретному сайту. Это позволит боту находить информацию на заданных интернет-страницах. Перед добавлением страницы убедитесь, что она проиндексирована Яндексом. Для этого введите запрос в Яндексе и проверьте, появляется ли нужная страница в результатах поиска. Если страница индексируется, она может быть использована в качестве источника знаний.
Вы можете указать конкретную страницу сайта. В этом случае Яндекс, скорее всего, выдаст именно её, так как это конкретный раздел сайта. Также можно указать адрес всего сайта. В этом случае бот будет использовать первую страницу, которую Яндекс считает наиболее релевантной по заданному ключевому слову. Когда вы указываете адрес сайта или страницы, бот использует Яндекс для поиска по ключевым словам в рамках указанного ресурса. Яндекс предоставляет наиболее релевантный результат, и бот использует информацию с этой страницы в качестве основы для своих знаний. ### Постоянная память #### Графовая память Графовая память — это новая функция, находящаяся в стадии активной разработки и тестирования. Она позволяет боту не только запоминать информацию, но и устанавливать связи между различными информационными блоками. Например, бот может запомнить, кто из ваших контактов является родственником, другом или коллегой, и использовать эти связи для выполнения более сложных задач. Графовая память может быть полезна в различных сценариях, таких как организация мероприятий или управление контактами. Она позволяет боту анализировать связи между данными и предлагать решения, основанные на этих связях.
#### Всегда оставаться в контексте диалога По умолчанию бот знает только время начала диалога, но иногда этого недостаточно. Включение временных меток в каждом сообщении позволяет боту более точно отслеживать ход диалога, особенно если он длится более 24 часов. Это также позволяет продолжать диалог через несколько дней, сохраняя контекст. Однако стоит учитывать, что сохранение контекста увеличивает расход токенов, что может повлиять на стоимость диалогов. Если экономия важнее, вы можете ограничить количество сохраняемых сообщений или отключить эту функцию.
#### Метка времени в сообщениях от пользователя Эта метка при включении позволяет боту получать информацию о текущем времени, дате и некоторых системных параметрах, таких как имя пользователя и канал коммуникации (например, Telegram). Изначально временные метки были разработаны для того, чтобы бот мог отслеживать, сколько времени прошло с начала диалога. Это особенно полезно, если диалог начался, например, два часа назад, и бот предложил что-то с временным ограничением. Если пользователь ответит позже, бот сможет учесть прошедшее время и скорректировать свои действия.
## Каналы коммуникаций В этом разделе мы рассмотрим, как подключить различные каналы коммуникации для взаимодействия с вашими клиентами через ботов. Боты могут быть интегрированы с различными платформами, такими как WhatsApp, персональный Telegram, Telegram-бот и другие. Это позволяет ботам общаться с клиентами на тех платформах, которые вы выберете.
### Входящие Для подключения каналов связи используются различные сервисы, такие как Umnico и Wazzup. Эти сервисы позволяют интегрировать WhatsApp, Telegram, ВКонтакте, Авито, Instagram и другие платформы.
### Umnico Umnico позволяет подключить множество каналов, включая виджеты для сайта. Для интеграции необходимо взять API ключ в личном кабинете Umnico и вставить в соответствующее окно на странице Интеграций в ProTalk и нажать кнопку сохранить. После обновление страницы на зеленом поле появятся подключенные номера каналов.
Скопируйте ID канала и вставьте в соответствующее поле в настройках вашего бота во вкладке Входящие каналы в разделе Umnico. Перезагрузите бота, после чего можно принимать сообщения.
Иногда связь между, например вашим номером Whatsapp и каналом в Umnico может пропасть или закончиться подписка на Umnico, в таком случае Ai бот из ProTalk не получит сообщений. Если он молчит, первым делом проверьте, чтобы статус связки канала и номера в Umnico был активен. ### Wazzup Wazzup поддерживает интеграцию с WhatsApp, Telegram и другими платформами. Для подключения необходимо указать ID канала и API-ключ. При настройке каналов важно правильно указать ID и API-ключи. Например, для Telegram это может быть номер телефона, а для Авито — уникальный ID. Эти данные можно найти в личном кабинете Wazzup. Примеры для записи в окошке “Канал и ID канала”: Номер WhatsApp (whatsapp:79158888888) WhatsApp Business API (wapi:79158888888) Номер Telegram (tgapi:79158888888) ВКонтакте (vk:123456789) Авито (avito:123456789) Instagram (instagram:my\_login\_instagram) Telegram Bot (telegram:my\_bot) Иногда связь между, например вашим номером Whatsapp и каналом в Wazzup может пропасть или закончиться подписка на Wazzup, в таком случае Ai бот из ProTalk не получит сообщений. Если он молчит, первым делом проверьте, чтобы статус связки канала и номера в Wazzup был активен.
### Whapi Здесь нужно указать название канала, которое найдете в личном кабинете Whapi и токен для входящих обращений к боту.
Иногда связь между, например вашим номером Whatsapp и каналом в Whapi может пропасть или закончиться подписка на Whapi, в таком случае Ai бот из ProTalk не получит сообщений. Если он молчит, первым делом проверьте, чтобы статус связки канала и номера в Whapi был активен. ### Wapico Для настройки интеграции с Wapico делаем следующее: 1\. В настройках бота в поле Access Token нужно указать ключ, который нужно взять в личном кабинете Wapico 2\. В разделе "Интеграция и API" копируем ссылку из блока Wapico 3\. В настройках чат-бота в сервисе Wapico вписываем ссылку в поле webhook
### Green-api Здесь нужно указать название канала, которое найдете в личном кабинете Green-api и токен для входящих обращений к боту.
Иногда связь между, например вашим номером Whatsapp и каналом в Green-api может пропасть или закончиться подписка на Green-api, в таком случае Ai бот из ProTalk не получит сообщений. Если он молчит, первым делом проверьте, чтобы статус связки канала и номера в Green-api был активен. ### Chat2Desk Для интеграции необходимо взять API ключ в личном кабинете Chat2Desk и вставить в соответствующее окно на странице Интеграций в ProTalk и нажать кнопку сохранить. После обновление страницы на зеленом поле появятся подключенные каналы ID.
Скопируйте эти данные и вставьте в соответствующие поля в настройках вашего бота во вкладке Входящие каналы. Запись должна состоять через двоеточие из ID оператора, ID канала и названия канала. Пример: operator\_id:channel\_id:transport
### Jivosite Jivosite популярный виджет для сайтов, который можно подключить для взаимодействия с клиентами. Для этого потребуется платный тариф Jivosite и токен, который можно получить через техподдержку.
В вашем личном кабинете JIVO напишите такой запрос в чат поддержки: Мы хотим подключить наш API к боту JIVO: Email: \_\_ВАШ\_EMAIL\_В\_JIVO\_\_ Канал: \_\_ВАШ\_КАНАЛ\_В\_JIVO\_\_ После этого вам вышлют ID провайдера и токен для интеграции с ProTalk. ### WILDBERRIES Добавить описание
## Исходящие ### Выбор Whatsapp, Телеграмм или Телергамм бот Вы можете использовать различные каналы для рассылки сообщений, где бот инициирует общение. Например, выбрав WhatsApp, вы можете задать список номеров для рассылки уведомлений. Однако, важно учитывать ограничения, накладываемые самим WhatsApp. Он может отслеживать нежелательные рассылки, поэтому используйте эту функцию с осторожностью. Не стоит массово загружать списки клиентов. Лучше, если контакты уже имели с вами переписку. Это снизит риск блокировки, так как клиент уже знаком с вашим номером. Для минимального риска блокировки, мы реализовали возможность отправки сообщений с интервалами, чтобы избежать массового спама. Рекомендуется писать текущим клиентам по важным для них вопросам, чтобы они были знакомы с вашим номером и имели историю переписки. Также доступна интеграция с Telegram. Вы можете пополнять список номеров для рассылки, но не стоит добавлять сразу тысячи контактов. Лучше ограничиться, например, 50 номерами на этапе, и чередовать их через время для безопасности. Для отправки сообщений через Telegram бот, клиент должен быть подписан на ваш бот. Сервисы, позволяющие привязывать ваши аккаунты WhatsApp и Telegram, аналогичны тем, что описаны в разделе [Входящие каналы коммуникаций.](#vkhodyashie) ### Телеграмм бот
#### Токен и никейм Перейдите в Telegram и найдите бота @BotFather. Следуйте инструкциям для создания нового бота: выберите имя и получите токен доступа. Вставьте токен бота и его никнейм в соответствующие поля.
### Меню #### Команды в меню Вы можете добавить различные кнопки в меню вашего бота. По умолчанию доступна кнопка «Новый диалог», которая перезапускает бота для начала нового разговора. Кнопки можно располагать как вертикально, так и горизонтально. Для горизонтального расположения используйте запятую для разделения кнопок, а для вертикального — новую строку.
Пример: если вы добавите две команды в одну строку, они будут отображаться горизонтально. Вы можете добавить кнопку для проверки баланса токенов, если ваш бот работает по подписке или пакетам токенов. Для этого необходимо интегрировать бота с платежными сервисами. #### Готовые ответы для команд из меню Вы можете создать кнопки, которые будут выдавать заранее подготовленные ответы без генерации нового текста. Это экономит токены и время.
#### Фраза во время ожидания ответа бота Вы можете задать фразу, которая будет отображаться во время ожидания ответа от бота. Например, «⏳ Думаю ....».
#### Количество подсказок Можно настроить количество подсказок, которые будут отображаться под ответом бота в виде inline-ссылок, еще их называют инлайн кнопки. Сперва необходимо включить режим Inline в настройках @Botfather.
Затем установите количество подсказок в поле “Количество подсказок”
### Обязательная подписка на канал Вы можете настроить бота так, чтобы он требовал подписку на ваш канал или чат перед началом общения. Для этого добавьте бота в качестве администратора канала или чата и укажите соответствующий ID.
### Автоматически переводить текст кнопок в меню бота и готовые ответы на язык пользователя
Ваш Телеграмм бот может самостоятельно переводить себя на любые языки мира. Что переводится: 1\. Приветствия 2\. Кнопки меню 3\. Подсказки 4\. Служебные сообщения Перевод осуществляется с помощью передового Google API, обеспечивая высокое качество и точность. Перевод активируется автоматически, если в команде бота присутствует эмодзи с флагом и как минимум одно слово. Например:
Информация о локализации пользователя берётся из настроек его Телеграмм.
## Еще настройки ### Монетизация В этом разделе мы рассмотрим, как можно монетизировать ваших Telegram-ботов. Существует несколько способов, которые помогут вам извлечь прибыль из вашего проекта.
### Продажа пакетов токенов Вы можете продавать пакеты токенов для использования вашего бота. Например, вы можете предложить 5 миллионов токенов за 1000 рублей. Укажите количество токенов в пакете и стоимость. Также добавьте сообщение, которое будет отправляться пользователю вместе с ссылкой на оплату.
Вы можете предоставить пользователям бесплатные токены для ознакомления с ботом, например, 500 токенов. Используйте реферальные ссылки для привлечения новых пользователей. За каждого привлеченного пользователя вы можете награждать реферала определенным количеством токенов. Для этого используйте в настройках бота команду /share для создания реферальной ссылки. ### Регулярные платежи по подписке Установите период подписки, например, 30 дней за 700 рублей. Предоставьте пользователям тестовый период, например, 5 дней. После окончания тестового периода пользователю будет отправлено сообщение с предложением оплатить подписку.
Важно! Вы можете ограничить количество сообщений, отправляемых пользователем в день (пункт настроек "Защита бота"), чтобы избежать чрезмерного использования в этом режиме. Для успешной монетизации необходимо интегрировать систему приема платежей. Это можно сделать в меню интеграции, добавив ключи от таких систем, как Робокасса. ### Кто может делать копии вашего бота Кроме монетизации через Telegram, вы можете продавать ботов целиком. Например, выбор “Только по приватной ссылке” разрешает через меню бота создавать уникальную ссылку для передачи бота другому пользователю.
Второй вариант для продажи бота, это публикация на странице магазина iiAgent.pro Выкладывайте ботов в магазин, доступный на тарифах "Бизнес" или "Профи". Укажите стоимость в токенах и добавьте описание, чтобы покупатели могли легко найти и понять, для чего предназначен ваш бот.
Вы можете выкладывать ботов бесплатно, чтобы привлечь внимание к своим услугам. Укажите свой email, чтобы потенциальные клиенты могли связаться с вами для заказа разработки бота. ### Лидогенерация В разделе «Лидогенерация» вы можете настроить получение информации о клиентах через различные каналы, такие как электронная почта, Telegram-бот или CRM-системы. Это особенно полезно для бизнеса, стремящегося автоматизировать процесс сбора и обработки клиентских данных.
#### Уведомление на email Достаточно ввести свой электронный адрес в соответствующее поле и убедиться, что у вашего бота подключена функция “Отправка лидов”.
#### Уведомление в Телеграмм бот Укажите токен вашего Telegram-бота и ваш личный ID, чтобы получать уведомления напрямую. Для получения вашего ID используйте специального бота @getmyid\_bot, который предоставит вам ваш уникальный номер.
#### Передача данных в Битрикс24 Вы можете отдельно настроить передачу данных в Битрикс24. Для этого необходимо создать входящий веб-хук в Битрикс24, предоставить необходимые доступы и вставить его в настройки бота. Зайдите в Битрикс24 в раздел "Разработчикам" и выбирайте "Другое". Затем Входящий вебхук.
В настройках скопируйте ключ интеграции и дайте права для доступа к необходимым сущностям системы в Битрикс24.
#### Передача данных в AmoCRM Укажите долгосрочный токен и специальную ссылку в настройках AmoCRM для передачи данных. Чтобы создать такой токен перейдите в Webhooks, затем в раздел внешних интеграций.
Скопируйте ссылку для перенаправления:
Вставьте её в соответствующее поле настроек интеграции amoCRM и установите галочку “Предоставить доступ” и сохраните.
В установленных интеграциях должна появиться ваша интеграция.
Чтобы она стала активной необходимо зайти в её настройки и нажать кнопку “Установить”.
Сгенерируйте токен во вкладке “Ключи и доступы” и вставьте его в настройках бота.
После того как клиент отправит свои контактные данные, либо по другому условию, которое вы сами зададите в промпте, бот активирует функцию «Отправка Лида». Данные автоматически отправляются на указанные адреса: электронная почта, Telegram и CRM-системы. В CRM создается карточка лида с кратким описанием диалога и всей необходимой информацией. #### Диалоговые настройки В этом разделе вы найдете все, что связано с управлением диалогами и сообщениями, включая ограничения на количество сообщений, которые клиент может получить за определенный период времени. Важно! Если вы хотите изменить или сбросить установленные лимиты, рекомендуется сохранить изменения, выключить бота и перезапустить его. Это гарантирует, что все изменения вступят в силу и старые настройки не будут действовать.
#### Длина контекста сообщений Это параметр, который определяет, сколько информации бот будет помнить из предыдущих сообщений. Ограничение длины контекста может помочь сэкономить количество токенов, что особенно полезно, если вы хотите оставить больше места для инструкций или базы знаний. Если ограничение не требуется, просто оставьте это поле пустым. ![](https://1389071903-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmgaG4ePuhIcI3pwDYuT9%2Fuploads%2F1irFEHzCOkDCtP12u3hP%2Fimage.png?alt=media\&token=cc20f160-63ed-4c4d-a628-f4d0bed7e665) #### Задержка отправки сообщения Вы также можете установить задержку отправки сообщений. По умолчанию бот отвечает сразу после обработки запроса. Однако, если вы хотите, чтобы бот имитировал человеческое поведение, вы можете установить задержку, например, в 10 секунд. Это позволит пользователю подумать и, возможно, дополнить свой запрос, прежде чем бот ответит. Такая задержка может быть полезна для создания более естественного взаимодействия. ![](https://1389071903-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmgaG4ePuhIcI3pwDYuT9%2Fuploads%2F38BFRvc7yLHkNqLhISxN%2Fimage.png?alt=media\&token=c71f5aef-cea8-477d-bb78-da10b498eee8)
#### Сообщение от пользователя при долгом ожидании Эта функция позволяет боту отправлять сообщение пользователю, если тот не отвечает в течение определенного времени. Например, если пользователь не отвечает в течение 5 минут, бот может задать вопрос, чтобы напомнить о диалоге. Это особенно полезно в продажах, где бот может использовать новые аргументы для убеждения клиента. Доступно по платной подписке.
#### Количество минут ожидания ответа от пользователя Здесь указывается время, через которое бот снова возобновит свой диалог.
#### Максимальная длина сообщения от пользователя Вы можете ограничить максимальную длину сообщения, которое пользователь может отправить боту. Это помогает контролировать расход токенов и предотвращает отправку слишком длинных сообщений, которые могут перегрузить систему. Например, вы можете установить ограничение в 1000 символов. Если пользователь превысит это ограничение, бот отправит сообщение с просьбой сократить текст. ![](https://1389071903-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmgaG4ePuhIcI3pwDYuT9%2Fuploads%2F0PjIoZXWkRLSs7aM8Bjk%2Fimage.png?alt=media\&token=e66ec051-d096-48a2-b8cb-733166c1b734) #### Сообщение при превышении максимальной длины Здесь вы должны написать текст предупреждения о превышении максимальной длины сообщения. ![](https://1389071903-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmgaG4ePuhIcI3pwDYuT9%2Fuploads%2FCYwC8Tu6V7neXz1l9rR1%2Fimage.png?alt=media\&token=233791aa-47af-4d0b-b79a-96e9110e4264) ### Настройки для групповых чатов Телеграмм #### Имя на которое реагирует бот Введение бота в групповые чаты может значительно улучшить взаимодействие и автоматизировать многие процессы. Однако, чтобы бот не мешал общению между участниками, необходимо правильно настроить его поведение. В этом разделе мы подробно рассмотрим, как сделать так, чтобы ваш бот реагировал только на определенные команды и не отвлекал участников чата. Для начала, добавьте бота в чат в качестве администратора. Это позволит ему иметь доступ ко всем сообщениям и выполнять необходимые действия. Чтобы бот не отвечал на каждое сообщение, настройте его так, чтобы он реагировал только на упоминание своего имени. Это имя должно быть уникальным и чувствительным к регистру. Например, если вашего бота зовут "Вася", он будет реагировать на сообщения, содержащие "Вася", "вася", "ВАСЯ" и т.д. Убедитесь, что имя бота уникально и не используется в других контекстах в чате. Это предотвратит случайные активации бота. Сообщите участникам чата о том, как обращаться к боту. Это поможет избежать недоразумений и обеспечит корректное взаимодействие. В некоторых системах возможно переключение между ботами по имени. Это позволяет направлять диалоги к нужному боту, просто упоминая его имя. #### Активационная фраза Активационная фраза — это специальное слово или фраза, которая запускает диалог с ботом. Она действует как пароль, необходимый для начала общения. Если бот еще не начал диалог, он не будет реагировать на сообщения, пока не будет произнесена активационная фраза. Это предотвращает случайные активации и обеспечивает контроль над началом взаимодействия. Активационная фраза может использоваться не только в Telegram, но и в других платформах, таких как WhatsApp или CRM-системы, например, Битрикс24. Например, если клиент хочет получить скидку, он может использовать промокод в качестве активационной фразы. После этого бот начнет взаимодействие и предоставит необходимую информацию или услугу. ### Защита бота В данном разделе мы рассмотрим, как можно эффективно защитить вашего бота, используя различные инструменты и настройки. Одним из ключевых элементов защиты является роль корректора, или цензора, который проверяет ответы вашего бота перед их отправкой пользователю.
### Роль корректора Роль корректора представляет собой отдельную нейросеть, которая анализирует ответы бота. Она проверяет каждое сообщение, которое бот собирается отправить, и может вмешаться, если обнаружит нежелательное содержание. Например, если бот пытаются обмануть или выведать конфиденциальную информацию, такую как токены, корректор может заблокировать ответ и заменить его защитной фразой. Эта роль позволяет не только защищать, но и корректировать ответы бота. Вы можете задать темы, на которые бот не должен отвечать, например, политические вопросы. Хотя многие модели уже имеют встроенную цензуру, роль корректора предоставляет дополнительный уровень контроля. Важно отметить, что роль корректора работает на той же модели, что и ваш бот. Это означает, что она использует те же алгоритмы и настройки, что и основной бот, и проверяет каждое сообщение, сгенерированное ботом, а также последнее сообщение пользователя. #### Лимит сообщений на 1 пользователя в течении 24 часов Вы можете ограничить количество сообщений, которые пользователь может отправить боту в течение 24 часов. Например, не более 30 сообщений в сутки.
#### Общий лимит сообщений на пользователя за все время Вы можете задать общее количество сообщений, которые пользователь может отправить за все время использования бота. Например, 150 сообщений, после чего бот перестанет отвечать этому пользователю. Эти настройки позволяют вам контролировать расход ресурсов и строить экономическую модель для вашего бота, определяя стоимость его использования. Предположим, ваш бот предназначен для проведения одноразовой акции, например, оповещения новых клиентов. В этом случае имеет смысл установить жесткие лимиты, чтобы бот выполнил свою задачу и больше не взаимодействовал с пользователем. Это предотвратит попытки манипуляции ботом и использование его в других целях.
### Управление ботом по эмодзи Управление ботом по эмодзи позволяет пользователям контролировать действия бота, используя определенные эмодзи или наборы символов. Это может быть полезно в различных сценариях, например, для остановки бота, завершения диалога или выполнения других действий.
Все наборы эмодзи вы можете изменять. Не рекомендуем ставить один смайлик - если в ответе бота случайно он появится бот ЗАМОЛЧИТ. В режиме ожидания сообщений бот может завершить диалог по своей инициативе, если это необходимо. Например, если клиент не отвечает в течение определенного времени, бот может отправить эмодзи и завершить диалог. Боты, подключенные через платформы, такие как Telegram или WhatsApp, часто имеют интерфейсы, где видны все диалоги. Операторы могут использовать эти интерфейсы для управления ботами и взаимодействия с клиентами. Для управления ботом рекомендуется использовать уникальные эмодзи или комбинации символов, чтобы избежать пересечения с обычным текстом. Это может быть набор из двух эмодзи или комбинация эмодзи и текста. #### Цель выполнена Бот может автоматически завершить диалог, отправив заранее заданный эмодзи, когда цель взаимодействия достигнута. Например, если бот должен предоставить информацию и завершить общение, он отправит соответствующий набор эмодзи, сигнализируя о завершении. #### Завершить диалог Вы можете задать условия, при которых диалог будет завершен. Это может быть полезно, если клиент благодарит бота или если цель взаимодействия не достигнута, но клиент попрощался. Условия могут быть настроены в промпте так, чтобы бот завершал диалог в зависимости от различных событий. #### Остановить работу бота Вы можете остановить бота, отправив определенный набор эмодзи из чата, где происходит взаимодействие с ботом. Это особенно полезно, если вы хотите вмешаться в диалог или изменить его направление. Оператор может вмешаться в диалог, отправив уникальный эмодзи или набор символов, чтобы остановить бота и взять управление на себя. Это может быть полезно, если диалог идет не в том направлении или требуется личное общение. #### Возобновить работу бота Установленный здесь набор эмодзи, отправленный оператором возобновит диалог. #### Остановить диалог с пользователем навсегда Вы можете настроить бота так, чтобы он завершал диалог навсегда или временно. Например, если бот завершил свою задачу, он может замолчать навсегда, чтобы не мешать дальнейшему процессу, даже после рестарта. #### Возобновить остановленный навсегда диалог Есть возможность возобновить остановленный навсегда диалог с помощью другого набора эмодзи. ### Активация по расписанию Активация бота по расписанию — это процесс, который позволяет запускать бота в заранее установленное время для выполнения определённых задач. Это может быть полезно для автоматизации различных процессов, таких как сбор информации, публикация новостей или выполнение других задач. В этом разделе мы подробно рассмотрим, как настроить и использовать активацию бота по расписанию.
#### Дата старта автоматических запусков Вы можете задать точную дату и время, когда бот начнёт выполнять свои задачи. Это может быть одноразовое действие или регулярные задачи, выполняемые ежедневно, еженедельно, ежемесячно и т.д. #### Напишите ваши команды боту Бот может выполнять не только диалоговые задачи, но и участвовать в автоматических цепочках действий. Например, бот может собирать информацию из Telegram-канала, переписывать её в заданном стиле, генерировать или находить соответствующую картинку и публиковать новость в канал. Вы можете задать последовательность команд, которые бот будет выполнять одна за другой. Это достигается с помощью специального разделителя, который позволяет ботам выполнять задачи в заданном порядке - ##. Пример использования: \- Представьте, что у вас есть бот, который ежедневно в определённое время собирает новости из Telegram-канала, переписывает их, добавляет изображение и публикует в вашем канале. Вы можете настроить бота так, чтобы он выполнял эти действия автоматически, без вашего участия. \- Укажите точное время, когда бот должен начать выполнение задач. Это может быть любое время суток, в зависимости от ваших потребностей. \- Напишите команды, которые бот должен выполнить. Например, "выбери канал", "сделай рерайт", "найди картинку", "опубликуй новость". Каждая команда должна быть чётко прописана и разделена специальным символом ## для последовательного выполнения. \- Перед автоматизацией рекомендуется протестировать команды в ручном режиме. Это поможет убедиться, что бот выполняет задачи правильно и без ошибок. \- Если что-то пошло не так, вы можете использовать логи для анализа и исправления ошибок. Логи помогут понять, на каком этапе произошёл сбой и что нужно скорректировать. #### Ссылка на таблицу Google для записи логов
Для того чтобы настроить Google Таблицу для получения логов, выполните следующие шаги: \- Перейдите на сайт Google Таблиц и создайте новый пустой документ. \- Нажмите на кнопку "Поделиться" в правом верхнем углу экрана. \- В открывшемся окне выберите "Настройки доступа". \- Установите режим доступа "Редактор" для всех, у кого есть ссылка. Это позволит логам автоматически выгружаться в таблицу. \- Скопируйте ссылку на вашу Google Таблицу. \- Вставьте скопированную ссылку в это окошко в настройках бота. После выполнения этих шагов, логи начнут автоматически выгружаться в вашу Google Таблицу. Убедитесь, что доступ к таблице открыт на редактирование, чтобы избежать проблем с выгрузкой данных. \
# Базовые параметры * [Выбор LLM модели или провайдера](https://docs.iiagent.pro/nastroika-bota#vybor-llm-modeli-ili-provaidera) * [Режим работы](https://docs.iiagent.pro/nastroika-bota#rezhim-raboty) * [Предупреждения для пользователей](https://docs.iiagent.pro/nastroika-bota#preduprezhdeniya-dlya-polzovatelei) * [Личность и промт](https://docs.iiagent.pro/nastroika-bota#lichnost-i-promt) * [Озвучка голосовых сообщений](https://docs.iiagent.pro/nastroika-bota#ozvuchka-golosovykh-soobshenii) * [Внешний промпт](https://docs.iiagent.pro/nastroika-bota#vneshnii-prompt) * [Первая фраза "приветствие бота"](https://docs.iiagent.pro/nastroika-bota#pervaya-fraza-privetstvie-bota) * [Скрытое сообщение от пользователя](https://docs.iiagent.pro/nastroika-bota#skrytoe-soobshenie-ot-polzovatelya) * [Роль, цель и поведение](https://docs.iiagent.pro/nastroika-bota#rol-cel-i-povedenie) * [Креативность](https://docs.iiagent.pro/nastroika-bota#kreativnost) * [Изображение аватара](https://docs.iiagent.pro/nastroika-bota#izobrazhenie-avatara) * [Теги](https://docs.iiagent.pro/nastroika-bota#tegi) ## Выбор LLM модели или провайдера В верхней части карточки представлены базовые параметры, на которых работает ваш бот. В данном примере, интеллект бота функционирует на платформе chatGPT-4-o-mini. В меню вы можете выбрать другую модель, включая ассистентов от Open AI.
Если у вас есть ассистенты от OpenAI и вы хотите использовать их на нашей платформе, выберите соответствующую опцию. Вам потребуется ввести ключ OpenAI и уникальный ID ассистента. Если вы работали с платформой Cozy, вы также можете интегрировать их ботов, указав ключ и уникальный ID. Наша платформа поддерживает различные модели, включая OpenAI, Claude, Llama, Groq, Яндекс-GPT, DeepSeek, Gemini и Giga-chat от Cбера. Вы можете выбрать любую из них в зависимости от ваших потребностей. Если вы хотите использовать свои собственные токены OpenAI, введите свой ключ в левом окошке. В этом случае конкретный бот будет использовать ваши личные токены OpenAI. Если поле остается пустым, будут использоваться токены нашей платформы, которые вы можете приобрести в разделе "Мой тариф".
Разные LLM модели имеют различные коэффициенты. Например, базовая модель chatGPT 3.5 turbo 0125 имеет коэффициент 1, что означает, что токены тратятся один к одному. Другие модели могут иметь разные коэффициенты, например, более дорогие модели могут умножаться на коэффициент 7, а некоторые, как chatGPT-o-4 mini, могут иметь коэффициент 0.33. Мы предоставляем полную прозрачность в расчетах и статистике. ## Режим работы В разделе "Режим работы" вы можете настроить, как ваш бот будет взаимодействовать с пользователями. Здесь вы найдете следующие параметры: \- Бот может находиться в режиме ожидания обращений от пользователей; \- Если необходимо, чтобы бот инициировал общение первым, вы можете изменить эту настройку; Вы можете задать время начала и окончания работы бота. Это позволяет, например, отключать бота в ночное время или в периоды, когда его работа не требуется.
### Предупреждения для пользователей Если бот настроен на определенный режим работы, рекомендуется добавить предупреждение для пользователей. Это предупреждение будет отображаться, если пользователь попытается обратиться к боту в нерабочее время. После настройки режима работы, информация о текущем режиме будет отображаться в этом разделе. Это позволит вам быстро проверить, в каком режиме работает бот, даже если вкладка свернута.
## Личность и промт Эта вкладка является ключевой для настройки уникальности вашего бота. Здесь вы можете задать основные параметры, которые определяют, как бот будет взаимодействовать с пользователями.
### Озвучка голосовых сообщений Вы можете выбрать голос для озвучки сообщений, которые бот отправляет в Telegram или WhatsApp. Если включена функция голосового ответа, бот будет отвечать как текстом, так и аудио сообщениями, при условии, что в ответе нет ссылок. Это сделано для того, чтобы избежать неуклюжего озвучивания URL-адресов. Если вы хотите использовать собственный голос, вы можете зарегистрироваться в сервисе Eleven Labs и указать уникальный ID голоса. Не забудьте также прописать ключ интеграции в разделе интеграций.
### Внешний промпт Вы можете использовать внешний промпт, разместив его в Google Документе или Notion. Это удобно для совместного редактирования и управления длинными текстами, которые могут превышать 100 тысяч символов. Внешний промпт позволяет команде экспертов работать над настройками бота в одном документе, добавляя комментарии и правки. Вы можете отделить промпт от комментариев к нему: \##ROLE\_START## Тут промпт целиком \##ROLE\_END## Тут можно комментировать, это в промт не попадет
### Первая фраза "приветствие бота" Можете задать первую фразу, с которой бот будет приветствовать пользователя.
### Скрытое сообщение от пользователя Есть возможность отправлять скрытые сообщения от имени пользователя, которые не будут видны пользователю, но на которые бот ответит. Это позволяет начать диалог с определенной темы или настроить бота на нужную волну.
### Роль, цель и поведение Эти параметры составляют основу промпта и помогают структурировать инструкции для бота. В разделе "Роль" указывается, кем является бот, "Цель" определяет, к чему он должен стремиться, а "Поведение" описывает условия, при которых бот действует определенным образом. Эти блоки помогают новичкам понять, как формируется промпт, а профессионалы могут использовать внешний промпт для более гибкой настройки.
### Креативность Если бот выполняет функции, требующие точности, рекомендуется установить креативность на ноль. Если же бот занимается созданием креативного контента, вы можете выбрать любое значение креативности.
### Изображение аватара Здесь можно загрузить изображение для карточки бота
### Теги Установите тег, чтобы легко находить и сортировать ваших ботов среди всех карточек на странице Сотрудники.
# Базы знаний и (Embedding) * [Подключение баз знаний](https://docs.iiagent.pro/nastroika-bota#podklyuchenie-baz-znanii) * [Включить режим отладки](https://docs.iiagent.pro/nastroika-bota#vklyuchit-rezhim-otladki) * [Количество блоков из базы](https://docs.iiagent.pro/nastroika-bota#kolichestvo-blokov-iz-bazy) * [Файл со знаниями в формате PDF при прямой интеграции с Assistant от OpenAi](https://docs.iiagent.pro/nastroika-bota#fail-so-znaniyami-v-formate-pdf-pri-pryamoi-integracii-s-assistant-ot-openai) * [База знаний Fine-Tune из файла Google sheets](https://docs.iiagent.pro/nastroika-bota#baza-znanii-fine-tune-iz-faila-google-sheets) * [Источники знаний из интернета](https://docs.iiagent.pro/nastroika-bota#istochniki-znanii-iz-interneta) * [Постоянная память](https://docs.iiagent.pro/nastroika-bota#postoyannaya-pamyat) ### Подключение баз знаний В этом разделе вы можете подключить базы знаний, которые ранее загружали на платформу. Для этого используйте кнопку "Добавить" и выберите нужную базу. После выбора база будет доступна вашему боту для работы.
### Включить режим отладки Вы можете включить режим отладки, чтобы протестировать, как бот взаимодействует с базой знаний. В этом режиме бот не будет работать с реальными клиентами, а позволит вам проверить корректность выдачи информации. Эти параметры доступны только на максимальном тарифе.
### Количество блоков из базы По умолчанию база знаний разбивается на блоки, что помогает находить нужную информацию. Вы можете настроить количество блоков, которое будет брать бот из найденных по смыслу блоков. Это важно для оптимизации расхода токенов и повышения точности ответов. Эти параметры доступны только на максимальном тарифе.
### Файл со знаниями в формате PDF при прямой интеграции с Assistant от OpenAi Если вы используете ассистентов от OpenAI, вы можете загрузить PDF-файл со знаниями. Обратите внимание, что документы, прикрепленные на стороне OpenAi, должны быть также прикреплены здесь для корректной работы. Эти параметры доступны только на максимальном тарифе.
### База знаний Fine-Tune из файла Google sheets Вы можете использовать файн-тюнинг для улучшения модели. Для этого создайте таблицу в Google Документах с вопросами и ответами (не менее 100 пар) и предоставьте открытую ссылку. После обучения модель получит уникальный номер и будет адаптирована под ваши данные. Учтите, что процесс обучения может занять от 30 минут до нескольких часов. Эти параметры доступны только на максимальном тарифе.
Важные замечания \- Галочку "Включить файн-тюнинг" следует использовать только при изменении данных в документе. \- Обучение доступно только для моделей OpenAI. \- Базы знаний embedding могут использоваться с любыми моделями, независимо от их типа. ### Источники знаний из интернета В этом разделе мы рассмотрим, как использовать интернет-источники для обогащения знаний вашего бота. Основной инструмент, который вам понадобится, — это функция поиска по сайту в Яндексе. Убедитесь, что у вашего бота активирована функция поиска в Яндексе по конкретному сайту. Это позволит боту находить информацию на заданных интернет-страницах. Перед добавлением страницы убедитесь, что она проиндексирована Яндексом. Для этого введите запрос в Яндексе и проверьте, появляется ли нужная страница в результатах поиска. Если страница индексируется, она может быть использована в качестве источника знаний.
Вы можете указать конкретную страницу сайта. В этом случае Яндекс, скорее всего, выдаст именно её, так как это конкретный раздел сайта. Также можно указать адрес всего сайта. В этом случае бот будет использовать первую страницу, которую Яндекс считает наиболее релевантной по заданному ключевому слову. Когда вы указываете адрес сайта или страницы, бот использует Яндекс для поиска по ключевым словам в рамках указанного ресурса. Яндекс предоставляет наиболее релевантный результат, и бот использует информацию с этой страницы в качестве основы для своих знаний. ### Постоянная память #### Графовая память Графовая память — это новая функция, находящаяся в стадии активной разработки и тестирования. Она позволяет боту не только запоминать информацию, но и устанавливать связи между различными информационными блоками. Например, бот может запомнить, кто из ваших контактов является родственником, другом или коллегой, и использовать эти связи для выполнения более сложных задач. Графовая память может быть полезна в различных сценариях, таких как организация мероприятий или управление контактами. Она позволяет боту анализировать связи между данными и предлагать решения, основанные на этих связях.
#### Всегда оставаться в контексте диалога По умолчанию бот знает только время начала диалога, но иногда этого недостаточно. Включение временных меток в каждом сообщении позволяет боту более точно отслеживать ход диалога, особенно если он длится более 24 часов. Это также позволяет продолжать диалог через несколько дней, сохраняя контекст. Однако стоит учитывать, что сохранение контекста увеличивает расход токенов, что может повлиять на стоимость диалогов. Если экономия важнее, вы можете ограничить количество сохраняемых сообщений или отключить эту функцию.
#### Метка времени в сообщениях от пользователя Эта метка при включении позволяет боту получать информацию о текущем времени, дате и некоторых системных параметрах, таких как имя пользователя и канал коммуникации (например, Telegram). Изначально временные метки были разработаны для того, чтобы бот мог отслеживать, сколько времени прошло с начала диалога. Это особенно полезно, если диалог начался, например, два часа назад, и бот предложил что-то с временным ограничением. Если пользователь ответит позже, бот сможет учесть прошедшее время и скорректировать свои действия.
## Каналы коммуникаций # Навыки * [Функции](https://docs.iiagent.pro/nastroika-bota#funkcii) * [Выбор функций](https://docs.iiagent.pro/nastroika-bota#vybor-funkcii) * [При каждом ответе запускать одну из функций](https://docs.iiagent.pro/nastroika-bota#pri-kazhdom-otvete-zapuskat-odnu-iz-funkcii) * [Запускать несколько функций одновременно](https://docs.iiagent.pro/nastroika-bota#zapuskat-neskolko-funkcii-odnovremenno) * [Использовать каждую функцию только один раз в новом диалоге](https://docs.iiagent.pro/nastroika-bota#ispolzovat-kazhduyu-funkciyu-tolko-odin-raz-v-novom-dialoge) ## Функции ### Выбор функций Функции позволяют расширять возможности наших ботов, добавляя им новые способности. В этом разделе вы можете найти и подключить необходимые функции. Поиск функций здесь осуществляется по названию или номеру, но он менее интеллектуален, чем в левом меню во вкладке функций. Просто введите название или номер функции, и она будет найдена. Вы можете выбрать несколько функций для подключения к боту, что позволит ему использовать новые возможности. Изначально функции поддерживаются моделями OpenAI, но на нашей платформе вы можете экспериментировать с другими моделями, такими как Yandex GPT или Gigachat от Сбера. Однако, стабильность работы функций с этими моделями не гарантируется. Рекомендуется сначала протестировать функции на моделях OpenAI, а затем переключиться на другие модели для экспериментов. Анализируйте логи и экспорт диалогов, чтобы убедиться в корректности работы функций.
### При каждом ответе запускать одну из функций Эта опция полезна, если каждый ответ бота должен сопровождаться вызовом функции. Однако, вы не можете контролировать, какую именно функцию он выберет. Если подключена только одна функция, она будет запускаться при каждом запросе. Это может быть полезно, например, для записи данных в таблицу или базу данных. Эти параметры доступны только на максимальном тарифе.
### Запускать несколько функций одновременно Позволяет запускать несколько функций одновременно, но без передачи результатов между ними. Например, можно одновременно отправить лид на e-mail и в Telegram. Однако, если вы хотите, чтобы одна функция использовала результат другой, эта опция не подойдет. Эти параметры доступны только на максимальном тарифе.
### Использовать каждую функцию только один раз в новом диалоге Эта настройка позволяет запускать функции в определенной последовательности. Например, если у вас есть три шага: парсинг, генерация картинки и публикация, то каждая функция будет использоваться только один раз в заданной последовательности. Это исключает возможность повторного запуска одной и той же функции в рамках одного диалога. Эти параметры доступны только на максимальном тарифе.
## Базы знаний и embedding ### Подключение баз знаний В этом разделе вы можете подключить базы знаний, которые ранее загружали на платформу. Для этого используйте кнопку "Добавить" и выберите нужную базу. После выбора база будет доступна вашему боту для работы.
### Включить режим отладки Вы можете включить режим отладки, чтобы протестировать, как бот взаимодействует с базой знаний. В этом режиме бот не будет работать с реальными клиентами, а позволит вам проверить корректность выдачи информации. Эти параметры доступны только на максимальном тарифе.
### Количество блоков из базы По умолчанию база знаний разбивается на блоки, что помогает находить нужную информацию. Вы можете настроить количество блоков, которое будет брать бот из найденных по смыслу блоков. Это важно для оптимизации расхода токенов и повышения точности ответов. Эти параметры доступны только на максимальном тарифе.
### Файл со знаниями в формате PDF при прямой интеграции с Assistant от OpenAi Если вы используете ассистентов от OpenAI, вы можете загрузить PDF-файл со знаниями. Обратите внимание, что документы, прикрепленные на стороне OpenAi, должны быть также прикреплены здесь для корректной работы. Эти параметры доступны только на максимальном тарифе.
### База знаний Fine-Tune из файла Google sheets Вы можете использовать файн-тюнинг для улучшения модели. Для этого создайте таблицу в Google Документах с вопросами и ответами (не менее 100 пар) и предоставьте открытую ссылку. После обучения модель получит уникальный номер и будет адаптирована под ваши данные. Учтите, что процесс обучения может занять от 30 минут до нескольких часов. Эти параметры доступны только на максимальном тарифе.
Важные замечания \- Галочку "Включить файн-тюнинг" следует использовать только при изменении данных в документе. \- Обучение доступно только для моделей OpenAI. \- Базы знаний embedding могут использоваться с любыми моделями, независимо от их типа. ## Источники знаний из интернета В этом разделе мы рассмотрим, как использовать интернет-источники для обогащения знаний вашего бота. Основной инструмент, который вам понадобится, — это функция поиска по сайту в Яндексе. Убедитесь, что у вашего бота активирована функция поиска в Яндексе по конкретному сайту. Это позволит боту находить информацию на заданных интернет-страницах. Перед добавлением страницы убедитесь, что она проиндексирована Яндексом. Для этого введите запрос в Яндексе и проверьте, появляется ли нужная страница в результатах поиска. Если страница индексируется, она может быть использована в качестве источника знаний.
Вы можете указать конкретную страницу сайта. В этом случае Яндекс, скорее всего, выдаст именно её, так как это конкретный раздел сайта. Также можно указать адрес всего сайта. В этом случае бот будет использовать первую страницу, которую Яндекс считает наиболее релевантной по заданному ключевому слову. Когда вы указываете адрес сайта или страницы, бот использует Яндекс для поиска по ключевым словам в рамках указанного ресурса. Яндекс предоставляет наиболее релевантный результат, и бот использует информацию с этой страницы в качестве основы для своих знаний. ## Постоянная память ### Графовая память Графовая память — это новая функция, находящаяся в стадии активной разработки и тестирования. Она позволяет боту не только запоминать информацию, но и устанавливать связи между различными информационными блоками. Например, бот может запомнить, кто из ваших контактов является родственником, другом или коллегой, и использовать эти связи для выполнения более сложных задач. Графовая память может быть полезна в различных сценариях, таких как организация мероприятий или управление контактами. Она позволяет боту анализировать связи между данными и предлагать решения, основанные на этих связях.
### Всегда оставаться в контексте диалога По умолчанию бот знает только время начала диалога, но иногда этого недостаточно. Включение временных меток в каждом сообщении позволяет боту более точно отслеживать ход диалога, особенно если он длится более 24 часов. Это также позволяет продолжать диалог через несколько дней, сохраняя контекст. Однако стоит учитывать, что сохранение контекста увеличивает расход токенов, что может повлиять на стоимость диалогов. Если экономия важнее, вы можете ограничить количество сохраняемых сообщений или отключить эту функцию.
### Метка времени в сообщениях от пользователя Эта метка при включении позволяет боту получать информацию о текущем времени, дате и некоторых системных параметрах, таких как имя пользователя и канал коммуникации (например, Telegram). Изначально временные метки были разработаны для того, чтобы бот мог отслеживать, сколько времени прошло с начала диалога. Это особенно полезно, если диалог начался, например, два часа назад, и бот предложил что-то с временным ограничением. Если пользователь ответит позже, бот сможет учесть прошедшее время и скорректировать свои действия.
# Каналы коммуникаций В этом разделе мы рассмотрим, как подключить различные каналы коммуникации для взаимодействия с вашими клиентами через ботов. Боты могут быть интегрированы с различными платформами, такими как WhatsAp
* [Входящие](https://docs.iiagent.pro/nastroika-bota#vkhodyashie) * [Umnico](https://docs.iiagent.pro/nastroika-bota#umnico) * [Wazzup](https://docs.iiagent.pro/nastroika-bota#wazzup) * [Whapi](https://docs.iiagent.pro/nastroika-bota#whapi) * [Wapico](https://docs.iiagent.pro/nastroika-bota#wapico) * [Green-api](https://docs.iiagent.pro/nastroika-bota#green-api) * [Chat2Desk](https://docs.iiagent.pro/nastroika-bota#chat2desk) * [Jivosite](https://docs.iiagent.pro/nastroika-bota#jivosite) * [WILDBERRIES](https://docs.iiagent.pro/nastroika-bota#wildberries) ## Входящие Для подключения каналов связи используются различные сервисы, такие как Umnico и Wazzup. Эти сервисы позволяют интегрировать WhatsApp, Telegram, ВКонтакте, Авито, Instagram и другие платформы.
### Umnico Umnico позволяет подключить множество каналов, включая виджеты для сайта. Для интеграции необходимо взять API ключ в личном кабинете Umnico и вставить в соответствующее окно на странице Интеграций в ProTalk и нажать кнопку сохранить. После обновление страницы на зеленом поле появятся подключенные номера каналов.
Скопируйте ID канала и вставьте в соответствующее поле в настройках вашего бота во вкладке Входящие каналы в разделе Umnico. Перезагрузите бота, после чего можно принимать сообщения.
Иногда связь между, например вашим номером Whatsapp и каналом в Umnico может пропасть или закончиться подписка на Umnico, в таком случае Ai бот из ProTalk не получит сообщений. Если он молчит, первым делом проверьте, чтобы статус связки канала и номера в Umnico был активен. ### Wazzup Wazzup поддерживает интеграцию с WhatsApp, Telegram и другими платформами. Для подключения необходимо указать ID канала и API-ключ. При настройке каналов важно правильно указать ID и API-ключи. Например, для Telegram это может быть номер телефона, а для Авито — уникальный ID. Эти данные можно найти в личном кабинете Wazzup. Примеры для записи в окошке “Канал и ID канала”: Номер WhatsApp (whatsapp:79158888888) WhatsApp Business API (wapi:79158888888) Номер Telegram (tgapi:79158888888) ВКонтакте (vk:123456789) Авито (avito:123456789) Instagram (instagram:my\_login\_instagram) Telegram Bot (telegram:my\_bot) Иногда связь между, например вашим номером Whatsapp и каналом в Wazzup может пропасть или закончиться подписка на Wazzup, в таком случае Ai бот из ProTalk не получит сообщений. Если он молчит, первым делом проверьте, чтобы статус связки канала и номера в Wazzup был активен.
### Whapi Здесь нужно указать название канала, которое найдете в личном кабинете Whapi и токен для входящих обращений к боту.
Иногда связь между, например вашим номером Whatsapp и каналом в Whapi может пропасть или закончиться подписка на Whapi, в таком случае Ai бот из ProTalk не получит сообщений. Если он молчит, первым делом проверьте, чтобы статус связки канала и номера в Whapi был активен. ### Wapico Для настройки интеграции с Wapico делаем следующее: 1\. В настройках бота в поле Access Token нужно указать ключ, который нужно взять в личном кабинете Wapico 2\. В разделе "Интеграция и API" копируем ссылку из блока Wapico 3\. В настройках чат-бота в сервисе Wapico вписываем ссылку в поле webhook
### Green-api Здесь нужно указать название канала, которое найдете в личном кабинете Green-api и токен для входящих обращений к боту.
Иногда связь между, например вашим номером Whatsapp и каналом в Green-api может пропасть или закончиться подписка на Green-api, в таком случае Ai бот из ProTalk не получит сообщений. Если он молчит, первым делом проверьте, чтобы статус связки канала и номера в Green-api был активен. ### Chat2Desk Для интеграции необходимо взять API ключ в личном кабинете Chat2Desk и вставить в соответствующее окно на странице Интеграций в ProTalk и нажать кнопку сохранить. После обновление страницы на зеленом поле появятся подключенные каналы ID.
Скопируйте эти данные и вставьте в соответствующие поля в настройках вашего бота во вкладке Входящие каналы. Запись должна состоять через двоеточие из ID оператора, ID канала и названия канала. Пример: operator\_id:channel\_id:transport
### Jivosite Jivosite популярный виджет для сайтов, который можно подключить для взаимодействия с клиентами. Для этого потребуется платный тариф Jivosite и токен, который можно получить через техподдержку.
В вашем личном кабинете JIVO напишите такой запрос в чат поддержки: Мы хотим подключить наш API к боту JIVO: Email: \_\_ВАШ\_EMAIL\_В\_JIVO\_\_ Канал: \_\_ВАШ\_КАНАЛ\_В\_JIVO\_\_ После этого вам вышлют ID провайдера и токен для интеграции с ProTalk. ### WILDBERRIES Добавить описание
## Исходящие ### Выбор Whatsapp, Телеграмм или Телергамм бот Вы можете использовать различные каналы для рассылки сообщений, где бот инициирует общение. Например, выбрав WhatsApp, вы можете задать список номеров для рассылки уведомлений. Однако, важно учитывать ограничения, накладываемые самим WhatsApp. Он может отслеживать нежелательные рассылки, поэтому используйте эту функцию с осторожностью. Не стоит массово загружать списки клиентов. Лучше, если контакты уже имели с вами переписку. Это снизит риск блокировки, так как клиент уже знаком с вашим номером. Для минимального риска блокировки, мы реализовали возможность отправки сообщений с интервалами, чтобы избежать массового спама. Рекомендуется писать текущим клиентам по важным для них вопросам, чтобы они были знакомы с вашим номером и имели историю переписки. Также доступна интеграция с Telegram. Вы можете пополнять список номеров для рассылки, но не стоит добавлять сразу тысячи контактов. Лучше ограничиться, например, 50 номерами на этапе, и чередовать их через время для безопасности. Для отправки сообщений через Telegram бот, клиент должен быть подписан на ваш бот. Сервисы, позволяющие привязывать ваши аккаунты WhatsApp и Telegram, аналогичны тем, что описаны в разделе [Входящие каналы коммуникаций.](#vkhodyashie) ## Телеграмм бот
### Токен и никейм Перейдите в Telegram и найдите бота @BotFather. Следуйте инструкциям для создания нового бота: выберите имя и получите токен доступа. Вставьте токен бота и его никнейм в соответствующие поля.
### Меню #### Команды в меню Вы можете добавить различные кнопки в меню вашего бота. По умолчанию доступна кнопка «Новый диалог», которая перезапускает бота для начала нового разговора. Кнопки можно располагать как вертикально, так и горизонтально. Для горизонтального расположения используйте запятую для разделения кнопок, а для вертикального — новую строку.
Пример: если вы добавите две команды в одну строку, они будут отображаться горизонтально. Вы можете добавить кнопку для проверки баланса токенов, если ваш бот работает по подписке или пакетам токенов. Для этого необходимо интегрировать бота с платежными сервисами. #### Готовые ответы для команд из меню Вы можете создать кнопки, которые будут выдавать заранее подготовленные ответы без генерации нового текста. Это экономит токены и время.
#### Фраза во время ожидания ответа бота Вы можете задать фразу, которая будет отображаться во время ожидания ответа от бота. Например, «⏳ Думаю ....».
#### Количество подсказок Можно настроить количество подсказок, которые будут отображаться под ответом бота в виде inline-ссылок, еще их называют инлайн кнопки. Сперва необходимо включить режим Inline в настройках @Botfather.
Затем установите количество подсказок в поле “Количество подсказок”
### Обязательная подписка на канал Вы можете настроить бота так, чтобы он требовал подписку на ваш канал или чат перед началом общения. Для этого добавьте бота в качестве администратора канала или чата и укажите соответствующий ID.
### Автоматически переводить текст кнопок в меню бота и готовые ответы на язык пользователя
Ваш Телеграмм бот может самостоятельно переводить себя на любые языки мира. Что переводится: 1\. Приветствия 2\. Кнопки меню 3\. Подсказки 4\. Служебные сообщения Перевод осуществляется с помощью передового Google API, обеспечивая высокое качество и точность. Перевод активируется автоматически, если в команде бота присутствует эмодзи с флагом и как минимум одно слово. Например:
Информация о локализации пользователя берётся из настроек его Телеграмм.
# Исходящие [Исходящие](/nastroika-bota/iskhodyashie) * [выбор Whatsapp, Телеграмм или Телергамм бот](#vybor-whatsapp-telegramm-ili-telergamm-bot) * [телеграмм бот](#telegramm-bot) * [токен и никейм](#token-i-nikeim) * ### [cоздаем своего бота и получаем токен](#sozdaem-svoego-bota-i-poluchaem-token) [Меню](#menyu) * [команды в меню](#komandy-v-menyu) * [готовые ответы для команд из меню](#gotovye-otvety-dlya-komand-iz-menyu) * [фраза во время ожидания ответа бота](#fraza-vo-vremya-ozhidaniya-otveta-bota) * [количество подсказок](#kolichestvo-podskazok) [Обязательная подписка на канал](#obyazatelnaya-podpiska-na-kanal) * [автоматически переводить текст кнопок в меню бота и готовые ответы на язык пользователя](#avtomaticheski-perevodit-tekst-knopok-v-menyu-bota-i-gotovye-otvety-na-yazyk-polzovatelya) ### Выбор Whatsapp, Телеграмм или Телергамм бот Вы можете использовать различные каналы для рассылки сообщений, где бот инициирует общение. Например, выбрав WhatsApp, вы можете задать список номеров для рассылки уведомлений. Однако, важно учитывать ограничения, накладываемые самим WhatsApp. Он может отслеживать нежелательные рассылки, поэтому используйте эту функцию с осторожностью. Не стоит массово загружать списки клиентов. Лучше, если контакты уже имели с вами переписку. Это снизит риск блокировки, так как клиент уже знаком с вашим номером. Для минимального риска блокировки, мы реализовали возможность отправки сообщений с интервалами, чтобы избежать массового спама. Рекомендуется писать текущим клиентам по важным для них вопросам, чтобы они были знакомы с вашим номером и имели историю переписки. Также доступна интеграция с Telegram. Вы можете пополнять список номеров для рассылки, но не стоит добавлять сразу тысячи контактов. Лучше ограничиться, например, 50 номерами на этапе, и чередовать их через время для безопасности. Для отправки сообщений через Telegram бот, клиент должен быть подписан на ваш бот. Сервисы, позволяющие привязывать ваши аккаунты WhatsApp и Telegram, аналогичны тем, что описаны в разделе [Входящие каналы коммуникаций.](#vkhodyashie) ## Телеграмм бот
### Токен и никейм Перейдите в Telegram и найдите бота @BotFather. Следуйте инструкциям для создания нового бота: выберите имя и получите токен доступа. Вставьте токен бота и его никнейм в соответствующие поля.
### Создаем своего бота и получаем токен. Это основной момент в создании бота. В нем нужно указать его название, задать адрес ссылки, описание, установить картинку бота и получить токен. Для создания бота введите в чат с BotFather команду. Откроется диалог в Телеграме. Здесь нужно выполнить команду /newbot, выбрать имя и юзернейм и получить от BotFather токен. Бот попросит вас ввести название для нового бота. Можете указать в любом удобном формате, поддерживается кириллица и латиница, например: «тестовый bot». — Имя будет отображаться в заголовке и в информации о боте.
Копируем токен, вставляем в окно сервиса и нажимаем «Создать»: После того, как вы задали боту имя, нужно указать его сокращенное название для ссылок. Оно должно обязательно содержат приставку «bot» на конце. Например: «Test\_Bot». — Сокращенное название может содержать от 5 до 32 и только латинских символов. Если все выполнено верно ваш бот будет зарегистрирован в Телеграм и BotFather выдаст вам токен бота в таком формате: API:764645301:AAGdRMMi\_bF67lCkJ0DKQNOwoATJQMWXk Этот токен можно использовать для авторизации бота и отправки запросов к Bot API. ### Меню #### Команды в меню Вы можете добавить различные кнопки в меню вашего бота. По умолчанию доступна кнопка «Новый диалог», которая перезапускает бота для начала нового разговора. Кнопки можно располагать как вертикально, так и горизонтально. Для горизонтального расположения используйте запятую для разделения кнопок, а для вертикального — новую строку.
Пример: если вы добавите две команды в одну строку, они будут отображаться горизонтально. Вы можете добавить кнопку для проверки баланса токенов, если ваш бот работает по подписке или пакетам токенов. Для этого необходимо интегрировать бота с платежными сервисами. #### Готовые ответы для команд из меню Вы можете создать кнопки, которые будут выдавать заранее подготовленные ответы без генерации нового текста. Это экономит токены и время.
#### Фраза во время ожидания ответа бота Вы можете задать фразу, которая будет отображаться во время ожидания ответа от бота. Например, «⏳ Думаю ....».
#### Количество подсказок Можно настроить количество подсказок, которые будут отображаться под ответом бота в виде inline-ссылок, еще их называют инлайн кнопки. Сперва необходимо включить режим Inline в настройках @Botfather.
Затем установите количество подсказок в поле “Количество подсказок”
### Обязательная подписка на канал Вы можете настроить бота так, чтобы он требовал подписку на ваш канал или чат перед началом общения. Для этого добавьте бота в качестве администратора канала или чата и укажите соответствующий ID.
### Автоматически переводить текст кнопок в меню бота и готовые ответы на язык пользователя
Ваш Телеграмм бот может самостоятельно переводить себя на любые языки мира. Что переводится: 1\. Приветствия 2\. Кнопки меню 3\. Подсказки 4\. Служебные сообщения Перевод осуществляется с помощью передового Google API, обеспечивая высокое качество и точность. Перевод активируется автоматически, если в команде бота присутствует эмодзи с флагом и как минимум одно слово. Например:
Информация о локализации пользователя берётся из настроек его Телеграмм.
# Еще настройки [Монетизация](#monetizaciya) * [продажа пакетов токенов](#prodazha-paketov-tokenov) * [продажа пакетов токенов](#prodazha-paketov-tokenov) * [регулярные платежи по подписке](#regulyarnye-platezhi-po-podpiske) * [кто может делать копии вашего бота](#kto-mozhet-delat-kopii-vashego-bota) [Лидогенерация](#lidogeneraciya) * [уведомление на email](#uvedomlenie-na-email) * [уведомление в Телеграмм бот](#uvedomlenie-v-telegramm-bot) * [передача данных в Битрикс24](#peredacha-dannykh-v-bitriks24) * [передача данных в AmoCRM](#peredacha-dannykh-v-amocrm) [Диалоговые настройки](#dialogovye-nastroiki) * [длина контекста сообщений](#dlina-konteksta-soobshenii) * [задержка отправки сообщения](#zaderzhka-otpravki-soobsheniya) * [сообщение от пользователя при долгом ожидании](#soobshenie-ot-polzovatelya-pri-dolgom-ozhidanii) * [количество минут ожидания ответа от пользователя](#kolichestvo-minut-ozhidaniya-otveta-ot-polzovatelya) * [максимальная длина сообщения от пользователя](#maksimalnaya-dlina-soobsheniya-ot-polzovatelya-2) [Настройки для групповых чатов Телеграмм](#nastroiki-dlya-gruppovykh-chatov-telegramm) * [имя на которое реагирует бот](#imya-na-kotoroe-reagiruet-bot) * [активационная фраза](#aktivacionnaya-fraza) [Защита бота](#zashita-bota) * [роль корректора](#rol-korrektora) * [лимит сообщений на 1 пользователя в течении 24 часов](#limit-soobshenii-na-1-polzovatelya-v-techenii-24-chasov) * [общий лимит сообщений на пользователя за все время](#obshii-limit-soobshenii-na-polzovatelya-za-vse-vremya) [Управление ботом по эмодзи](#upravlenie-botom-po-emodzi) * [цель выполнена](#cel-vypolnena) * [завершить диалог](#zavershit-dialog) * [остановить работу бота](#ostanovit-rabotu-bota) * [возобновить работу бота](#vozobnovit-rabotu-bota) * [остановить диалог с пользователем навсегда](#ostanovit-dialog-s-polzovatelem-navsegda) * [возобновить остановленный навсегда диалог](#vozobnovit-ostanovlennyi-navsegda-dialog) [Активация по расписанию](#aktivaciya-po-raspisaniyu) * [дата старта автоматических запусков](#data-starta-avtomaticheskikh-zapuskov) * [напишите ваши команды боту](#napishite-vashi-komandy-botu) [Ссылка на таблицу Google для записи логов](#ssylka-na-tablicu-google-dlya-zapisi-logov) ## Монетизация В этом разделе мы рассмотрим, как можно монетизировать ваших Telegram-ботов. Существует несколько способов, которые помогут вам извлечь прибыль из вашего проекта.
### Продажа пакетов токенов Вы можете продавать пакеты токенов для использования вашего бота. Например, вы можете предложить 5 миллионов токенов за 1000 рублей. Укажите количество токенов в пакете и стоимость. Также добавьте сообщение, которое будет отправляться пользователю вместе с ссылкой на оплату.
Вы можете предоставить пользователям бесплатные токены для ознакомления с ботом, например, 500 токенов. Используйте реферальные ссылки для привлечения новых пользователей. За каждого привлеченного пользователя вы можете награждать реферала определенным количеством токенов. Для этого используйте в настройках бота команду /share для создания реферальной ссылки. ### Регулярные платежи по подписке Установите период подписки, например, 30 дней за 700 рублей. Предоставьте пользователям тестовый период, например, 5 дней. После окончания тестового периода пользователю будет отправлено сообщение с предложением оплатить подписку.
Важно! Вы можете ограничить количество сообщений, отправляемых пользователем в день (пункт настроек "Защита бота"), чтобы избежать чрезмерного использования в этом режиме. Для успешной монетизации необходимо интегрировать систему приема платежей. Это можно сделать в меню интеграции, добавив ключи от таких систем, как Робокасса. ### Кто может делать копии вашего бота Кроме монетизации через Telegram, вы можете продавать ботов целиком. Например, выбор “Только по приватной ссылке” разрешает через меню бота создавать уникальную ссылку для передачи бота другому пользователю.
Второй вариант для продажи бота, это публикация на странице магазина iiAgent.pro Выкладывайте ботов в магазин, доступный на тарифах "Бизнес" или "Профи". Укажите стоимость в токенах и добавьте описание, чтобы покупатели могли легко найти и понять, для чего предназначен ваш бот.
Вы можете выкладывать ботов бесплатно, чтобы привлечь внимание к своим услугам. Укажите свой email, чтобы потенциальные клиенты могли связаться с вами для заказа разработки бота. ## Лидогенерация В разделе «Лидогенерация» вы можете настроить получение информации о клиентах через различные каналы, такие как электронная почта, Telegram-бот или CRM-системы. Это особенно полезно для бизнеса, стремящегося автоматизировать процесс сбора и обработки клиентских данных.
### Уведомление на email Достаточно ввести свой электронный адрес в соответствующее поле и убедиться, что у вашего бота подключена функция “Отправка лидов”.
### Уведомление в Телеграмм бот Укажите токен вашего Telegram-бота и ваш личный ID, чтобы получать уведомления напрямую. Для получения вашего ID используйте специального бота @getmyid\_bot, который предоставит вам ваш уникальный номер.
### Передача данных в Битрикс24 Вы можете отдельно настроить передачу данных в Битрикс24. Для этого необходимо создать входящий веб-хук в Битрикс24, предоставить необходимые доступы и вставить его в настройки бота. Зайдите в Битрикс24 в раздел "Разработчикам" и выбирайте "Другое". Затем Входящий вебхук.
В настройках скопируйте ключ интеграции и дайте права для доступа к необходимым сущностям системы в Битрикс24.
### Передача данных в AmoCRM Укажите долгосрочный токен и специальную ссылку в настройках AmoCRM для передачи данных. Чтобы создать такой токен перейдите в Webhooks, затем в раздел внешних интеграций.
Скопируйте ссылку для перенаправления:
Вставьте её в соответствующее поле настроек интеграции amoCRM и установите галочку “Предоставить доступ” и сохраните.
В установленных интеграциях должна появиться ваша интеграция.
Чтобы она стала активной необходимо зайти в её настройки и нажать кнопку “Установить”.
Сгенерируйте токен во вкладке “Ключи и доступы” и вставьте его в настройках бота.
После того как клиент отправит свои контактные данные, либо по другому условию, которое вы сами зададите в промпте, бот активирует функцию «Отправка Лида». Данные автоматически отправляются на указанные адреса: электронная почта, Telegram и CRM-системы. В CRM создается карточка лида с кратким описанием диалога и всей необходимой информацией. ## Диалоговые настройки В этом разделе вы найдете все, что связано с управлением диалогами и сообщениями, включая ограничения на количество сообщений, которые клиент может получить за определенный период времени. Важно! Если вы хотите изменить или сбросить установленные лимиты, рекомендуется сохранить изменения, выключить бота и перезапустить его. Это гарантирует, что все изменения вступят в силу и старые настройки не будут действовать.
### Длина контекста сообщений Это параметр, который определяет, сколько информации бот будет помнить из предыдущих сообщений. Ограничение длины контекста может помочь сэкономить количество токенов, что особенно полезно, если вы хотите оставить больше места для инструкций или базы знаний. Если ограничение не требуется, просто оставьте это поле пустым. ![](https://1389071903-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmgaG4ePuhIcI3pwDYuT9%2Fuploads%2F1irFEHzCOkDCtP12u3hP%2Fimage.png?alt=media\&token=cc20f160-63ed-4c4d-a628-f4d0bed7e665) ### Задержка отправки сообщения Вы также можете установить задержку отправки сообщений. По умолчанию бот отвечает сразу после обработки запроса. Однако, если вы хотите, чтобы бот имитировал человеческое поведение, вы можете установить задержку, например, в 10 секунд. Это позволит пользователю подумать и, возможно, дополнить свой запрос, прежде чем бот ответит. Такая задержка может быть полезна для создания более естественного взаимодействия. ![](https://1389071903-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmgaG4ePuhIcI3pwDYuT9%2Fuploads%2F38BFRvc7yLHkNqLhISxN%2Fimage.png?alt=media\&token=c71f5aef-cea8-477d-bb78-da10b498eee8)
### Сообщение от пользователя при долгом ожидании Эта функция позволяет боту отправлять сообщение пользователю, если тот не отвечает в течение определенного времени. Например, если пользователь не отвечает в течение 5 минут, бот может задать вопрос, чтобы напомнить о диалоге. Это особенно полезно в продажах, где бот может использовать новые аргументы для убеждения клиента. Доступно по платной подписке.
### Количество минут ожидания ответа от пользователя Здесь указывается время, через которое бот снова возобновит свой диалог.
### Максимальная длина сообщения от пользователя Вы можете ограничить максимальную длину сообщения, которое пользователь может отправить боту. Это помогает контролировать расход токенов и предотвращает отправку слишком длинных сообщений, которые могут перегрузить систему. Например, вы можете установить ограничение в 1000 символов. Если пользователь превысит это ограничение, бот отправит сообщение с просьбой сократить текст. ![](https://1389071903-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmgaG4ePuhIcI3pwDYuT9%2Fuploads%2F0PjIoZXWkRLSs7aM8Bjk%2Fimage.png?alt=media\&token=e66ec051-d096-48a2-b8cb-733166c1b734) #### Сообщение при превышении максимальной длины Здесь вы должны написать текст предупреждения о превышении максимальной длины сообщения. ![](https://1389071903-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmgaG4ePuhIcI3pwDYuT9%2Fuploads%2FCYwC8Tu6V7neXz1l9rR1%2Fimage.png?alt=media\&token=233791aa-47af-4d0b-b79a-96e9110e4264) ### Настройки для групповых чатов Телеграмм #### Имя на которое реагирует бот Введение бота в групповые чаты может значительно улучшить взаимодействие и автоматизировать многие процессы. Однако, чтобы бот не мешал общению между участниками, необходимо правильно настроить его поведение. В этом разделе мы подробно рассмотрим, как сделать так, чтобы ваш бот реагировал только на определенные команды и не отвлекал участников чата. Для начала, добавьте бота в чат в качестве администратора. Это позволит ему иметь доступ ко всем сообщениям и выполнять необходимые действия. Чтобы бот не отвечал на каждое сообщение, настройте его так, чтобы он реагировал только на упоминание своего имени. Это имя должно быть уникальным и чувствительным к регистру. Например, если вашего бота зовут "Вася", он будет реагировать на сообщения, содержащие "Вася", "вася", "ВАСЯ" и т.д. Убедитесь, что имя бота уникально и не используется в других контекстах в чате. Это предотвратит случайные активации бота. Сообщите участникам чата о том, как обращаться к боту. Это поможет избежать недоразумений и обеспечит корректное взаимодействие. В некоторых системах возможно переключение между ботами по имени. Это позволяет направлять диалоги к нужному боту, просто упоминая его имя. #### Активационная фраза Активационная фраза — это специальное слово или фраза, которая запускает диалог с ботом. Она действует как пароль, необходимый для начала общения. Если бот еще не начал диалог, он не будет реагировать на сообщения, пока не будет произнесена активационная фраза. Это предотвращает случайные активации и обеспечивает контроль над началом взаимодействия. Активационная фраза может использоваться не только в Telegram, но и в других платформах, таких как WhatsApp или CRM-системы, например, Битрикс24. Например, если клиент хочет получить скидку, он может использовать промокод в качестве активационной фразы. После этого бот начнет взаимодействие и предоставит необходимую информацию или услугу. ## Защита бота В данном разделе мы рассмотрим, как можно эффективно защитить вашего бота, используя различные инструменты и настройки. Одним из ключевых элементов защиты является роль корректора, или цензора, который проверяет ответы вашего бота перед их отправкой пользователю.
### Роль корректора Роль корректора представляет собой отдельную нейросеть, которая анализирует ответы бота. Она проверяет каждое сообщение, которое бот собирается отправить, и может вмешаться, если обнаружит нежелательное содержание. Например, если бот пытаются обмануть или выведать конфиденциальную информацию, такую как токены, корректор может заблокировать ответ и заменить его защитной фразой. Эта роль позволяет не только защищать, но и корректировать ответы бота. Вы можете задать темы, на которые бот не должен отвечать, например, политические вопросы. Хотя многие модели уже имеют встроенную цензуру, роль корректора предоставляет дополнительный уровень контроля. Важно отметить, что роль корректора работает на той же модели, что и ваш бот. Это означает, что она использует те же алгоритмы и настройки, что и основной бот, и проверяет каждое сообщение, сгенерированное ботом, а также последнее сообщение пользователя. #### Лимит сообщений на 1 пользователя в течении 24 часов Вы можете ограничить количество сообщений, которые пользователь может отправить боту в течение 24 часов. Например, не более 30 сообщений в сутки.
#### Общий лимит сообщений на пользователя за все время Вы можете задать общее количество сообщений, которые пользователь может отправить за все время использования бота. Например, 150 сообщений, после чего бот перестанет отвечать этому пользователю. Эти настройки позволяют вам контролировать расход ресурсов и строить экономическую модель для вашего бота, определяя стоимость его использования. Предположим, ваш бот предназначен для проведения одноразовой акции, например, оповещения новых клиентов. В этом случае имеет смысл установить жесткие лимиты, чтобы бот выполнил свою задачу и больше не взаимодействовал с пользователем. Это предотвратит попытки манипуляции ботом и использование его в других целях.
## Управление ботом по эмодзи Управление ботом по эмодзи позволяет пользователям контролировать действия бота, используя определенные эмодзи или наборы символов. Это может быть полезно в различных сценариях, например, для остановки бота, завершения диалога или выполнения других действий.
Все наборы эмодзи вы можете изменять. Не рекомендуем ставить один смайлик - если в ответе бота случайно он появится бот ЗАМОЛЧИТ. В режиме ожидания сообщений бот может завершить диалог по своей инициативе, если это необходимо. Например, если клиент не отвечает в течение определенного времени, бот может отправить эмодзи и завершить диалог. Боты, подключенные через платформы, такие как Telegram или WhatsApp, часто имеют интерфейсы, где видны все диалоги. Операторы могут использовать эти интерфейсы для управления ботами и взаимодействия с клиентами. Для управления ботом рекомендуется использовать уникальные эмодзи или комбинации символов, чтобы избежать пересечения с обычным текстом. Это может быть набор из двух эмодзи или комбинация эмодзи и текста. ### Цель выполнена Бот может автоматически завершить диалог, отправив заранее заданный эмодзи, когда цель взаимодействия достигнута. Например, если бот должен предоставить информацию и завершить общение, он отправит соответствующий набор эмодзи, сигнализируя о завершении. ### Завершить диалог Вы можете задать условия, при которых диалог будет завершен. Это может быть полезно, если клиент благодарит бота или если цель взаимодействия не достигнута, но клиент попрощался. Условия могут быть настроены в промпте так, чтобы бот завершал диалог в зависимости от различных событий. ### Остановить работу бота Вы можете остановить бота, отправив определенный набор эмодзи из чата, где происходит взаимодействие с ботом. Это особенно полезно, если вы хотите вмешаться в диалог или изменить его направление. Оператор может вмешаться в диалог, отправив уникальный эмодзи или набор символов, чтобы остановить бота и взять управление на себя. Это может быть полезно, если диалог идет не в том направлении или требуется личное общение. ### Возобновить работу бота Установленный здесь набор эмодзи, отправленный оператором возобновит диалог. ### Остановить диалог с пользователем навсегда Вы можете настроить бота так, чтобы он завершал диалог навсегда или временно. Например, если бот завершил свою задачу, он может замолчать навсегда, чтобы не мешать дальнейшему процессу, даже после рестарта. ### Возобновить остановленный навсегда диалог Есть возможность возобновить остановленный навсегда диалог с помощью другого набора эмодзи. ## Активация по расписанию Активация бота по расписанию — это процесс, который позволяет запускать бота в заранее установленное время для выполнения определённых задач. Это может быть полезно для автоматизации различных процессов, таких как сбор информации, публикация новостей или выполнение других задач. В этом разделе мы подробно рассмотрим, как настроить и использовать активацию бота по расписанию.
### Дата старта автоматических запусков Вы можете задать точную дату и время, когда бот начнёт выполнять свои задачи. Это может быть одноразовое действие или регулярные задачи, выполняемые ежедневно, еженедельно, ежемесячно и т.д. ### Напишите ваши команды боту Бот может выполнять не только диалоговые задачи, но и участвовать в автоматических цепочках действий. Например, бот может собирать информацию из Telegram-канала, переписывать её в заданном стиле, генерировать или находить соответствующую картинку и публиковать новость в канал. Вы можете задать последовательность команд, которые бот будет выполнять одна за другой. Это достигается с помощью специального разделителя, который позволяет ботам выполнять задачи в заданном порядке - ##. Пример использования: \- Представьте, что у вас есть бот, который ежедневно в определённое время собирает новости из Telegram-канала, переписывает их, добавляет изображение и публикует в вашем канале. Вы можете настроить бота так, чтобы он выполнял эти действия автоматически, без вашего участия. \- Укажите точное время, когда бот должен начать выполнение задач. Это может быть любое время суток, в зависимости от ваших потребностей. \- Напишите команды, которые бот должен выполнить. Например, "выбери канал", "сделай рерайт", "найди картинку", "опубликуй новость". Каждая команда должна быть чётко прописана и разделена специальным символом ## для последовательного выполнения. \- Перед автоматизацией рекомендуется протестировать команды в ручном режиме. Это поможет убедиться, что бот выполняет задачи правильно и без ошибок. \- Если что-то пошло не так, вы можете использовать логи для анализа и исправления ошибок. Логи помогут понять, на каком этапе произошёл сбой и что нужно скорректировать. ### Ссылка на таблицу Google для записи логов
Для того чтобы настроить Google Таблицу для получения логов, выполните следующие шаги: \- Перейдите на сайт Google Таблиц и создайте новый пустой документ. \- Нажмите на кнопку "Поделиться" в правом верхнем углу экрана. \- В открывшемся окне выберите "Настройки доступа". \- Установите режим доступа "Редактор" для всех, у кого есть ссылка. Это позволит логам автоматически выгружаться в таблицу. \- Скопируйте ссылку на вашу Google Таблицу. \- Вставьте скопированную ссылку в это окошко в настройках бота. После выполнения этих шагов, логи начнут автоматически выгружаться в вашу Google Таблицу. Убедитесь, что доступ к таблице открыт на редактирование, чтобы избежать проблем с выгрузкой данных. # Функции Перечень функций, которые доступны для подключения к боту ## [Анализ данных](/funkcii/analiz-dannykh) * Поверхностный анализ документов * Получение фото и площади земельного участка из Росреестра по кадастровому номеру * Прикрепить файл к задаче в Bitrix24 * Распознавание текста на фото через Gemini-Pro-Vision * Распознавание рукописного текста * Обработка больших документов * Получение скриншота сайта * Распознавание MP3 * Омниканальный запрос (текст+фото) * Распознавание текста на фото и документах используя EasyOSR, GigaChat, YandexOSR, Gemini * Чтение офисных файлов * Распознавание изображения OpenAI GPT-4-omni * Анализ PDF с помощью ChatGPT 4-omni * Детальный анализ PDF с помощью ChatGPT 4-omni * Распознавание текста (gemini-pro-vision + gemini-flash) * Распознавание текста на фото и документах через API YandexOSR (JPG, PNG, PDF) ## [Базы данных](/funkcii/bazy-dannykh) * База данных в виде Google таблицы * Создание записи в таблице Notion * Поиск строки в базе Notion и изменение значения нужного поля * Чтение базы данных в Notion v.2 * Получение структуры полей базы данных в Notion * Управление Google таблицей * Получить поля таблицы из базы Airtable по имени таблицы * Получение данных из таблицы Airtable * Создание записи в Airtable * Генератор ментальных карт * Чтение страницы в Notion в формате .md * Создание презентации PPTX + Яндекс.Картинки ## [Бизнес](/funkcii/biznes) Работа с Гугл таблицами * Заполнение Google таблицы данными * Добавить строку в таблицу Google Работа с Гугл сервисами * Управление Google календарем * Чтение текста из Google документа v2 * Замена текста в шаблоне Google Slides * Записать текст в документ Google * Чтение текста из Google документа * Редактирование презентации в Google Slides (с использованием ИИ) * Замена текста в шаблоне Google Document [Работа с Битрикс 24](#rabota-s-bitriks-24) * [Отправить лид в Битрикс24](#otpravit-lid-v-bitriks24) * [Анализ аудио записей из Bitrix24 папки](#analiz-audio-zapisei-iz-bitrix24-papki) * [Получение лида из Битрикс24](#poluchenie-lida-iz-bitriks24) * [Прикрепить файл к задаче в Bitrix24](#prikrepit-fail-k-zadache-v-bitrix24) * [Завершение задачи в Bitrix24](#zavershenie-zadachi-v-bitrix24) * [Получение задачи из Bitrix24](#poluchenie-zadachi-iz-bitrix24) * [Изменить стадию сделки в Битрикс24](#izmenit-stadiyu-sdelki-v-bitriks24) * [Получить данные из определенной сделки из Битрикс](#poluchit-dannye-iz-opredelennoi-sdelki-iz-amocrm) [Работа с Yclients](#rabota-s-yclients) * [Yclients: Запись на услугу с указанием даты и времени](#yclients-zapis-na-uslugu-s-ukazaniem-daty-i-vremeni) * [Yclients: Получить список сотрудников и их услуг по ID компании](#yclients-poluchit-spisok-sotrudnikov-i-ikh-uslug-po-id-kompanii) * [Получение текущих записей по номеру телефона клиента в сервисе YClients](#poluchenie-tekushikh-zapisei-po-nomeru-telefona-klienta-v-servise-yclients) * [Создать запись в сервисе YClients](#sozdat-zapis-v-servise-yclients) * [Yclients: Получить полный список данных о клиенте по номеру телефона](#yclients-poluchit-polnyi-spisok-dannykh-o-kliente-po-nomeru-telefona) * [Удаление записей клиента в сервисе YClients](#udalenie-zapisei-klienta-v-servise-yclients) * [Yclients: Получить график сотрудника на указанные даты](#yclients-poluchit-grafik-sotrudnika-na-ukazannye-daty) [Работа c файлами ](#rabota-c-failami) * [Генерация PDF](#generaciya-pdf) * [Чтение офисных файлов](#chtenie-ofisnykh-failov) [Другие СРМ](#drugie-srm) * [Поиск товаров на Мойсклад](#poisk-tovarov-na-moisklad) * [Получить данные из определенной сделки из AmoCRM](#poluchit-dannye-iz-opredelennoi-sdelki-iz-amocrm) [Работа с HH.ru](#rabota-s-hh.ru) * [Поиск резюме на сайте HH](#poisk-rezyume-na-saite-hh) * [Поиск вакансий на HH.ru](#poisk-vakansii-na-hh.ru) * [Поиск резюме на HH.ru](#poisk-rezyume-na-saite-hh) [Распознавание данных ](#raspoznavanie-dannykh) * [Распознавание текста на фото](#raspoznavanie-teksta-na-foto) * [Распознавание текста на фото через Gemini-Pro-Vision](#raspoznovanie-teksta-na-foto-cherez-gemini-pro-vision) * [Распознавание текста на фото и документах используя EasyOSR, GigaChat, YandexOSR, Gemini](#raspoznavanie-teksta-na-foto-i-dokumentakh-ispolzuya-easyosr-gigachat-yandexosr-gemini) * [Распознавание текста (gemini-pro-vision + gemini-flash)](#raspoznavanie-teksta-gemini-pro-vision--gemini-flash) [Презентации PPTX](#prezentacii-pptx) * [Редактирование презентации PPTX](#redaktirovanie-prezentacii-pptx) * [Создание презентации PPTX](#sozdanie-prezentacii-pptx) [Поиск и отправка данных ](#poisk-i-otpravka-dannykh) * [Отправка лида (все каналы)](#otpravka-lida-vse-kanaly) * [Поиск контактов на странице сайта](#poisk-kontaktov-na-stranice-saita) * [Поиск холодных клиентов](#poisk-kholodnykh-klientov) * [Поиск контакта по базе Apollo.ai](#poisk-kontakta-po-baze-apollo.ai) * [Проверка компании по данным ФНС](#proverka-kompanii-po-dannym-fns) * [Получение товаров из категории на сайте Bitrix](#poluchenie-tovarov-iz-kategorii-na-saite-bitrix24) [Получение товаров](#poluchenie-tovarov) * [Получение товаров из категории на сайте Webasyst (Shop-Script)](#poluchenie-tovarov-iz-kategorii-na-saite-webasyst-shop-script) * [Получение товаров из категории на сайте WordPress](#poluchenie-tovarov-iz-kategorii-na-saite-wordpress) [Дополнительные функции ](#dopolnitelnye-funkcii) * [Создание лендинга на Bootstrap](#sozdanie-lendinga-na-bootstrap) * [Оплата в диалоге](#oplata-v-dialoge) ## [Вычисления](/funkcii/vychisleniya) * [Создание графиков](#sozdanie-grafikov) * [Генератор случайных чисел](#generator-sluchainykh-chisel) * [Случайный выбор варианта](#sluchainyi-vybor-varianta) * [Получение текущего времени по часовому поясу](#poluchenie-tekushego-vremeni-po-chasovomu-poyasu) * [Получить текущую дату в формате ДД.ММ.ГГ](#poluchit-tekushuyu-datu-v-formate-dd.mm.gg) * [Получение текущего времени](#poluchenie-tekushego-vremeni) * [Получить текущий день недели](#poluchit-tekushii-den-nedeli) ## [Диалоги](/funkcii/dialogi) * [Запуск исходящего диалога (для автоматизации)](#zapusk-iskhodyashego-dialoga-dlya-avtomatizacii) * [Активация бота для отдельного пользователя в отдельном канале](#aktivaciya-bota-dlya-otdelnogo-polzovatelya-v-otdelnom-kanale) * [Активировать Телеграм-Бот для всех его пользователей](#aktivirovat-telegram-bot-dlya-vsekh-ego-polzovatelei) * [Отправить сообщение в диалог](#otpravit-soobshenie-v-dialog) * [Отправка сообщения пользователем Телеграм-бота v2](#otpravka-soobsheniya-polzovatelem-telegram-bota-v2) * [Диалог с одного бота с другим](#dialog-s-odnogo-bota-s-drugim) * [Диалог с ботом v2](#dialog-s-botom-v2) * [Подключение функции к диалогу](#podklyuchenie-funkcii-k-dialogu) * [Добавить роль в диалог](#dobavit-rol-v-dialog) * [Задать вопрос боту](#zadat-vopros-botu) * [Задать вопрос человеку по телефону](#zadat-vopros-cheloveku-po-telefonu) * [Создание напоминаний от бота](#sozdanie-napominanii-ot-bota) * [Постоянная память 3.0](#postoyannaya-pamyat-3.0) * [Графовая память](#grafovaya-pamyat) * [Отложенный запуск функции](#otlozhennyi-zapusk-funkcii) ## [Интернет](/funkcii/internet) [Отправка и получение данных ](#otpravka-i-poluchenie-dannykh) * [Парсинг по URL](#parsing-po-url) * [Рекурсивный парсинг сайта](#rekursivnyi-parsing-saita) * [Отправка Email со своего SMTP сервера](#otpravka-email-so-svoego-smtp-servera) * [Отправить сообщение всем пользователям Телеграм-бота](#otpravit-soobshenie-vsem-polzovatelyam-telegram-bota) * [Получение содержания страницы в Интернет](#poluchenie-soderzhaniya-stranicy-v-internet) * [Получения ссылок на первые 10 сайтов в выдаче Baidu по вашему ключевому запросу](#polucheniya-ssylok-na-pervye-10-saitov-v-vydache-baidu-po-vashemu-klyuchevomu-zaprosu) * [Получение транскрипции видео с YouTube](#poluchenie-transkripcii-video-s-youtube) * [Чтение данных из таблицы Google](#chtenie-dannykh-iz-tablicy-google) * [Скачивание аудио с youtube.](#skachivanie-audio-s-youtube) * [Прогнозы по ставкам на спорт](#prognozy-po-stavkam-na-sport) * [Создание HTML](#sozdanie-html) * [Статистика видео на YouTube](#statistika-video-na-youtube) * [Список мест по ГЕО-координатам](#spisok-mest-po-geo-koordinatam) * [Взаимодействие с Albato через веб-хук](#vzaimodeistvie-s-albato-cherez-veb-khuk) * [Анализатор ссылок](#analizator-ssylok) [Поиск](#poisk) * [Поиск в Яндекс.Картинки](#poisk-v-yandeks.kartinki) * [Поиск в Яндекс](#poisk-v-yandeks) * [Поиск ссылок на страницах сайта, используя Яндекс](#poisk-ssylok-na-stranicakh-saita-ispolzuya-yandeks) * [Поиск в Яндекс (по сайту)](#poisk-v-yandeks-po-saitu) * [Поиск картинок в Яндекс (API)](#poisk-kartinok-v-yandeks-api) * [Поиск литературы в Google Scholar](#poisk-literatury-v-google-scholar) * [Поиск в Google](#poisk-v-google) * [Поиск картинки в Google](#poisk-kartinki-v-google) * [Поиск через Perplexity](#poisk-cherez-perplexity) * [Поиск через Perplexity (VseGPT)](#poisk-cherez-perplexity-vsegpt) * [Поиск холодных клиентов](#poisk-kholodnykh-klientov) * [Поиск контакта по базе Apollo.ai](#poisk-kontakta-po-baze-apollo.ai) * [Поиск событий по сайту Афиша.ру](#poisk-sobytii-po-saitu-afisha.ru) * [Поиск контактов на странице сайта](#poisk-kontaktov-na-stranice-saita) ## [Реклама](/funkcii/reklama) * [Отправить уведомление в Telegram](#otpravit-uvedomlenie-v-telegram) * [Получение статистики из Яндекс.Директ](#poluchenie-statistiki-iz-yandeks.direkt) * [Получение постов из публичного Телеграм канала v2](#poluchenie-postov-iz-publichnogo-telegram-kanala-v2) * [Получение постов из публичного Телеграм канала](#poluchenie-postov-iz-publichnogo-telegram-kanala) * [Публикация поста в несколько Телеграм каналов из Google таблицы](#publikaciya-posta-v-neskolko-telegram-kanalov-iz-google-tablicy) * [Публикация поста в Телеграм канале](#publikaciya-posta-v-telegram-kanale) ## [Соц сети](/funkcii/soc-seti) * [Публикация поста в Телеграм канале](#publikaciya-posta-v-telegram-kanale) * [Публикация поста в несколько Телеграм каналов из Google таблицы](#publikaciya-posta-v-neskolko-telegram-kanalov-iz-google-tablicy) * [Публикация поста в Инстаграм](#publikaciya-posta-v-instagram) * [Получение постов из публичного Телеграм канала](#poluchenie-postov-iz-publichnogo-telegram-kanala) * [Получение постов из публичного Телеграм канала v2](#poluchenie-postov-iz-publichnogo-telegram-kanala-v2) * [Поиск в каналах и чатах Телеграмм](#poisk-v-kanalakh-i-chatakh-telegramm) * [Отправить уведомление в Telegram](#otpravit-uvedomlenie-v-telegram) * [Активировать Телеграм-Бот для всех его пользователей](#aktivirovat-telegram-bot-dlya-vsekh-ego-polzovatelei) ## [Фото и видео](/funkcii/foto-i-video) * [Создания 3D аватара от HedraAI](#sozdaniya-3d-avatara-ot-hedraai) * [Создание стикеров для Telegram](#sozdanie-stikerov-dlya-telegram) * [Задать вопрос к видео на YouTube](#zadat-vopros-k-video-na-youtube) * [Распознавание изображения OpenAI GPT-4-omni](#raspoznavanie-izobrazheniya-openai-gpt-4-omni) * [Распознавание MP3](#raspoznavanie-mp3) * [Распознавание рукописного текста](#raspoznavanie-rukopisnogo-teksta) * [Замена лиц на фото (Midjourney)](#zamena-lic-na-foto-midjourney) * [Генерация фото StabilityAI v3](#generaciya-foto-stabilityai-v3) * [Генерация изображений Kandinsky](#generaciya-izobrazhenii-kandinsky) * [Генерация фото (Midjourney)](#generaciya-foto-midjourney) * [Генерация SVG](#generaciya-svg) * [Генерация изображений DALL-E v3](#generaciya-izobrazhenii-dall-e-v3) * [Поиск картинки в Google](#poisk-kartinki-v-google) * [Поиск в Яндекс.Картинки](#poisk-v-yandeks.kartinki) ## [Разное](/funkcii/raznoe) * [Внешний API](#vneshnii-api) * [Отправить вебхук в Make](#otpravit-vebkhuk-v-make) * [Озвучивание текста (ElevenLabs)](#ozvuchivanie-teksta-elevenlabs) * [Озвучивание файлов (ElevenLabs)](#ozvuchivanie-failov-elevenlabs) * [Изменение данных из таблицы Airtable](#izmenenie-dannykh-iz-tablicy-airtable) * [Получение данных из таблицы Airtable](#poluchenie-dannykh-iz-tablicy-airtable) * [Загрузка файла в облако Backblaze](#zagruzka-faila-v-oblako-backblaze) * [Отправить вебхук в Zapier](#otpravit-vebkhuk-v-zapier) * [Генерация изображений Midjourney (Rapid API)](#generaciya-izobrazhenii-midjourney-rapid-api) * [Поиск товаров на сайте Joomla](#poisk-tovarov-na-saite-joomla) * [Определи свое предназначение в роду](#opredeli-svoe-prednaznachenie-v-rodu) * [Управление Google календарем](#upravlenie-google-kalendarem) * [Управление Google таблицей](#upravlenie-google-tablicei) * [Генератор ментальных карт](#generator-mentalnykh-kart) * [Генерация PDF](#generaciya-pdf) # Анализ данных * [Поверхностный анализ документов](#poverkhnostnyi-analiz-dokumentov) * [Получение фото и площади земельного участка из Росреестра по кадастровому номеру](#poluchenie-foto-i-ploshadi-zemelnogo-uchastka-iz-rosreestra-po-kadastrovomu-nomeru) * [Прикрепить файл к задаче в Bitrix24](#prikrepit-fail-k-zadache-v-bitrix24) * [Распознавание текста на фото через Gemini-Pro-Vision](#raspoznavanie-teksta-na-foto-cherez-gemini-pro-vision) * [Распознавание рукописного текста](#raspoznavanie-rukopisnogo-teksta) * [Обработка больших документов](#obrabotka-bolshikh-dokumentov) * [Получение скриншота сайта](#poluchenie-skrinshota-saita) * [Распознавание MP3](#raspoznavanie-mp3) * [Омниканальный запрос (текст+фото)](#omnikanalnyi-zapros-tekstfoto) * [Распознавание текста на фото и документах используя EasyOSR, GigaChat, YandexOSR, Gemini](#raspoznavanie-teksta-na-foto-i-dokumentakh-ispolzuya-easyosr-gigachat-yandexosr-gemini) * [Чтение офисных файлов](#chtenie-ofisnykh-failov) * [Распознавание изображения OpenAI GPT-4-omni](#raspoznavanie-izobrazheniya-openai-gpt-4-omni) * [Анализ PDF с помощью ChatGPT 4-omni](#analiz-pdf-s-pomoshyu-chatgpt-4-omni) * [Детальный анализ PDF с помощью ChatGPT 4-omni](#detalnyi-analiz-pdf-s-pomoshyu-chatgpt-4-omni) * [Распознавание текста (gemini-pro-vision + gemini-flash)](#raspoznavanie-teksta-gemini-pro-vision--gemini-flash) * [Распознавание текста на фото и документах через API YandexOSR (JPG, PNG, PDF)](#raspoznavanie-teksta-na-foto-i-dokumentakh-cherez-api-yandexosr-jpg-png-pdf) ## Поверхностный анализ документов Функция проводит анализ документа по URL ссылке методом суммаризации. Допустимые форматы: PDF, DOC, DOCX, XLS, XLSX, PPTX и ссылка на документ Google. ``` { "name": "ai_doc_summarize", "description": "Анализ документа по URL с использованием OpenAI API", "parameters": { "type": "object", "properties": { "url": { "type": "string", "description": "URL документа", }, "limit": { "type": "integer", "description": "Максимальная длина текста в символах в итоговом результате. По умолчанию 2000 символов.", }, "user_question": { "type": "string", "description": "Дословный вопрос пользователя к документу", } }, "required": ["url", "limit", "user_question"], }, }, ``` ## Получение фото и площади земельного участка из Росреестра по кадастровому номеру Пример текста в роли бота: ``` После получения ответа от функции по кадастровому номеру покажи ссылку на фото участка в формате: `##IMG:тут_ссылка_на_фото_## Площадь участка: X` где X - это его площадь. ``` ``` { "name": "get_area_from_rosreestr", "description": "Получить фото земельного участка и его площади по кадастровому номеру", "parameters": { "type": "object", "properties": { "pkk_id": { "type": "string", "description": "Кадастровый номер земельного участка", }, }, "required": ["pkk_id"], }, }, ``` ## Прикрепить файл к задаче в Bitrix24 Пример инструкции в боте: ``` Прикрепи файл к задаче в Битрикс24: https://minio.nplus1.ru/app-images/152754/30c1c568a1e8e538911c6f8d02ca69f2.jpg Номер задачи: 122 ID папки: 1 Webhook Битрикс24: "https://COMPANY.bitrix24.ru/rest/1/b7zwgdXXXXXXXX" ``` ``` { "name": "bitrix24_attach_file_to_task", "description": "Прикрепить файл к задаче в Bitrix24", "parameters": { "type": "object", "properties": { "bitrix24_webhook": { "type": "string", "description": "Вебхук для доступа к API Bitrix24", }, "task_id": { "type": "string", "description": "ID задачи, к которой нужно прикрепить файл", }, "folder_id": { "type": "string", "description": "ID папки, в которой находится задача", }, "file_url": { "type": "string", "description": "URL файла, который нужно прикрепить", }, }, "required": ["bitrix24_webhook", "task_id", "folder_id", "file_url"], }, }, ``` ## Распознавание текста на фото через Gemini-Pro-Vision Функции нужно отправить ссылку на фото в формате JPG. ``` { "name": "gemini_vision", "description": "Извлечение текста из изображения по URL", "parameters": { "type": "object", "properties": { "image_url": { "type": "string", "description": "URL изображения", }, }, "required": ["image_url"], }, }, ``` ## Распознавание рукописного текста Распознавание рукописного текста ``` { "name": "handwriting_recognition", "description": "Распознавание рукописного текста", "parameters": { "type": "object", "properties": { "file_url": { "type": "string", "description": "Ссылка файл (URL файла) или изображение (URL фото) с рукописным текстом. Формат файла в ссылке не важен.", }, }, "required": ["file_url"], }, }, ``` ## Обработка больших документов Данная функция позволит построчно пройти большой документ блоками и обработать каждый блок вашим запросом. Затем этот вопрос будет задан всему документу целиком. ``` { "name": "ai_doc_analyze", "description": "Анализ документа по URL с использованием OpenAI API", "parameters": { "type": "object", "properties": { "url": { "type": "string", "description": "URL документа", }, "role": { "type": "string", "description": "Роль ИИ для оптимального выполнения поставленной пользователем задачи. Например для перевода это будет роль: `Ты - переводчик текстов`.", }, "user_question": { "type": "string", "description": "Дословная формулировка задачи от пользователем относительно данного документа. Если задача не понятна, требуется уточнить её у пользователя.", }, "answer_in_dialog": { "type": "boolean", "description": "Вернуть ответ в диалог. По умолчанию False", }, }, "required": ["url", "role", "user_question", "answer_in_dialog"], }, }, ``` ## Получение скриншота сайта Получение скриншота сайта ``` { "name": "url_screenshot", "description": "Take a screenshot of a given URL", "parameters": { "type": "object", "properties": { "url": { "type": "string", "description": "The URL of the website to take a screenshot of", }, "token": { "type": "string", "description": "API token for authentication", }, }, "required": ["url", "token"], }, }, ``` ## Распознавание MP3 Функция получает ссылку на MP3 файл и с помощью методов асинхронного распознавания Яндекса возвращает текстовый файл с результатом. ``` Если ты получишь ссылку на файл .mp3, то сразу вызови функцию распознования с параметрами: { 'languageCode' : '', 'model' : 'general', 'profanityFilter' : False, 'literature_text' : False, 'audioEncoding' : 'MP3', 'audioChannelCount' : 1, 'rawResults' : False, } bucket_name = 'protalkstt' ``` ``` { "name": "yandex_transcribe_audio", "description": "Отправить аудиофайл на распознавание речи", "parameters": { "type": "object", "properties": { "audioURL": { "type": "string", "description": "URL аудиофайла", }, "languageCode": { "type": "string", "description": "Код языка, по умолчанию `ru-RU`", }, "audio_model": { "type": "string", "description": "Модель распознавания, по умолчанию `general`", "enum": ["general"], }, "profanityFilter": { "type": "boolean", "description": "Фильтр ненормативной лексики, по умолчанию `False`", }, "literature_text": { "type": "boolean", "description": "Включает режим нормализации, по умолчанию `False`", }, "audioEncoding": { "type": "string", "description": "Формат аудиофайла, по умолчанию `MP3`", "enum": ["LINEAR16_PCM", "OGG_OPUS", "MP3"], }, "sampleRateHertz": { "type": "integer", "enum": [48000, 16000, 8000], "description": "Частота дискретизации аудио. Этот параметр обязателен, если значение format равно LINEAR16_PCM.", }, "audioChannelCount": { "type": "integer", "description": "Количество аудиоканалов, по умолчанию равно 1", }, }, "required": ["audioURL", "languageCode", "audio_model", "profanityFilter", "literature_text", "audioEncoding", "audioChannelCount"], }, }, ``` ## Омниканальный запрос (текст+фото) Омниканальный запрос (текст+фото). Задает вопрос к OpenAI API передав одновременно текст и изображения ``` { "name": "openai_question_omni", "description": "Задает вопрос к OpenAI API передав одновременно текст и изображения", "parameters": { "type": "object", "properties": { "ai_model": { "type": "string", "enum": ["gpt-4o-mini", "gpt-4o-2024-08-06"], "description": "Модель OpenAI для обработки запроса, по умолчанию `gpt-4o-mini`" }, "text": { "type": "string", "description": "Текстовая информация" }, "images_urls": { "type": "string", "description": "URLs изображений в формате: `URL1;URL2;URL3`" }, "question": { "type": "string", "description": "Вопрос, который нужно задать на основе текста и изображений" } }, "required": ["ai_model", "text", "images_urls", "question"] }, }, ``` ## Распознавание текста на фото и документах используя EasyOSR, GigaChat, YandexOSR, Gemini Функция `osr_combine` предназначена для распознавания текста и шаблонных документов с использованием различных моделей. Модели для распознавания текста: page (по умолчанию) — подходит для изображений с любым количеством строк текста, сверстанного в одну колонку. page-column-sort — для распознавания многоколоночного текста. handwritten — для распознавания произвольного сочетания печатного и рукописного текста на русском и английском языках. table — для распознавания таблиц на русском и английском языках. Модели для распознавания шаблонных документов: passport — основной разворот паспорта. driver-license-front — водительское удостоверение, лицевая сторона. driver-license-back — водительское удостоверение, обратная сторона. vehicle-registration-front — свидетельство о регистрации транспортного средства, лицевая сторона. vehicle-registration-back — свидетельство о регистрации транспортного средства, обратная сторона. license-plates — все регистрационные номера автомобилей на изображении. ```` { "name": "osr_combine", "description": "Распознавание текста по фото или PDF", "parameters": { "type": "object", "properties": { "osr_model": { "type": "string", "description": "Модель для распознавания. ```\nМодели для распознавания текста:\npage (по умолчанию) — подходит для изображений с любым количеством строк текста, сверстанного в одну колонку.\npage-column-sort — для распознавания многоколоночного текста.\nhandwritten — для распознавания произвольного сочетания печатного и рукописного текста на русском и английском языках.\ntable — для распознавания таблиц на русском и английском языках.\n \nМодели для распознавания шаблонных документов:\npassport — основной разворот паспорта.\ndriver-license-front — водительское удостоверение, лицевая сторона.\ndriver-license-back — водительское удостоверение, обратная сторона.\nvehicle-registration-front — свидетельство о регистрации транспортного средства, лицевая сторона.\nvehicle-registration-back — свидетельство о регистрации транспортного средства, обратная сторона.\nlicense-plates — все регистрационные номера автомобилей на изображении.\n```", "enum": ["page", "page-column-sort", "handwritten", "table", "passport", "driver-license-front", "driver-license-back", "vehicle-registration-front", "vehicle-registration-back", "license-plates"], }, "file_url": { "type": "string", "description": "URL изображения или PDF файла для распознавания", }, }, "required": ["osr_model", "file_url"], }, }, ```` ## Чтение офисных файлов Функция переводит файлы форматов PDF, DOC, XLS, PPT в текст ``` { "name": "read_file_from_url", "description": "Read a file from a URL and extract text with Cyrillic support", "parameters": { "type": "object", "properties": { "url": { "type": "string", "description": "URL of the file", }, "file_type": { "type": "string", "description": "Type of the file to read", "enum": ["PDF", "DOC", "DOCX", "XLS", "XLSX", "PPT", "PPTX"], } }, "required": ["url", "file_type"], }, }, ``` ## Распознавание изображения OpenAI GPT-4-omni Распознавание изображения OpenAI GPT-4-omni ``` { "name": "image_recognition", "description": "Распознавание изображения", "parameters": { "type": "object", "properties": { "file_url": { "type": "string", "description": "Ссылка файл (URL файла) или изображение (URL фото). Формат файла в ссылке не важен.", }, "question": { "type": "string", "description": "Формулировка задачи по распознованию изображения", }, }, "required": ["file_url", "question"], }, }, ``` ## Анализ PDF с помощью ChatGPT 4-omni Анализ PDF с помощью ChatGPT 4-omni ``` { "name": "omni_question_pdf", "description": "Задает вопрос к PDF-документу, используя API OpenAI и извлекая текст и изображения из PDF.", "parameters": { "type": "object", "properties": { "ai_model": { "type": "string", "enum": ["gpt-4o-mini", "gpt-4o-2024-08-06"], "description": "Модель OpenAI для обработки запроса, по умолчанию `gpt-4o-mini`" }, "pdf_url": { "type": "string", "description": "URL PDF-документа для извлечения текста и изображений" }, "question": { "type": "string", "description": "Вопрос, который нужно задать на основе содержимого PDF" } }, "required": ["ai_model", "pdf_url", "question"] }, }, ``` ## Детальный анализ PDF с помощью ChatGPT 4-omni Детальный анализ PDF с помощью ChatGPT 4-omni ``` { "name": "omni_question_pdf_detalied", "description": "Составление подробной оценки каждой страницы PDF-документа", "parameters": { "type": "object", "properties": { "ai_model": { "type": "string", "enum": ["gpt-4o-mini", "gpt-4o-2024-08-06"], "description": "Модель OpenAI для обработки запроса, по умолчанию `gpt-4o-mini`" }, "pdf_url": { "type": "string", "description": "URL PDF-документа для извлечения текста и изображений" }, "role": { "type": "string", "description": "Формулировка роли ИИ, которая будет проводить анализ PDF" } }, "required": ["ai_model", "pdf_url", "role"] }, }, ``` ## Распознавание текста (gemini-pro-vision + gemini-flash) Функции нужно отправить ссылку на фото в формате JPG ``` { "name": "osr_combine_ai", "description": "Распознавание текста по фото", "parameters": { "type": "object", "properties": { "image_url": { "type": "string", "description": "URL изображения для распознавания", }, }, "required": ["image_url"], }, }, ``` ## Распознавание текста на фото и документах через API YandexOSR (JPG, PNG, PDF) Функция `yandex_osr` предназначена для распознавания текста и шаблонных документов с использованием различных моделей. Модели для распознавания текста: page (по умолчанию) — подходит для изображений с любым количеством строк текста, сверстанного в одну колонку. page-column-sort — для распознавания многоколоночного текста. handwritten — для распознавания произвольного сочетания печатного и рукописного текста на русском и английском языках. table — для распознавания таблиц на русском и английском языках. Модели для распознавания шаблонных документов: passport — основной разворот паспорта. driver-license-front — водительское удостоверение, лицевая сторона. driver-license-back — водительское удостоверение, обратная сторона. vehicle-registration-front — свидетельство о регистрации транспортного средства, лицевая сторона. vehicle-registration-back — свидетельство о регистрации транспортного средства, обратная сторона. license-plates — все регистрационные номера автомобилей на изображении. ```` { "name": "yandex_osr", "description": "Распознавание текста по фото от сервиса Yandex OSR", "parameters": { "type": "object", "properties": { "osr_model": { "type": "string", "description": "Модель для распознавания. ```\nМодели для распознавания текста:\npage (по умолчанию) — подходит для изображений с любым количеством строк текста, сверстанного в одну колонку.\npage-column-sort — для распознавания многоколоночного текста.\nhandwritten — для распознавания произвольного сочетания печатного и рукописного текста на русском и английском языках.\ntable — для распознавания таблиц на русском и английском языках.\n \nМодели для распознавания шаблонных документов:\npassport — основной разворот паспорта.\ndriver-license-front — водительское удостоверение, лицевая сторона.\ndriver-license-back — водительское удостоверение, обратная сторона.\nvehicle-registration-front — свидетельство о регистрации транспортного средства, лицевая сторона.\nvehicle-registration-back — свидетельство о регистрации транспортного средства, обратная сторона.\nlicense-plates — все регистрационные номера автомобилей на изображении.\n```", "enum": ["page", "page-column-sort", "handwritten", "table", "passport", "driver-license-front", "driver-license-back", "vehicle-registration-front", "vehicle-registration-back", "license-plates"], }, "file_url": { "type": "string", "description": "URL изображения или PDF файла для распознавания", }, }, "required": ["osr_model", "file_url"], }, }, ```` # Базы данных * [База данных в виде Google таблицы](#baza-dannykh-v-vide-google-tablicy) * [Создание записи в таблице Notion](#sozdanie-zapisi-v-tablice-notion) * [Поиск строки в базе Notion и изменение значения нужного поля](#poisk-stroki-v-baze-notion-i-izmenenie-znacheniya-nuzhnogo-polya) * [Чтение базы данных в Notion v.2](#chtenie-bazy-dannykh-v-notion-v.2) * [Получение структуры полей базы данных в Notion](#poluchenie-struktury-polei-bazy-dannykh-v-notion) * [Управление Google таблицей](#upravlenie-google-tablicei) * [Получить поля таблицы из базы Airtable по имени таблицы](#poluchit-polya-tablicy-iz-bazy-airtable-po-imeni-tablicy) * [Получение данных из таблицы Airtable](#poluchenie-dannykh-iz-tablicy-airtable) * [Создание записи в Airtable](#sozdanie-zapisi-v-airtable) * [Генератор ментальных карт](#generator-mentalnykh-kart) * [Чтение страницы в Notion в формате .md](#chtenie-stranicy-v-notion-v-formate-.md) * [Создание презентации PPTX + Яндекс.Картинки](#sozdanie-prezentacii-pptx--yandeks.kartinki) ## База данных в виде Google таблицы Пример инструкции в роли бота: ``` Ты должна подбирать квартиры на основе данных в таблице: https://docs.google.com/spreadsheets/d/1wcKA2__qfMjImLUiEOhK-lHUf0_rt5tmc-dvYEqepro/edit?usp=sharing Колонки для запроса из таблицы: A - H Для фильтрации используй эти колонки: `C` - Цена аренды (в сутки) - числовое поле `D` - Размер квартиры в м2 - числовое поле `G` - VIP сегмент - фиксированные значения: `Да`, `Нет` ``` ``` { "name": "get_filtered_google_table", "description": "Получить отфильтрованные данные из Google таблицы по заданному URL и запросу фильтрации", "parameters": { "type": "object", "properties": { "url": { "type": "string", "description": "URL Google таблицы" }, "sheet_index": { "type": "integer", "description": "Индекс листа (начиная с 1)", "default": 1 }, "filter_query": { "type": "string", "description": "Запрос фильтрации в формате SQL. Например: `SELECT A, C WHERE B=1`, для поиска по ключевым словам используй: `SELECT B WHERE F MATCHES '(?s).*ключ.*'`", "default": "" } }, "required": ["url"] }, }, ``` ## Создание записи в таблице Notion Создание записи в таблице Notion ``` { "name": "create_notion_record", "description": "Добавление записи в базу данных Notion", "parameters": { "type": "object", "properties": { "databaseId": { "type": "string", "description": "Идентификатор базы данных в Notion или URL на базу" }, "record_data": { "type": "string", "description": "Данные записи в формате: `Имя_колонки;;Тип;;Значение##Имя_колонки;;Тип;;Значение`. Типы колонок: `integer`, `string`, `title`, `date`. Даты передавай в формате ISO 8601: `1977-11-15`." }, "token": { "type": "string", "description": "Токен авторизации для доступа к Notion API" }, "reply": { "type": "string", "description": "Готовый ответ после выполнения функции" } }, "required": ["databaseId", "record_data", "token"] }, }, ``` ## Поиск строки в базе Notion и изменение значения нужного поля Поиск строки в базе Notion и изменение значения нужного поля ``` { "name": "notion_find_and_update_database_cell", "description": "Находит и обновляет ячейку в базе данных Notion", "parameters": { "type": "object", "properties": { "token": { "type": "string", "description": "Токен доступа к Notion API", }, "base_id": { "type": "string", "description": "ID базы данных Notion или URL страницы с базой в Notion", }, "field_name": { "type": "string", "description": "Имя поля для фильтрации", }, "field_type": { "type": "string", "description": "Тип поля для фильтрации", "enum": ["title", "rich_text", "multi_select"], }, "field_filter": { "type": "string", "description": "Значение для фильтрации по полю", }, "cell_name": { "type": "string", "description": "Имя ячейки для обновления", }, "cell_type": { "type": "string", "description": "Тип ячейки для обновления", "enum": ["multi_select", "text", "number"], }, "cell_value": { "type": "string", "description": "Новое значение для ячейки. Для `multi_select` это список значений через запятую.", }, }, "required": ["token", "base_id", "field_name", "field_type", "field_filter", "cell_name", "cell_type", "cell_value"], }, }, ``` ## Чтение базы данных в Notion v.2 Чтение базы данных в Notion v.2 ```` { "name": "read_notion_db_v2", "description": "Чтение данных из базы данных Notion", "parameters": { "type": "object", "properties": { "token": { "type": "string", "description": "Токен", }, "base_id": { "type": "string", "description": "ID базы данных или ссылка на базу данных", }, "n": { "type": "integer", "description": "Количество записей", }, "filter": { "type": "string", "description": """JSON словарь вида:\n```JSON\n{"Column1": {"multi-select": ["value1", "value2"]}, "Column2": {"range": [0, 10]}, "Column3": {"search": "keyword"}}```\n\nМожет быть пустым словарем `{}`.""", }, }, "required": ["token", "base_id", "n", "filter"], }, }, ```` ## Получение структуры полей базы данных в Notion Получение структуры полей базы данных в Notion ``` { "name": "get_notion_database_structure_from_url", "description": "Получить структуру полей в базе данных Notion по ссылке", "parameters": { "type": "object", "properties": { "url": { "type": "string", "description": "Ссылка на базу данных Notion", }, "token": { "type": "string", "description": "Токен доступа к API Notion", }, }, "required": ["url", "token"], }, }, ``` ## Управление Google таблицей Функция может внести изменения в таблицу Google. Нужно в промпте указать нейросети правило по которому идет запись в таблицу: ``` Записывай полученную информацию, ссылки и ID файлов в Google таблицу по этим правилам: Row data to append at the end of Google Sheet formatted like this: value1;;value2;;value3 "value1" - Заголовок "value2" - Описание "value3" - URL фото Ячейки, в которые тебе нечего записать заполни знаком `-` ``` ``` { "name": "ai_edit_google_sheet", "description": "Make changes in Google Sheet Document with AI", "parameters": { "type": "object", "properties": { "url": { "type": "string", "description": "URL of Google Sheet", }, "request": { "type": "string", "description": "Here, pass 100% verbatim the task from the user without any changes", }, "mode": { "type": "string", "enum" : ["+", "-", ".", "?"], "description": "`+` - add data in Google Sheet, `-` - delete data in Google Sheet, `.` - change data in Google Sheet, `?` - read data from Google Sheet", }, "next_question": { "type": "string", "description": "Next question", }, }, "required": ["url", "request", "mode", "next_question"], }, }, ``` ## Получить поля таблицы из базы Airtable по имени таблицы Получить поля таблицы из базы Airtable по имени таблицы ``` { "name": "airtable_table_info", "description": "Получить поля таблицы из базы Airtable по имени таблицы", "parameters": { "type": "object", "properties": { "base_id": { "type": "string", "description": "ID базы Airtable", }, "table_name": { "type": "string", "description": "Имя таблицы", }, "api_key": { "type": "string", "description": "API ключ для доступа к Airtable", }, }, "required": ["base_id", "table_name", "api_key"], }, }, ``` ## Получение данных из таблицы Airtable Функция получает данные из базы Airtable. Для этого вы должны передать в функцию API токен Airtable, ID базы, название таблицы, фильтр и название колонок из которых вам нужны данные. ```` { "name": "filter_airtable_data", "description": "Получить записи из базы данных по заданным фильтрам", "parameters": { "type": "object", "properties": { "api_key": { "type": "string", "description": "API ключ для доступа к базе данных", }, "base_id": { "type": "string", "description": "ID базы данных", }, "table_name": { "type": "string", "description": "Название таблицы для запроса", }, "filters": { "type": "string", "description": "Название таблицы для запроса", }, "max_records": { "type": "integer", "description": "Максимальное количество записей для возврата. По умолчанию 1", }, "fields": { "type": "string", "description": """JSON массив вида:```JSON\n[{"field": "Column1", "value": "Value1", "type": "select"},{"field": "Column2", "value": "Value2", "type": "text"},{"field": "Column3", "value": Value3, "type": "percent"},{"field": "Column4", "value": 0, "type": "checkbox"},{"field": "Column5", "value": "Value5", "type": "multi-select"},{"field": "Column6", "min": Value6_1, "max": Value6_2, "type": "range"},{"field": "Column7", "min": Value7_1, "max": Value7_2, "type": "range_percent"}]```. Не обязательный параметр.""", }, "columns": { "type": "string", "description": "Список колонок, которые получить из таблицы в виде: `column1;column2;column3`. Не обязательный параметр", }, }, "required": ["api_key", "base_id", "table_name", "max_records"], }, }, ```` ## Создание записи в Airtable Пример инструкции в боте: Из присланной тебе информации создай запись в таблице Airtable с этими полями: ``` ИИ рейтинг (число от 0 до 100) Название проекта Краткое описание проекта (до 280 символов) Тип проекта (выпадающий список: B2B, B2C, B2G) Отрасль (мульти-селект: Образование, Производство, ИТ, Искусство) ``` Твоя задача - создавать записи в базе Airtable. После создания записи функция тебе вернет ID созданной записи, используй этот ID для выдачи мне такой ссылки: "" и предложи мне перейти по ней. Параметры для работы с базой Airtable: ``` 'base_id' : 'appFzXXXXXXXXXX', 'table_name' : 'Анкета', 'api_key' : 'patK0tMn7NB7MJEb4.ee211b6ee49de496643aXXXXXXXXXXXXXXXXXXXX', ``` Твои сообщения отправляются в Телеграм, поэтому оформляй все свои ответы согласно допустимым стандартам разметки HTML в Телеграм. ``` { "name": "airtable_create_record", "description": "Добавить запись в Airtable", "parameters": { "type": "object", "properties": { "base_id": { "type": "string", "description": "ID базы данных Airtable", }, "table_name": { "type": "string", "description": "Имя таблицы в Airtable", }, "api_key": { "type": "string", "description": "API ключ для доступа к Airtable", }, "data": { "type": "string", "description": "Данные для добавления в запись в формате JSON", }, }, "required": ["base_id", "table_name", "api_key", "data"], }, }, ``` ## Генератор ментальных карт Функция создает ментальную карту в формате PNG. ```` { "name": "generate_mind_map", "description": """Mind Map to PNG. For the task at hand, make a detailed mental map in Python in this form in Russian: ```python { "Plan for a trip": { "Choose a country": { "Find tickets": "In process...", "Buy tickets": "In process...", "Book a hotel": "In progress..." } } } ``` Don't use lists, just keys and values.""", "parameters": { "type": "object", "properties": { "mind_map_json": { "type": "string", "description": "Mind Map as JSON string", }, }, "required": ["mind_map_json"], }, }, ```` ## Чтение страницы в Notion в формате .md Чтение страницы в Notion в формате .md ``` { "name": "notion_to_markdown", "description": "Преобразование Notion страницы в формат Markdown", "parameters": { "type": "object", "properties": { "token": { "type": "string", "description": "Токен для доступа к Notion", }, "page_url": { "type": "string", "description": "URL страницы в Notion", }, }, "required": ["token", "page_url"], }, }, ``` ## Создание презентации PPTX + Яндекс.Картинки Пример инструкции в роли бота: ``` Вот шаблон описания слайдов: description = """ # Слайд 1 title: "Заголовок слайда" title_color: "0000FF" title_size: 48 text: "Ваш текст здесь" text_color: "FF0000" text_size: 24 image: "красивый пейзаж" image_position: right background: "абстрактный фон" # Слайд 2 title: "Слайд с маркированным списком" title_color: "008000" bullet_points: Первый пункт; Второй пункт; Третий пункт text_color: "800080" text_size: 20 image: "бизнес график" image_position: top # Слайд 3 title: "Слайд с центральным изображением" text: "Текст вокруг центрального изображения" image: "логотип компании" image_position: center """ ``` ``` { "name": "create_pptx_yandex", "description": "Создает презентацию на основе текстового описания каждого слайда", "parameters": { "type": "object", "properties": { "description": { "type": "string", "description": "Текстовое описание для каждого слайда презентации", }, }, "required": ["description"], }, }, ``` # Бизнес [Работа с Гугл таблицами ](#rabota-s-gugl-tablicami) * [Заполнение Google таблицы данными](#zapolnenie-google-tablicy-dannymi) * [Добавить строку в таблицу Google](#dobavit-stroku-v-tablicu-google) [Работа с Гугл сервисами](#rabota-s-gugl-servisami) * [Управление Google календарем](#upravlenie-google-kalendarem) * [Чтение текста из Google документа v2](#chtenie-teksta-iz-google-dokumenta-v2) * [Замена текста в шаблоне Google Slides](#zamena-teksta-v-shablone-google-slides) * [Записать текст в документ Google](#zapisat-tekst-v-dokument-google) * [Чтение текста из Google документа](#chtenie-teksta-iz-google-dokumenta) * [Редактирование презентации в Google Slides (с использованием ИИ)](#redaktirovanie-prezentacii-v-google-slides-s-ispolzovaniem-ii) * [Замена текста в шаблоне Google Document](#zamena-teksta-v-shablone-google-document) [Работа с Битрикс 24](#rabota-s-bitriks-24) * [Отправить лид в Битрикс24](#otpravit-lid-v-bitriks24) * [Анализ аудио записей из Bitrix24 папки](#analiz-audio-zapisei-iz-bitrix24-papki) * [Получение лида из Битрикс24](#poluchenie-lida-iz-bitriks24) * [Прикрепить файл к задаче в Bitrix24](#prikrepit-fail-k-zadache-v-bitrix24) * [Завершение задачи в Bitrix24](#zavershenie-zadachi-v-bitrix24) * [Получение задачи из Bitrix24](#poluchenie-zadachi-iz-bitrix24) * [Изменить стадию сделки в Битрикс24](#izmenit-stadiyu-sdelki-v-bitriks24) * [Получить данные из определенной сделки из Битрикс](#poluchit-dannye-iz-opredelennoi-sdelki-iz-amocrm) [Работа с Yclients](#rabota-s-yclients) * [Yclients: Запись на услугу с указанием даты и времени](#yclients-zapis-na-uslugu-s-ukazaniem-daty-i-vremeni) * [Yclients: Получить список сотрудников и их услуг по ID компании](#yclients-poluchit-spisok-sotrudnikov-i-ikh-uslug-po-id-kompanii) * [Получение текущих записей по номеру телефона клиента в сервисе YClients](#poluchenie-tekushikh-zapisei-po-nomeru-telefona-klienta-v-servise-yclients) * [Создать запись в сервисе YClients](#sozdat-zapis-v-servise-yclients) * [Yclients: Получить полный список данных о клиенте по номеру телефона](#yclients-poluchit-polnyi-spisok-dannykh-o-kliente-po-nomeru-telefona) * [Удаление записей клиента в сервисе YClients](#udalenie-zapisei-klienta-v-servise-yclients) * [Yclients: Получить график сотрудника на указанные даты](#yclients-poluchit-grafik-sotrudnika-na-ukazannye-daty) [Работа c файлами ](#rabota-c-failami) * [Генерация PDF](#generaciya-pdf) * [Чтение офисных файлов](#chtenie-ofisnykh-failov) [Другие СРМ](#drugie-srm) * [Поиск товаров на Мойсклад](#poisk-tovarov-na-moisklad) * [Получить данные из определенной сделки из AmoCRM](#poluchit-dannye-iz-opredelennoi-sdelki-iz-amocrm) [Работа с HH.ru](#rabota-s-hh.ru) * [Поиск резюме на сайте HH](#poisk-rezyume-na-saite-hh) * [Поиск вакансий на HH.ru](#poisk-vakansii-na-hh.ru) * [Поиск резюме на HH.ru](#poisk-rezyume-na-saite-hh) [Распознавание данных ](#raspoznavanie-dannykh) * [Распознавание текста на фото](#raspoznavanie-teksta-na-foto) * [Распознавание текста на фото через Gemini-Pro-Vision](#raspoznovanie-teksta-na-foto-cherez-gemini-pro-vision) * [Распознавание текста на фото и документах используя EasyOSR, GigaChat, YandexOSR, Gemini](#raspoznavanie-teksta-na-foto-i-dokumentakh-ispolzuya-easyosr-gigachat-yandexosr-gemini) * [Распознавание текста (gemini-pro-vision + gemini-flash)](#raspoznavanie-teksta-gemini-pro-vision--gemini-flash) [Презентации PPTX](#prezentacii-pptx) * [Редактирование презентации PPTX](#redaktirovanie-prezentacii-pptx) * [Создание презентации PPTX](#sozdanie-prezentacii-pptx) [Поиск и отправка данных ](#poisk-i-otpravka-dannykh) * [Отправка лида (все каналы)](#otpravka-lida-vse-kanaly) * [Поиск контактов на странице сайта](#poisk-kontaktov-na-stranice-saita) * [Поиск холодных клиентов](#poisk-kholodnykh-klientov) * [Поиск контакта по базе Apollo.ai](#poisk-kontakta-po-baze-apollo.ai) * [Проверка компании по данным ФНС](#proverka-kompanii-po-dannym-fns) * [Получение товаров из категории на сайте Bitrix](#poluchenie-tovarov-iz-kategorii-na-saite-bitrix24) [Получение товаров](#poluchenie-tovarov) * [Получение товаров из категории на сайте Webasyst (Shop-Script)](#poluchenie-tovarov-iz-kategorii-na-saite-webasyst-shop-script) * [Получение товаров из категории на сайте WordPress](#poluchenie-tovarov-iz-kategorii-na-saite-wordpress) [Дополнительные функции ](#dopolnitelnye-funkcii) * [Создание лендинга на Bootstrap](#sozdanie-lendinga-na-bootstrap) * [Оплата в диалоге](#oplata-v-dialoge) ## Работа с Гугл таблицами ### Заполнение Google таблицы данными Заполнение Google таблицы данными ``` { "name": "edit_google_sheet", "description": "Редактировать данные в Google Sheet", "parameters": { "type": "object", "properties": { "url": { "type": "string", "description": "URL Google Sheet", }, "data": { "type": "string", "description": "Данные для добавления в одну строку в формате: `A1::значение1##G2::значение2##FB25::значение3`", }, }, "required": ["url", "data"], }, }, ``` ### Добавить строку в таблицу Google Позволяет вести запись в строку таблицы Google без затрат токенов. ``` { "name": "append_row_to_google_sheet", "description": "Appent row to Google Sheet", "parameters": { "type": "object", "properties": { "url": { "type": "string", "description": "URL of Google Sheet", }, "sheet_number": { "type": "integer", "description": "List Index in Google Sheet. Starts from 1. Default value is 1.", }, "sheet_name": { "type": "string", "description": "List Name in Google Sheet. Not required.", }, "row_to_append": { "type": "string", "description": "Row data to append at the end of Google Sheet formatted like this: `value1;;value2;;value3`", }, }, "required": ["url", "sheet_number", "text_to_append"], }, }, ``` ## Работа с Гугл сервисами ### Управление Google календарем С помощью функции бот может безопасно добавлять, просматривать, редактировать и удалять события в Google календаре. В поведении боту пропишите эти настройки: 
1. Для твоей работы необходим ID календаря, который ты будешь передавать в функцию "google_calendar". ID календаря может быть предоставлен и в виде Email адреса. Без него ты не можешь отвечать ни на какие вопросы пользователя.
2. При показе запланированных событий после названия события указывай его "event_id".
3. Вот инструкции как пользоваться функцией:
Пропишите в промте боту как правильно этим пользоваться: ``` Тип действия. `+` - означает добавление события. `?` - означает получение всех событий календаря.. `-` - удалить событие в календаре. `.` - редактировать событие в календаре. ``` Также необходимо в настройках вашего календаря с помощью браузера открыть доступ к этому пользователю: "" с правами "Внесение изменений и предоставления доступа". ``` dialogai@dialogai-385904.iam.gserviceaccount.com ``` ID календаря может быть как в виде e-mail адреса, так и в виде собственного обозначения, если это не основной календарь (ID можно найти в настройках интеграции календаря). Если боту предоставить ID не верный, будет выходить ошибка. ```` { "name": "google_calendar", "description": "Управление календарем Google", "parameters": { "type": "object", "properties": { "calendarId": { "type": "string", "description": "ID календаря", }, "action": { "type": "string", "enum": ["+", "?", '-', '.'], "description": "Тип действия. `+` - означает добавление события. `?` - означает получение всех событий календаря.. `-` - удалить событие в календаре. `.` - редактировать событие в календаре.", }, "event_ids": { "type": "string", "description": "Список ID событий в календаре в формате json строки: ```[{\"event_id\": \"3lsvlor3hjlgpgmv7er7e5juov\"}]```. Передается при типах действия `-` или '.'", }, "events": { "type": "string", "description": "Список событий в формате json строки: ```[{\"summary\": \"test event\", \"description\": \"some info\", \"start\": {\"dateTime\": \"2024-09-04T03:00:00+03:00\"}, \"end\": {\"dateTime\": \"2024-09-04T05:30:00+03:00\"}}]```. Передается при типах действия `+` или '.'", }, "start_date": { "type": "string", "description": "Дата начала периода в формате `2024-09-04T03:00:00+03:00`. Передается при типах действия `?` или '-'", }, "end_date": { "type": "string", "description": "Дата окончания периода в формате `2024-09-04T03:00:00+03:00`. Передается при типах действия `?` или '-'", }, }, "required": ["calendarId", "action"], }, }, ```` ### Чтение текста из Google документа v2 Чтение текста из Google документа v2 ``` { "name": "read_google_doc_text", "description": "Читает содержимое Google Docs по URL и возвращает текст с ограничением по размеру", "parameters": { "type": "object", "properties": { "url": { "type": "string", "description": "URL документа Google Docs", }, "limit": { "type": "integer", "description": "Максимальное количество символов в ответе. По умолчанию равно 8000", "minimum": 1 }, "return_as_link": { "type": "integer", "description": "0 - возвращает текст, 1 - возвращает ссылку на файл txt вместо текста", }, }, "required": ["url", "return_as_link"], }, }, ``` ### Замена текста в шаблоне Google Slides Пример инструкции в боте: ``` Получить информацию от пользователя и Измени только эти значения: ###company_name### — замените на новое название компании. ###pres_name### — замените на название презентации. ###about_us### — замените на текст “О компании”. ###about_us_2### — замените на дополнительный текст “О компании”. ###product_1### — замените на описание первого продукта/услуги. ``` ``` { "name": "replace_in_google_slides", "description": "Заменить текстовые метки в Google Slides", "parameters": { "type": "object", "properties": { "url": { "type": "string", "description": "URL презентации Google Slides", }, "replacements": { "type": "string", "description": "Строка замен строго в формате: `метка1->значение1||метка2->значение2`. `->` - этот разделитель обязателен.", }, "format": { "type": "string", "description": "Формат возвращаемой ссылки", "enum": ["link", "pdf", "pptx"], }, }, "required": ["url", "replacements", "format"], }, }, ``` ### Записать текст в документ Google Записать текст в документ Google ``` { "name": "append_text_to_google_doc", "description": "Appent text to Google Document", "parameters": { "type": "object", "properties": { "url": { "type": "string", "description": "URL of Google Document", }, "text_to_append": { "type": "string", "description": "Text to append at the end of Google Document", }, }, "required": ["url", "text_to_append"], }, }, ``` ### Чтение текста из Google документа Чтение текста из Google документа ``` { "name": "get_google_doc_text", "description": "Получить текст из документа Google по URL", "parameters": { "type": "object", "properties": { "url": { "type": "string", "description": "URL документа Google", }, "limit": { "type": "integer", "description": "Максимально количество букв в ответе, по умолчанию 8000", }, }, "required": ["url", "limit"], }, }, ``` ### Редактирование презентации в Google Slides (с использованием ИИ) Пример инструкции в роли бота: ``` В этой презентации: https://docs.google.com/presentation/d/1RSl-KiaTh7xB-R3tOywleXyO6LvPd4dv5wyjbOjkfUY/edit?usp=sharing Напиши слоган и замени лучшая на эффективная ``` ``` { "name": "ai_edit_google_slides", "description": "Редактирует текст в Google Slides", "parameters": { "type": "object", "properties": { "url": { "type": "string", "description": "URL презентации Google Slides", }, "task": { "type": "string", "description": "Задача, содержащая слоган и слово для замены", }, }, "required": ["url", "task"], }, }, ``` ### Замена текста в шаблоне Google Document Пример инструкции в боте: ``` Получить информацию от пользователя и Измени только эти значения: ###company_name### — замените на новое название компании. ###pres_name### — замените на название документа. ###about_us### — замените на текст “О компании”. ###about_us_2### — замените на дополнительный текст “О компании”. ###product_1### — замените на описание первого продукта/услуги. ``` ``` { "name": "replace_in_google_doc", "description": "Заменить текстовые метки в Google Document", "parameters": { "type": "object", "properties": { "url": { "type": "string", "description": "URL презентации Google Document", }, "replacements": { "type": "string", "description": "Строка замен строго в формате: `метка1->значение1||метка2->значение2`. `->` - этот разделитель обязателен.", }, "format": { "type": "string", "description": "Формат возвращаемой ссылки", "enum": ["link", "pdf", "docx"], }, }, "required": ["url", "replacements", "format"], }, }, ``` ## Работа с Битрикс 24 ### Отправить лид в Битрикс24 Отправить лид в Битрикс24 ``` { "name": "send_lead_bitrix24", "description": "Отправка лида в Bitrix24", "parameters": { "type": "object", "properties": { "bitrix_webhook": { "type": "string", "description": "Вебхук Bitrix24", }, "name": { "type": "string", "description": "Имя клиента", }, "phone": { "type": "string", "description": "Номер телефона клиента", }, "email": { "type": "string", "description": "E-mail клиента", }, }, "required": ["bitrix_webhook", "name", "phone", "email"], }, }, ``` ### Получение лида из Битрикс24 Функция запрашивает в Битрикс24 новый лид ``` { "name": "get_lead_from_bitrix24", "description": "Get lead information from Bitrix24", "parameters": { "type": "object", "properties": { "webhook": { "type": "string", "description": "Bitrix24 webhook URL", } }, "required": ["webhook"], }, }, ``` ### Изменить стадию сделки в Битрикс24 Функция update\_deal\_stage предназначена для обновления стадии сделки в системе Битрикс24. Она принимает три параметра: deal\_id (идентификатор сделки), stage\_id (идентификатор новой стадии) и webhook\_url (URL вебхука для отправки запроса). ``` { "name": "bitrix_update_deal_stage", "description": "Обновить стадию сделки в Битрикс24", "parameters": { "type": "object", "properties": { "deal_id": { "type": "integer", "description": "ID сделки", }, "stage_id": { "type": "string", "description": "ID новой стадии", }, "webhook_url": { "type": "string", "description": "URL вебхука Битрикс24", }, }, "required": ["deal_id", "stage_id", "webhook_url"], }, }, ``` ### Получить данные из определенной сделки из Битрикс Функция работает при заполненном вебхуке Битрикс24 в разделе "Лидогенерация". Для получения данных о сделке в функцию нужно предать ID сделки. ``` { "name": "bitrix_get_dial_fields", "description": "Получить данные из определенной сделки из Битрикс", "parameters": { "type": "object", "properties": { "deal_id": { "type": "string", "description": "ID сделки", }, }, "required": ["deal_id"], }, }, ``` ### Получение задачи из Bitrix24 Получение задачи из Bitrix24 ``` { "name": "bitrix_get_task", "description": "Получение задачи из Bitrix24", "parameters": { "type": "object", "properties": { "bitrix_webhook": { "type": "string", "description": "Bitrix24 webhook URL", }, "keyword": { "type": "string", "description": "Ключевое слово в названии задачи", }, }, "required": ["bitrix_webhook", "keyword"], }, }, ``` ### Завершение задачи в Bitrix24 Завершение задачи в Bitrix24 ``` { "name": "bitrix_end_task", "description": "Завершение задачи из Bitrix24", "parameters": { "type": "object", "properties": { "bitrix_webhook": { "type": "string", "description": "Bitrix24 webhook URL", }, "ID": { "type": "integer", "description": "ID задачи в Bitrix24", }, "task_result": { "type": "string", "description": "Текст с результатом выполнения задачи", }, }, "required": ["bitrix_webhook", "ID", "task_result"], }, }, ``` ### Прикрепить файл к задаче в Bitrix24 Пример инструкции в боте: ``` Прикрепи файл к задаче в Битрикс24: https://minio.nplus1.ru/app-images/152754/30c1c568a1e8e538911c6f8d02ca69f2.jpg Номер задачи: 122 ID папки: 1 Webhook Битрикс24: "https://COMPANY.bitrix24.ru/rest/1/b7zwgdXXXXXXXX" ``` ``` { "name": "bitrix24_attach_file_to_task", "description": "Прикрепить файл к задаче в Bitrix24", "parameters": { "type": "object", "properties": { "bitrix24_webhook": { "type": "string", "description": "Вебхук для доступа к API Bitrix24", }, "task_id": { "type": "string", "description": "ID задачи, к которой нужно прикрепить файл", }, "folder_id": { "type": "string", "description": "ID папки, в которой находится задача", }, "file_url": { "type": "string", "description": "URL файла, который нужно прикрепить", }, }, "required": ["bitrix24_webhook", "task_id", "folder_id", "file_url"], }, }, ``` ### Получение товаров из категории на сайте Bitrix24 Получение товаров из категории на сайте Bitrix. Для работы функции создайте в корне сайта файл `api_products.php` со следующим кодом: ``` "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, '/upload/') === 0) { $imageUrl = $site_url . $imageUrl; } $arResult[] = array( "name" => $arFields["NAME"], "price" => $productPrice, "url" => $site_url . $arFields["DETAIL_PAGE_URL"], "details" => $arFields["DETAIL_TEXT"], "image_url" => $imageUrl ); } // Вывод результата в формате JSON header('Content-Type: application/json'); echo json_encode($arResult); require($_SERVER["DOCUMENT_ROOT"]."/bitrix/modules/main/include/epilog_after.php"); ?> ``` В коде замените код инфоблока каталога товаров - `IBLOCK_ID` на значение для вашего сайта. Инфоблок - это сущность, где хранится структурированная информация, например товары, новости. ``` { "name": "get_products_bitrix", "description": "Получить товары с сайта на Битрикс по заданным параметрам", "parameters": { "type": "object", "properties": { "site_url": { "type": "string", "description": "URL сайта для поиска товаров без `/` в конце", }, "paraments": { "type": "string", "description": """ Параметры поиска в виде: `name:id:min_price:max_price:limit##name:id:min_price:max_price:limit##` `name` - Название товара (может быть прочерком `-`) `nacategory_idme` - ID категории товара `min_price` - Минимальная цена товара `max_price` - Максимальная цена товара `limit` - Сколько товаров должно быть в ответе. По умолчанию 10 """, }, }, "required": ["site_url", "paraments"], }, }, ``` ### Анализ аудио записей из Bitrix24 папки Сначала функция обращается в папку на диске Bitrix24 и скачивает все новые .mp3 файлы за последние 10 минут. Далее она переводит все файлы в текст и проводит анализ диалогов. Результаты она записывает в таблицу Google. ``` { "name": "bitrix_mp3_to_sheet", "description": "Анализ аудио записей из папки Bitrix24", "parameters": { "type": "object", "properties": { "bitrix_webhook": { "type": "string", "description": "Bitrix24 webhook URL", }, "folder_id": { "type": "integer", "description": "Bitrix24 folder ID", }, "ID": { "type": "integer", "description": "ID бота для анализа диалогов", }, "sheet_url": { "type": "string", "description": "URL таблицы Google Sheet", }, "api_token": { "type": "string", "description": "API token бота для анализа диалогов", }, "time_interval": { "type": "integer", "description": "Интервал для загрузки новых файлов в минутах", }, }, "required": ["bitrix_webhook", "folder_id", "ID", "sheet_url", "api_token", "time_interval"], }, }, ``` ## Работа с Yclients ### Yclients: Запись на услугу с указанием даты и времени Yclients: Запись на услугу с указанием даты и времени ``` { "name": "yclients_book_record", "description": "Yclients: Запись на услугу с указанием даты и времени", "parameters": { "type": "object", "properties": { "phone": { "type": "string", "description": "Номер телефона для записи", }, "code": { "type": "integer", "description": "Код для аутентификации", }, "datetime": { "type": "string", "description": "Дата и время записи в формате ISO 8601", }, "api_key": { "type": "string", "description": "API ключ для авторизации", }, "api_key_user": { "type": "string", "description": "Пользовательский API ключ для авторизации", }, }, "required": ["phone", "code", "datetime", "api_key", "api_key_user"], }, }, ``` ### Yclients: Получить список сотрудников и их услуг по ID компании Yclients: Получить список сотрудников и их услуг по ID компании ``` { "name": "yclients_get_staff_list_with_services", "description": "Yclients: Получить список сотрудников и их услуг по ID компании", "parameters": { "type": "object", "properties": { "api_key": { "type": "string", "description": "API ключ для доступа к Yclients" }, "company_id": { "type": "integer", "description": "ID компании в Yclients" }, "api_key_user": { "type": "string", "description": "API ключ пользователя для доступа к Yclients" } }, "required": ["api_key", "company_id", "api_key_user"] }, }, ``` ### Получение текущих записей по номеру телефона клиента в сервисе YClients Пример инструкции в боте: ``` Используй эти данные для записи клиентов: АПИ токен: "XXXXXXXXXXXXX" Токен пользователя: "XXXXXXXXXXXXXXXXXXXXXX" Номер компании: 309XXX ``` ``` { "name": "yclients_client_appointments", "description": "Получить записи клиента по номеру телефона", "parameters": { "type": "object", "properties": { "company_id": { "type": "integer", "description": "ID компании в YClients", }, "api_token": { "type": "string", "description": "API токен для доступа к YClients", }, "user_token": { "type": "string", "description": "Токен пользователя для доступа к YClients", }, "client_phone": { "type": "string", "description": "Номер телефона клиента", }, }, "required": ["company_id", "api_token", "user_token", "client_phone"], }, }, ``` ### Создать запись в сервисе YClients Пример инструкции в роли бота: ``` Вы - Диана, опытный администратор центра Подологии, специализирующийся на уходе за стопами и ногтями. Наш центр оказывает высококвалифицированные услуги по медицинскому педикюру и лечению различных заболеваний ногтей. У вас дружелюбный, заботливый, доброжелательный и позитивный характер. Используй в общении смайлы: 🏙️,✍,😇,🙏🏻,🌿 . Если клиент прислал тебе голосовое сообщение, запрещено в ответ присылать ему голосовое сообщение. Не присылай в ответ голосовые сообщения и любые аудио файлы! Выделение важной информации: - Включай жирный шрифт для важных деталей, таких как стоимость и бонусы. Запрещено писать чтобы клиент подождал. Твоя задача создавать записи клиентов на сеансы в наш салон красоты. Номера услуг: 1340XXX - ПараМедицинский МАНИКЮР (seance_length - 2часа) ... Номера специалистов: 3276XXXX - Милана (подолог) ... Используй эти данные для записи клиентов: АПИ токен: "XXXXXXXXXXXXX" Токен пользователя: "XXXXXXXXXXXXXXXXXXXXXX" Номер компании: 309XXX Емайл у всех клиентов передавай такой: api@email.com ``` ``` { "name": "yclients_book_appointment", "description": "Записать клиента на прием через API YClients", "parameters": { "type": "object", "properties": { "company_id": { "type": "integer", "description": "ID компании в YClients", }, "api_token": { "type": "string", "description": "API токен для доступа к YClients", }, "user_token": { "type": "string", "description": "Токен пользователя для доступа к YClients", }, "client_info": { "type": "string", "description": "Информация о клиенте в формате 'телефон;имя;email'", }, "staff_id": { "type": "integer", "description": "ID сотрудника, к которому записывается клиент", }, "service_ids": { "type": "string", "description": "ID услуг, разделенные точкой с запятой", }, "datetime": { "type": "string", "description": "Дата и время записи в формате ISO 8601", }, "seance_length": { "type": "integer", "description": "Длительность сеанса в минутах", }, }, "required": ["company_id", "api_token", "user_token", "client_info", "staff_id", "service_ids", "datetime", "seance_length"], }, }, ``` ### Yclients: Получить полный список данных о клиенте по номеру телефона Yclients: Получить полный список данных о клиенте по номеру телефона ``` { "name": "yclients_get_client_data_by_phone", "description": "Yclients: Получить полный список данных о клиенте по номеру телефона", "parameters": { "type": "object", "properties": { "company_id": { "type": "integer", "description": "ID компании", }, "phone": { "type": "string", "description": "Номер телефона клиента", }, "api_key": { "type": "string", "description": "bearer api_key", }, }, "required": ["company_id", "phone", "api_key"], }, }, ``` ### Удаление записей клиента в сервисе YClients Пример инструкции в боте: ``` Используй эти данные для записи клиентов: АПИ токен: "XXXXXXXXXXXXX" Токен пользователя: "XXXXXXXXXXXXXXXXXXXXXX" Номер компании: 309XXX Номера записей: 914XXXXX; 9144XXXX ``` ``` { "name": "yclients_delete_client_appointments", "description": "Удалить записи клиента в сервисе YClients по списку ID записей", "parameters": { "type": "object", "properties": { "company_id": { "type": "integer", "description": "ID компании в YClients", }, "api_token": { "type": "string", "description": "API токен для доступа к YClients", }, "user_token": { "type": "string", "description": "Токен пользователя для доступа к YClients", }, "record_ids": { "type": "string", "description": "ID записией, которые нужно удалить, разделенные точкой с запятой", }, }, "required": ["company_id", "api_token", "user_token", "record_ids"], }, }, ``` ### Yclients: Получить график сотрудника на указанные даты Yclients: Получить график сотрудника на указанные даты ``` { "name": "yclients_get_employee_schedule", "description": "Yclients: Получить график сотрудника на указанные даты", "parameters": { "type": "object", "properties": { "start_date": { "type": "string", "description": "Дата начала в формате YYYY-MM-DD", }, "end_date": { "type": "string", "description": "Дата окончания в формате YYYY-MM-DD", }, "api_key": { "type": "string", "description": "bearer api_key", }, "company_id": { "type": "integer", "description": "company_id", }, "api_key_user": { "type": "string", "description": "api_key_user", }, }, "required": ["start_date", "end_date", "api_key", "company_id", "api_key_user"], }, }, ``` ## Работа c файлами ### Генерация PDF Функция позволяет попросить бота сформировать PDF файл из любой переданной ему или сгенерированной им самим информации. При этом если вы хотите оформить файл красиво с разметкой, то используйте такую инструкцию: "Если я попрошу сделать PDF, то оформи текст в соответствии с заданием в формате HTML и сформируй из этого файл PDF". ``` "Если я попрошу сделать PDF, то оформи текст в соответствии с заданием в формате HTML и сформируй из этого файл PDF". ``` ``` { "name": "generate_pdf_from_html", "description": "Генерация PDF документа на основе HTML-кода", "parameters": { "type": "object", "properties": { "title": { "type": "string", "description": "Заголовок HTML-документа" }, "body_content": { "type": "string", "description": "Содержимое тела HTML-документа" }, "styles": { "type": "string", "description": "CSS-стили для HTML-документа" }, "filename": { "type": "string", "description": "Имя файла на выходе. Не обязательный параметр." }, }, "required": ["title", "body_content"] }, }, ``` ### Чтение офисных файлов Функция переводит файлы форматов PDF, DOC, XLS, PPT в текст ``` { "name": "read_file_from_url", "description": "Read a file from a URL and extract text with Cyrillic support", "parameters": { "type": "object", "properties": { "url": { "type": "string", "description": "URL of the file", }, "file_type": { "type": "string", "description": "Type of the file to read", "enum": ["PDF", "DOC", "DOCX", "XLS", "XLSX", "PPT", "PPTX"], } }, "required": ["url", "file_type"], }, }, ``` ## Другие СРМ ### Поиск товаров на Мойсклад Поиск товара по ключевому слову в базу сервиса Мойсклад ``` { "name": "moysklad_search", "description": "Search for products by query in the Moysklad API", "parameters": { "type": "object", "properties": { "query": { "type": "string", "description": "Search query", }, "token": { "type": "string", "description": "Bearer token for authorization", }, }, "required": ["query", "token"], }, }, ``` ### Получить данные из определенной сделки из AmoCRM Функция работает при заполненном вебхуке AmoCRM в разделе "Лидогенерация". Для получения данных о сделке в функцию нужно предать ID сделки. ``` { "name": "amocrm_get_lead", "description": "Получить данные о сделке из AmoCRM по ID сделки", "parameters": { "type": "object", "properties": { "lead_id": { "type": "integer", "description": "ID сделки, данные которой нужно получить", }, }, "required": ["lead_id"], }, }, ``` ## Работа с HH.ru ### Поиск резюме на сайте HH Функция предназначена для поиска резюме на платформе hh.ru. Она принимает несколько параметров, включая OAuth токен для авторизации, текст для поиска, ID региона, опыт работы и количество результатов на странице. 1. **api\_token**: обязательный параметр, который используется для авторизации при обращении к API. 2. **search\_text**: обязательный параметр, который определяет, что именно нужно искать в резюме. 3. **area**: опциональный параметр, который позволяет указать ID региона для более точного поиска. 4. **experience**: опциональный параметр, который позволяет фильтровать резюме по опыту работы. Возможные значения: "noExperience", "between1And3", "between3And6", "moreThan6". 5. **per\_page**: опциональный параметр, который задает количество результатов на странице (по умолчанию 20). ``` { "name": "hh_search_resumes", "description": "Поиск резюме на hh.ru", "parameters": { "type": "object", "properties": { "api_token": { "type": "string", "description": "OAuth токен для авторизации", }, "search_text": { "type": "string", "description": "Текст для поиска", }, "area": { "type": "string", "description": "ID региона поиска", }, "experience": { "type": "string", "description": "Опыт работы", "enum": ["noExperience", "between1And3", "between3And6", "moreThan6"], }, "per_page": { "type": "integer", "description": "Количество результатов на странице", }, }, "required": ["api_token", "search_text"], }, }, ``` ### Поиск вакансий на [HH.ru](http://HH.ru) Функция ищет по запросу вакансии на сайте HH.ru ``` { "name": "hh_vacancies", "description": "Поиск вакансий на сайте HH.ru", "parameters": { "type": "object", "properties": { "search_filter": { "type": "string", "description": "Поисковый фильтр", }, "region_id": { "type": "integer", "description": "ID города или региона", }, "period": { "type": "integer", "description": "Период в днях, за который появились вакансии", }, }, "required": ["search_filter", "region_id", "period"], }, }, ``` Поиск резюме на HH.ru Функция invite\_for\_interview предназначена для поиска резюме на сайте HH.ru и отправки приглашений на собеседование. Она принимает следующие параметры: * search\_query: строка, содержащая поисковый запрос для поиска резюме. * employer\_id: строка, содержащая ID работодателя на HH.ru. * vacancy\_id: строка, содержащая ID вакансии, на которую отправляется приглашение. * message: строка, содержащая сообщение для приглашения на собеседование. Функция выполняет следующие шаги: 1. Формирует URL и параметры для поиска резюме на HH.ru. 2. Выполняет запрос к API HH.ru для поиска резюме по заданному поисковому запросу. 3. Проверяет, успешно ли выполнен запрос и найдены ли резюме. 4. Формирует URL для отправки приглашений на собеседование. 5. Для каждого найденного резюме отправляет приглашение на собеседование с указанным сообщением. 6. Возвращает сообщение о результате выполнения: либо "Приглашения успешно отправлены", либо сообщение об ошибке. Функция использует библиотеку requests для выполнения HTTP-запросов к API HH.ru. ``` { "name": "invite_for_interview", "description": "Находит резюме на HH.ru и отправляет приглашение на собеседование", "parameters": { "type": "object", "properties": { "search_query": { "type": "string", "description": "Поисковый запрос для поиска резюме" }, "employer_id": { "type": "string", "description": "ID работодателя на HH.ru" }, "vacancy_id": { "type": "string", "description": "ID вакансии, на которую отправляется приглашение" }, "message": { "type": "string", "description": "Сообщение для приглашения на собеседование" } }, "required": ["search_query", "employer_id", "vacancy_id", "message"] }, }, ``` ## Распознавание данных ### Распознавание текста на фото Функция распознает текст на фото ``` { "name": "easyosr", "description": "Распознование текста по фото", "parameters": { "type": "object", "properties": { "url": { "type": "string", "description": "URL фото для распознования", }, }, "required": ["url"], }, }, ``` ### Распознование текста на фото через Gemini-Pro-Vision Функции нужно отправить ссылку на фото в формате JPG. ``` { "name": "gemini_vision", "description": "Извлечение текста из изображения по URL", "parameters": { "type": "object", "properties": { "image_url": { "type": "string", "description": "URL изображения", }, }, "required": ["image_url"], }, }, ``` ### Распознавание текста на фото и документах используя EasyOSR, GigaChat, YandexOSR, Gemini Функция `osr_combine` предназначена для распознавания текста и шаблонных документов с использованием различных моделей. Модели для распознавания текста: page (по умолчанию) — подходит для изображений с любым количеством строк текста, сверстанного в одну колонку. page-column-sort — для распознавания многоколоночного текста. handwritten — для распознавания произвольного сочетания печатного и рукописного текста на русском и английском языках. table — для распознавания таблиц на русском и английском языках. Модели для распознавания шаблонных документов: passport — основной разворот паспорта. driver-license-front — водительское удостоверение, лицевая сторона. driver-license-back — водительское удостоверение, обратная сторона. vehicle-registration-front — свидетельство о регистрации транспортного средства, лицевая сторона. vehicle-registration-back — свидетельство о регистрации транспортного средства, обратная сторона. license-plates — все регистрационные номера автомобилей на изображении. ```` { "name": "osr_combine", "description": "Распознавание текста по фото или PDF", "parameters": { "type": "object", "properties": { "osr_model": { "type": "string", "description": "Модель для распознавания. ```\nМодели для распознавания текста:\npage (по умолчанию) — подходит для изображений с любым количеством строк текста, сверстанного в одну колонку.\npage-column-sort — для распознавания многоколоночного текста.\nhandwritten — для распознавания произвольного сочетания печатного и рукописного текста на русском и английском языках.\ntable — для распознавания таблиц на русском и английском языках.\n \nМодели для распознавания шаблонных документов:\npassport — основной разворот паспорта.\ndriver-license-front — водительское удостоверение, лицевая сторона.\ndriver-license-back — водительское удостоверение, обратная сторона.\nvehicle-registration-front — свидетельство о регистрации транспортного средства, лицевая сторона.\nvehicle-registration-back — свидетельство о регистрации транспортного средства, обратная сторона.\nlicense-plates — все регистрационные номера автомобилей на изображении.\n```", "enum": ["page", "page-column-sort", "handwritten", "table", "passport", "driver-license-front", "driver-license-back", "vehicle-registration-front", "vehicle-registration-back", "license-plates"], }, "file_url": { "type": "string", "description": "URL изображения или PDF файла для распознавания", }, }, "required": ["osr_model", "file_url"], }, }, ```` ### Распознавание текста (gemini-pro-vision + gemini-flash) Функции нужно отправить ссылку на фото в формате JPG ``` { "name": "osr_combine_ai", "description": "Распознавание текста по фото", "parameters": { "type": "object", "properties": { "image_url": { "type": "string", "description": "URL изображения для распознавания", }, }, "required": ["image_url"], }, }, ``` ## Презентации PPTX ### Редактирование презентации PPTX Пример инструкции в роли бота: ``` 1. Запроси ссылку на презентацию в PPTX. 2. Спроси что нужно изменить в презентации. 3. Запусти функцию редактирования PPTX и покажи ответ функции. ``` ``` { "name": "ai_edit_pptx", "description": "Редактирование PPTX файла", "parameters": { "type": "object", "properties": { "pptx_url": { "type": "string", "description": "URL PPTX файла для редактирования", }, "task": { "type": "string", "description": "Задача редактирования", }, "pdf_result": { "type": "integer", "description": "1 - нужно выдать в формате PDF, 0 - формат PPTX. По умолчанию равно 0.", }, }, "required": ["pptx_url", "task", "pdf_result"], }, }, ``` ### Создание презентации PPTX Пример инструкции в роли бота: ``` 1. Для создание презентации ты должна создать сначала HTML страницу на которой каждый заголовок `

` становится заголовком слайда, а соответствующий текст разбивай на блоки с тегом `

`. 2. В одном теге `

` не должно быть больше 100 символов. 3. Картинки добавляй отдельно, используя тег ``. ``` ``` { "name": "generate_pptx", "description": "Создает презентацию PowerPoint из HTML-кода", "parameters": { "type": "object", "properties": { "html_content": { "type": "string", "description": "HTML-код для создания презентации", }, }, "required": ["html_content"], }, }, ``` ## Поиск и отправка данных ### Отправка лида (все каналы) Функция необходима для сбора лидов (заявок) ботом и отправки информации вам, настраивается на странице "Настройка сбора лидов" ``` { "name": "send_lead", "description": "Отправка лида", "parameters": { "type": "object", "properties": { "name": { "type": "string", "description": "Имя клиента", }, "phone": { "type": "string", "description": "Номер телефона клиента", }, "email": { "type": "string", "description": "E-mail клиента", }, "region": { "type": "string", "description": "Регион или город клиента", }, "url": { "type": "string", "description": "Адрес страницы на сайте", }, "log": { "type": "string", "description": "Сюда напиши всю переписку с клиентом", }, "subject": { "type": "string", "description": "Тема письма, в которой название компании в которую обращается клиент", }, "body": { "type": "string", "description": "Текст письма, в котором укажи все полученные контактные данные клиента и суть его запроса", }, "amo_pipeline_id": { "type": "integer", "description": "ID воронки в AmoCRM. Не обязательный параметр.", }, "amo_status_id": { "type": "integer", "description": "ID этапа воронки в AmoCRM. Не обязательный параметр.", }, }, "required": ["name", "phone", "email", "region", "log", "subject", "body"], }, }, ``` ### Поиск контактов на странице сайта Поиск контактов на странице сайта ``` { "name": "contacts_in_url", "description": "Получение контактов на странице по её URL", "parameters": { "type": "object", "properties": { "url": { "type": "string", "description": "URL для передачи в запрос", }, "css_selector": { "type": "string", "description": "CSS селектор нужного блока на странице. Может быть пустым.", }, }, "required": ["url", "css_selector"], }, }, ``` ### Поиск холодных клиентов Поиск холодных клиентов ``` { "name": "find_clients", "description": "Поиск контактов клиентов через поиск Яндекса", "parameters": { "type": "object", "properties": { "query": { "type": "string", "description": "Поисковый запрос без указания сайта", }, "site": { "type": "string", "description": "Сайт для поиска. Может быть пустым.", }, "n": { "type": "integer", "description": "Количество найденных страниц", }, "css_selector": { "type": "string", "description": "CSS селектор нужного блока на странице. Может быть пустым.", }, "channel": { "type": "string", "enum": ["Emails", "Phones", "Telegram", "WhatsApp"], "description": "Тип канала коммуникации с клиентом", }, }, "required": ["query", "site", "n", "css_selector", "channel"], }, }, ``` ### Поиск контакта по базе Apollo.ai Функция для получения информации о человека по базе данных Apollo.ai ``` { "name": "apollo_person_search", "description": "Поиск персоны в Apollo.ai", "parameters": { "type": "object", "properties": { "api_key": { "type": "string", "description": "API ключ для доступа к Apollo.ai", }, "first_name": { "type": "string", "description": "Имя персоны", }, "last_name": { "type": "string", "description": "Фамилия персоны", }, "organization_name": { "type": "string", "description": "Название организации", }, "domain": { "type": "string", "description": "URL домена", }, }, "required": ["api_key", "first_name", "last_name", "organization_name", "domain"], }, }, ``` ### Проверка компании по данным ФНС Функция check\_company\_fns принимает два обязательных параметра: req (ОГРН или ИНН компании) и key (ключ доступа к API). ``` { "name": "check_company_fns", "description": "Проверка компании по данным ФНС России. Если в ответе функции есть слово `Позитив`, то нужно ответить так: `Положительная репутация`, иначе нужно ответить: `Отрицательная репутация`", "parameters": { "type": "object", "properties": { "req": { "type": "string", "description": "ОГРН или ИНН компании", }, "key": { "type": "string", "description": "Ваш ключ доступа к API", }, }, "required": ["req", "key"], }, }, ``` ### Получение товаров из категории на сайте Bitrix24 Получение товаров из категории на сайте Bitrix. Для работы функции создайте в корне сайта файл `api_products.php` со следующим кодом: ``` "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, '/upload/') === 0) { $imageUrl = $site_url . $imageUrl; } $arResult[] = array( "name" => $arFields["NAME"], "price" => $productPrice, "url" => $site_url . $arFields["DETAIL_PAGE_URL"], "details" => $arFields["DETAIL_TEXT"], "image_url" => $imageUrl ); } // Вывод результата в формате JSON header('Content-Type: application/json'); echo json_encode($arResult); require($_SERVER["DOCUMENT_ROOT"]."/bitrix/modules/main/include/epilog_after.php"); ?> ``` В коде замените код инфоблока каталога товаров - `IBLOCK_ID` на значение для вашего сайта. Инфоблок - это сущность, где хранится структурированная информация, например товары, новости. ``` { "name": "get_products_bitrix", "description": "Получить товары с сайта на Битрикс по заданным параметрам", "parameters": { "type": "object", "properties": { "site_url": { "type": "string", "description": "URL сайта для поиска товаров без `/` в конце", }, "paraments": { "type": "string", "description": """ Параметры поиска в виде: `name:id:min_price:max_price:limit##name:id:min_price:max_price:limit##` `name` - Название товара (может быть прочерком `-`) `nacategory_idme` - ID категории товара `min_price` - Минимальная цена товара `max_price` - Максимальная цена товара `limit` - Сколько товаров должно быть в ответе. По умолчанию 10 """, }, }, "required": ["site_url", "paraments"], }, }, ``` ## Получение товаров ### Получение товаров из категории на сайте Webasyst (Shop-Script) Получение товаров из категории на сайте Webasyst (Shop-Script). Для работы требуется создать в корне сайта файл `get_products.php` со следующим кодом: ``` getProducts('*', $offset, $limit); $result = array(); foreach ($products as $product) { // Получаем полный URL изображения $image_url = ''; if ($product['image_id']) { $image = shopImage::getById($product['image_id']); if ($image) { $image_url = $image->getUrl('thumb', true); // true для получения абсолютного URL } } $result[] = array( 'id' => $product['id'], 'name' => $product['name'], 'price' => $product['price'], 'description' => $product['description'], 'image_url' => $image_url, ); } return $result; } // Обработка запроса if ($_SERVER['REQUEST_METHOD'] === 'GET') { $category_id = isset($_GET['category_id']) ? intval($_GET['category_id']) : 0; $limit = isset($_GET['limit']) ? intval($_GET['limit']) : 10; $offset = isset($_GET['offset']) ? intval($_GET['offset']) : 0; if ($category_id > 0) { $products = getProductsByCategory($category_id, $limit, $offset); header('Content-Type: application/json'); echo json_encode(array( 'status' => 'success', 'data' => $products )); } else { header('HTTP/1.1 400 Bad Request'); echo json_encode(array( 'status' => 'error', 'message' => 'Invalid category ID' )); } } else { header('HTTP/1.1 405 Method Not Allowed'); echo json_encode(array( 'status' => 'error', 'message' => 'Method not allowed' )); } ?> ``` ``` { "name": "get_products_webasyst", "description": "Получить список товаров с сайта Webasyst по заданной категории", "parameters": { "type": "object", "properties": { "site_url": { "type": "string", "description": "URL сайта без `/` в конце", }, "category_id": { "type": "integer", "description": "ID категории товаров", }, "limit": { "type": "integer", "description": "Количество товаров для получения", }, "offset": { "type": "integer", "description": "Смещение для пагинации", }, }, "required": ["site_url", "category_id", "limit", "offset"], }, }, ``` ### Получение товаров из категории на сайте WordPress Получение товаров из категории на сайте WordPress. Для работы функции добавьте в файл `functions.php` вот этот код: ```php add_action('rest_api_init', function () { register_rest_route('myshop/v1', '/products', array( 'methods' => 'GET', 'callback' => 'get_products_info', 'permission_callback' => '__return_true' )); }); function get_products_info($request) { $category = $request->get_param('category'); $args = array( 'status' => 'publish', 'limit' => -1 ); if ($category) { $args['category'] = array($category); } $products = wc_get_products($args); $data = array(); foreach ($products as $product) { $data[] = array( 'id' => $product->get_id(), 'name' => $product->get_name(), 'price' => $product->get_price(), 'regular_price' => $product->get_regular_price(), 'sale_price' => $product->get_sale_price(), 'stock_status' => $product->get_stock_status(), 'stock_quantity' => $product->get_stock_quantity(), 'categories' => wp_list_pluck($product->get_category_ids(), 'name'), 'permalink' => get_permalink($product->get_id()), 'image_url' => wp_get_attachment_url($product->get_image_id()), ); } return new WP_REST_Response($data, 200); } ``` ``` { "name": "get_products_from_wordpress", "description": "Получить товары из категории на сайте WordPress", "parameters": { "type": "object", "properties": { "category": { "type": "string", "description": "Название категории товаров", }, "site_url": { "type": "string", "description": "Ссылка на сайт с WordPress без `/` в конце", }, }, "required": ["category", "site_url"], }, }, ``` ## Дополнительные функции ### Создание лендинга на Bootstrap Создание лендинга на Bootstrap ``` { "name": "generate_landing_page", "description": "Генерация одностраничного сайта", "parameters": { "type": "object", "properties": { "user_data": { "type": "string", "description": "Данные для сайта", }, "user_comments": { "type": "string", "description": "Любые пожелания пользователя к сайту. Может быть пустым.", }, }, "required": ["user_data", "user_comments"] }, }, ``` ### Оплата в диалоге Функция генерирует ссылку и QR-код на оплату внутри диалога. Будет работать только при настроенной интеграции с платежной системой. ``` { "name": "get_payment_link", "description": "Payment link generator", "parameters": { "type": "object", "properties": { "cost": { "type": "integer", "description": "Amount due", }, }, "required": ["cost"], }, }, ```

# Вычисления * [Создание графиков](#sozdanie-grafikov) * [Генератор случайных чисел](#generator-sluchainykh-chisel) * [Случайный выбор варианта](#sluchainyi-vybor-varianta) * [Получение текущего времени по часовому поясу](#poluchenie-tekushego-vremeni-po-chasovomu-poyasu) * [Получить текущую дату в формате ДД.ММ.ГГ](#poluchit-tekushuyu-datu-v-formate-dd.mm.gg) * [Получение текущего времени](#poluchenie-tekushego-vremeni) * [Получить текущий день недели](#poluchit-tekushii-den-nedeli) ## Создание графиков Создание графиков ``` { "name": "generate_google_chart", "description": "Генерация графика с использованием Google Chart", "parameters": { "type": "object", "properties": { "user_data": { "type": "string", "description": "Данные для графика", }, "user_comments": { "type": "string", "description": "Любые пожелания пользователя к графику. Может быть пустым.", }, }, "required": ["user_data", "user_comments"] }, }, ``` ## Генератор случайных чисел Функция get\_random\_numbers принимает аргументы в виде словаря arguments, в котором необходимо указать количество случайных чисел (quantity), минимальное значение (min) и максимальное значение (max) для генерации случайных чисел. Далее функция делает запрос к внешнему API по указанному URL, передавая параметры в запросе. Полученный ответ в виде случайных чисел в указанном диапазоне возвращается в виде текстового значения. ``` { "name": "get_random_numbers", "description": "Получение случайных чисел через внешнее API", "parameters": { "type": "object", "properties": { "quantity": { "type": "integer", "description": "Количество случайных чисел", }, "min": { "type": "integer", "description": "Минимальное значение случайного числа", }, "max": { "type": "integer", "description": "Максимальное значение случайного числа", } }, "required": ["quantity", "min", "max"] }, }, ``` ## Случайный выбор варианта Данная функция принимает список текстовых значений в качестве аргумента и возвращает случайное значение из этого списка, используя миллисекунды для увеличения случайности выбора. Функция использует модули random и time для генерации случайного индекса с учетом текущего времени в миллисекундах. ``` { "name": "get_random_text", "description": "Выбор случайного элемента из списка", "parameters": { "type": "object", "properties": { "texts": { "type": "string", "description": "List of text values separated with comma", } }, "required": ["texts"], }, }, ``` ## Получение текущего времени по часовому поясу Код функции get\_almaty\_time использует библиотеку pytz для работы с часовыми поясами и datetime для работы с временем. Функция получает текущее время в часовом поясе Алматы, форматирует его в формате hh:mm:ss и возвращает это время в виде строки. ``` { "name": "get_time_by_timezone", "description": "Получить текущее время по заданному часовому поясу", "parameters": { "type": "object", "properties": { "timezone": { "type": "string", "description": "Часовой пояс в формате 'Region/City'", }, }, "required": ["timezone"], }, }, ``` ## Получить текущую дату в формате ДД.ММ.ГГ Функция get\_current\_date предназначена для получения текущей даты в формате "ДД.ММ.ГГ". 1. Внутри функции происходит импорт модуля datetime, который предоставляет классы для работы с датами и временем. 2. С помощью метода datetime.now() мы получаем текущую дату и время. 3. Метод strftime("%d.%m.%y") форматирует дату в нужный формат: "ДД" - день, "ММ" - месяц, "ГГ" - последние две цифры года. 4. Функция возвращает строку с текущей датой в указанном формате. Таким образом, вызвав эту функцию, вы всегда получите актуальную дату. ``` { "name": "get_current_date", "description": "Получить текущую дату в формате ДД.ММ.ГГ", "parameters": { "type": "object", "properties": {}, "required": [], }, }, ``` ## Получение текущего времени Эта функция get\_current\_time принимает на вход словарь arguments с ключом "timezone", который указывает на необходимый часовой пояс. Функция возвращает текущее время в указанном формате hh.mm.ss в соответствии с выбранным часовым поясом. Внутри функции используется модуль datetime для работы с временем. ``` { "name": "get_current_time", "description": "Получить текущее время в формате hh.mm.ss", "parameters": { "type": "object", "properties": { "timezone": { "type": "string", "description": "Часовой пояс", "enum": ["UTC", "GMT", "EST", "CET", "PST"], } }, "required": ["timezone"], }, }, ``` ## Получить текущий день недели Функция get\_day\_of\_week принимает на вход словарь arguments, содержащий ключ "date" с датой в формате 'ГГГГ-ММ-ДД'. Далее функция извлекает год, месяц и день из входной даты, затем определяет день недели для этой даты с помощью модуля datetime. Наконец, функция возвращает текущий день недели в текстовом формате. ``` { "name": "get_day_of_week", "description": "Получить текущий день недели", "parameters": { "type": "object", "properties": { "date": { "type": "string", "description": "Дата в формате 'ГГГГ-ММ-ДД'", } }, "required": ["date"], }, }, ``` # Диалоги * [Запуск исходящего диалога (для автоматизации)](#zapusk-iskhodyashego-dialoga-dlya-avtomatizacii) * [Активация бота для отдельного пользователя в отдельном канале](#aktivaciya-bota-dlya-otdelnogo-polzovatelya-v-otdelnom-kanale) * [Активировать Телеграм-Бот для всех его пользователей](#aktivirovat-telegram-bot-dlya-vsekh-ego-polzovatelei) * [Отправить сообщение в диалог](#otpravit-soobshenie-v-dialog) * [Отправка сообщения пользователем Телеграм-бота v2](#otpravka-soobsheniya-polzovatelem-telegram-bota-v2) * [Диалог с одного бота с другим](#dialog-s-odnogo-bota-s-drugim) * [Диалог с ботом v2](#dialog-s-botom-v2) * [Подключение функции к диалогу](#podklyuchenie-funkcii-k-dialogu) * [Добавить роль в диалог](#dobavit-rol-v-dialog) * [Задать вопрос боту](#zadat-vopros-botu) * [Задать вопрос человеку по телефону](#zadat-vopros-cheloveku-po-telefonu) * [Создание напоминаний от бота](#sozdanie-napominanii-ot-bota) * [Постоянная память 3.0](#postoyannaya-pamyat-3.0) * [Графовая память](#grafovaya-pamyat) * [Отложенный запуск функции](#otlozhennyi-zapusk-funkcii) ## Запуск исходящего диалога (для автоматизации) Функция запустит диалог нужного Вам нейро-сотрудника с клиентом в канале WhatsApp или Telegram по определённому триггеру или отложенному таймеру. ``` { "name": "run_external_dialog", "description": "The function triggers an outgoing dialog between the neuro-employee and the client", "parameters": { "type": "object", "properties": { "employee_id": { "type": "integer", "description": "Neuro-employee ID" }, "token": { "type": "string", "description": "Neuro-employee Token" }, "client": { "type": "string", "description": "Client's phone number or Telegram nickname. May be empty." }, "hello": { "type": "string", "description": "Text of greeting for a client from a neuro-employee" } }, "required": ["employee_id", "token", "client", "hello"] }, }, ``` ## Активация бота для отдельного пользователя в отдельном канале Активация бота для отдельного пользователя в отдельном канале ``` { "name": "activate_task", "description": "Активирует бота для отдельного пользователя в нужном канале.", "parameters": { "type": "object", "properties": { "job_id": { "type": "integer", "description": "Номер бота" }, "channel": { "type": "string", "description": "Канал, через который будет активирована задача", "enum": ["Telegram Bot", "Telegram", "WhatsApp"] }, "user_chat_id": { "type": "string", "description": "Идентификатор пользователя" }, "hello_text": { "type": "string", "description": "Текст приветствия. Может быть пустым." } }, "required": ["job_id", "channel", "user_chat_id", "hello_text"] }, }, ``` ## Активировать Телеграм-Бот для всех его пользователей Активировать Телеграм-Бот для всех его пользователей ``` { "name": "activate_telegram_bot", "description": "Активирует бота для всех его пользователей.", "parameters": { "type": "object", "properties": { "job_id": { "type": "integer", "description": "Номер бота" }, "hello_text": { "type": "string", "description": "Текст приветствия. Может быть пустым." } }, "required": ["job_id", "hello_text"] }, }, ``` ## Отправить сообщение в диалог Отправить сообщение в диалог ``` { "name": "send_message_in_dialog", "description": "Отправить сообщение в диалог", "parameters": { "type": "object", "properties": { "role": { "type": "string", "enum" : ["user", "assistant"], "description": "С какой стороны будет сообщение. По умолчанию - user" }, "bot_reply": { "type": "integer", "description": "1 - требуется ответ от бота, 0 - не требуется ответ. По умолчанию - 0" }, "add_in_messages": { "type": "integer", "description": "1 - добавить данное сообщение в контекст диалога, 0 - не добавлять в контекст диалога. По умолчанию - 1" }, "message": { "type": "string", "description": "Текст сообщения" }, "temperature": { "type": "integer", "description": "Креативность ответа бота. Целое число от 1 до 10. По умолчанию 0." }, "from_chat_id": { "type": "string", "description": "ID чата, куда отправить сообщение. Не обязательный параметр." }, "limit": { "type": "integer", "description": "Максимальная длина сообщения, по умолчанию 4000 символов" }, }, "required": ["role", "bot_reply", "add_in_messages", "message", "temperature", "limit"] }, }, ``` ## Отправка сообщения пользователем Телеграм-бота v2 Отправка сообщения пользователем Телеграм-бота v2 ``` { "name": "telegram_bot_broadcast_message", "description": "Отправка массового сообщения пользователям Telegram", "parameters": { "type": "object", "properties": { "bot_token": { "type": "string", "description": "Токен Телеграм-бота", }, "chat_ids": { "type": "string", "description": "Список ID пользователей, разделенных запятыми", }, "message": { "type": "string", "description": "Сообщение для отправки", }, "max_threads": { "type": "integer", "description": "Максимальное количество потоков для отправки сообщений, по умолчанию 10", } }, "required": ["bot_token", "chat_ids", "message"], }, }, ``` ## Диалог с одного бота с другим Запуск автоматического диалога с нейро-сотрудником ``` { "name": "employee_dialog", "description": "Диалог с ИИ сотрудником", "parameters": { "type": "object", "properties": { "employee_id": { "type": "integer", "description": "ID сотрудника", }, "task": { "type": "string", "description": "Описание задачи", }, "human_auto_answers": { "type": "string", "description": "Список автоматических ответов сотруднику. Каждый ответ должен быть с новой строки.", }, }, "required": ["employee_id", "hello_text", "human_auto_answers"], }, }, ``` ## Диалог с ботом v2 Позволяет ботам обмениваться информацией между собой по запросу. Например. Мы хотим находить всю информацию по ИНН и после красиво по заданному шаблону оформлять все в файл ПДФ Создадим 3 бота. №1 главный ( через него будет обращаться к другим ботам) №2 помощник ищет всю информацию по ИНН №3 помощник оформляет текст в пдф по заданным шаблонам. Ставим задачу главному боту. Он в зависимости от контекста задачи обращается к нужному боту. Найти информацию по ИНН 12345689. Главный бот обратится к помощнику боту №2. Далее. Оформи информацию в пдф. Главный бот обратится к помощнику боту №3. Обращения можно делать * текстовым запросом * голосовым. * запрограммировать кнопку * Автоматизировать весь цикл (по необходимости) ``` { "name": "dialog_with_emploee", "description": "Задать вопросы сотруднику", "parameters": { "type": "object", "properties": { "emploee_id": { "type": "integer", "description": "ID сотрудника" }, "token": { "type": "string", "description": "Токен сотрудника" }, "messages": { "type": "string", "description": "Одно или несколько сообщений сотруднику разделенных `##`" } }, "required": ["emploee_id", "token", "messages"] }, }, ``` ## Подключение функции к диалогу Подключение функции к диалогу ``` { "name": "add_function_in_dialog", "description": "Добавить функцию в диалог", "parameters": { "type": "object", "properties": { "query": { "type": "string", "description": "Запрос для поиска функции" }, }, "required": ["query"] }, }, ``` ## Добавить роль в диалог Добавить роль в диалог ``` { "name": "add_role_in_dialog", "description": "Добавить новую роль в текущий диалог", "parameters": { "type": "object", "properties": { "name": { "type": "string", "description": "Имя роли" }, "role": { "type": "string", "description": "Текст роли" }, "functions_ids": { "type": "string", "description": "ID функций через запятую. Не обязательный параметр." }, }, "required": ["name", "role"] }, }, ``` ## Задать вопрос боту Задать вопрос боту ``` { "name": "ask_emploee", "description": "Задать вопрос сотруднику", "parameters": { "type": "object", "properties": { "emploee_id": { "type": "integer", "description": "ID сотрудника" }, "token": { "type": "string", "description": "Токен сотрудника" }, "message": { "type": "string", "description": "Вопрос или сообщение сотруднику" } }, "required": ["emploee_id", "token", "message"] }, }, ``` ## Задать вопрос человеку по телефону Интеграция с voximplant ``` { "name": "ask_question_by_phone", "description": "Ask a question by phone", "parameters": { "type": "object", "properties": { "employee_id": { "type": "integer", "description": "Employee ID", }, "voxapikeys_url": { "type": "string", "description": "Api key file URL", }, "rule_id": { "type": "integer", "description": "Rule ID", }, "phone": { "type": "string", "description": "Phone number starting with country code without spaces, only numbers", }, "role": { "type": "string", "description": "AI prompt for manage dialog", }, "hello_text": { "type": "string", "description": "Greeting in Russian", }, "voice": { "type": "string", "enum" : ["Rachel", "Thomas"], "description": "Voice name. `Rachel` - female voice, `Thomas` - male voice", }, "report_chat_id": { "type": "string", "description": "Set '#' if not given", }, "report_promt_id": { "type": "string", "description": "Set '#' if not given", }, }, "required": ["employee_id", "voxapikeys_url", "rule_id", "phone", "role", "hello_text", "voice", "report_chat_id", "report_promt_id"], }, }, ``` ## Создание напоминаний от бота В одном диалоге можно сделать неограниченное количество напоминаний. Пример: при общении клиент может боту сказать: ""я занят, напиши мне завтра после обеда" и бот с ним свяжется в указанное время ``` { "name": "bot_scheduled_message", "description": "Отложенное сообщение от бота для текущего диалога", "parameters": { "type": "object", "properties": { "activation_datetime": { "type": "string", "description": "Дата и время отправки сообщения в формате `%Y-%m-%dT%H:%M:%S.%fZ`" }, "message": { "type": "string", "description": "Текст сообщения от бота" }, }, "required": ["activation_datetime", "message"] }, }, ``` ## Постоянная память 3.0 Функция позволяет боту запоминать что-то из диалога с пользователем. И даже после перезагрузки бот будет держать это в памяти. Через 24 часа без функции памяти бот не сможет помнить о чем был диалог вчера. ``` { "name": "ai_memory_v3", "description": "Call this function when you need to make adjustments to JSON memory.", "parameters": { "type": "object", "properties": { "key": { "type": "string", "description": "New or existing key from JSON memory", }, "value": { "type": "string", "description": "Plain text to be written by the specified key", }, "action": { "type": "string", "enum": ["+", '-', '.', '_'], "description": "Action type. `+` - means adding information to memory. `-` - means deleting information from memory. `.` - means changing information in memory. `_` - means clear all memory", }, "reply_message": { "type": "string", "description": "Response in case of successful operation of the function. Can be empty.", }, }, "required": ["key", "value", "action", "reply_message"], }, }, ``` ## Графовая память Графовая память ``` { "name": "user_memory", "description": "User memory", "parameters": { "type": "object", "properties": { "category": { "type": "string", "description": "Memory category", }, "action": { "type": "string", "description": "The action to perform", "enum": ["create", "read", "update", "delete"], }, "content": { "type": "string", "description": "Text to remember. Required only in `create` and `update` mode", }, "id": { "type": "integer", "description": "Memory record ID. Required only in 'delete' mode", }, }, "required": ["category", "action"], }, }, ``` ## Отложенный запуск функции Отложенный запуск функции ``` { "name": "bot_scheduled_function", "description": "Отложенное выполнение функции ботом", "parameters": { "type": "object", "properties": { "activation_datetime": { "type": "string", "description": "Дата и время отправки сообщения в формате `%Y-%m-%dT%H:%M:%S.%fZ`" }, "function_id": { "type": "integer", "description": "ID функции" }, "parameters": { "type": "string", "description": "Параметры для вызова функции в виде JSON-строки: `{'param_name' : 'param_value'}`" }, "reply_in_dialog": { "type": "boolean", "description": "Нужно ли возвращать результат в диалог. По умолчанию `True`" }, }, "required": ["activation_datetime", "function_id", "parameters", "reply_in_dialog"] }, }, ``` # Интернет [Отправка и получение данных ](#otpravka-i-poluchenie-dannykh) * [Парсинг по URL](#parsing-po-url) * [Рекурсивный парсинг сайта](#rekursivnyi-parsing-saita) * [Отправка Email со своего SMTP сервера](#otpravka-email-so-svoego-smtp-servera) * [Отправить сообщение всем пользователям Телеграм-бота](#otpravit-soobshenie-vsem-polzovatelyam-telegram-bota) * [Получение содержания страницы в Интернет](#poluchenie-soderzhaniya-stranicy-v-internet) * [Получения ссылок на первые 10 сайтов в выдаче Baidu по вашему ключевому запросу](#polucheniya-ssylok-na-pervye-10-saitov-v-vydache-baidu-po-vashemu-klyuchevomu-zaprosu) * [Получение транскрипции видео с YouTube](#poluchenie-transkripcii-video-s-youtube) * [Чтение данных из таблицы Google](#chtenie-dannykh-iz-tablicy-google) * [Скачивание аудио с youtube.](#skachivanie-audio-s-youtube) * [Прогнозы по ставкам на спорт](#prognozy-po-stavkam-na-sport) * [Создание HTML](#sozdanie-html) * [Статистика видео на YouTube](#statistika-video-na-youtube) * [Список мест по ГЕО-координатам](#spisok-mest-po-geo-koordinatam) * [Взаимодействие с Albato через веб-хук](#vzaimodeistvie-s-albato-cherez-veb-khuk) * [Анализатор ссылок](#analizator-ssylok) [Поиск](#poisk) * [Поиск в Яндекс.Картинки](#poisk-v-yandeks.kartinki) * [Поиск в Яндекс](#poisk-v-yandeks) * [Поиск ссылок на страницах сайта, используя Яндекс](#poisk-ssylok-na-stranicakh-saita-ispolzuya-yandeks) * [Поиск в Яндекс (по сайту)](#poisk-v-yandeks-po-saitu) * [Поиск картинок в Яндекс (API)](#poisk-kartinok-v-yandeks-api) * [Поиск литературы в Google Scholar](#poisk-literatury-v-google-scholar) * [Поиск в Google](#poisk-v-google) * [Поиск картинки в Google](#poisk-kartinki-v-google) * [Поиск через Perplexity](#poisk-cherez-perplexity) * [Поиск через Perplexity (VseGPT)](#poisk-cherez-perplexity-vsegpt) * [Поиск холодных клиентов](#poisk-kholodnykh-klientov) * [Поиск контакта по базе Apollo.ai](#poisk-kontakta-po-baze-apollo.ai) * [Поиск событий по сайту Афиша.ру](#poisk-sobytii-po-saitu-afisha.ru) * [Поиск контактов на странице сайта](#poisk-kontaktov-na-stranice-saita) ## Отправка и получение данных ### Парсинг по URL Функция get\_element\_content позволяет получить содержимое элемента на веб-странице, используя любую часть CSS селектора для поиска элементов. Полученный контент очищается от HTML тегов. Пользователь может указать, нужно ли возвращать HTML контент блока, а также количество блоков для возврата контента. Например чтение 3-х новостей с главной страницы Lenta.RU выглядит так: ``` Прочитай 3 новости с сайта https://lenta.ru с селектором 'card-big _topnews _news' в текстовом виде. ``` ``` { "name": "get_element_content", "description": "Получить содержимое элемента по CSS селектору и очистить от HTML тегов, используя библиотеку fake_headers", "parameters": { "type": "object", "properties": { "url": { "type": "string", "description": "URL страницы", }, "tag_name" : { "type": "string", "description": "Название html тега, например: html, title, head, body, td, p. По умолчанию `body`. Пусто, если нужны только заголовки с сайта.", }, "css_component": { "type": "string", "description": "Название аттрибута DOM элемента (например: class, name, data). По умолчанию пусто.", }, "css_selector": { "type": "string", "description": "Часть CSS селектора. Может быть пустым.", }, "return_html": { "type": "integer", "description": "Возвращать ли HTML контент блока (`0` - нет, `1` - да). По умолчанию `0`.", }, "count_elements": { "type": "integer", "description": "Количество блоков для возврата контента. По умолчанию `1`.", }, "only_headers": { "type": "integer", "description": "Нужно ли вернуть только заголовки и метатеги страницы (`0` - нет, `1` - да). По умолчанию `0`.", }, }, "required": ["url", "tag_name", "css_component", "css_selector", "return_html", "count_elements", "only_headers"], }, }, ``` ### Рекурсивный парсинг сайта Функция проведет парсинг сайта и создаст XLSX файл с загруженными данными ``` { "name": "ai_web_crawl", "description": "Recursive AI website parsing using CSS selectors", "parameters": { "type": "object", "properties": { "url": { "type": "string", "description": "URL of the website", }, "limit": { "type": "integer", "description": "Limit of the number of pages for the parser to traverse", }, "css_selectors": { "type": "string", "description": "List of CSS selectors separated by commas", } }, "required": ["url", "limit", "css_selectors"], }, }, ``` ### Отправка Email со своего SMTP сервера Функция выполняет отправку Email с вашего SMPT сервера ``` { "name": "send_email", "description": "Отправка Email сообщения через SMTP сервер", "parameters": { "type": "object", "properties": { "email_from": { "type": "string", "description": "Email отправителя", }, "email_from_name": { "type": "string", "description": "Имя отправителя", }, "recipients": { "type": "string", "description": "Email получателя", }, "subject": { "type": "string", "description": "Тема сообщения", }, "email_text": { "type": "string", "description": "Текст сообщения", }, "host": { "type": "string", "description": "SMTP сервер", }, "port": { "type": "integer", "description": "Порт SMTP сервера", }, "login": { "type": "string", "description": "Логин для авторизации на SMTP сервере", }, "password": { "type": "string", "description": "Пароль для авторизации на SMTP сервере", }, "debug": { "type": "boolean", "description": "Отладочный режим", } }, "required": ["email_from", "email_from_name", "recipients", "subject", "email_text", "host", "port", "login", "password"], }, }, ``` ### Отправить сообщение всем пользователям Телеграм-бота Отправить сообщение всем пользователям Телеграм-бота ``` { "name": "send_telegram_message_all_users", "description": "Send a message to users of a Telegram bot using the specified API.", "parameters": { "type": "object", "properties": { "promt_id": { "type": "integer", "description": "The ID of the prompt." }, "bot_token": { "type": "string", "description": "The token of the Telegram bot." }, "message": { "type": "string", "description": "The message to be sent to the users." } }, "required": ["promt_id", "bot_token", "message"] }, }, ``` ### Получение содержания страницы в Интернет Получение содержания страницы в Интернет ``` { "name": "get_cleaned_text_from_url", "description": "Получить текст со страницы по URL, очищенный от всех HTML тегов и отформатированный в Markdown", "parameters": { "type": "object", "properties": { "url": { "type": "string", "description": "URL страницы для извлечения текста", }, "limit": { "type": "integer", "description": "Максимальная длина полученного текста (по умолчанию равна 8000)", }, }, "required": ["url", "limit"], }, }, ``` ### Получения ссылок на первые 10 сайтов в выдаче Baidu по вашему ключевому запросу В функцию необходимо передать поисковый запрос ``` { "name": "parse_baidu", "description": "Парсит результаты поиска Baidu по заданному запросу", "parameters": { "type": "object", "properties": { "query": { "type": "string", "description": "Поисковый запрос", }, }, "required": ["query"], }, }, ``` ### Получение транскрипции видео с YouTube Функция позволяет боту иметь доступ к тексту транскрипции видео на Youtube и работать с ним ``` { "name": "get_youtube_transcript", "description": "Get transcript of YouTube video by URL", "parameters": { "type": "object", "properties": { "url": { "type": "string", "description": "URL of YouTube video", }, }, "required": ["url"], }, }, ``` ### Чтение данных из таблицы Google Чтение данных из таблицы Google ``` { "name": "get_google_table", "description": "Получить данные из Google таблицы по URL и порядковому номеру листа", "parameters": { "type": "object", "properties": { "url": { "type": "string", "description": "URL Google таблицы" }, "sheet_index": { "type": "integer", "description": "Порядковый номер листа в Google таблице начиная с 1. По умолчанию 1.", } }, "required": ["url"] }, }, ``` ### Скачивание аудио с youtube. Скачивание аудио с youtube. ``` { "name": "download_youtube_audio", "description": "Получить аудио дорожку по ссылке на ролик YouTube", "parameters": { "type": "object", "properties": { "video_url": { "type": "string", "description": "Ссылка на ролик на YouTube", } }, "required": ["video_url"], }, }, ``` ### Прогнозы по ставкам на спорт Эта функция позволяет быстро находить прогноз по ставкам на ближайшую игру ``` { "name": "get_sport_tips", "description": "Get sports tips for a specific day and game", "parameters": { "type": "object", "properties": { "day": { "type": "string", "description": "Day for sports tips", "enum": ["yesterday", "today", "tomorrow"], }, "game": { "type": "string", "description": "Type of game for sports tips", "enum": ["football", "hockey", "tennis", "formula-1", "basketball", "mma", "volleyball", "handball", "baseball", "cybersport", "box", "olympic"], } }, "required": ["day", "game"], }, }, ``` ### Создание HTML Пример инструкции в боте: ``` Ты создаешь HTML страницу по моим задачам. Вот тут текущий код страницы: ##dynamic_data## ``` ``` { "name": "html_builder", "description": "Данная функция позволяет создавать и редактировать HTML код", "parameters": { "type": "object", "properties": { "mode": { "type": "string", "description": "Режим", "enum": ["blank_html", "edit", "from_url"], }, "edit_replacements": { "type": "string", "description": "Замены для обновления HTML, в формате: `старый_код_1:::новый_код_1;;;старый_код_2:::новый_код_2`.", }, "from_url": { "type": "string", "description": "Адрес страницы с которой нужно загрузить HTML", }, "blank_html": { "type": "string", "description": "HTML код новой страницы.", }, }, "required": ["mode"], }, }, ``` ### Статистика видео на YouTube Функция по ссылке на ролик YouTube возвращает статистику: "Статистика видео - Просмотры: 3347, Лайки: 410, Дизлайки: 0, Комментарии: 120" ``` { "name": "get_youtube_stats", "description": "Get statistics of a video on YouTube", "parameters": { "type": "object", "properties": { "video_url": { "type": "string", "description": "URL of the video on YouTube" } }, "required": ["video_url"] }, }, ``` ### Список мест по ГЕО-координатам Функция позволяет отправить боту свои координаты (в том числе через мессенджеры кнопкой "поделиться локацией") и получить в ответ информацию о достопримечательностях или кафе поблизости ``` { "name": "search_places_by_coordinates", "description": "Поиск мест по геокоординатам с отдельным вводом широты и долготы и размерами области поиска", "parameters": { "type": "object", "properties": { "latitude": { "type": "number", "description": "Широта", }, "longitude": { "type": "number", "description": "Долгота", }, "type": { "type": "string", "description": "Тип места", "enum": [ "Гостиницы", "Рестораны и кафе", "Музеи", "Памятники", "Арт-объекты", "Места для отдыха" "Культовые сооружения", "Природные парки", "Озера, реки, водоёмы", "Промышленные объекты", "Мастерские ремесленников", "Города, Сёла" ], }, "spn": { "type": "string", "description": "Размеры области поиска (широта, долгота), пример 0.552069,0.400552", } }, "required": ["latitude", "longitude", "type", "spn"], }, }, ``` ### Взаимодействие с Albato через веб-хук Позволяет передать данные от ИИ ассистента в сервис Альбато ``` { "name": "interact_with_albato", "description": "Взаимодействие с Albato через веб-хук", "parameters": { "type": "object", "properties": { "data": { "type": "string", "description": "Данные для передачи в Albato" }, "webhook_url": { "type": "string", "description": "URL веб-хука Albato" } }, "required": ["data", "webhook_url"] }, }, ``` ### Анализатор ссылок Функция позволяет отправив боту ссылку на страницу сайта попросить его проанализировать содержание и например выдать какой-то анализ или краткое содержание или написать пост об этом. ``` { "name": "get_text_from_url", "description": "Получение информации по URL", "parameters": { "type": "object", "properties": { "url": { "type": "string", "description": "Адрес сайта", }, }, "required": ["url"], }, }, ``` ## Поиск ### Поиск в Яндекс.Картинки Поиск картинок в Яндексе ``` { "name": "yandex_images", "description": "Поиск на Яндекс.Картинки", "parameters": { "type": "object", "properties": { "query": { "type": "string", "description": "Поисковый запрос", }, }, "required": ["query"], }, }, ``` ### Поиск в Яндекс Функция позволяет попросить бота найти какую-то информацию, файл, статью и т.д. в Яндексе и получить ответ и ссылку на него ``` { "name": "search_yandex", "description": "Search information in Yandex", "parameters": { "type": "object", "properties": { "query": { "type": "string", "description": "Search request in Russian", }, }, "required": ["query"], }, }, ``` ### Поиск ссылок на страницах сайта, используя Яндекс Поиск ссылок на страницах сайта, используя Яндекс ``` { "name": "parse_site_links_yandex", "description": "Поиск ссылок на страницы сайта, используя поиск Яндекса", "parameters": { "type": "object", "properties": { "query": { "type": "string", "description": "Поисковый запрос без указания сайта", }, "site": { "type": "string", "description": "Сайт для поиска. Может быть пустым.", }, "n": { "type": "integer", "description": "Количество найденных страниц", }, }, "required": ["query", "site", "n"], }, }, ``` ### Поиск в Яндекс (по сайту) Функция позволяет запрашивать у бота информацию, которая содержится на конкретной странице сайта (ссылку нужно указать на странице "Базы знаний") ``` { "name": "parse_yandex", "description": "Функция поиска информации с сайта через поиск Яндекс. При ответе не нужно указывать источник.", "parameters": { "type": "object", "properties": { "query": { "type": "string", "description": "Поисковый запрос", }, "site": { "type": "string", "description": "Сайт для поиска", }, }, "required": ["query", "site"], }, }, ``` ### Поиск картинок в Яндекс (API) Описание параметров для поиска изображений 1. **text** - То, что вы хотите найти. Напишите здесь свой запрос, например "красивые пейзажи". Это третий обязательный параметр. 2. **groupby** - Настройка того, как группировать найденные картинки. Обычно этот параметр лучше оставить специалистам. 3. **p** - Номер страницы с результатами. Если хотите увидеть больше картинок, можете указать 2, 3 и так далее. 4. **fyandex** - Включение "семейного" фильтра. Если указать 1, то поиск будет без "взрослого" контента. 5. **site** - Если хотите искать картинки только на определенном сайте, укажите его адрес здесь. 6. **itype** - Тип файла картинки. Можно выбрать jpg, gif или png. 7. **iorient** - Как расположена картинка: горизонтально, вертикально или квадратная. 8. **isize** - Размер картинки: от крошечной до огромной или обоев для рабочего стола. 9. **icolor** - Основной цвет картинки. Можно выбрать из списка: серый, цветной, красный, оранжевый, желтый, зеленый, голубой, синий, фиолетовый, белый или черный. ``` { "name": "search_images", "description": "Поиск изображений по заданным параметрам через Yandex Search API", "parameters": { "type": "object", "properties": { "text": { "type": "string", "description": "Текст поискового запроса" }, "groupby": { "type": "string", "description": "Настройки группировки результатов" }, "p": { "type": "integer", "description": "Номер страницы поисковой выдачи" }, "fyandex": { "type": "integer", "description": "Фильтр 'Семейный поиск'", "enum": [0, 1] }, "site": { "type": "string", "description": "Доменное имя сайта для поиска" }, "itype": { "type": "string", "description": "Формат картинки", "enum": ["jpg", "gif", "png"] }, "iorient": { "type": "string", "description": "Тип ориентации изображения", "enum": ["horizontal", "vertical", "square"] }, "isize": { "type": "string", "description": "Размер картинки", "enum": ["enormous", "large", "medium", "small", "tiny", "wallpaper"] }, "icolor": { "type": "string", "description": "Цвет картинки", "enum": ["gray", "color", "red", "orange", "yellow", "green", "cyan", "blue", "violet", "white", "black"] } }, "required": ["text"] }, }, ``` ### Поиск литературы в Google Scholar Функция search\_literature предназначена для поиска источников литературы в Google Scholar. Она принимает два обязательных параметра: query (строка, содержащая поисковый запрос) и api\_key (строка, содержащая ключ API для доступа к Google Scholar). 1. Внутри функции импортируется библиотека serpapi, которая используется для выполнения запросов к API Google Scholar. 2. Создается словарь params, который содержит параметры запроса, включая тип поискового движка, сам запрос и ключ API. 3. Затем создается объект GoogleSearch с переданными параметрами и выполняется запрос с помощью метода get\_dict(). 4. Результаты поиска извлекаются из ответа и возвращаются в виде строки. Таким образом, вы можете использовать эту функцию для получения результатов поиска по заданному запросу в Google Scholar. ``` { "name": "search_literature", "description": "Search for literature sources in Google Scholar", "parameters": { "type": "object", "properties": { "query": { "type": "string", "description": "Search query for literature", }, "api_key": { "type": "string", "description": "API key for Google Scholar", }, }, "required": ["query", "api_key"], }, }, ``` ### Поиск в Google Поиск информации в Google ``` { "name": "parse_google", "description": "##Специальность## ##Компания##. Не указывай источник. ", "parameters": { "type": "object", "properties": { "query": { "type": "string", "description": "Поисковый запрос", }, "site": { "type": "string", "description": "Сайт для поиска", }, "role": { "type": "string", "description": "Текст для роли ChatGPT, задача которой решать подходит ли страница в выдаче запросу пользователя", }, }, "required": ["query", "site", "role"], }, }, ``` ### Поиск картинки в Google Поиск картинки в Google ``` { "name": "get_google_image", "description": "Получить URL изображения по запросу в Google", "parameters": { "type": "object", "properties": { "query": { "type": "string", "description": "Поисковый запрос для Google" } }, "required": ["query"] }, }, ``` ### Поиск через Perplexity Для работы функции нужен API ключ от perplexity.ai ``` { "name": "perplexity_online", "description": "Получить ответ от AI Perplexity", "parameters": { "type": "object", "properties": { "api_key": { "type": "string", "description": "API ключ для доступа к OpenAI", }, "question": { "type": "string", "description": "Вопрос для AI", }, "ai_model": { "type": "string", "description": "Модель AI для обработки запроса. По умолчанию `llama-3.1-sonar-small-128k-online`", "enum": ["llama-3.1-sonar-small-128k-online", "llama-3.1-sonar-large-128k-online", "llama-3.1-sonar-huge-128k-online"] }, }, "required": ["api_key", "question", "ai_model"], }, }, ``` ### Поиск через Perplexity (VseGPT) Для поиска по конкретному сайту попросите бота: ``` Ко всем запросам поиска в Интернет добавляй: "site:ВАШ_САЙТ.SITE" ``` ``` { "name": "vsegpt_perplexity_online", "description": "Получить ответ от AI Perplexity с доступом в Интернет", "parameters": { "type": "object", "properties": { "question": { "type": "string", "description": "Вопрос для поиска в Интернет", }, "ai_model": { "type": "string", "description": "LLM модель. По умолчанию: `llama-3.1-sonar-small-128k-online`", "enum": ["llama-3.1-sonar-small-128k-online", "llama-3.1-sonar-large-128k-online"] }, "search_domain_filter": { "type": "string", "description": "Домен для поиска в виде: `https://domain.com`. Не обязательный параметр", }, }, "required": ["question", "ai_model"], }, }, ``` ### Поиск холодных клиентов Поиск холодных клиентов ``` { "name": "find_clients", "description": "Поиск контактов клиентов через поиск Яндекса", "parameters": { "type": "object", "properties": { "query": { "type": "string", "description": "Поисковый запрос без указания сайта", }, "site": { "type": "string", "description": "Сайт для поиска. Может быть пустым.", }, "n": { "type": "integer", "description": "Количество найденных страниц", }, "css_selector": { "type": "string", "description": "CSS селектор нужного блока на странице. Может быть пустым.", }, "channel": { "type": "string", "enum": ["Emails", "Phones", "Telegram", "WhatsApp"], "description": "Тип канала коммуникации с клиентом", }, }, "required": ["query", "site", "n", "css_selector", "channel"], }, }, ``` ### Поиск контакта по базе Apollo.ai Функция для получения информации о человека по базе данных Apollo.ai ``` { "name": "apollo_person_search", "description": "Поиск персоны в Apollo.ai", "parameters": { "type": "object", "properties": { "api_key": { "type": "string", "description": "API ключ для доступа к Apollo.ai", }, "first_name": { "type": "string", "description": "Имя персоны", }, "last_name": { "type": "string", "description": "Фамилия персоны", }, "organization_name": { "type": "string", "description": "Название организации", }, "domain": { "type": "string", "description": "URL домена", }, }, "required": ["api_key", "first_name", "last_name", "organization_name", "domain"], }, }, ``` ### Поиск событий по сайту Афиша.ру Эта функция позволяет быстро найти какой-либо концерт, фильм, спектакль и т.п. ``` { "name": "get_afisha_event", "description": "Get information about an event from Afisha website", "parameters": { "type": "object", "properties": { "city": { "type": "string", "description": "City name", "enum": ["ekaterinburg", "msk", "spb", "novosibirsk", "samara", "anapa"], }, "category": { "type": "string", "description": "Event category", "enum": ["schedule_concert", "schedule_theatre", "schedule_cinema", "schedule_exhibition", "schedule_kids"], }, "day": { "type": "string", "description": "Day of the event", "enum": ["01", "02", "03", "04", "05", "06", "07", "08", "09", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30", "31"], }, "month": { "type": "string", "description": "Month of the event", "enum": ["marta", "aprelya", "maya", "iyunya", "iyulya", "avgusta", "sentyabrya", "oktyabrya", "noyabrya", "dekabrya", "yanvarya", "fevralya"], } }, "required": ["city", "category", "day", "month"], }, }, ``` ### Поиск контактов на странице сайта Поиск контактов на странице сайта ``` { "name": "contacts_in_url", "description": "Получение контактов на странице по её URL", "parameters": { "type": "object", "properties": { "url": { "type": "string", "description": "URL для передачи в запрос", }, "css_selector": { "type": "string", "description": "CSS селектор нужного блока на странице. Может быть пустым.", }, }, "required": ["url", "css_selector"], }, }, ``` # Реклама * [Публикация поста в Телеграм канале](#publikaciya-posta-v-telegram-kanale) * [Публикация поста в несколько Телеграм каналов из Google таблицы](#publikaciya-posta-v-neskolko-telegram-kanalov-iz-google-tablicy) * [Получение постов из публичного Телеграм канала](#poluchenie-postov-iz-publichnogo-telegram-kanala) * [Получение постов из публичного Телеграм канала v2](#poluchenie-postov-iz-publichnogo-telegram-kanala-v2) * [Получение статистики из Яндекс.Директ](#poluchenie-statistiki-iz-yandeks.direkt) * [Отправить уведомление в Telegram](#otpravit-uvedomlenie-v-telegram) ## Публикация поста в Телеграм канале Функция позволяет боту публиковать любую информацию в ваш ТГ-канал. Для этого в целях боту пропишите эту команду: "Сначала узнай токен бота и id телеграм канала для возможности публиковать посты и без этой информации ты не можешь отвечать ни на какие вопросы пользователя." Не забудьте, что бот должен быть добавлен в администраторы вашего канала! ``` { "name": "send_post_to_telegram_channel", "description": "Publish post in Telegram channel", "parameters": { "type": "object", "properties": { "bot_token": { "type": "string", "description": "Bot token from @BotFather", }, "channel_id": { "type": "string", "description": "Channel name (strating with @) or channel ID ", }, "post_text": { "type": "string", "description": "Message to post in HTML format", }, "post_foto": { "type": "string", "description": "Post foto URL. May be empty.", }, "post_video": { "type": "string", "description": "Post video URL. May be empty.", }, "post_file": { "type": "string", "description": "Post file URL. May be empty.", }, }, "required": ["bot_token", "channel_id", "post_text", "post_foto", "post_video", "post_file"], }, }, ``` ## Публикация поста в несколько Телеграм каналов из Google таблицы Публикация поста в несколько Телеграм каналов из Google таблицы ``` { "name": "send_post_to_telegram_channel_google_sheet", "description": "Publish post in Telegram channel using Google Sheet", "parameters": { "type": "object", "properties": { "bot_token": { "type": "string", "description": "Bot token from @BotFather", }, "google_sheet_url": { "type": "string", "description": "Google Sheet with Telegram channels names", }, "post_text": { "type": "string", "description": "Message to post in HTML format", }, "post_foto": { "type": "string", "description": "Post foto URL. May be empty.", }, "post_video": { "type": "string", "description": "Post video URL. May be empty.", }, "post_file": { "type": "string", "description": "Post file URL. May be empty.", }, }, "required": ["bot_token", "google_sheet_url", "post_text", "post_foto", "post_video", "post_file"], }, }, ``` ## Получение постов из публичного Телеграм канала Функция позволяет боту иметь доступ к контенту указанного телеграм-канала, можно попросить взять какой-то конкретный пост (например последний) и переписать его. ``` { "name": "get_last_posts_from_telegram_channel", "description": "Получение постов из Телеграм канала", "parameters": { "type": "object", "properties": { "channel_id": { "type": "string", "description": "Имя канала (начинается с @)", }, "n": { "type": "integer", "description": "Количество постов. По умолчанию равно 1", }, }, "required": ["channel_id"], }, }, ``` ## Получение постов из публичного Телеграм канала v2 Функция позволяет боту иметь доступ к контенту указанного телеграм-канала, можно попросить взять какой-то конкретный пост (например последний) и переписать его. ``` { "name": "parse_telegram_channel", "description": "Получение постов из Телеграм канала", "parameters": { "type": "object", "properties": { "channel_id": { "type": "string", "description": "Имя канала (начинается с @)", }, "n": { "type": "integer", "description": "Количество постов. По умолчанию равно 1", }, }, "required": ["channel_id"], }, }, ``` ## Получение статистики из Яндекс.Директ Функция получаем статистику по рекламной кампании. Для работы функции необходимо создать приложение по ссылке: ; ``` https://direct.yandex.ru/registered/main.pl?cmd=apiCertificationRequestList ``` и предоставить полный доступ к управлению вашими рекламными кампаниями. После регистрации приложения используйте эту ссылку для получения токена: ``` https://oauth.yandex.ru/authorize?response_type=token&client_id=client_id_вашего_приложения ``` ``` { "name": "get_yandex_direct_stats", "description": "Get Yandex.Direct statistics report for a specific date", "parameters": { "type": "object", "properties": { "token": { "type": "string", "description": "Yandex.Direct API token", }, "login": { "type": "string", "description": "Yandex.Direct account login. Not required.", }, "days": { "type": "integer", "description": "Number of days to go back in history", }, }, "required": ["token", "days"], }, }, ``` ## Отправить уведомление в Telegram Отправить уведомление в Telegram ``` { "name": "send_telegram_message", "description": "Отправить сообщение в Telegram", "parameters": { "type": "object", "properties": { "bot_token": { "type": "string", "description": "Токен бота Telegram", }, "user_chat_id": { "type": "string", "description": "Идентификатор чата или несколько через запятую", }, "message": { "type": "string", "description": "Сообщение для отправки", }, "user_cc": { "type": "integer", "description": "Нужно ли отправлять копию сообщения в текущий диалог. По умолчанию этот параметр равен 0 и дублировать сообщение в текущий диалог не нужно. Если он будет 1 то уведомление нужно отправить.", }, "parse_mode": { "type": "string", "enum" : ["HTML", "MarkdownV2", "Plain"], "description": "Формат отправки. По умолчанию `Plain`", }, "foto_url": { "type": "string", "description": "Ссылка на фото. Не обязательный параметр.", }, }, "required": ["bot_token", "user_chat_id", "message", "user_cc", "parse_mode"], }, }, ``` # Соц сети * [Публикация поста в Телеграм канале](#publikaciya-posta-v-telegram-kanale) * [Публикация поста в несколько Телеграм каналов из Google таблицы](#publikaciya-posta-v-neskolko-telegram-kanalov-iz-google-tablicy) * [Публикация поста в Инстаграм](#publikaciya-posta-v-instagram) * [Получение постов из публичного Телеграм канала](#poluchenie-postov-iz-publichnogo-telegram-kanala) * [Получение постов из публичного Телеграм канала v2](#poluchenie-postov-iz-publichnogo-telegram-kanala-v2) * [Поиск в каналах и чатах Телеграмм](#poisk-v-kanalakh-i-chatakh-telegramm) * [Отправить уведомление в Telegram](#otpravit-uvedomlenie-v-telegram) * [Активировать Телеграм-Бот для всех его пользователей](#aktivirovat-telegram-bot-dlya-vsekh-ego-polzovatelei) ## Публикация поста в Телеграм канале Функция позволяет боту публиковать любую информацию в ваш ТГ-канал. Для этого в целях боту пропишите эту команду: "Сначала узнай токен бота и id телеграм канала для возможности публиковать посты и без этой информации ты не можешь отвечать ни на какие вопросы пользователя." Не забудьте, что бот должен быть добавлен в администраторы вашего канала! {% embed url="" %} ``` { "name": "send_post_to_telegram_channel", "description": "Publish post in Telegram channel", "parameters": { "type": "object", "properties": { "bot_token": { "type": "string", "description": "Bot token from @BotFather", }, "channel_id": { "type": "string", "description": "Channel name (strating with @) or channel ID ", }, "post_text": { "type": "string", "description": "Message to post in HTML format", }, "post_foto": { "type": "string", "description": "Post foto URL. May be empty.", }, "post_video": { "type": "string", "description": "Post video URL. May be empty.", }, "post_file": { "type": "string", "description": "Post file URL. May be empty.", }, }, "required": ["bot_token", "channel_id", "post_text", "post_foto", "post_video", "post_file"], }, }, ``` ## Публикация поста в несколько Телеграм каналов из Google таблицы Публикация поста в несколько Телеграм каналов из Google таблицы ``` { "name": "send_post_to_telegram_channel_google_sheet", "description": "Publish post in Telegram channel using Google Sheet", "parameters": { "type": "object", "properties": { "bot_token": { "type": "string", "description": "Bot token from @BotFather", }, "google_sheet_url": { "type": "string", "description": "Google Sheet with Telegram channels names", }, "post_text": { "type": "string", "description": "Message to post in HTML format", }, "post_foto": { "type": "string", "description": "Post foto URL. May be empty.", }, "post_video": { "type": "string", "description": "Post video URL. May be empty.", }, "post_file": { "type": "string", "description": "Post file URL. May be empty.", }, }, "required": ["bot_token", "google_sheet_url", "post_text", "post_foto", "post_video", "post_file"], }, }, ``` ## Публикация поста в Инстаграм Для функции требуется: 1. Бизнес-аккаунт Instagram 2. Связанная страница Facebook 3. Приложение Facebook с необходимыми разрешениями 4. Токен доступа с нужными правами 5. ID вашего Instagram бизнес-аккаунта Видео как получить ID: ``` https://www.youtube.com/watch?app=desktop&v=6lHVkszs2M0 ``` ``` { "name": "send_post_to_instagram", "description": "Публикует пост в Instagram", "parameters": { "type": "object", "properties": { "image_url": { "type": "string", "description": "URL изображения для публикации", }, "caption": { "type": "string", "description": "Текст подписи к посту", }, "access_token": { "type": "string", "description": "Токен доступа Facebook", }, "instagram_account_id": { "type": "string", "description": "ID бизнес-аккаунта Instagram", }, }, "required": ["image_url", "caption", "access_token", "instagram_account_id"], }, }, ``` ## Получение постов из публичного Телеграм канала Функция позволяет боту иметь доступ к контенту указанного телеграм-канала, можно попросить взять какой-то конкретный пост (например последний) и переписать его. {% embed url="" %} ``` { "name": "get_last_posts_from_telegram_channel", "description": "Получение постов из Телеграм канала", "parameters": { "type": "object", "properties": { "channel_id": { "type": "string", "description": "Имя канала (начинается с @)", }, "n": { "type": "integer", "description": "Количество постов. По умолчанию равно 1", }, }, "required": ["channel_id"], }, }, ``` ## Получение постов из публичного Телеграм канала v2 Функция позволяет боту иметь доступ к контенту указанного телеграм-канала, можно попросить взять какой-то конкретный пост (например последний) и переписать его. {% embed url="" %} ``` { "name": "parse_telegram_channel", "description": "Получение постов из Телеграм канала", "parameters": { "type": "object", "properties": { "channel_id": { "type": "string", "description": "Имя канала (начинается с @)", }, "n": { "type": "integer", "description": "Количество постов. По умолчанию равно 1", }, }, "required": ["channel_id"], }, }, ``` ## Поиск в каналах и чатах Телеграмм Поиск в каналах и чатах Телеграмм ``` { "name": "telegram_search_messages", "description": "Поиск сообщений в Telegram по ключевому слову и лимиту сообщений", "parameters": { "type": "object", "properties": { "keyword": { "type": "string", "description": "Ключевое слово для поиска", }, "limit": { "type": "integer", "description": "Максимальное количество сообщений для возврата. По умолчанию равно 1.", }, }, "required": ["keyword", "limit"], }, }, ``` ## Отправить уведомление в Telegram Отправить уведомление в Telegram ``` { "name": "send_telegram_message", "description": "Отправить сообщение в Telegram", "parameters": { "type": "object", "properties": { "bot_token": { "type": "string", "description": "Токен бота Telegram", }, "user_chat_id": { "type": "string", "description": "Идентификатор чата или несколько через запятую", }, "message": { "type": "string", "description": "Сообщение для отправки", }, "user_cc": { "type": "integer", "description": "Нужно ли отправлять копию сообщения в текущий диалог. По умолчанию этот параметр равен 0 и дублировать сообщение в текущий диалог не нужно. Если он будет 1 то уведомление нужно отправить.", }, "parse_mode": { "type": "string", "enum" : ["HTML", "MarkdownV2", "Plain"], "description": "Формат отправки. По умолчанию `Plain`", }, "foto_url": { "type": "string", "description": "Ссылка на фото. Не обязательный параметр.", }, }, "required": ["bot_token", "user_chat_id", "message", "user_cc", "parse_mode"], }, }, ``` ## Активировать Телеграм-Бот для всех его пользователей Активировать Телеграм-Бот для всех его пользователей ``` { "name": "activate_telegram_bot", "description": "Активирует бота для всех его пользователей.", "parameters": { "type": "object", "properties": { "job_id": { "type": "integer", "description": "Номер бота" }, "hello_text": { "type": "string", "description": "Текст приветствия. Может быть пустым." } }, "required": ["job_id", "hello_text"] }, }, ``` # Фото и видео * [Поиск в Яндекс.Картинки](#poisk-v-yandeks.kartinki) * [Поиск картинки в Google](#poisk-kartinki-v-google) * [Генерация изображений DALL-E v3](#generaciya-izobrazhenii-dall-e-v3) * [Генерация SVG](#generaciya-svg) * [Генерация фото (Midjourney)](#generaciya-foto-midjourney) * [Генерация изображений Kandinsky](#generaciya-izobrazhenii-kandinsky) * [Генерация фото StabilityAI v3](#generaciya-foto-stabilityai-v3) * [Замена лиц на фото (Midjourney)](#zamena-lic-na-foto-midjourney) * [Распознавание рукописного текста](#raspoznavanie-rukopisnogo-teksta) * [Распознавание MP3](#raspoznavanie-mp3) * [Распознавание изображения OpenAI GPT-4-omni](#raspoznavanie-izobrazheniya-openai-gpt-4-omni) * [Задать вопрос к видео на YouTube](#zadat-vopros-k-video-na-youtube) * [Создание стикеров для Telegram](#sozdanie-stikerov-dlya-telegram) * [Создания 3D аватара от HedraAI](#sozdaniya-3d-avatara-ot-hedraai) ## Поиск в Яндекс.Картинки Поиск в Яндекс.Картинки ``` { "name": "yandex_images", "description": "Поиск на Яндекс.Картинки", "parameters": { "type": "object", "properties": { "query": { "type": "string", "description": "Поисковый запрос", }, }, "required": ["query"], }, }, ``` ## Поиск картинки в Google Поиск картинки в Google ``` { "name": "get_google_image", "description": "Получить URL изображения по запросу в Google", "parameters": { "type": "object", "properties": { "query": { "type": "string", "description": "Поисковый запрос для Google" } }, "required": ["query"] }, }, ``` ## Генерация изображений DALL-E v3 Функция даёт возможность попросить бота создать изображение или показать то, о чем он вам написал через генерацию изображений DALL-E v3 ``` { "name": "generate_image_dalle", "description": "Генерация изображений", "parameters": { "type": "object", "properties": { "query": { "type": "string", "description": "Описание изображения", }, "resolution": { "type": "string", "enum" : ["1024x1024", "1792x1024", "1024x1792"], "description": "Разрешение изображения, по умолчанию 1024x1024", }, }, "required": ["query", "resolution"], }, }, ``` ## Генерация SVG Генерация SVG файлов. Используется модель OpenAI O1-mini. ``` { "name": "svg_generate", "description": "Генерация SVG файлов", "parameters": { "type": "object", "properties": { "question": { "type": "string", "description": "Дословное описание задачи пользователя для генерации SVG файла" } }, "required": ["question"] }, }, ``` ## Генерация фото (Midjourney) Для работы функции нужно указать токен от Пример вызова функции: "api: XXXXXXXXXXXXXXXXXXXXXX нарисуй мне голубоглазую девушку в стиле фотореализм в формате 4:7" ``` "api: XXXXXXXXXXXXXXXXXXXXXX нарисуй мне голубоглазую девушку в стиле фотореализм в формате 4:7" ``` 💡Токен можно прописать внутри инструкций вашего бота и тогда будет достаточно только запроса на генерацию картинки. ``` https://documenter.getpostman.com/view/33976547/2sA35HXgaH ``` {% embed url="" %} ``` { "name": "generate_image_midjourney", "description": "Generate image with Midjourney", "parameters": { "type": "object", "properties": { "api_key": { "type": "string", "description": "API KEY", }, "prompt": { "type": "string", "description": "Detailed prompt for generate image in Midjourney", }, "aspect_ratio": { "type": "string", "enum": ["1:1", "2:3", "3:2", "4:5", "5:4", "4:7", "7:4"], "description": "image proportions, by default 1:1", }, }, "required": ["prompt", "api_key", "aspect_ratio"], }, }, ``` ## Генерация изображений Kandinsky Функция даёт возможность попросить бота создать изображение или показать то, о чем он вам написал через генерацию изображений Kandinsky (Fusion Brain) ``` { "name": "generate_image_sber", "description": "Генерация изображений", "parameters": { "type": "object", "properties": { "query": { "type": "string", "description": "Описание изображения", }, }, "required": ["query"], }, }, ``` ## Генерация фото StabilityAI v3 Для работы функции нужно указать токен от ``` https://stability.ai/ ``` Пример вызова функции: "api: XXXXXXXXXXXXXXXXXXXXXX нарисуй мне снежного барса в снегопаде" ``` "api: XXXXXXXXXXXXXXXXXXXXXX нарисуй мне снежного барса в снегопаде" ``` ``` { "name": "generate_image_stabilityai", "description": "Генерация изображений", "parameters": { "type": "object", "properties": { "api_key": { "type": "string", "description": "API KEY", }, "query": { "type": "string", "description": "Описание изображения. Минимум в 10 слов и только на английском языке.", }, "resolution": { "type": "string", "enum" : ["1024x1024", "1792x1024", "1024x1792"], "description": "Разрешение изображения, по умолчанию 1024x1024", }, }, "required": ["query", "resolution"], }, }, ``` ## Замена лиц на фото (Midjourney) Замена лиц на фото (Midjourney) Для работы функции нужно указать токен от ``` https://apiframe.pro/ ``` 💡Токен можно прописать внутри инструкций вашего бота и тогда будет достаточно только запроса на генерацию картинки. {% embed url="" %} ``` https://documenter.getpostman.com/view/33976547/2sA35HXgaH ``` ``` { "name": "faceswap_midjourney", "description": "Face swap with Midjourney", "parameters": { "type": "object", "properties": { "api_key": { "type": "string", "description": "API KEY", }, "target_image_url": { "type": "string", "description": "Target image URL", }, "swap_image_url": { "type": "string", "description": "Swap image URL", }, }, "required": ["api_key", "target_image_url", "swap_image_url"], }, }, ``` ## Распознавание рукописного текста Распознавание рукописного текста ``` { "name": "handwriting_recognition", "description": "Распознавание рукописного текста", "parameters": { "type": "object", "properties": { "file_url": { "type": "string", "description": "Ссылка файл (URL файла) или изображение (URL фото) с рукописным текстом. Формат файла в ссылке не важен.", }, }, "required": ["file_url"], }, }, ``` ## Распознавание MP3 Функция получает ссылку на MP3 файл и с помощью методов асинхронного распознавания Яндекса возвращает текстовый файл с результатом. ``` Если ты получишь ссылку на файл .mp3, то сразу вызови функцию распознования с параметрами: { 'languageCode' : '', 'model' : 'general', 'profanityFilter' : False, 'literature_text' : False, 'audioEncoding' : 'MP3', 'audioChannelCount' : 1, 'rawResults' : False, } bucket_name = 'protalkstt' ``` ``` { "name": "yandex_transcribe_audio", "description": "Отправить аудиофайл на распознавание речи", "parameters": { "type": "object", "properties": { "audioURL": { "type": "string", "description": "URL аудиофайла", }, "languageCode": { "type": "string", "description": "Код языка, по умолчанию `ru-RU`", }, "audio_model": { "type": "string", "description": "Модель распознавания, по умолчанию `general`", "enum": ["general"], }, "profanityFilter": { "type": "boolean", "description": "Фильтр ненормативной лексики, по умолчанию `False`", }, "literature_text": { "type": "boolean", "description": "Включает режим нормализации, по умолчанию `False`", }, "audioEncoding": { "type": "string", "description": "Формат аудиофайла, по умолчанию `MP3`", "enum": ["LINEAR16_PCM", "OGG_OPUS", "MP3"], }, "sampleRateHertz": { "type": "integer", "enum": [48000, 16000, 8000], "description": "Частота дискретизации аудио. Этот параметр обязателен, если значение format равно LINEAR16_PCM.", }, "audioChannelCount": { "type": "integer", "description": "Количество аудиоканалов, по умолчанию равно 1", }, }, "required": ["audioURL", "languageCode", "audio_model", "profanityFilter", "literature_text", "audioEncoding", "audioChannelCount"], }, }, ``` ## Распознавание изображения OpenAI GPT-4-omni Распознавание изображения OpenAI GPT-4-omni ``` { "name": "image_recognition", "description": "Распознавание изображения", "parameters": { "type": "object", "properties": { "file_url": { "type": "string", "description": "Ссылка файл (URL файла) или изображение (URL фото). Формат файла в ссылке не важен.", }, "question": { "type": "string", "description": "Формулировка задачи по распознованию изображения", }, }, "required": ["file_url", "question"], }, }, ``` ## Задать вопрос к видео на YouTube Задать вопрос к видео на YouTube ``` { "name": "question_youtube_video", "description": "Отправляет вопрос к видео на YouTube и получает ответ", "parameters": { "type": "object", "properties": { "openai_api_key": { "type": "string", "description": "API ключ OpenAI", }, "model": { "type": "string", "description": "Модель OpenAI для обработки запроса", "enum": ["gpt-4o-2024-08-06", "gpt-4o-mini"], }, "video_url": { "type": "string", "description": "URL видео на YouTube", }, "question": { "type": "string", "description": "Вопрос к видео", }, }, "required": ["openai_api_key", "model", "video_url", "question"], }, }, ``` ## Создание стикеров для Telegram Принцип работы: * Изображение конвертируется в формат RGBA. * Цвет фона определяется по первому пикселю (0,0). * Все пиксели, которые совпадают с цветом фона (с учетом заданного коэффициента допуска), становятся прозрачными. ``` { "name": "convert_image_to_sticker", "description": "Создание стикера из картинки JPG или PNG", "parameters": { "type": "object", "properties": { "image_url": { "type": "string", "description": "URL изображения", }, "tolerance": { "type": "integer", "description": "Коэффициент допуска для определения прозрачности пикселей. По умолчанию равен 30.", }, }, "required": ["image_url", "tolerance"], }, }, ``` ## Создания 3D аватара от HedraAI Функция generate\_talking\_character предназначена для создания говорящего персонажа на основе изображения и текста. ``` { "name": "hedra_generate_talking_character", "description": "Generate a talking character from an image and text", "parameters": { "type": "object", "properties": { "image_url": { "type": "string", "description": "URL of the image for the character", }, "text": { "type": "string", "description": "Text for the character to speak", }, "api_key": { "type": "string", "description": "API key for authentication", }, "voice_id": { "type": "string", "description": "Voice ID for the character. Male default: `Mg1264PmwVoIedxsF9nu`. Female default: `LcfcDJNUP1GQjkzn1xUU`", }, }, "required": ["image_url", "text", "api_key", "voice_id"], }, }, ``` # Разное * [Внешний API](#vneshnii-api) * [Отправить вебхук в Make](#otpravit-vebkhuk-v-make) * [Озвучивание текста (ElevenLabs)](#ozvuchivanie-teksta-elevenlabs) * [Озвучивание файлов (ElevenLabs)](#ozvuchivanie-failov-elevenlabs) * [Изменение данных из таблицы Airtable](#izmenenie-dannykh-iz-tablicy-airtable) * [Получение данных из таблицы Airtable](#poluchenie-dannykh-iz-tablicy-airtable) * [Загрузка файла в облако Backblaze](#zagruzka-faila-v-oblako-backblaze) * [Отправить вебхук в Zapier](#otpravit-vebkhuk-v-zapier) * [Генерация изображений Midjourney (Rapid API)](#generaciya-izobrazhenii-midjourney-rapid-api) * [Поиск товаров на сайте Joomla](#poisk-tovarov-na-saite-joomla) * [Определи свое предназначение в роду](#opredeli-svoe-prednaznachenie-v-rodu) * [Управление Google календарем](#upravlenie-google-kalendarem) * [Управление Google таблицей](#upravlenie-google-tablicei) * [Генератор ментальных карт](#generator-mentalnykh-kart) * [Генерация PDF](#generaciya-pdf) \_\_\_\_ ## Внешний API Данная функция может быть использована для вызова любого внешнего API. Бот помощник формирования примеров для API запросов: Вот пример вызова функции для отправки сообщения через Telegram-бот: ``` Получи текст сообщения, токен бота у пользователя и ID пользователя в Telegram и вызови функцию `call_external_api` с параметрами: { "url": f'https://api.telegram.org/bot{bot_token}/sendMessage', "method": "POST", "data": { "chat_id": user_id, "text": "_ТЕКСТ_СООБЩЕНИЯ_" } } ``` ``` { "name": "call_api", "description": "Вызов API с заданными параметрами, включая заголовки, данные и параметры в виде строк", "parameters": { "type": "object", "properties": { "url": { "type": "string", "description": "URL API", }, "method": { "type": "string", "description": "HTTP метод", "enum": ["GET", "POST", "PUT", "DELETE"], }, "headers": { "type": "string", "description": "Заголовки запроса в формате JSON", }, "params": { "type": "string", "description": "Параметры запроса в формате JSON", }, "data": { "type": "string", "description": "Данные для отправки в запросе в формате JSON", }, "json": { "type": "string", "description": "Данные для отправки в формате JSON", }, "file_url": { "type": "string", "description": "URL файла для загрузки", }, "timeout": { "type": "integer", "description": "Таймаут запроса в секундах", }, }, "required": ["url"], }, }, ``` ## Отправить вебхук в Make Функция send\_webhook\_to\_make предназначена для отправки данных на вебхук платформы Make. Она принимает два обязательных параметра: webhook\_url, который представляет собой URL вебхука, и data, содержащие данные в формате JSON, которые необходимо отправить. Функция использует библиотеку requests для выполнения POST-запроса к указанному вебхуку. Если запрос успешен, функция возвращает ответ в формате JSON. В случае ошибки при отправке данных, функция возвращает сообщение об ошибке. ``` { "name": "send_webhook_to_make", "description": "Отправить данные на вебхук Make", "parameters": { "type": "object", "properties": { "webhook_url": { "type": "string", "description": "URL вебхука Nake", }, "data": { "type": "string", "description": "Данные для отправки в формате JSON", }, }, "required": ["webhook_url", "data"], }, }, ``` ## Озвучивание текста (ElevenLabs) Озвучивание текста (ElevenLabs) ``` { "name": "text_to_speach_elevenlabs", "description": "Озвучивание текст (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.", }, }, "required": ["text", "elevellabs_api_key", "voice_id", "limit", "stability", "similarity_boost"] }, }, ``` ## Озвучивание файлов (ElevenLabs) Озвучивание файлов (ElevenLabs) ``` { "name": "file_to_speach", "description": "Озвучивание файлов (ElevenLabs)", "parameters": { "type": "object", "properties": { "file_url": { "type": "string", "description": "Ссылка на файл в формате PDF, DOCX, XLSX, PPTX", }, "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.", }, }, "required": ["file_url", "elevellabs_api_key", "voice_id", "limit", "stability", "similarity_boost"] }, }, ``` ## Изменение данных из таблицы Airtable Функция изменяет данные в базе Airtable. Для этого вы должны передать в функцию API токен Airtable, ID базы, название таблицы, фильтр и новые данные в формате JSON {"Колонка" : "Значение"}. ``` { "name": "write_airtable_data", "description": "Запись данных в таблицу Airtable с возможностью задать фильтр и изменить нужные записи в таблице", "parameters": { "type": "object", "properties": { "base_id": { "type": "string", "description": "Идентификатор базы данных Airtable" }, "table_name": { "type": "string", "description": "Название таблицы в Airtable" }, "api_key": { "type": "string", "description": "API ключ для доступа к Airtable" }, "filter": { "type": "string", "description": "Фильтр для выборки данных (необязательный), например: AND({Public}=1)" }, "fields": { "type": "string", "description": "Строка вида: Поле1:Значение1, Поле2:Значение2" } }, "required": ["base_id", "table_name", "api_key", "fields"] }, }, ``` ## Получение данных из таблицы Airtable Функция получает данные из базы Airtable. Для этого вы должны передать в функцию API токен Airtable, ID базы, название таблицы, фильтр и название колонок из которых вам нужны данные. ```` { "name": "filter_airtable_data", "description": "Получить записи из базы данных по заданным фильтрам", "parameters": { "type": "object", "properties": { "api_key": { "type": "string", "description": "API ключ для доступа к базе данных", }, "base_id": { "type": "string", "description": "ID базы данных", }, "table_name": { "type": "string", "description": "Название таблицы для запроса", }, "filters": { "type": "string", "description": "Название таблицы для запроса", }, "max_records": { "type": "integer", "description": "Максимальное количество записей для возврата. По умолчанию 1", }, "fields": { "type": "string", "description": """JSON массив вида:```JSON\n[{"field": "Column1", "value": "Value1", "type": "select"},{"field": "Column2", "value": "Value2", "type": "text"},{"field": "Column3", "value": Value3, "type": "percent"},{"field": "Column4", "value": 0, "type": "checkbox"},{"field": "Column5", "value": "Value5", "type": "multi-select"},{"field": "Column6", "min": Value6_1, "max": Value6_2, "type": "range"},{"field": "Column7", "min": Value7_1, "max": Value7_2, "type": "range_percent"}]```. Не обязательный параметр.""", }, "columns": { "type": "string", "description": "Список колонок, которые получить из таблицы в виде: `column1;column2;column3`. Не обязательный параметр", }, }, "required": ["api_key", "base_id", "table_name", "max_records"], }, }, ```` ## Загрузка файла в облако Backblaze Пример инструкции в боте: ``` arguments = { "file_url" : "https://c.files.bbci.co.uk/110CD/production/_126273896_wed5.jpg", "bucket_name" : "XXXXX", "application_key_id" : "XXXXXXXXXX", "application_key" : "XXXXXXXXXXXXXXXXX", } ``` ``` { "name": "upload_file_to_backblaze", "description": "Загрузка файлов в облако Backblaze", "parameters": { "type": "object", "properties": { "file_urls": { "type": "string", "description": "URL of the files to be uploaded. Separated with `;`", }, "bucket_name": { "type": "string", "description": "Name of the Backblaze B2 bucket", }, "application_key_id": { "type": "string", "description": "Backblaze B2 Application Key ID", }, "application_key": { "type": "string", "description": "Backblaze B2 Application Key", }, }, "required": ["file_urls", "bucket_name", "application_key_id", "application_key"], }, }, ``` ## Отправить вебхук в Zapier Функция send\_webhook\_to\_zapier предназначена для отправки данных на вебхук Zapier. 1. URL вебхука Zapier формируется с использованием переданного `webhook_id`. 2. Данные, переданные в `data`, должны быть в формате JSON строкой. ``` { "name": "send_webhook_to_zapier", "description": "Отправить данные на вебхук Zapier", "parameters": { "type": "object", "properties": { "webhook_id": { "type": "string", "description": "ID вебхука Zapier", }, "data": { "type": "string", "description": "Данные для отправки в формате JSON", }, }, "required": ["webhook_id", "data"], }, }, ``` ## Генерация изображений Midjourney (Rapid API) Функция rapid\_api\_midjourney\_generate\_image предназначена для создания изображений на основе текстовых описаний и различных параметров. Основной запрос: Вы задаете основной текст, который описывает, что вы хотите увидеть на изображении. Это обязательный элемент, без которого функция не сможет сработать. Дополнительные запросы: Вы можете добавить вторичный текст, который уточняет ваш запрос. Например, если основной запрос — "кот", то вторичный может быть "в шляпе". Вес запросов: Вы можете указать, насколько сильно вторичный запрос должен влиять на итоговое изображение. Это делается с помощью числового значения, где большее значение означает большее влияние. Отрицательные запросы: Если есть что-то, что вы не хотите видеть на изображении, вы можете указать это. Например, "без собак". Изображения для подсказок: Вы можете предоставить URL-адреса изображений, которые могут помочь в создании вашего изображения. Это может быть изображение стиля или персонажа. Соотношение сторон: Вы можете задать ширину и высоту изображения, чтобы оно соответствовало вашим требованиям, например, для обложки книги или постера. Стилизация и уникальность: Функция позволяет настроить уровень стилизации, странности и хаоса, чтобы изображение выглядело так, как вы хотите — от реалистичного до абстрактного. Дополнительный текст: Вы также можете добавить текст, который будет использован для генерации, если это необходимо. ``` { "name": "rapid_api_midjourney_generate_image_and_face_swap", "description": "Generate an image based on prompts and parameters or face swap on image", "parameters": { "type": "object", "properties": { "rapid_api_key": { "type": "string", "description": "API key", }, "textPrompt": { "type": "string", "description": "Primary text prompt for image generation", }, "secondTextPrompt": { "type": "string", "description": "Secondary text prompt for image generation", }, "secondTextPromptWeight": { "type": "integer", "description": "Weight of the secondary text prompt", }, "negativePrompt": { "type": "string", "description": "Negative prompts to avoid in the image", }, "imagePromptUrl": { "type": "string", "description": "URL of the image prompt", }, "imageWeight": { "type": "integer", "description": "Weight of the image prompt", }, "aspectRatioWidth": { "type": "integer", "description": "Width of the aspect ratio", }, "aspectRatioHeight": { "type": "integer", "description": "Height of the aspect ratio", }, "characterReferenceUrl": { "type": "string", "description": "URL of the character reference image", }, "characterWeight": { "type": "integer", "description": "Weight of the character reference", }, "styleReferenceUrl": { "type": "string", "description": "URL of the style reference image", }, "styleWeight": { "type": "integer", "description": "Weight of the style reference", }, "stylize": { "type": "integer", "description": "Stylization parameter", }, "tile": { "type": "boolean", "description": "Whether to tile the image", }, "weird": { "type": "integer", "description": "Weirdness factor", }, "chaos": { "type": "integer", "description": "Chaos factor", }, "textGeneration": { "type": "string", "description": "Text for generation", }, "faceSwapUrl": { "type": "string", "description": "URL for face_swap mode", }, "mode": { "type": "string", "description": "Mode ", "enum": ["imagine", "face_swap"] }, }, "required": ["rapid_api_key", "textPrompt", "mode"], }, }, ``` ## Поиск товаров на сайте Joomla Пример инструкции в боте: ``` При поиске товаров на сайте передавай так параметры поиска: Адрес сайта: "https://site-name.ru" Ключ АПИ: "XXXXXXXX" Ключевые слова для поиска в категориях: "Покрытие", "детских", "площадок", "резиновой", "крошки" Ключевые слова для поиска товаров: "SBR", "Eco", "Color", "EPDM", "Premium", "каучук", "sandwich" Результат поиска оформи в виде короткого и информативного ответа на запрос клиента. ``` Для работы функции создайте файл `search_products.php` в корне вашего сайта: ``` 'Wrong API key']); exit; } define('_JEXEC', 1); define('JPATH_BASE', __DIR__); require_once JPATH_BASE . '/includes/defines.php'; require_once JPATH_BASE . '/includes/framework.php'; $app = JFactory::getApplication('site'); $db = JFactory::getDbo(); $prefix = $db->getPrefix(); $query = $db->getQuery(true); $query->select('p.virtuemart_product_id, p.product_name, pp.product_price, c.category_name, m.file_url') ->from($db->quoteName($prefix . 'virtuemart_products_ru_ru', 'p')) ->join('INNER', $db->quoteName($prefix . 'virtuemart_product_prices', 'pp') . ' ON p.virtuemart_product_id = pp.virtuemart_product_id') ->join('INNER', $db->quoteName($prefix . 'virtuemart_product_categories', 'pc') . ' ON p.virtuemart_product_id = pc.virtuemart_product_id') ->join('INNER', $db->quoteName($prefix . 'virtuemart_categories_ru_ru', 'c') . ' ON pc.virtuemart_category_id = c.virtuemart_category_id') ->join('LEFT', $db->quoteName($prefix . 'virtuemart_product_medias', 'pm') . ' ON p.virtuemart_product_id = pm.virtuemart_product_id') ->join('LEFT', $db->quoteName($prefix . 'virtuemart_medias', 'm') . ' ON pm.virtuemart_media_id = m.virtuemart_media_id'); if ($product_name !== null) { $query->where($db->quoteName('p.product_name') . ' LIKE ' . $db->quote('%' . $db->escape($product_name, true) . '%', false)); } if ($category !== null) { $query->where($db->quoteName('c.category_name') . ' LIKE ' . $db->quote('%' . $db->escape($category, true) . '%', false)); } if ($min_price !== null) { $query->where($db->quoteName('pp.product_price') . ' >= ' . $db->quote($min_price)); } if ($max_price !== null) { $query->where($db->quoteName('pp.product_price') . ' <= ' . $db->quote($max_price)); } $query->group($db->quoteName('p.virtuemart_product_id')); $query->setLimit($limit); $db->setQuery("SET NAMES utf8mb4"); if (!$db->execute()) { echo json_encode(['error' => 'Error in set utf8mb4']); exit; } $db->setQuery($query); try { $results = $db->loadAssocList(); if (empty($results)) { echo json_encode(['message' => 'No data']); } else { // Добавляем полный URL к изображениям foreach ($results as &$result) { if (!empty($result['file_url'])) { $result['file_url'] = $IMG_URL . $result['file_url']; } } echo json_encode($results); } } catch (Exception $e) { echo json_encode(['error' => 'Exception' . $e->getMessage()]); } ?> ``` ``` { "name": "get_filtered_joomla_products", "description": "Получить отфильтрованные продукты из Joomla по заданным параметрам", "parameters": { "type": "object", "properties": { "joomla_url": { "type": "string", "description": "URL Joomla сайта", }, "joomla_api_key": { "type": "string", "description": "API ключ для доступа к Joomla", }, "product_name": { "type": "string", "description": "Ключевая фраза для поиска по названию товара/услуги", }, "category": { "type": "string", "description": "Ключевая фраза для поиска по категории товара/услуг", }, "min_price": { "type": "number", "description": "Минимальная цена продукта", }, "max_price": { "type": "number", "description": "Максимальная цена продукта", }, "limit": { "type": "integer", "description": "Максимальное количество возвращаемых продуктов. По умолчанию равно 10.", } }, "required": ["joomla_url", "joomla_api_key", "limit"], }, }, ``` ## Определи свое предназначение в роду Данный расчет помогает получить сведения о своих кармических задачах. Предлагаем Вашему внимание интересную гипотезу определения Вашей роли в семье. Узнать предназначение вас в этой жизни. Определяем 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 Это и есть Ваше личное число Рода. Читаем ниже результат, какую позицию Вам предоставил Род: 1 — Глава рода 2 — Миротворец Рода 3 — Пахарь Рода (Труд на благо Рода) 4 — Миротворец Рода (Примирения, остановка конфликтов) 5 — Лекарь рода ( Лечит душевные и телесные раны) 6 — Наставник Рода (Оказывает внимание и поддержку юным) 7 — Хранитель Рода (Оберегает, чтит традиции, сплачивает) 8 — Страж рода (Защищает, оказывает помощь) 9 — Совесть рода ( Указывает на ошибки, исправляет промахи) ``` { "name": "calculate_life_purpose", "description": "Рассчитывает цель жизни на основе имени, даты рождения и имени старшего родственника", "parameters": { "type": "object", "properties": { "full_name": { "type": "string", "description": "Полное имя", }, "birth_date": { "type": "string", "description": "Дата рождения", }, "oldest_relative_name": { "type": "string", "description": "Имя старшего родственника", }, }, "required": ["full_name", "birth_date", "oldest_relative_name"], }, }, ``` ## Управление Google календарем С помощью функции бот может безопасно добавлять, просматривать, редактировать и удалять события в Google календаре. В поведении боту пропишите эти настройки: 1. Для твоей работы необходим ID календаря, который ты будешь передавать в функцию "google\_calendar". ID календаря может быть предоставлен и в виде Email адреса. Без него ты не можешь отвечать ни на какие вопросы пользователя. 2. При показе запланированных событий после названия события указывай его "event\_id". 3. Вот инструкции как пользоваться функцией: Пропишите в промпте боту как правильно этим пользоваться: ### Тип действия. `+` - означает добавление события. `?` - означает получение всех событий календаря.. `-` - удалить событие в календаре. `.` - редактировать событие в календаре. Также необходимо в настройках вашего календаря с помощью браузера открыть доступ к этому пользователю: "" с правами "Внесение изменений и предоставления доступа". ID календаря может быть как в виде e-mail адреса, так и в виде собственного обозначения, если это не основной календарь (ID можно найти в настройках интеграции календаря). Если боту предоставить ID не верный, будет выходить ошибка. ```` { "name": "google_calendar", "description": "Управление календарем Google", "parameters": { "type": "object", "properties": { "calendarId": { "type": "string", "description": "ID календаря", }, "action": { "type": "string", "enum": ["+", "?", '-', '.'], "description": "Тип действия. `+` - означает добавление события. `?` - означает получение всех событий календаря.. `-` - удалить событие в календаре. `.` - редактировать событие в календаре.", }, "event_ids": { "type": "string", "description": "Список ID событий в календаре в формате json строки: ```[{\"event_id\": \"3lsvlor3hjlgpgmv7er7e5juov\"}]```. Передается при типах действия `-` или '.'", }, "events": { "type": "string", "description": "Список событий в формате json строки: ```[{\"summary\": \"test event\", \"description\": \"some info\", \"start\": {\"dateTime\": \"2024-09-04T03:00:00+03:00\"}, \"end\": {\"dateTime\": \"2024-09-04T05:30:00+03:00\"}}]```. Передается при типах действия `+` или '.'", }, "start_date": { "type": "string", "description": "Дата начала периода в формате `2024-09-04T03:00:00+03:00`. Передается при типах действия `?` или '-'", }, "end_date": { "type": "string", "description": "Дата окончания периода в формате `2024-09-04T03:00:00+03:00`. Передается при типах действия `?` или '-'", }, }, "required": ["calendarId", "action"], }, }, ```` ## Управление Google таблицей Функция может внести изменения в таблицу Google Нужно в промпте указать нейросети правило по которому идет запись в таблицу: Записывай полученную информацию, ссылки и ID файлов в Google таблицу по этим правилам: Row data to append at the end of Google Sheet formatted like this: `value1;;value2;;value3` "value1" - Заголовок "value2" - Описание "value3" - URL фото Ячейки, в которые тебе нечего записать заполни знаком `-` ``` { "name": "ai_edit_google_sheet", "description": "Make changes in Google Sheet Document with AI", "parameters": { "type": "object", "properties": { "url": { "type": "string", "description": "URL of Google Sheet", }, "request": { "type": "string", "description": "Here, pass 100% verbatim the task from the user without any changes", }, "mode": { "type": "string", "enum" : ["+", "-", ".", "?"], "description": "`+` - add data in Google Sheet, `-` - delete data in Google Sheet, `.` - change data in Google Sheet, `?` - read data from Google Sheet", }, "next_question": { "type": "string", "description": "Next question", }, }, "required": ["url", "request", "mode", "next_question"], }, }, ``` ## Генератор ментальных карт Функция создает ментальную карту в формате PNG. ```` { "name": "generate_mind_map", "description": """Mind Map to PNG. For the task at hand, make a detailed mental map in Python in this form in Russian: ```python { "Plan for a trip": { "Choose a country": { "Find tickets": "In process...", "Buy tickets": "In process...", "Book a hotel": "In progress..." } } } ``` Don't use lists, just keys and values.""", "parameters": { "type": "object", "properties": { "mind_map_json": { "type": "string", "description": "Mind Map as JSON string", }, }, "required": ["mind_map_json"], }, }, ```` ## Генерация PDF Функция позволяет попросить бота сформировать PDF файл из любой переданной ему или сгенерированной им самим информации. При этом если вы хотите оформить файл красиво с разметкой, то используйте такую инструкцию: "Если я попрошу сделать PDF, то оформи текст в соответствии с заданием в формате HTML и сформируй из этого файл PDF". ``` { "name": "generate_pdf_from_html", "description": "Генерация PDF документа на основе HTML-кода", "parameters": { "type": "object", "properties": { "title": { "type": "string", "description": "Заголовок HTML-документа" }, "body_content": { "type": "string", "description": "Содержимое тела HTML-документа" }, "styles": { "type": "string", "description": "CSS-стили для HTML-документа" }, "filename": { "type": "string", "description": "Имя файла на выходе. Не обязательный параметр." }, }, "required": ["title", "body_content"] }, }, ``` # Университет # Как создать бота? в iiAgent.pro можно создать личного помощника и любого бота буквально за 5 минут. Рассмотрим на примере создания личного финансового консультанта. #### В главном меню * зайдите на вкладку сотрудники * нажмите создать по шаблону

#### В базовых параметрах выбирайте LLM модель на которой будет работать бот. По умолчанию лучше выбрать ChatGPT
#### Настройте режим работы
#### Заполняйте обязательные поля с красной звездочкой. Опишите инструкции для бота (роль,цель,поведение). Если эти поля оставить пустыми, то получится бот с ИИ для свободного общения на любые темы.
#### Функции добавляются по потребности (не обязательно). Нужны для усиления бота и выполнения конкретных более сложных задач чем общение.
#### Для удобства созданный бот можно добавить в телеграмм или другой мессенджер по инструкции. Это не обязательно. Так же с ботом можно общаться внутри платформы в разделе (сотрудники). В центре карточки сотрудника кнопка "чат с сотрудником".
#### Прикрепите ссылку по инструкции для записи логов. В будущем это поможет быстро найти ошибку в работе бота.
#### Нажмите сохранить и запустите бота в разделе сотрудники. Поздравляем. Ваш первый бот готов! # Что такое RPA? Роботизированная автоматизация процессов (RPA) — это программная технология, которая упрощает создание, развёртывание и управление программными роботами, имитирующими действия человека при взаимодейст ## Роботизированная автоматизация процессов (RPA) Программное обеспечение для автоматизации, позволяющее покончить с повторяющимися задачами и воплотить цифровую трансформацию в реальность. ## Каковы преимущества RPA для бизнеса? Роботизированная автоматизация процессов оптимизирует рабочие процессы, что делает организации более прибыльными, гибкими и оперативными. Она также повышает удовлетворённость, вовлечённость и производительность сотрудников, избавляя их от рутинных задач. RPA неинвазивен и может быть быстро внедрен для ускорения цифровой трансформации. И он идеально подходит для автоматизации рабочих процессов, связанных с устаревшими системами, в которых отсутствуют API, инфраструктуры виртуальных рабочих столов (VDI) или доступ к базе данных.
## Почему RPA трансформирует? Технология RPA меняет то, как в мире выполняется работа. Программные роботы — вместо людей — выполняют повторяющуюся и менее ценную работу, например, входят в приложения и системы, перемещают файлы и папки, извлекают, копируют и вставляют данные, заполняют формы и выполняют рутинный анализ и составление отчётов. Продвинутые роботы могут даже выполнять когнитивные процессы, например, интерпретировать текст, участвовать в чатах и беседах, понимать неструктурированные данные и применять передовые модели машинного обучения для принятия сложных решений. Когда роботы выполняют такие повторяющиеся и объёмные задачи, люди могут сосредоточиться на том, что у них получается лучше всего и что им нравится: на инновациях, совместной работе, творчестве и взаимодействии с клиентами. Предприятия тоже получают выгоду: более высокую производительность, эффективность и устойчивость. Неудивительно, что RPA меняет представление о работе. Это история о работе. Она началась очень давно, в понедельник... По мере того, как люди становились лучше в работе, они создавали инструменты для более эффективной работы, они даже создали компьютеры для более умной работы, но всё равно не могли сделать достаточно работы! Чем больше работы они делали, тем больше работы они создавали, и не всегда хорошей. Однажды очень умный человек придумал, как вернуть удовольствие в работу, и это их история... ## Где можно использовать RPA? Сегодня RPA повышает эффективность и освобождает людей от монотонной работы в самых разных отраслях и процессах. Предприятия в самых разных отраслях, от финансовых услуг и здравоохранения до производства, государственного сектора, розничной торговли и многих других, внедрили RPA в таких областях, как финансы, соблюдение нормативных требований, юриспруденция, обслуживание клиентов, операционные процессы и ИТ. И это только начало. RPA получил такое широкое распространение, потому что он универсален. Практически любой повторяющийся процесс, управляемый бизнес-правилами и требующий больших объёмов данных, отлично подходит для автоматизации, как и когнитивные процессы, требующие навыков ИИ более высокого уровня. ## Какие функции и возможности важны в технологии RPA? Чтобы создать программу RPA для всего предприятия и управлять ею, вам нужна технология, которая поможет вам не просто автоматизировать один процесс. Вам нужна платформа, которая поможет вам создать новые возможности для всего предприятия и управлять ими, а также стать полностью автоматизированным предприятием™. Ваша технология RPA должна поддерживать вас на всех этапах: от поиска возможностей для автоматизации до быстрого создания высокоэффективных роботов и управления тысячами автоматизированных рабочих процессов.
## Почему RPA является самым быстрорастущим корпоративным программным обеспечением в мире?
* RPA может помочь многим различным отраслям промышленности решать их конкретные производственные задачи новыми и эффективными способами. * Руководители функциональных подразделений, от финансов и обслуживания клиентов до маркетинга, управления персоналом и других, обнаруживают, что RPA улучшает многие процессы, повышая производительность, ускоряя обработку данных и сокращая количество ошибок в ключевых процессах. * С точки зрения финансового директора, инвестиции в технологии RPA обеспечивают быструю окупаемость и требуют минимальных первоначальных затрат по сравнению с другими корпоративными технологиями. * ИТ-руководители считают, что RPA можно внедрить без особых сбоев. А поскольку программные роботы могут легко получать доступ к устаревшим системам и работать в них, RPA стала ключевым фактором цифровой трансформации. А современная технология RPA предлагает масштабируемые платформы, готовые к работе на предприятии. * Сотрудники обнаруживают, что роботизированных помощников легко внедрить в рабочий процесс, а подход RPA с минимумом программирования позволяет им стать гражданскими разработчиками, способными создавать собственные простые системы автоматизации. Если вы объедините количественную оценку ценности RPA с простотой его внедрения по сравнению с другими корпоративными технологиями, то легко поймёте, почему внедрение RPA ускоряется по всему миру. ## Является ли RPA тем же самым, что и искусственный интеллект (ИИ)? RPA — это не ИИ, а ИИ — это не RPA. Но сочетание RPA и ИИ открывает перед предприятиями по всему миру совершенно новые возможности. Во-первых, технология RPA теперь позволяет внедрять в роботов RPA передовые навыки ИИ в виде моделей машинного обучения, обработки естественного языка (NLP), распознавания символов и изображений и многого другого. Благодаря этим навыкам ИИ роботы значительно расширяют свои возможности в когнитивных процессах, требующих таких действий, как: * Понимание документов, включая полуструктурированные или неструктурированные данные * Визуализация экранов (включая виртуальные рабочие столы) * Понимание речи и ведение бесед и переписки ИИ также позволяет научно обоснованно выявлять полный спектр возможностей автоматизации и создавать надёжные конвейеры автоматизации с помощью таких приложений RPA, как интеллектуальный анализ процессов. И в то время, когда компаниям необходимо ускорить интеграцию ИИ в повседневную деятельность и принятие решений, многие обнаруживают, что RPA может служить «последней милей» в доставке ИИ. Роботов можно настроить на применение моделей машинного обучения для автоматизированного принятия решений и анализа, внедряя машинный интеллект в повседневные операции. ## Как начать работу с RPA? Как его масштабировать? Мы работали со многими компаниями над их автоматизацией. Мы выяснили, что наиболее успешные предприятия проходят три этапа: \ \
# Агентская автоматизация Сначала появилась роботизированная автоматизация процессов (RPA), которая использовала программных роботов для выполнения повторяющихся действий и задач, основанных на правилах. Затем появилась автоматизация на основе ИИ, которая расширила возможности автоматизации до процессов, требующих более высоких когнитивных навыков, таких как интеллектуальная обработка документов (IDP), интеллектуальный анализ коммуникаций и интеллектуальный анализ процессов. А теперь появилась агентная автоматизация. #### 1. Что такое агентская автоматизация? Агентская автоматизация — это новейший этап эволюции автоматизации. Она позволяет программным «агентам», работающим на основе больших языковых моделей (LLM), генеративного искусственного интеллекта (GenAI) и больших моделей действий (LAM), а также других передовых технологий искусственного интеллекта, совершать автономные действия.ия Агенты агентской автоматизации могут воспринимать окружающую среду, рассуждать и задавать вопросы о ней, а также формулировать и выполнять набор действий для достижения конкретных целей. Людям не нужно структурировать и направлять работу этих агентов. Вместо этого агенты сами могут оценивать данные, выявлять закономерности, формулировать новые вопросы, делать выводы, структурировать процессы для выполнения работы и выполнять работу. RPA и автоматизация на основе ИИ никуда не денутся. Но агентская автоматизация меняет будущее автоматизации, делая её ещё более важной для бизнес-операций в мире, насыщенном цифровыми технологиями и ИИ. Теперь, когда к набору подходов к автоматизации добавилась агентская автоматизация, мы можем автоматизировать сложные бизнес-процессы, которые раньше были слишком нестандартными или непредсказуемыми для автоматизации. Это означает, что теперь предприятия могут полностью автоматизировать сложные сквозные рабочие процессы. И теперь они могут автоматизировать «длинный хвост» процессов, которые до сегодняшнего дня не поддавались автоматизации. #### 2. Каковы преимущества использования агентской автоматизации? Агентская автоматизация обеспечивает следующие преимущества для всех подразделений и отраслей промышленности: Агентская автоматизация расширяет возможности автоматизации на более широкий спектр организационных процессов, позволяя автоматизировать задачи, которые ранее были слишком сложными или специфическими для традиционных ме \ Эта технология обеспечивает скорость, дополнительную производительность и эффективность автоматизации для более широкого спектра медленных, ручных и дорогостоящих процессов, включая «длинный хвост» задач, с которыми традиционная RPA не может справиться самостоятельно. \ Агентская автоматизация хорошо работает в динамичных средах, где правила не всегда точны. \ Благодаря своей адаптивности и динамичности автоматизация теперь может применяться в сложных рабочих процессах, которые включают работу с неструктурированными данными, распознавание образов и принятие решений в режиме реального времени. В то время как традиционные подходы к автоматизации, такие как RPA, успешно устраняют повторяющиеся задачи с заранее заданными правилами, они не так хорошо подходят для выполнения менее предсказуемой работы, не основанной на правилах. Это означает, что в сквозных процессах могут быть места, которые необходимо заполнять вручную. Благодаря агентской автоматизации, реализованной с помощью передовых технологий автоматизации, агенты теперь могут выполнять такие вероятностные, менее структурированные задачи, что позволяет полностью автоматизировать больше процессов. **Результат:** с одной стороны, высокоэффективный и точный автоматизированный процесс, а с другой — больше времени для продуктивной работы, которая приносит больше пользы. Для многих предприятий многие решения требуют быстрого анализа больших объёмов данных, чтобы делать точные выводы и оперативно принимать меры (подумайте, например, об оптимизации цепочки поставок в режиме реального времени, мгновенной выявлении мошенничества или выборе оптимальных действий для клиентов по запросу). Поскольку агенты ИИ могут обрабатывать и анализировать данные со скоростью и в масштабах, недоступных человеку, и делать это в режиме реального времени, они могут быстро предоставлять высококачественную, точную и полезную информацию. \ Более того, благодаря постоянному или «по требованию» анализу информационных потоков агенты ИИ помогают принимать решения на основе наиболее точной и актуальной информации. Чтобы оставаться конкурентоспособными, необходимо постоянно двигаться вперёд. Способность ИИ-агентов анализировать огромные объёмы данных, выявлять закономерности и давать рекомендации также распространяется на поддержку инноваций. Агенты могут автономно проводить сложный анализ, который помогает находить новые рынки, эффективно и быстро запускать новые продукты и определять способы предоставления более качественных, быстрых и дешёвых товаров и услуг. Кроме того, беря на себя трудоёмкий, низкоуровневый и базовый анализ, агенты могут освободить людей для того, чтобы они могли в большей степени использовать свои «человеческие» способности к творчеству, воображению и нестандартному мышлению для разработки по-настоящему новых идей. Агентская автоматизация может расширить возможности сотрудников, предоставляя им ИИ-помощника для выполнения рутинных и повторяющихся задач, чтобы люди могли сосредоточиться на более творческой и стратегической работе. \ Такой подход не только повышает удовлетворённость работой, но и позволяет сотрудникам вносить более значимый вклад в достижение целей организации. \ Компании получают более вовлечённую и мотивированную рабочую силу, которая может заниматься «человеческими» делами, такими как творчество, воображение и инновации, — всё это является ключом к долгосрочному успеху и преимуществам. Самые сложные агенты ИИ могут отслеживать собственную производительность, учиться и совершенствоваться со временем без значительного вмешательства человека. \ По мере обучения агентов процессы становятся ещё более эффективными. Способность агентской автоматизации к постоянному самоконтролю не только способствует непрерывному совершенствованию процессов (см. выше). \ Она также позволяет быстро и точно рассчитывать влияние автоматизации и рентабельность инвестиций как на уровне задач, так и на уровне процессов. \ Организации могут видеть, как работают их бизнес-операции и какие области требуют дополнительного внимания. \ Компании также могут быть уверены в своих инвестиционных решениях и использовать результаты и аналитические данные для фокусировки и обоснования дополнительных инвестиций. Предоставляя необходимые структуры и интеллектуальные возможности для использования наиболее подходящих и эффективных моделей для решения любой задачи, агентская автоматизация может помочь компаниям в полной мере использовать свои инвестиции в ИИ и расширить возможности ИИ, сократив при этом время окупаемости инвестиций. Агентская автоматизация по своей сути масштабируема и гибка. \ Таким образом, независимо от того, нужно ли масштабироваться, чтобы справиться с возросшим спросом, быстро реагировать на изменения на рынке или переходить на новый рынок, агентская автоматизация обеспечивает гибкость и скорость, необходимые для реагирования на меняющиеся условия ведения бизнеса. \ Эта врождённая гибкость крайне важна для предприятий, стремящихся обеспечить свою деятельность в будущем. #### 3. В чём разница между агентской автоматизацией, автоматизацией на основе ИИ и RPA? Организации могут выбирать из множества подходов и инструментов автоматизации для автоматизации процессов. \ RPA, автоматизация на основе ИИ и агентская автоматизация играют ключевую роль в автоматизации предприятий. **RPA** идеально подходит для экономичной и точной обработки задач, основанных на правилах. \ RPA отлично справляется со структурированными данными и четкими инструкциями, что делает его идеальным для рутинных, предсказуемых процессов, таких как ввод данных и обработка счетов. \ Это важные задачи для большинства организаций, но зачастую они неинтересны и не требуют от человека особых навыков, творческого подхода или эмпатии. \ Таким образом, если поручить роботам выполнение таких повторяющихся задач, люди смогут заняться более важной работой. **Автоматизация на основе ИИ** (иногда называемая «интеллектуальной автоматизацией») наделяет программных роботов продвинутыми навыками ИИ. \ Благодаря этим навыкам роботы могут выполнять более широкий спектр сложных задач, таких как понимание содержания документов, извлечение данных, определение тональности электронного письма и тому подобное. \ ИИ может включать в себя такие методы, как машинное обучение, обработка естественного языка (NLP), оптическое распознавание символов (OCR) и, в последнее время, генеративный ИИ и большие языковые модели (LLM). \ Задачи и процессы по-прежнему определяются людьми, но сами задачи требуют ряда возможностей, предоставляемых искусственным интеллектом. **Агентская автоматизация** выводит автоматизацию на новый уровень автономии, используя возможности GenAI, чтобы предоставить агентам возможности анализировать неструктурированные данные, распознавать закономерности, планировать действия и принимать решения самостоятельно. \ Вместо того чтобы требовать, чтобы люди точно указывали роботам, что делать в рамках определенного процесса, agentic automation использует новейшие возможности GenAI, позволяющие агентам (думайте о них как о программных роботах с чрезвычайно высоким уровнем когнитивных навыков) действовать автономно при понимании, структурировании и выполнении своей работы. Например, сотрудник-человек может дать агенту “подсказку о задаче”, например: “пожалуйста, составьте подробный отчет на основе данных из двух разных систем, который включает подробный анализ, рекомендуемые действия и обоснование этих действий”. \ Агент был бы способен самостоятельно определять, что должно быть сделано, где информацию можно найти в различных системах, как информацию необходимо анализировать и тому подобное. \ Затем агент мог бы разработать и выполнить рабочий процесс. #### 4. Будет ли автоматизация на базе RPA и искусственного интеллекта заменена агентской автоматизацией? Ответ однозначный — «нет». \ В любом процессе есть множество задач и процессов, которые RPA может и должен выполнять. \ В частности, RPA будет работать с гораздо большей эффективностью, надёжностью и точностью, чем агентская автоматизация, при выполнении предсказуемых задач, основанных на правилах, которые не отличаются высокой сложностью и вариативностью. \ Что касается интеллектуальной автоматизации, она также обеспечивает более высокую вычислительную эффективность и, что важно, более высокую надёжность и достоверность, чем \ агентская автоматизация в таких областях, как обработка документов, анализ документов, интеллектуальный анализ данных и тому подобное. \ По этой причине агентская автоматизация с гораздо большей вероятностью будет сотрудничать с RPA и интеллектуальной автоматизацией, а не вытеснять их. \ Представьте себе мозаику из агентов и роботов с разным уровнем квалификации, которые работают вместе в рамках организованного процесса, и каждый выполняет свою работу наиболее эффективно и качественно. Чтобы сделать это более реальным, рассмотрим следующий сценарий: для завершения сквозного процесса ИИ-агент может обратиться к роботам RPA, чтобы они выполнили рутинные действия, основанные на правилах. \ Если процесс требует понимания документов и извлечения информации из внутренних и внешних систем, ИИ-агент может использовать роботов с такими навыками интеллектуальной автоматизации. ### 5. Каковы некоторые распространенные области применения агентской автоматизации? Несмотря на то, что агентская автоматизация — это всё ещё развивающаяся технология, она широко применяется в различных отраслях, подразделениях и классах процессов. Ниже приведены примеры успешного внедрения агентской автоматизации с оговоркой, что в будущем появится ещё много-много приложений.
**Банковские и финансовые услуги** Агенты используются для анализа рыночных тенденций, оценки инвестиционных возможностей и даже для создания индивидуальных финансовых планов для отдельных клиентов, что позволяет финансовым консультантам сосредоточиться на построении отношений и стратегическом руководстве. В сфере управления рисками агенты анализируют огромные объёмы данных, выявляя потенциальные уязвимости, что помогает финансовым учреждениям заблаговременно управлять рисками и обеспечивать соблюдение нормативных требований.
**Страхование** Агентская автоматизация позволяет страховым компаниям повысить эффективность своей работы. Например, страховые компании могут использовать эту технологию для автоматизации всего процесса рассмотрения страховых случаев, от первоначальной подачи заявления до окончательной выплаты. Агент с искусственным интеллектом может мгновенно оценить обоснованность заявления, собрать необходимую информацию из различных источников и даже компетентно и сочувственно общаться с клиентом. Помимо ускорения процесса рассмотрения страховых случаев, это снижает административную нагрузку на страховых агентов, позволяя им сосредоточиться на более сложных случаях и предоставлять более высокий уровень персонализированного обслуживания.
**Государственный сектор** Государственные учреждения используют возможности агентской автоматизации для улучшения обслуживания граждан и оптимизации работы. Эта технология позволяет государственным учреждениям автоматизировать такие задачи, как обработка документов, анализ данных и распределение ресурсов, высвобождая ценные человеческие ресурсы для выполнения более сложных задач. Она также позволяет принимать решения на основе данных в таких областях, как городское планирование и здравоохранение, что приводит к повышению эффективности государственных услуг.
**Производство** Агентская автоматизация открывает новую эру эффективности и производительности на производственных площадках. Алгоритмы профилактического обслуживания анализируют машинные данные в режиме реального времени, предотвращая поломки до их возникновения и сводя к минимуму дорогостоящие простои. Они также выступают в качестве тщательных инспекторов по контролю качества, используя системы на базе ИИ для проверки продукции с беспрецедентной точностью. А в сфере управления цепочками поставок агенты в режиме реального времени оптимизируют маршруты, прогнозируют потенциальные узкие места и даже корректируют уровень запасов в зависимости от колебаний спроса.
**Телекоммуникации** В телекоммуникационной отрасли надёжность сети имеет первостепенное значение. Агентская автоматизация играет важнейшую роль в обеспечении бесперебойной связи, заблаговременно выявляя и устраняя потенциальные проблемы в сети. Это гарантирует бесперебойное обслуживание клиентов и сводит к минимуму время простоя.
**Здравоохранение и науки о жизни** По мере стремительной цифровизации здравоохранения агентская автоматизация может ускорить его трансформацию. Агенты могут быстро диагностировать пациентов, используя оцифрованные медицинские изображения и данные о пациентах. Они также могут быстро составлять индивидуальные планы лечения, объединяя актуальные научные данные с историями болезни отдельных пациентов. При разработке лекарств агенты ИИ могут быстро анализировать большие массивы данных, выявлять потенциальные мишени для лекарств и проводить сложные симуляции для прогнозирования их эффективности — и всё это с целью ускорить вывод на рынок жизненно важных препаратов.
**Опыт работы с клиентами** Агентская автоматизация повышает качество обслуживания клиентов во всех отраслях. Она обеспечивает персонализированные рекомендации и круглосуточную поддержку, благодаря чему клиенты чувствуют, что их слышат и ценят. Инструменты анализа настроений оценивают отзывы клиентов в режиме реального времени, позволяя компаниям оперативно реагировать и совершенствовать свои предложения, формируя устойчивую лояльность и обеспечивая стабильный рост. И эта поддержка выходит далеко за рамки простых часто задаваемых вопросов и автоматических ответов. Оснащенные агентским ИИ, агенты могут понимать устные и письменные запросы клиентов, решать сложные проблемы и даже предугадывать потребности клиентов, обеспечивая персонализированный и проактивный подход.
**Опыт работы сотрудников** Часто руководители отвечают за повышение вовлечённости сотрудников, отвечая на их вопросы и отзывы, которые появляются в результате внутренних коммуникаций, блогов и объявлений. Агенты ИИ используются для сбора и обобщения этих сообщений, связывания комментариев с этими обобщениями, определения того, нужно ли руководителю отвечать на комментарий, назначения комментария нужному руководителю и отправки каждому руководителю по электронной почте краткого обзора необходимых действий с указанием приоритетности. Это даёт руководителям больше времени для подготовки качественных персонализированных ответов и гарантирует, что они не пропустят важные сообщения от сотрудников.
**Средства, оборудование и управление продукцией и мониторинг** Интеграция агентного ИИ с Интернетом вещей (IoT) порождает множество вариантов использования, которые обещают произвести революцию в управлении тяжёлым оборудованием, объектами и продуктами по всему миру. Представьте себе сеть взаимосвязанных устройств и датчиков, каждое из которых оснащено ИИ-агентом, способным отслеживать, анализировать и оптимизировать операции в режиме реального времени. Это может произвести революцию в таких отраслях, как производство, здравоохранение и транспорт, и привести к повышению эффективности, снижению затрат и улучшению безопасности. **6. Какая инфраструктура и технологии необходимы для поддержки автоматизации управления на уровне предприятия?** Агентская автоматизация требует целого ряда технологических возможностей, включая: Агентский ИИ часто называют следующим шагом в развитии больших языковых моделей. \ Но хотя большие языковые модели необходимы, они не являются достаточным условием. \ Скорее, агентский ИИ использует совокупность различных методов ИИ и машинного обучения. \ К ним относятся передовые подходы, такие как обучение с подкреплением, глубокое обучение и модели обучения с учителем/без учителя, которые позволяют автономно принимать решения; обработка естественного языка и компьютерное зрение, которые позволяют агентам использовать документы и другие мультимодальные данные для понимания контекста, в котором они работают; а также модели машинного обучения, которые анализируют исторические данные для прогнозирования будущего, чтобы агенты могли предвидеть будущее и принимать упреждающие решения. Рабочее место, на котором все бегают и занимаются своими делами, а никто не умеет организовывать собственные рабочие процессы, будет довольно хаотичным и непродуктивным. \ То же самое можно сказать и об агентском рабочем месте. \ Вот почему гибкая и мощная оркестрация процессов необходима для агентской автоматизации. \ У агентов должна быть «высшая власть», которая поможет им координировать задачи, управлять рабочими процессами и оптимизировать операции для достижения заранее определённых целей. \ Функция оркестрации процессов должна поддерживать **динамическое выполнение рабочих процессов**, то есть обеспечивать эффективную совместную работу нескольких агентов, выполняющих различные задачи. \ Она также должна поддерживать **многоагентское взаимодействие**, чтобы процессы с участием нескольких агентов, роботов и людей выполнялись плавно и синхронно. Межкорпоративные и независимые **сквозные процессы почти всегда включают в себя несколько систем, приложений и технологий.** \ **Поэтому возможности оркестрации должны быть** — способны работать во всей экосистеме корпоративных технологий. \ И если разные решения принимаются разными агентами — процесс, называемый \ **распределенным принятием решений**, — возможности оркестрации процессов должны обеспечивать правильную последовательность решений, действий и данных для других решений. Триггер — это событие или действие, которое побуждает агента искусственного интеллекта к действию, будь то содержание электронного письма, запрос от сотрудника, сообщение о неблагоприятной погоде, сигнал от устройства Интернета вещей (IoT) или множество других событий. \ Они играют фундаментальную роль в инициировании и руководстве действиями агентов искусственного интеллекта и необходимы для обеспечения того, чтобы агенты могли реагировать динамически без вмешательства человека. \ Следовательно, каждая агентская система требует возможности идентифицировать триггеры и оповещать нужного агента (ов). \ Для этого необходима возможность непрерывного и точного отслеживания процессов, входных данных, действий, а также внутренних и внешних событий. **RPA** — это критически важная возможность для выполнения агентской автоматизации. \ Представьте, что роботы RPA выполняют большую часть задач в рамках сквозного агентского рабочего процесса. Агентские системы должны уметь автономно и автоматически извлекать уроки из прошлого опыта и адаптироваться для повышения своей эффективности. \ Подобно тому, как люди учатся на своих ошибках, агенты должны уметь выявлять ошибки — например, при интерпретации неструктурированных данных, выявлении закономерностей или принятии решений на основе контекста — и использовать эту обратную связь для адаптации и оптимизации. \ Для этого необходимо объединить автоматизированный процесс обратной связи/оценки с моделями искусственного интеллекта и машинного обучения. Чтобы принимать правильные решения, ИИ-агент должен понимать среду, в которой он работает. \ Это может включать в себя всё: от бизнес-правил и политик до исторических решений и конкретной информации о клиентах, продуктах, партнёрах или поставщиках, а также ценностей и поведенческих норм компании. \ Агентские системы должны иметь возможность предоставлять своим агентам соответствующий контекст и ситуационное понимание, необходимые для принятия решений, понимания, прогнозирования и действий. \ В агентские системы необходимо встраивать автоматизированные процессы, позволяющие агентам получать доступ к этим контекстным данным. Разработка подсказок с помощью ИИ необходима для повышения эффективности агентских систем, особенно тех, которые используют большие языковые модели для понимания естественного языка, принятия решений или взаимодействия. \ Разработка подсказок с помощью ИИ повышает способность людей создавать и оптимизировать подсказки. \ Более качественные подсказки позволяют агентским системам ИИ достигать большей точности, действовать более контекстно-зависимым образом и достигать ключевых бизнес-целей, сводя к минимуму ошибки и предубеждения. \ Результат: более продуктивная, адаптивная и удобная для пользователей агентская автоматизация. Агенты ИИ могут выступать в качестве виртуальных коллег и высокоинтеллектуальных помощников (например, вторых пилотов), но для максимальной эффективности они должны иметь возможность естественного взаимодействия с людьми с помощью интуитивно понятных интерфейсов, таких как чат-боты, голосовые помощники и тому подобное. \ Кроме того, агентские системы должны упрощать и облегчать вовлечение человека в процессы, чтобы люди могли быстро выявлять исключения и проблемы с производительностью и реагировать на них. Системы искусственного интеллекта часто работают с конфиденциальными данными, которые необходимо защищать от внутренних и внешних угроз. \ Поэтому им требуются инструменты безопасности на основе ИИ, которые могут автономно выявлять и снижать эти риски без постоянного контроля и вмешательства человека. \ Кроме того, системы должны обеспечивать, чтобы автоматизированные процессы и решения, принимаемые ИИ, были справедливыми, непредвзятыми и соответствовали правовым и нормативным стандартам. \ Поэтому агентские системы ИИ должны включать в себя как автономные возможности аудита и мониторинга, так и поддержку управления человеком, включая прозрачность, мониторинг и контроль. **7. Какие проблемы ввозникают при внедрении агентской автоматизаци?** Хотя агентская автоматизация открывает перед бизнесом огромные возможности, её внедрение сопряжено с трудностями и соображениями, которые требуют пристального внимания.
**Обеспечение надежного принятия решений** Сама суть агентской автоматизации заключается в её способности принимать автономные решения. Но вместе с этой автономностью приходит и ответственность. Обеспечение точности и безопасности этих решений имеет первостепенное значение. Динамическая природа агентской автоматизации означает, что агенты ИИ должны быть тщательно протестированы и проверены в различных сценариях, чтобы выявить и устранить потенциальные предубеждения или ошибки. Для контроля и управления системами на базе ИИ необходим надёжный процесс проверки, а также участие человека, чтобы гарантировать заинтересованным сторонам, что решения являются обоснованными и надёжными.
**Конфиденциальность и безопасность данных** Агентская автоматизация может включать процессы, связанные с конфиденциальными данными, что делает конфиденциальность и безопасность данных первостепенной задачей. Поскольку эти системы становятся все более взаимосвязанными с корпоративными приложениями и инфраструктурой, внедрение строгих мер безопасности является обязательным условием. Это включает шифрование, контроль доступа и регулярные аудиты для защиты данных и поддержания соответствия нормативным требованиям. Создание надежной основы для инициатив по автоматизации агентства имеет решающее значение для защиты ваших операций, репутации и информации клиентов.
**Уверенно ориентируясь в сложных условиях** Сложность агентской автоматизации, предполагающей интеграцию ИИ и моделей машинного обучения, может создавать трудности при настройке и интеграции. Однако сотрудничество с опытными поставщиками может значительно упростить этот процесс. Сотрудничество с экспертами, которые разбираются в нюансах технологий ИИ и в ваших конкретных бизнес-потребностях, позволит вам уверенно справляться со сложностями и обеспечить бесперебойную реализацию.
**Определение приоритета этичных методов искусственного интеллекта** Внедрение автоматизации на основе ИИ поднимает важные этические вопросы. Обеспечение прозрачности процессов принятия решений с помощью ИИ, устранение потенциальных предвзятостей в моделях и сохранение подотчётности — всё это имеет решающее значение для ответственного внедрения ИИ. Компании должны уделять приоритетное внимание справедливости, равноправию и этичным методам использования ИИ, чтобы завоевать доверие клиентов, сотрудников и заинтересованных сторон. Для решения этих проблем требуется проактивный и вдумчивый подход. Решая их, компании могут в полной мере использовать потенциал агентской автоматизации для повышения эффективности, внедрения инноваций и роста, обеспечивая при этом ответственное и этичное использование ИИ. # Агентный искусственный интеллект Узнайте о будущем сферы труда, где современный искусственный интеллект и автоматизация объединяются для создания мощных автономных агентов, способных понимать, создавать и выполнять сложные бизнес-процессы. ### Что такое агентный искусственный интеллект? Агентный ИИ — это новая технология, которая призвана преобразовать все отрасли. Она сочетает в себе новые формы искусственного интеллекта (ИИ), такие как большие языковые модели (LLM), традиционный ИИ, например машинное обучение, и автоматизацию предприятий для создания автономных ИИ-агентов, которые могут анализировать данные, ставить цели и предпринимать действия с минимальным участием человека. Эти агенты способны принимать решения и динамически решать проблемы, обучаться и совершенствоваться при каждом взаимодействии. Агентный ИИ — это вероятностная технология, которая легко адаптируется к меняющимся условиям и событиям. Она опирается на закономерности и вероятности при принятии решений и выполнении действий, в отличие от детерминированных систем, таких как роботизированная автоматизация процессов (RPA), которые следуют фиксированным правилам и заранее заданным результатам. Агентный ИИ позволяет автоматизировать многие рабочие процессы и бизнес-процессы, с которыми детерминированные системы не могут справиться самостоятельно. Агентный ИИ не просто позволяет предприятиям автоматизировать конкретные задачи — он создаёт интеллектуальные системы, способные понимать контекст, адаптироваться к новой информации и сотрудничать с людьми для решения сложных задач. Позволяя машинам действовать независимо в неструктурированных средах, агентный ИИ меняет представление о том, чего может достичь автоматизация. В то время как агентный ИИ открывает новые возможности для автоматизации, RPA по-прежнему играет важнейшую роль в обеспечении соответствия требованиям, безопасности и отказоустойчивости. Таким образом, в будущем рабочие процессы на предприятиях будут представлять собой сочетание вероятностных и детерминированных технологий, работающих вместе. ### Агентский искусственный интеллект и агентская автоматизация Агентный ИИ позволил создать новый тип автоматизации — агентную автоматизацию, — которая может оптимизировать сложные неструктурированные процессы, с которыми традиционная автоматизация на основе правил не может справиться самостоятельно. Агентная автоматизация знаменует собой переход от традиционной автоматизации на основе правил к более динамичному, учитывающему контекст подходу. В то время как RPA играет важную роль в автоматизации структурированных, повторяющихся задач, агентная автоматизация позволяет обрабатывать сложные процессы принятия решений, которые могут адаптироваться в режиме реального времени. Это не просто расширение технологических возможностей RPA; это революционный подход, который отлично дополняет существующие предложения RPA, расширяя возможности предприятий по автоматизации более масштабных и сложных процессов. Агентная автоматизация предполагает симбиотическое сочетание ИИ-агентов, RPA-роботов и людей. Люди определяют цели для агентов, обеспечивают управление и вмешиваются, когда требуется человеческое суждение и проверка (человек в цикле). Роботы повышают точность, производительность и эффективность ИИ-агентов, собирая данные, необходимые для принятия решений (например, для входа в систему, подключения и понимания информации в нескольких системах); они также могут выполнять широкий спектр других определённых действий для агентов. Становится всё более очевидным, что организованная экосистема, состоящая из агентов, роботов и людей, управляемых с помощью одной платформы, обеспечивает более высокую производительность, безопасность и контроль. Платформа UiPath™интегрирует передовой искусственный интеллект с платформами автоматизации, такими как и позволяет предприятиям: * Воспользуйтесь преимуществами бесперебойной координации действий людей, роботов и ИИ-агентов * Управляйте многоагентной экосистемой с помощью критически важных средств контроля, управления и безопасности, необходимых современным предприятиям * Автоматизируйте динамические рабочие процессы в CRM, ERP и других системах * Оптимизируйте процесс принятия решений с использованием данных в режиме реального времени Такой подход обеспечивает возможности и масштабируемость, необходимые компаниям для расширения сферы автоматизации, сочетая интеллектуальные функции и действия для повышения эффективности. **Каковы преимущества агентного ИИ и агентской автоматизации?** Позволяя ИИ-агентам нового поколения выполнять более широкий спектр задач, чем когда-либо прежде, агентский ИИ значительно расширяет возможности автоматизации. Кроме того, он улучшает качество взаимодействия между агентами и людьми. Для предприятий это даёт ряд важных преимуществ:
**Повышение эффективности и продуктивности** Уполномоченные программные агенты теперь могут выполнять сложные задачи, требующие принятия решений, которые ранее были недоступны машинам. Это позволяет сотрудникам сосредоточить свою энергию и опыт на стратегических инициативах, творческом решении проблем и построении более прочных отношений с клиентами — действиях, которые действительно способствуют росту бизнеса.
**Улучшенный опыт работы с клиентами** Агентский ИИ совершает революцию в общении с клиентами, предоставляя персонализированный и адаптивный опыт в больших масштабах и с высокой скоростью. Используя сложные модели, ИИ-агенты могут определять намерения клиентов, прогнозировать потребности и предлагать индивидуальные решения, работая круглосуточно и без выходных для обеспечения постоянной и эффективной поддержки.
**Стратегическое сотрудничество человека и искусственного интеллекта** Системы agentic с искусственным интеллектом могут не заменять обычных сотрудников, а повышать эффективность работы персонала, его продуктивность и вовлеченность. Благодаря плавной интеграции с существующими системами и процессами системы agentic с искусственным интеллектом могут формировать прочные партнерские отношения с рабочей силой. Это дает предприятиям больший совокупный потенциал и интеллект для решения сложных задач, автоматизации процесса принятия решений и повышения эффективности во всех своих организациях. ### Каковы наиболее эффективные варианты использования agentic AI на сегодняшний день?
**Оптимизация процесса рассмотрения страховых претензий** Страховой отрасли не привыкать к бумажной волоките и ручным процессам, но агентский ИИ меняет правила. Страховые компании могут использовать эту технологию для автоматизации всего процесса рассмотрения страховых случаев, от первоначальной подачи заявления до окончательной выплаты. Это позволяет ускорить обработку, сократить количество ошибок и значительно улучшить качество обслуживания клиентов. Представьте себе агента с искусственным интеллектом, который может мгновенно оценить обоснованность претензии, собрать необходимую информацию из разных источников и общаться с клиентом понятным и чутким образом. Помимо ускорения процесса рассмотрения претензий, это снижает административную нагрузку на страховых агентов, позволяя им сосредоточиться на более сложных случаях и предоставлять более высокий уровень персонализированного обслуживания.
**Оптимизация логистики и управления цепочками поставок** В мире логистики и управления цепочками поставок важна каждая минута. Задержки, сбои и неэффективность могут негативно сказаться на всей системе, costing бизнесу время и деньги. Агентский ИИ становится мощным инструментом для решения этих проблем. Программные агенты Agentic на базе искусственного интеллекта могут анализировать огромные объемы данных в режиме реального времени, оптимизируя маршруты, прогнозируя потенциальные узкие места и даже корректируя уровень запасов в зависимости от колебаний спроса. Такая динамическая оптимизация может помочь обеспечить эффективную доставку товаров и услуг, снизить затраты и повысить удовлетворенность клиентов.
**Расширение возможностей при принятии финансовых** решений Агентский ИИ также набирает популярность в финансовом секторе, позволяя программным агентам анализировать рыночные тенденции, оценивать инвестиционные возможности и даже создавать персонализированные финансовые планы для отдельных клиентов. Избавившись от необходимости проводить подробный анализ и составлять отчёты, финансовые консультанты теперь могут сосредоточиться на построении отношений и предоставлении стратегических рекомендаций. Помимо рекомендаций по инвестициям, агентский искусственный интеллект также трансформирует методы управления рисками финансовых институтов. Agentic - агенты на базе искусственного интеллекта могут анализировать огромные объемы данных для выявления потенциальных рисков и уязвимостей, помогая финансовым учреждениям активно управлять своими рисками и обеспечивать соблюдение нормативных требований. Такой упреждающий подход сводит к минимуму потери и одновременно повышает общую устойчивость финансовой системы.
**Ускорение открытия и разработки лекарственных средств** Отрасль здравоохранения переживает цифровую трансформацию, и агентский ИИ играет в этом ключевую роль. Например, программные агенты могут рекомендовать планы лечения на основе индивидуальных данных пациента, обеспечивая индивидуальный подход к лечению с учётом уникальных потребностей и истории болезни каждого пациента. Такой персонализированный подход к здравоохранению обещает улучшить результаты лечения и более эффективно использовать медицинские ресурсы. Агентный ИИ также ускоряет поиск и разработку лекарств, позволяя программным агентам быстро анализировать большие массивы данных, выявлять потенциальные мишени для лекарств и прогнозировать их эффективность. Это ускоряет процесс исследования, что приводит к снижению затрат и позволяет ускорить выпуск жизненно важных лекарств.
**Преобразование обслуживания и подде**ржки клиентов Обеспечение исключительного качества обслуживания клиентов является главным приоритетом для компаний во всех отраслях. Agentic AI помогает улучшить обслуживание клиентов, позволяя программным агентам предоставлять персонализированную круглосуточную поддержку. И эта поддержка выходит далеко за рамки простых часто задаваемых вопросов и автоматических ответов. Агенты по обслуживанию клиентов на базе искусственного интеллекта могут понимать устные и письменные запросы клиентов, решать сложные проблемы и даже предвидеть потребности клиентов, обеспечивая по-настоящему персонализированный опыт. Представьте себе виртуального помощника, который не только отвечает на ваши вопросы, но и активно предлагает актуальную информацию и рекомендации, основанные на ваших прошлых взаимодействиях. Этот гиперперсонализированный сервис повышает лояльность к бренду, предоставляя клиентам первоклассный опыт.
**Ускорение и оптимизация тестирования** Агентное тестирование использует ИИ-агентов для выполнения ряда сложных и критически важных задач по тестированию под контролем человека. Например, агенты могут создавать регулярные отчёты о текущих тестовых проектах. Они могут разрабатывать, проводить и анализировать тесты приложений. Агенты могут сотрудничать с людьми, чтобы находить и устранять слабые места в планах и проектах по тестированию. ### В чем разница между агентированным ИИ и генеративным ИИ? Хотя и агентный ИИ, и генеративный ИИ (GenAI) являются ключевыми технологиями, их цели различаются. У каждой из них есть свои уникальные преимущества и области применения. GenAI отлично справляется с созданием нового контента в различных форматах, включая текст, изображения, музыку и даже код. Он умеет генерировать идеи, создавать захватывающие истории и предлагать инновационные решения. Однако генеративный ИИ в первую очередь ориентирован на создание контента и полагается на человеческий вклад и рекомендации для определения контекста и целей своей работы. С другой стороны, агентский ИИ ориентирован на действия и выходит за рамки создания контента, расширяя возможности автономных систем, способных самостоятельно принимать решения и действовать. Эти системы могут анализировать ситуации, формулировать стратегии и выполнять действия для достижения конкретных целей с минимальным вмешательством человека. Они предназначены для автономной работы, адаптации к меняющимся условиям и обучения на собственном опыте. По сути, в то время как GenAI фокусируется на создании, агентный ИИ фокусируется на выполнении. Результатом генеративного ИИ является новый контент, в то время как результатом агентного ИИ является серия действий или решений. Их можно использовать в тандеме для создания мощных решений, сочетающих креативность с действием. Например, модель GenAI может быть использована для создания маркетинговой копии, в то время как агентская система искусственного интеллекта может автономно развертывать эту копию по оптимальным каналам на основе данных в реальном времени и целей кампании. ### Как мы дошли до этого с помощью agentic AI? История агентского ИИ началась с первых чат-ботов, примитивных цифровых помощников, которые использовали базовое сопоставление шаблонов и деревья решений для имитации диалога. Эти чат-боты стали революционным шагом в развитии взаимодействия человека и машины, но они были ограничены в своей способности понимать нюансы языка, контекстные подсказки и сложные запросы. Несмотря на свои ограничения, эти первые чат-боты заложили основу для разработки более сложных технологий искусственного интеллекта для общения. Они продемонстрировали потенциал ИИ для автономного взаимодействия с клиентами, например, для ответа на запросы клиентов, предоставления информации по запросу и даже для ведения простых диалогов. Однако зависимость чат-ботов от заранее заданных правил и шаблонных ответов ограничивала их способность обрабатывать сложные сценарии и адаптироваться к неожиданным действиям пользователей. У них просто не было когнитивных способностей для обработки более сложных и тонких взаимодействий. Но затем значительные достижения в области возможностей ИИ и корпоративных технологий начали расширять возможности, что привело к появлению агентского ИИ. **Как большие языковые модели (LLM) способствовали появлению аге**нтного ИИ? С появлением мощных больших языковых моделей, таких как GPT-3 и GPT-4, ландшафт ИИ кардинально изменился. Эти модели, обученные на огромных массивах данных, продемонстрировали новую способность ИИ понимать и генерировать текст, похожий на человеческий. Разговоры стали более естественными и содержательными, открывая новые возможности для применения ИИ. Представьте, что LLM — это мозг, управляющий агентским ИИ. Они обеспечивают основу для понимания естественного языка, позволяя агентам ИИ интерпретировать сложные инструкции, участвовать в содержательных беседах и даже генерировать творческий контент. Благодаря расширенным языковым возможностям агентский ИИ может взаимодействовать с пользователями более естественным и интуитивно понятным образом, открывая новые возможности для совместной работы и решения проблем. Более того, LLM-модели позволили агентному ИИ рассуждать и принимать решения на основе обрабатываемой ими информации. Анализ больших объёмов данных и выявление закономерностей позволяет этим ИИ-агентам генерировать идеи, делать прогнозы и предпринимать действия, соответствующие их заранее заданным целям. Эта способность мыслить и действовать автономно является ключевой характеристикой агентного ИИ, отличающей его от традиционных технологий автоматизации. #### Какие достижения в области машинного обучения способствовали развитию агентского ИИ — и каким образом? Достижения в области алгоритмов машинного обучения в сочетании с постоянно растущей вычислительной мощностью ещё больше ускорили эту эволюцию. Теперь эти системы могут обучаться на основе огромных объёмов данных, совершенствуя свои возможности и становясь всё более адаптируемыми к новым ситуациям. Этот сдвиг проложил путь для более динамичных решений в области автоматизации и искусственного интеллекта. Например, обучение с подкреплением — разновидность машинного обучения, при которой автономные агенты учатся, взаимодействуя с окружающей средой и получая обратную связь, — сыграло важную роль в развитии агентского ИИ, способного принимать решения на высоком уровне. Обучение методом проб и ошибок позволяет агентским системам ИИ оптимизировать свои действия для достижения конкретных целей даже в сложных и динамичных средах. #### Какие технологические инновации и достижения способствуют внедрению агентского ИИ с помощью ИИ-агентов на предприятиях? Интеграция инструментов ИИ с существующими корпоративными системами изменила правила игры. Это позволило автономным агентам получать доступ к множеству источников данных по всей организации — от систем управления взаимоотношениями с клиентами (CRM) и планирования ресурсов предприятия (ERP) до инструментов управления цепочками поставок и персоналом. Разрушение разрозненности данных и объединение разрозненных систем позволяет агентному ИИ получать полное представление о вашем бизнесе, принимать более взвешенные решения на основе данных и автоматизировать сложные рабочие процессы. Достижения в области облачных вычислений также сыграли решающую роль в развитии агентского ИИ. Облачные платформы, такие как Microsoft Azure и Amazon Web Services (AWS), обеспечивают масштабируемую вычислительную мощность и ёмкость хранилища, необходимые для обучения и развёртывания сложных моделей ИИ. Кроме того, сложные инструменты обработки данных позволяют компаниям извлекать ценную информацию из больших массивов данных в режиме реального времени, расширяя возможности агентского ИИ по принятию решений. Кроме того, разработка решений для автоматизации на основе ИИ, таких как UiPath Platform™, ещё больше ускорила внедрение агентского ИИ. Эти платформы предлагают полный набор инструментов и сервисов, которые упрощают проектирование, разработку и внедрение автоматизированных систем на основе ИИ, позволяя компаниям создавать интеллектуальных агентов и управлять ими, которые могут выполнять широкий спектр сложных задач и процессов. #### Как эти достижения объединились, обеспечив появление агентов с искусственным интеллектом? Как уже говорилось выше, сочетание мощных больших языковых моделей, сложного машинного обучения и бесшовной интеграции с предприятием привело к появлению агентского ИИ — «мозгового центра» агентов ИИ. Благодаря значительно улучшенным аналитическим способностям, навыкам рассуждения, обучения и умозаключения, этот новый тип программных агентов теперь может работать с минимальным вмешательством человека, выполняя сложные динамичные процессы, которые когда-то считались исключительной прерогативой человеческого интеллекта. Они могут ставить цели, разрабатывать и оптимизировать процессы для выполнения работы. Они могут самостоятельно принимать решения о выполнении действий или направлять других агентов для запуска процесса. Они могут учиться на собственном опыте и со временем повышать свою эффективность. ### Какие риски и проблемы возникают при внедрении agentic AI? Потенциал агентного ИИ значителен, но важно помнить о потенциальных рисках, связанных с этой преобразующей технологией. По мере того, как системы ИИ становятся всё более автономными и эффективными, обеспечение их ответственного и этичного использования становится первостепенной задачей. Исследователи и разработчики активно работают над созданием структур и руководств, которые обеспечат прозрачную, справедливую и подотчётную работу агентного ИИ. Некоторые области, вызывающие серьёзную обеспокоенность:
### Каковы некоторые рекомендации по внедрению agentic AI?
**Сильное управление** Разработайте чёткие механизмы управления и соблюдения требований, которые определяют роли и обязанности всех заинтересованных сторон, участвующих в разработке и внедрении агентских систем ИИ. Это включает в себя разработку этических принципов использования ИИ, обеспечение соблюдения соответствующих нормативных требований и создание механизмов для регулярного мониторинга и аудита.
**Безопасность и соответствие требованиям** Внедрите надёжные меры безопасности, такие как шифрование, контроль доступа и регулярную оценку уязвимостей, чтобы защитить конфиденциальную информацию и сохранить целостность агентских систем ИИ. Кроме того, обеспечьте соблюдение правил защиты данных и установите чёткие правила использования данных, чтобы снизить риски для конфиденциальности и соблюдать этические нормы.
**Тестирование и валидация** Тщательное тестирование и проверка необходимы для обеспечения надёжности и безопасности агентских систем искусственного интеллекта. Проведите всестороннее тестирование в различных сценариях, включая как ожидаемые, так и непредвиденные ситуации, чтобы выявить и устранить потенциальные недостатки или непредвиденные последствия до внедрения системы в реальную среду.
**Постоянный мониторинг и совершенствование** Системы агентного ИИ должны постоянно обновляться, чтобы обеспечивать свою эффективность и безопасность. Регулярная обратная связь, показатели эффективности и отзывы пользователей могут помочь выявить области, требующие улучшения, и позволить системе адаптироваться к меняющимся условиям. Постоянное обучение и совершенствование — ключ к максимальной отдаче и долговечности инвестиций в агентный ИИ. ### Каким будет будущее агентского ИИ, агентской автоматизации и ИИ-агентов? Огромные прорывы в области искусственного интеллекта, которые позволяют машинам работать почти как люди, создают революционные технологические изменения. Сегодня машины понимают нас лучше, чем когда-либо. Они могут учиться, прогнозировать, интуитивно понимать и рассуждать. Они могут выполнять неопределённые задачи, управлять сложными процессами и принимать взвешенные решения, которые всего год или два назад могли принимать только люди. Короче говоря, агентский ИИ позволяет нам создать новую виртуальную рабочую силу, которая впервые в истории может выполнять работу специалистов в области знаний. Это открывает совершенно новые возможности для проектирования рабочих процессов, распределения работы между агентами и людьми, а также определения ролей людей и машин в многочисленных процессах в организации. Хотя достижения в области агентного ИИ уже изменили некоторые способы взаимодействия и сотрудничества людей и машин, это лишь несколько капель в океане масштабных перемен. На горизонте маячит масштабная и неизбежная волна трансформации труда, которая только начинает формироваться и набирать обороты. То, как будут работать самые современные и успешные компании через пять лет, — повсеместное использование автоматизации и искусственного интеллекта во всех сферах их деятельности, — то, что будут делать их сотрудники, то, что будут делать машины, и то, как люди и машины будут работать вместе, — будет мало похоже на то, как они работают сейчас. Они будут работать лучше, быстрее и эффективнее. Они будут отличаться выдающимся уровнем взаимодействия с клиентами, гибкостью в реагировании на текущие и будущие изменения, а также способностью достигать новых уровней продуктивности и вовлечённости сотрудников. Возможности практически безграничны, и будущее агентного ИИ наполнено перспективами. По мере развития этой технологии она может изменить мир труда и роли людей и машин в этом мире. # Порождающий искусственный интеллект Узнайте, как генеративный искусственный интеллект и автоматизация работают вместе, повышая эффективность и производительность, улучшая качество обслуживания клиентов и стимулируя трансформацию бизнеса # Кейсы Сборник решений которые присылают наши пользователи. ## Кейс #1 ### **БАНИ И САУНЫ** ГОТОВОЕ РЕШЕНИЕ. Подходит для любой строительной компании.\ Если у вас строительная компания и надоел слив клиентов от менеджера (забыли/забили/не посмотрели/не успели). Это решение закрывает проблему рутинного общения и консультации клиента в любых мессенджерах и соцсетях. С возможностью гибкой настройки и постоянного улучшения вплоть до полного документооборота и дальней поддержки на всех этапах взаимодействия с вашей компанией. * Обучен продавать бани и сауны * Гибкая настройка базы знаний Компания разработчик [https://aissi.ru/](https://aissi.ru/keis1) Полное описание кейса # Шаблоны В сервисе представлены десятки готовых решений которые можно тонко настроить под себя. В разделе "Шаблоны ботов" вы можете создавать ботов с нуля или использовать готовые шаблоны. Если вы хотите создать бота с чистого листа, у вас есть возможность самостоятельно заполнить все необходимые поля. Это позволяет вам полностью контролировать процесс создания и адаптировать бота под ваши конкретные нужды.
### Генерация бизнесс-процессов Для тех, кто предпочитает автоматизацию, доступна функция генерации бота. Вам нужно лишь описать, каким вы видите своего бота и какие функции он должен выполнять. На основе вашего запроса система предложит варианты заполнения полей и функций, которые можно подключить. Чем подробнее вы опишете функционал бота, тем меньше потребуется последующих правок. Также доступны готовые шаблоны для различных ролей, таких как программист или администратор клиники. Эти шаблоны уже содержат предварительно настроенные параметры и функции, которые были протестированы и успешно работают. Вы можете использовать их как основу для создания своего бота, адаптируя под свои нужды.
Если вы хотите создать уникального бота, рекомендуется начать с генерации или с чистого листа, чтобы избежать ненужных настроек, которые могут быть в шаблонах. Выбирайте шаблон, который наиболее близок к вашему кейсу, и настраивайте его под свои требования. Это позволит вам эффективно использовать возможности шаблонов и создать бота, который идеально соответствует вашим задачам. # API Введение Этот код использует API для отправки и получения сообщений через сервис iiagent.pro. Давай разберем каждый фрагмент. #### Отправка сообщения: 1. **URL**: `https://api.iiagent.pro/api/v1.0/send_message` — это конечная точка (endpoint) для отправки сообщений. 2. **Данные запроса** (payload): ```json { "chat_id": "c3", "message_id": "m1", "message": "2+2" } ``` * `chat_id` — уникальный идентификатор чата, в который нужно отправить сообщение. * `message_id` — уникальный идентификатор сообщения, которое отправляется. * `message` — сам текст сообщения (в данном случае "2+2"). 3. **API\_KEY** — это токен для авторизации, который должен быть включен в заголовки для получения доступа к API. 4. **Заголовки**: ```python headers = { "Content-Type": "application/json", "Authorization": f"Bearer {API_KEY}", } ``` Заголовки содержат информацию о формате данных (`application/json`) и токен авторизации (`Bearer {API_KEY}`). 5. **Ответ**: ```python response = requests.request("POST", url, headers=headers, data=json.dumps(payload)) print(response.text) ``` Ответ от API выводится на экран, где `response.text` будет содержать результат выполнения запроса. #### Получение сообщений: 1. **URL**: `https://api.iiagent.pro/api/v1.0/get_messages` — это конечная точка для получения сообщений. 2. **Данные запроса**: json ```json { "chat_id": "c3" } ``` Запрос отправляется для получения сообщений из чата с ID `c3`. 3. **Заголовки** аналогичны запросу на отправку сообщения, с включением авторизационного токена. 4. **Ответ**: python ```python response = requests.request("POST", url, headers=headers, data=json.dumps(payload)) response.json() ``` Ответ будет в формате JSON и содержать список сообщений для указанного чата. #### Пример с `curl`: Для тех, кто работает с командной строкой, приведены примеры того, как можно отправить запрос с помощью `curl`. #### Общие моменты: * Все запросы используют формат JSON для данных. * API требует авторизации через токен. * API предоставляет возможность отправлять и получать сообщения через чаты с использованием указанных идентификаторов чатов и сообщений. Эти фрагменты кода можно использовать для интеграции с чат-ботами или мессенджерами для автоматизации отправки и получения сообщений через API. # API настройка ## Сообщения ### Google Colab ``` https://colab.research.google.com/drive/1eJlKKpRMRv6PIgA8rzMO6_ZpdmnnhU_P?usp=sharing ``` ### Отправить сообщение ``` import requests import json url = "https://api.iiagent.pro/api/v1.0/send_message" payload = { "chat_id": "c3", "message_id": "m1", "message": "2+2" } API_KEY = '3397_3QEg2tuvp9pXXXXXXXXXXXXXXX' headers = { "Content-Type": "application/json", "Authorization": f"Bearer {API_KEY}", } response = requests.request("POST", url, headers=headers, data=json.dumps(payload)) print(response.text) ``` ### Получать Все сообщения ``` import requests url = "https://api.iiagent.pro/api/v1.0/get_messages" payload = { "chat_id": "c3" } API_KEY = '3397_3QEg2tuvp9pXXXXXXXXXXXXXXXXXX' headers = { "Content-Type": "application/json", "Authorization": f"Bearer {API_KEY}", } response = requests.request("POST", url, headers=headers, data=json.dumps(payload)) response.json() ``` ### Публикация Отправить сообщение ``` https://api.iiagent.pro/api/v1.0/send_message ``` Пример запроса ``` curl --location 'https://api.iiagent.pro/api/v1.0/send_message' \ --data '{ "chat_id": "c3", "message_id": "m1", "message": "2+2" }' ``` ### АВТОРИЗАЦИЯ Токен на предъявителя ``` Жетон <токен> ``` ``` Тело необработанный (json) ``` json ```json { "chat_id": "c3", "message_id": "m1", "message": "2+2" } ``` ### Публикация Получаем сообщения ``` https://api.iiagent.pro/api/v1.0/get_messages ``` Пример запроса ``` curl --location 'https://api.iiagent.pro/api/v1.0/get_messages' \ --data '{ "chat_id": "c3" }' ``` ### АВТОРИЗАЦИЯ Токен на предъявителя ``` Жетон <токен> ``` ``` Тело необработанный (json) ``` json ```json { "chat_id": "c3" } ``` # Создание функции Ключевое отличие iiAgent.pro от конкурентов в том что без навыков программирования за 5 минут можно самостоятельно создавать сложные функции и прикреплять к своим нейро-агентам. [Этапы создания функции. (Упрощенная последовательность)](#etapy-sozdaniya-funkcii.-uproshennaya-posledovatelnost) [1 этап. Создать описание функции. ](#id-1-etap.-sozdat-opisanie-funkcii) [2 этап. Создай код функции в chat.deepseek.com](#id-2-etap.-sozdai-kod-funkcii-v-chat.deepseek.com) [3 этап. Протестируй функцию в colab.research.google.com](#id-3-etap.-protestirui-funkciyu-v-colab.research.google.com) [4 этап. Создай и оформи функцию в iiAgent.pro](#id-4-etap.-sozdai-i-oformi-funkciyu-v-iiagent.pro) ### Этапы создания функции. (Упрощенная последовательность). Концепция очень простая. Просим дипсик ([chat.deepseek.com](https://chat.deepseek.com/)) по примеру создавать код по описанию функции. Проверяем работоспособоность функции в гугл коллаб ([colab.research.google.com](https://colab.research.google.com/)). По инструкции переносим код в ииАгент (iiAgent.pro). Создаем функцию и отправляем на модерацию. 1. Создай описание функции в свободной форме. 2. Показываем пример как должен выглядеть код функции. 3. Описываем функцию и просим по примеру написать код функции. 4. Просим написать пример вызова функции. 5. Копируем код в проверяем на ошибки. 6. Копируем код вызова функции и запускаем проверку работы функции. Потребуются инструменты. ``` https://chat.deepseek.com/ ``` ``` https://colab.research.google.com/ ``` {% embed url="" %} {% embed url="" %} ### 1 этап. Создать описание функции. Опишите функцию в свободной форме. Пример. 
Мне нужна функция поиск картинок на сайте pinterest.com
### 2 этап. Создай код функции в chat.deepseek.com * Зайди в chat.deepseek.com. * Создай новый чат. * Вставь пример функции и попроси "оформляй все функции в таком виде". Задача написана в последней строчке примера ниже. * Следующим предложением добавь описание функции. "Мне нужна функция поиск картинок на сайте pinterest.com". Задача написана в последней строчке в примере ниже. ``` { "name": "get_movie_rating", "description": "Получить рейтинг фильма по ID на Кинопоиске", "parameters": { "type": "object", "properties": { "movie_id": { "type": "string", "description": "ID фильма на Кинопоиске", }, }, "required": ["movie_id"], }, }, def get_movie_rating(arguments): import requests movie_id = arguments['movie_id'] url = f"https://kinopoiskapiunofficial.tech/api/v2.2/films/{movie_id}" headers = { "X-API-KEY": "ваш_ключ_кинопоиска" } response = requests.get(url, headers=headers) if response.status_code == 200: data = response.json() return data.get('rating', 'Рейтинг не найден') else: return 'Ошибка при получении данных' оформляй функции все в таком виде. Мне нужна функция поиск картинок на сайте pinterest.com ```
* chat.deepseek напишет код. "Который мы ПОЗЖЕ скопируем в colab.research.google.com. Проверим на ошибки и протестируем."
* Просим chat.deepseek "написать пример вызова функции". "Этот код потребуется чтобы запустить функцию в colab.research.google.com"
### 3 этап. Протестируй функцию в colab.research.google.com Зайди в colab.research.google.com. Нажми файл - создать блокнот на диске.
В запущенном окне нажми + Код.
* Скопируй полученный результат "код функции" из chat.deepseek. и вставь в colab.research.google.com ``` { "name": "search_pinterest_images", "description": "Поиск изображений на сайте Pinterest по заданному запросу", "parameters": { "type": "object", "properties": { "query": { "type": "string", "description": "Поисковый запрос для изображений на Pinterest" }, "count": { "type": "integer", "description": "Количество изображений, которые нужно получить", "default": 10 } }, "required": ["query"] } } def search_pinterest_images(arguments): import requests query = arguments['query'] count = arguments.get('count', 10) url = f"https://www.pinterest.com/resource/BaseSearchResource/get/" params = { "source_url": f"/search/pins/?q={query}", "data": f'{{"options":{{"query":"{query}","scope":"pins","page_size":{count}}}}}' } headers = { "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/58.0.3029.110 Safari/537.3" } response = requests.get(url, headers=headers, params=params) if response.status_code == 200: data = response.json() images = [] for pin in data.get('resource_response', {}).get('data', {}).get('results', []): images.append(pin.get('images', {}).get('orig', {}).get('url')) return images else: return 'Ошибка при получении данных' ``` * Запусти проверку кода нажав на значек "play". Дождись результата. Если в коде нет ошибок то появится зеленая галочка около значка "play". Если в коде допущены ошибки, то система выдаст комментарии.
* Скопируй код запуска функции из chat.deepseek. Нажми "+ Код" в colab.research.google.com и вставь код ``` arguments = { "query": "nature", "count": 5 } result = search_pinterest_images(arguments) print(result) ```
* Запусти функцию. Нажми кнопку "play". После запуска получим результат. (5 изображений с природой)
### 4 этап. Создай и оформи функцию в iiAgent.pro На этом этапе мы попросим [chat.deepseek.com](https://chat.deepseek.com/) создать описание функции и добавим его в iiAgent.pro. Скопируем определение функции из [colab.research.google.com](https://colab.research.google.com/) ( это первая часть кода до команды def) перенесем в iiAgent.pro. Скопируем вторую часть кода функции из [colab.research.google.com](https://colab.research.google.com/) (это код на Python) перенесем в iiAgent.pro. * Вернись в [chat.deepseek.com](https://chat.deepseek.com/) и попроси "создать описание функции для пользователя". Получим подробное описание как работает функция.
* Зайди в раздел Функции- Мои функции. Нажми Добавить функцию. Придумай и заполни название. Скопируй описание из [chat.deepseek.com](https://chat.deepseek.com/) и перенеси в iiAgent.pro
* Добавь лого функции
* Скопируй из [colab.research.google.com](https://colab.research.google.com/) определение функции и добавь в iiAgent.pro **Определение функции - это то что идет до команды def**

Скопируй первую часть кода из colab.research.google.com

Вставь первую часть кода в iiAgent.pro

* Скопируй из [colab.research.google.com](https://colab.research.google.com/) вторую чайсть кода (это код на Python. Начинается с команды def и до конца) перенеси в iiAgent.pro в раздел "Код на Python".

Скопируй вторую часть кода из colab.research.google.com


Вставь вторую часть кода из colab.research.google.com в iiAgent.pro

* Установи стоимость подписки на функцию если планируешь ее монетезировать. * Установи какое количество токенов будет списываться за каждый вызову функции. * Выбери категорию рубрикатора для размещения * Нажми кнопку "Отправить на модерацию". После проверки функция будет одобрена и появится в разделе "Мои функции".
### Подсказки chat.deepseek.com - не всегда пишет функции одинаково. Просите проверить его себя на ошибки и улучшить код. # Интеграции # Подключение авито **Для получения Client ID и Client secret перейдите по ссылке:** {% embed url="" %} **Путь в авито.** Профиль - профиль и настройки - интеграции и API. Раздел интеграции **Скопируйте** **Client ID и Client secret в Авито**

Скопируйте Client ID и Client secret в Авито

**Вставьте в iiAgent**

Вставьте в iiAgent

**ID товаров** ID товаров указаны в объявлении и в конце в адресной строке. Все объявления можно просмотреть в разделе "Мои объявления".