Portable Agent Platform

Открытая платформа переносимого персонального AI-агента. Пользователь формулирует намерение голосом или текстом, проверяет детерминированное действие в независимом от канала виджете и безопасно выполняет его через MCP-инструменты.

Это отдельный продукт, не связанный с существующим репозиторием planner.

Назначение репозитория

Этот репозиторий — управляющий слой платформы: архитектура, межсервисные контракты, каталог сервисов, документация разработчика, GitOps-конфигурация и общие инженерные стандарты. Каждый deployable-сервис находится в собственной GitHub-репе, владеет своими данными и имеет независимый pipeline.

Это намеренно не монорепозиторий: здесь нет модулей реализации сервисов.

Созданные репозитории

• .github — общие шаблоны и CI/CD.
• platform — архитектура и общая документация.
• contracts — OpenAPI, AsyncAPI и JSON Schema.
• action-service — каркас Java-сервиса действий.
• agent-runtime — каркас Python-сервиса агента.
• deploy — Helm charts и проверка установки в k3d.
• infra — OpenTofu modules и тесты инфраструктуры.
• test-lab — системные, нагрузочные и resilience-тесты.
• calendar-mcp — MCP-сервис календаря с fake-провайдером.
• mcp-gateway — безопасная маршрутизация вызовов MCP.
• channel-gateway — единый вход Web, Telegram и других каналов.

Первый backend-срез уже проверен: русский текст превращается в предложение, после явного подтверждения проходит через Temporal и создаёт событие в Fake Calendar. Входные каналы, виджеты и реальный календарь ещё не реализованы.

Первый вертикальный срез

Telegram voice -> STT -> Conversation -> Agent -> Proposed action
               -> Policy -> Confirmation widget -> Durable workflow
               -> MCP Gateway -> Calendar -> Result + audit trail

Архитектура

• Архитектура платформы
• Последовательность выполнения действия
• Технологическая стратегия
• Tech radar
• Модель репозиториев и организации
• Платформа разработчика
• Правила разработки
• Диагностика документации
• Каталог сервисов
• Дорожная карта поставки
• Пошаговый план инженерных работ
• План MVP: месяц, полгода и год
• Текущее состояние по репозиториям
• Полигон тестирования и масштабирования
• Записи архитектурных решений

Открытый проект

Portable Agent Platform распространяется по лицензии Apache License 2.0. Перед участием ознакомьтесь с правилами внесения изменений, моделью управления, кодексом поведения и политикой безопасности.