🦸ИИ функции | AI-functions

Как дать ИИ возможность совершать действия во внутренних и внешних системах.

Выберите способ получения информации: видеоинструкция (таймкод 07:55 — 10:49) или текст с изображениями ниже.

Видео на Дзен.

Видео на Rutube.

Видео на YouTube.

Профессиональные настройки — блок настроек, где вы можете создавать разнообразные функции для взаимодействия ИИ-менеджера с внутренними и внешними API. Блок находится в форме редактирования ИИ менеджера.

Установка тегов на диалог через функции

Теги используются для того, чтобы ИИ-менеджер мог автоматически помечать диалоги в нужный момент. Это нужно для удобной визуализации и фильтрации диалогов в личном кабинете, а также для выполнения действий во внешней интеграции.

Как установить теги через функцию:

1. В личном кабинете Selarti перейдите в раздел «ИИ». Затем нажмите на строку с ИИ, к которому хотите добавить теги.

1. Перейдите в раздел «Профессиональные настройки».

1. В выпадающем меню «ИИ функции» выберите нужный тег.

Теги в выпадающем списке «ИИ функции»

• success: применяется, когда диалог завершился успешно (например, достигнута договорённость о встрече или звонке). После добавления этого тега диалог помечается как успешный и информация может быть передана в CRM или другую систему через вебхук.

• get_contact: используется, когда бот получает контактные данные пользователя (например, номер телефона или username из Telegram). Этот тег помечает диалог как содержащий контактную информацию, а данные передаются во внешнюю систему через вебхук.

• interest: применяется, когда пользователь проявляет интерес к предложению (например, соглашается обсудить детали). Этот тег позволяет отслеживать воронку продаж или эффективность взаимодействий. Также поддерживается отправка вебхука.

• close: используется для завершения диалога. После применения этого тега бот перестаёт отвечать на сообщения, а дальнейшая коммуникация передается менеджеру в личный кабинет. Это помогает избежать бесконечных циклов общения, например, когда два бота вступают в диалог друг с другом.

• operator: используется для передачи диалога на оператора. После применения этого тега бот передаёт диалог оператору и перестаёт отвечать на сообщения.

• scheduler: используется для отправки запланированного сообщения. Если клиент напишет сообщения по типу: «Напиши мне 30 числа» или «Напишите послезавтра» — бот запланирует отправку сообщения в указанное время.

1. При необходимости дополните или измените описание функции, для этого нажмите «Добавить функцию».

Чтобы сбросить параметры ИИ функции, нажмите «Отмена».

1. Протестируйте корректность установки тегов, для этого нажмите «Тестирование ИИ».

1. Нажмите «Сохранить», чтобы сохранить изменения.

Настройка сustom API

Функция custom API позволяет подключать внешние сервисы и интеграции, чтобы ИИ-менеджер мог обрабатывать запросы пользователей и передавать данные во внешние системы. Это простой и удобный способ автоматизировать разные задачи.

Примеры использования

Подключение внешнего ресурса: вы можете подключить ИИ к любому внешнему сервису. Например, с помощью интеграции с сервисом погоды ИИ сможет предоставлять актуальную информацию о погоде в ответ на запросы пользователя. При запросе информации о текущей погоде, ИИ отправит API-запрос к внешнему сервису, получит данные и вернет ответ, учитывая контекст диалога.

Функция планирования звонков: ИИ-менеджер может помочь в планировании звонков, интегрируясь с внешними системами. Например, ИИ запросит доступные временные слоты для звонка, получит необходимые данные и запишет событие в календарь или CRM-систему.

Планирование задач или связи с пользователем: С помощью внешнего API ИИ может отслеживать и планировать действия на основе временных условий, например, отправить напоминание пользователю или запланировать повторный контакт через заданный интервал времени.

Расширенные возможности: Интеграции могут включать заказ товаров или услуг. Например, ИИ-менеджер может помочь заказать такси или кофе из ближайшего кафе, интегрируясь с соответствующими сервисами.

Как настроить custom API

Описание концепции

Функции custom API позволяют интегрировать ИИ с внешними ресурсами, отправляя POST-запросы через API для передачи и получения данных. Вы можете настроить отправку структурированных JSON-запросов на ваш сервер, например, для внесения сделок в CRM или для получения информации, такой как свободные слоты в календаре.

Когда пользователь отправляет сообщение, ИИ автоматически проверяет необходимость выполнения функций. Если данных недостаточно, он запросит недостающую информацию, после чего отправит запрос на ваш сервер. Сервер обработает вебхук, вернёт ответ, который будет направлен в ИИ, и затем сгенерирует итоговый ответ. Одно сообщение от пользователя может инициировать неограниченное количество различных функций.

1. В личном кабинете Selarti перейдите в раздел «ИИ». Затем нажмите на строку с ИИ, к которому хотите подключить внешний ресурс.

1. Перейдите в раздел «Профессиональные настройки».

1. В выпадающем меню выберите «сustom api».

1. Напишите инструкцию для ИИ, опишите что должна делать данная функция.

1. Создайте JSON объект, описывающий структуру POST-запроса на ваш сервер. Поддерживаются все типы json shema https://json-schema.org/understanding-json-schema

Пример для создания сделки в CRM:

{
    "type": "object",
    "properties": {
      "name": {
        "type": "string",
        "description": "имя пользователя"
      },
      "phone": {
        "type": "string",
        "description": "Телефон пользователя"
      }
    },
    "additionalProperties": false,
    "required": [
      "name",
      "phone"
    ]
  }

На сервер мы ожидаем получить такой объект.

{
"name": "Сергей",
"phone": "[phone]"
}

Если в диалоге не будет хватать нужных данных для выполнения функции, то ИИ может сам дополнительно их спросить.

1. Добавьте URL сервера, который будет обрабатывать вебхуки от ИИ, например, Make.

1. Пропишите правила в инструкцию ИИ как правильно взаимодействовать с функцией.

1. Пример реализации приёма данных в Google Sheets.

1. Добавьте ответ на вебхук. Данная информация будет передана в ИИ, обработана, после чего будет сформирован ответ пользователю на основе контекста диалога и информации из ответа сервера.

1. Протестируйте корректность выполнения функции.

1. Проверьте логи запроса и его обработки.

1. В Google Sheets мы получили созданную строку.

   

Если у вас возникнут трудности с подключением внешних ресурсов, вы можете заказать у нас настройку функций «под ключ». Связаться с нами можно в Telegram — @selarti_support_bot.