vocion-core

Vocion (@vocion/core) представляет собой открытый фреймворк для запуска ИИ-агентов в промышленной эксплуатации, а не только для прототипирования. В README целевой пользователь описывается как инженер или техлид, переводящий команду агентов в продакшен. Явно указано, в каких случаях проект не подходит: для одного чат-бота, разового скрипта или облачного no-code конструктора. Предполагается, что вы используете Postgres, храните конфигурацию в git и хотите иметь возможность человеческого контроля над важными действиями. Основной пакет не опубликован в npm; вы клонируете репозиторий и запускаете его самостоятельно. Что объединяет платформа Vocion описывается как приложение Next.js плюс схема Postgres плюс MCP-сервер плюс исполнитель рабочих процессов (workflow runner). Вы создаете Sources, Objects, Skills, Playbooks, Workflows, Missions, Automations, Agents и Teams в виде YAML и markdown в git, применяете их к базе данных и получаете типизированную среду выполнения с единой очередью проверки человеком, наблюдаемостью и экосистемой плагинов. Три режима работы используют одну среду выполнения: - Workflows: детерминированные шаги с гейтами одобрения и запроса. - Missions: открытые постоянные обязанности, где команда агентов планирует, работает и создает артефакты, подлежащие проверке. - Teams: несколько агентов, сгруппированных под руководством лида с ответственным человеком. Другие заявленные возможности включают встроенный пакет коннекторов для Google Ads, GA4, HubSpot, Gmail, Slack и Google Drive с инкрементальным конвейером загрузки в разрезе клиентов; многопользовательскую панель управления с Bearer-токенами тенантов, которые разрешаются в субъект разрешений; write API, предоставляющий доступ к очереди проверки через REST (эндпоинты листинга и принятия решений); и MCP через HTTP в качестве плоскости агентов и инструментов. Разрешения на обнаружение и изменение разделены, исполнение регулируется «лестницей автономности» с гейтами одобрения, а изоляция между клиентами обеспечивается на уровне запросов, а не через промпты. Выполнение агентов настраивается через одну настройку: harness.runsOn. Документированные варианты: запуск цикла агента внутри процесса приложения, в собственном контейнере проекта на AWS Bedrock AgentCore Runtime или передача в управляемый harness от AWS; документация поясняет, какой аккаунт AWS оплачивает токены в каждом случае. Слоистые пакеты и контракт плагинов Репозиторий является основным слоем более крупной платформы. Пакет SDK определяет стабильный контракт плагина, включая типы Skill и PluginManifest, а также типы клиентов LLM. Коннекторы и навыки поставляются как отдельные npm-пакеты плагинов; также планируется создание форкабельного стартового установщика в отдельном репозитории. Плагин — это npm-пакет, экспортирующий манифест; core загружает манифесты при запуске через SDK. В README показан пример определения навыка, созданного с помощью библиотеки валидации схем, где объявляются slug, имя, версия, провайдер, требование одобрения, схемы ввода и вывода, а также функция run, экспортируемая как PluginManifest. Пример плагина transcript-highlights находится в директории packages/plugins. Рабочее пространство как код Весь контекст тенанта живет в рабочем пространстве (workspace): отслеживаемой в git директории с YAML и markdown, находящейся вне чекаута репозитория (обычно в собственном репо), чтобы контекст клиента можно было проверять в pull-запросах и он не смешивался с core. Переменная окружения указывает приложению на него; без нее рабочее пространство не настроено. Документированные типы сущностей и их расположение включают: манифест рабочего пространства, агентов (YAML-файл плюс markdown-файл системного промпта), команды, навыки, плейбуки, миссии, запуски рабочих процессов, созданные через API, рабочие процессы, автоматизации (единственное место, где живут время и события), типы объектов с весами источников и промптом классификации, источники с типом коннектора и частотой синхронизации, правила доверия для автовыполнения действий, шаги обучения как именованные корзины накопленных правил, наборы данных eval для тест-кейсов каждого агента и определенные тенантом страницы дашборда. Базовый пакет поставляется внутри core и располагается под рабочим пространством: вы привязываете его директивой extends, активируете агентов списком use и переопределяете значения по умолчанию файлами с тем же slug. Применение рабочего пространства к базе данных записывает строку аудита с версией workspace, а вызовы инструментов штампуют хэш рабочего пространства, чтобы результаты можно было отследить до промптов, которые их создали. Настройка и эксплуатация Начало работы описывается как клонирование и установка, копирование примера файла окружения и установка URL базы данных, секрета аутентификации и хотя бы одного ключа провайдера LLM, запуск вспомогательных сервисов скриптом dev:up (Postgres, Langfuse, Temporal), выполнение миграций, создание структуры рабочего пространства, указание WORKSPACE_PATH на него, применение и запуск dev-сервера на localhost:3000. Скрипты проекта также охватывают линтинг, проверку типов, тесты, применение рабочего пространства и запуски оценки. Для MCP-клиентов, таких как Claude Code, Cursor или Zed, предусмотрена локальная команда stdio для установки одним разработчиком, а также удаленный HTTP-эндпоинт, где организация определяется по Bearer-токену тенанта, и каждый вызов инструмента ограничен этой организацией в рамках той же модели разрешений, что и для человека. Учетные данные обрабатываются в обоих направлениях и управляются со страницы дашборда. Входящие токены выпускаются Vocion, хранятся только в виде SHA-256 хэша и показываются в открытом виде один раз. Исходящие ключи вендоров могут предоставляться для каждого рабочего пространства, шифроваться в покое с помощью AES-256-GCM под ключом шифрования данных организации, чтобы оплата шла с аккаунта вендора самого рабочего пространства; один активный ключ на платформу для одной организации. Каждый исходящий вызов вендора сначала разрешает сохраненный ключ рабочего пространства, а затем переменную окружения сервера, что охватывает чат-модели, эмбеддинги при загрузке и запросе, переранжирование, зрение и генерацию изображений (два внутренних пути по дизайну остаются на ключе сервера). Конфигурация шифрования предлагает локальный режим vault для разработки и режим KMS, рекомендуемый для установок с реальными ключами клиентов. Поиск (Retrieval) является встроенным: pgvector с HNSW cosine плюс полнотекстовый поиск Postgres, объединенные с помощью reciprocal rank fusion, с опциональным переранжированием через LLM. Модели эмбеддингов и переранжирования являются настройками уровня окружения, в то время как веса поиска для каждого типа и агента задаются в рабочем пространстве без изменения кода. Стек и интеграции Заявленный стек: Next.js 16 с App Router, React 19 и строгий TypeScript, PostgreSQL 16 с ORM, Auth.js / NextAuth v5 для многопользовательской среды с ролевым доступом через членство в аккаунте и проекте, OpenAI и Anthropic в качестве взаимозаменяемых провайдеров LLM для каждого навыка, Langfuse для трассировки LLM и OpenTelemetry для спанов и метрик, встроенный в процесс исполнитель устойчивых шагов рабочего процесса на Postgres, интерфейсы чата Slack, где упоминание агента создает ветку ответов (при этом очередь проверки остается единственным местом одобрения, доступно за feature-флагом), и внешний контроллер воркеров для многочасовых запусков с лизами, хартбитами, стоимостью за запуск и «жнецом» (также за feature-флагом). Лицензия Проект доступен по лицензии Mozilla Public License 2.0, которая одобрена OSI и предусматривает copyleft на уровне файлов: вы можете использовать, селф-хостить, изучать, модифицировать и встраивать его в более крупную проприетарную систему; при этом модифицированные файлы Vocion остаются открытыми под MPL при распространении, в то время как окружающий код приложения остается вашим. В README указано, что данные, бизнес-контекст, конфигурации агентов, рабочие процессы, история оценки и операционные результаты остаются вашими, и проект можно развернуть в собственной среде. Определенные виды использования, такие как white-labelling самого Vocion, его распространение под проприетарной лицензией, создание управляемого сервиса с поддержкой вендора, проприетарные корпоративные модули или коммерческие гарантии и уровни обслуживания, требуют отдельного соглашения. Название и логотипы являются товарными знаками Metacto, Inc., и MPL не предоставляет прав на товарные знаки. Указатели на документацию В README есть ссылки на руководство по началу работы (от пустой директории до работающей команды агентов без написания кода), файл для агентов по кодингу, работающих в репозитории, машиночитаемый индекс документации, руководство по созданию рабочего пространства, справочники по полям сущностей, страницу модели объектов (где каждый объект создается, хранится, исполняется и отображается), руководство по страницам дашборда и документацию по развертыванию для различных сред и паттерна родительского проекта. Руководство по контрибьютингу охватывает conventional commits, подтверждение DCO, а также запуск проверки типов, тестов и линтинга перед коммитом.