botruntime

Облачная платформа для разработки, деплоя и эксплуатации ботов на TypeScript.

botruntime — облачная платформа для ботов и AI-агентов. Вы храните поведение бота в TypeScript-проекте, проверяете его как обычный код и деплоите через brt. Платформа запускает бандл, доставляет события и хранит рабочие данные.

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

Быстрый старт

Создайте проект, запустите dev-бота и выполните первый deploy.

Проект бота

Разберитесь со структурой проекта и примитивами runtime.

CLI

Изучите dev, production targets и команды brt.

API Reference

Откройте сгенерированный справочник HTTP API.

Что предоставляет платформа

Возможность	Назначение
Conversations	Обработка сообщений и событий из подключённых каналов.
Agent loop	Вызов модели, инструментов и кода внутри одного хода.
Workflows	Долгие процессы с шагами, паузами, таймерами и повторной доставкой.
Tables and state	Данные бота без отдельного сервиса хранения.
Files and knowledge	Файлы, поиск и источники для RAG.
Integrations	Подключение мессенджеров, CRM и внешних API отдельными бандлами.
Observability	Диалоги, события, логи, трейсы, evals и метрики в консоли.

Как работает бот

Минимальный проект содержит конфигурацию и один обработчик:

package.json

agent.config.ts

src/conversations/index.ts

import { Conversation } from '@holocronlab/botruntime-runtime'

export default new Conversation({
  channel: '*',
  handler: async ({ execute }) => {
    await execute({
      instructions: 'Помогай пользователю найти заказ. Отвечай кратко.',
    })
  },
})

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

Цены, лимиты, права доступа и другие точные значения вычисляйте кодом. Модель может объяснить результат, но не должна быть его источником.

Путь от кода до production

brt check
brt dev
brt deploy --adk --name "support-bot"

brt dev использует отдельный dev target и направляет события к локальному процессу. brt deploy --adk собирает бандл и обновляет production target. Настройки, секреты и интеграции этих окружений не смешиваются.