Coreness — Платформа для автоматизации и AI-решений

Coreness — event-driven платформа для построения автоматизированных workflow через конфигурационные файлы. Логика описывается в YAML, платформа управляет выполнением, хранением данных и интеграциями.

Основные сценарии: разработка ботов (Telegram и др.), автоматизация бизнес-процессов, AI-ассистенты и чат-боты с LLM, scheduled-задачи.

В этой документации — быстрый старт, руководства по сценариям и справочники.

🔧 Для продвинутых пользователей: Расширенная документация — архитектура, плагины

⚡ Оглавление документации

• Начало работы
• Практические примеры сценариев
• Master Bot — Управление тенантами
• Развёртывание
• Руководство по созданию сценариев
• Руководство по конфигурации тенантов
• Руководство по хранилищу атрибутов
• Гайд по действиям системы
• Гайд по событиям системы
• Плейсхолдеры
• Гайд по моделям AI
• Changelog

🚀 Начало работы

📖 Практические примеры сценариев

Сборник примеров: от быстрого старта до сценариев с оплатами и RAG. Есть пошаговое руководство для первого бота, базовые и продвинутые примеры.

Когда использовать: Вы только начинаете, хотите быстро поднять тестового бота или нужен пример под задачу (оплаты, векторное хранилище).

---

🔧 Master Bot — Управление тенантами

Системный бот для управления тенантами (как @BotFather). Через него: выбор тенанта, настройка токенов, Storage, синхронизация с GitHub.

Когда использовать: Нужно управлять всеми тенантами и бота после развёртывания платформы.

---

📖 Полный индекс документации

📋 Руководство по созданию сценариев

Что это: Руководство по созданию сценариев для Telegram-ботов. Плейсхолдеры, переходы, динамическая логика.

Зачем нужно: Команды, меню и обработка сообщений — всё это сценарии. В гайде: от триггеров до сложной логики, с примерами.

Что внутри:

• Структура сценария
• Триггеры (условия запуска сценария)
• Последовательность действий (step)
• Переходы между сценариями (transition)
• Плейсхолдеры: синтаксис, модификаторы, доступные данные
• Практические примеры для разных задач

Когда использовать: При создании новых сценариев или изменении существующих. Это основной гайд для работы с логикой ботов.

---

🔧 Master Bot — Управление тенантами

Что это: Гайд по Master Bot. Выбор тенанта, настройка токенов, Storage, синхронизация с GitHub.

Зачем нужно: Одна точка входа в Telegram для управления всеми тенантами и бота после деплоя.

Когда использовать: Настройка тенантов, конфигураций и Storage.

---

⚙️ Руководство по конфигурации тенантов

Что это: Настройка тенантов (клиентов) и их Telegram-ботов.

Зачем нужно: Добавляете бота или нового тенанта — здесь всё: токен, команды, группы сценариев, папки, синхронизация с репозиторием.

Что внутри:

• Структура конфигурации тенантов
• Типы тенантов (системные и публичные)
• Синхронизация тенантов
• Конфигурация ботов (папка bots/, например bots/telegram.yaml)
• Организация сценариев в папках
• Синхронизация с внешним репозиторием

Когда использовать: При добавлении нового бота или тенанта, изменении конфигурации существующих.

---

💾 Руководство по хранилищу атрибутов

Что это: Работа с хранилищем атрибутов (Storage). Key-value для настроек, лимитов, флагов.

Зачем нужно: Хранить настройки тенанта без правок БД. Новые атрибуты добавляются через конфиг-файлы.

Что внутри:

• Структура хранилища и организация файлов
• Типы значений (строки, числа, булевы)
• Создание и синхронизация атрибутов
• Примеры использования

Когда использовать: При необходимости хранить настройки тенанта, лимиты, флаги функций и другие конфигурационные данные.

---

🎯 Гайд по действиям системы

Что это: Справочник всех действий в системе.

Зачем нужно: Нужно отправить сообщение, удалить его или вызвать AI? Здесь каждое действие и его параметры. Справочник по send_message, delete_message, completion, validate и др.

Что внутри:

• Список всех доступных действий в системе
• Подробное описание параметров (входных и выходных)
• Типы данных и опциональность полей
• Практические примеры использования в YAML-конфигурации

Когда использовать: Всегда, когда создаёте или редактируете сценарии и нужно знать, какие параметры и как передать в действие.

---

📡 Гайд по событиям системы

Что это: Справочник полей в событиях.

Зачем нужно: В плейсхолдерах ({username}, {user_id} и т.д.) подставляются данные из событий. Здесь список полей: user_id, chat_id, текст, вложения, callback-кнопки.

Что внутри:

• Общие поля для всех событий (user_id, chat_id, message_id, username и др.)
• Поля сообщений (event_text, attachment, is_reply, is_forward)
• Поля callback-кнопок (callback_data, callback_id)
• Структура вложений (фото, документы, видео, аудио и др.)
• Примеры использования в плейсхолдерах

Когда использовать: При работе с плейсхолдерами в сценариях, когда нужно получить данные из события.

---

🤖 Гайд по моделям AI

Что это: Справочник моделей AI (Polza.AI) и их параметров.

Зачем нужно: Используете completion и нужно выбрать модель. Здесь модели (OpenAI, Google, Anthropic, DeepSeek и др.), параметры и цены.

Что внутри:

• Список всех доступных моделей по провайдерам
• Поддержка параметров (JSON, Tools, temperature, max_tokens и др.)
• Цены за миллион токенов
• Описание параметров и их назначение

Когда использовать: При настройке AI-сценариев, когда нужно выбрать модель и настроить параметры генерации.

---

🔄 Changelog

Изменения, новые функции, breaking changes и миграции.

Когда использовать: Перед обновлением — проверить, что изменилось и что ломается.

📚 Рекомендуемый порядок изучения

1. Практические примеры — создайте первого бота и изучите примеры
2. Развёртывание — установите платформу (если ещё не развернули)
3. Master Bot — настройте управление тенантами
4. Руководство по сценариям — изучите создание сценариев
5. Гайд по действиям — изучите доступные действия
6. Гайд по событиям — изучите работу с плейсхолдерами
7. Настройка тенантов — настройте бота
8. Хранилище атрибутов — работа с данными
9. Модели AI — настройка AI (опционально)
10. Changelog — последние изменения (опционально)