single-bot 0.1.4

Omnichannel state-based chatbot framework

Чатбот созданный для Single Bot - это набор связанных функций(нод), принимающих на вход обьект UserState и вызывающие методы этого же обьекта UserState.

Для запуска чатбота - передать первую ноду в BotFactory и вызвать метод .start() указав нужные платформы.

Все данные, которые чатбот производит в процессе работы сохранаются в папке data в корне проекта. Для миграции - сохранить и перенести эту папку.

Для создания бота:

from single_bot.bot_factory import BotFactory
from nodes import first_node
import asyncio


async def main():
    await BotFactory(first_node=first_node).start("telegram")


if __name__ == "__main__":
    asyncio.run(main())

Методы UserState для нод:

get_request - Получить запрос пользователя. send_message(text:str="", streaming:bool) - отправка сообщения пользователю. Установив значения параметра streaming=True можно создать стриминг токенов пользователю. После стриминга необходимо отправить пустое сообщение со streaming=False

Этими методами можно работать с переменными пользователя: set_value(key:str, value) get_value(key) -> value or False

set_next_node - Указание ноды, которая должна выполниться сразу после завершения этой, не дожидаясь ввода пользователя.

add_button - Добавляет кнопку пользователю. Кнопка - текст, при вводе которого пользователь будет переходить на указанную в методе add_button - ноду. Отображение кнопок реализовано в подходящих интерфейсах.

set_input_field - Указывает, в какую ноду передать пользователя, если его ввод отличен от кнопок.

Пример ноды:

from single_bot.user_state import UserState

async def first_node(state:UserState):
	user_message = state.get_request()["text"]
	for letter in user_message:
		state.send_message(letter, streaming=True)
	state.send_message() # Для завершения стриминга
	state.set_input_field(second_node) # при любом вводе от пользователя, он отправиться в second_node

Особенности нод:

• В ноде обязательно следует указывать input_field. Отсутствие приведёт к ошибкам.
• На данный момент отсутсвует какая либо проверка нод. Ошибки в нодах приведут к выводу из строя всего бота. Также ошибки в нодах почему то не всегда выдают ошибки в консоль. Бот просто останавливается.
• Связи между нодами не проверяются. Убедитесь в том, что все ноды перетекают в другие ноды при любом вводе пользователя.

На данный момент есть только поддержка telegram и cmd. Однако добавить другие мессенджеры по аналоги в дальнейшем не составит труда.

***Буду рад любой помощи с проектом. ***

Что нужно добавить:

• Тесты
• Логику авторизации, подтверждения, фильтрации пользователей мессенджеров.
• Логику ответа и стриминга включающую файлы.
• Мессенджеров.
• Логику приведения одного человека с различных мессенджеров к одному UserState.
• Обработку ошибок в нодах. Проверку связности.