Возможности¶
Synth объединяет то, что обычно размазано по десяткам сессий терминала и личных подписок: ключи, модели, разрешения, контекст и аудит — в одном месте. Ниже — возможности по областям и планы развития.
Централизация¶
- Единый сервер-хаб. Весь трафик идёт через один сервер: ключи провайдеров, модели и журналы хранятся только на нём.
- Общая история. История и состояние сессий живут на сервере: перезапуск и переподключение не теряют контекст.
- Stateless-движки. Движок получает историю, новое сообщение и контекст — поэтому движок можно менять, не теряя диалог.
Коллаборация¶
- Люди и агенты вместе. Несколько пользователей и агентов работают в одной сессии с общим контекстом.
- План и задачи. План проекта с приоритетами и зависимостями, todo — в сессии; состояние меняется инструментами.
- Очередь сообщений. Доставка сообщений по одному, совместная работа без гонок.
Доступ к проекту¶
- Владелец и участники. У проекта есть автор и участники с ролями: просмотр, изменение содержимого, владелец.
- Чтение не равно праву менять. Роль просмотра открывает всё содержимое, включая историю сессий, но не даёт ни отправить сообщение, ни поправить файл.
- Группы и «доступ всем». Участников добавляют по одному или группами из OIDC; проект можно открыть всем пользователям инстанса с выбранной ролью.
- Передача владения. Владение передаёт автор или администратор; прежний владелец сохраняет доступ к содержимому.
- Права не переезжают. При импорте, экспорте, копировании и форке состав участников не переносится: новая копия создаётся «только автором».
Подробнее — Сессии и проекты.
Безопасность¶
- LLM Gateway. Единый слой для всех LLM-вызовов: обфускация секретов, ограничение частоты запросов, JSONL-аудит.
- Аудит. Каждый запрос логируется: кто, когда, какая модель, сколько токенов.
- Гранулярные права. Правила
allow/deny/askна уровне инструментов и паттернов команд; опасные действия требуют подтверждения. - Понятные подтверждения. Полоса показывает, какой участок команды или пути вызвал вопрос; разрешение можно выдать каталогом — запреты при этом не отменяются, а выданный грант попадает в аудит.
- Устойчивость к перезапуску. Ожидание подтверждения переживает перезапуск инстанса: вопрос не задаётся заново.
- Роли и вход. Встроенные роли ADMIN / USER / LEAD / AUDITOR, OIDC (Keycloak) и API-ключи.
- Режимы сессии. Plan / Act / YOLO и настраиваемая строгость цикла «план → реализация».
- Защита от prompt injection. Результаты инструментов — файлы, веб, shell,
MCP, терминал — считаются недоверенными: они помечаются и оборачиваются, а
подозрительный текст ищется по словарю. Режимы:
flag(пометить),sanitize(заменить совпадения) иblock(не отдавать модели). Подделка служебных маркеров экранируется и не закрывает блок досрочно. Включено по умолчанию, настройка — в разделе «Безопасность».
Подробнее — Безопасность.
Внешние доступы¶
- Доступ — сохранённая авторизация. OAuth-вход во внешний сервис по коду авторизации (PKCE) или по коду устройства; Synth сам подставляет токен в транспорт MCP-коннектора, а агент и модель токена не видят.
- Секрет не отдаётся. В интерфейсе видна только маска; доступ можно переавторизовать, привязать к коннектору или отозвать — отзыв необратим.
- Без открытого текста. Заголовки авторизации в MCP-коннекторе запрещены: только через сохранённый доступ.
Подробнее — Внешние доступы.
Полномочия¶
- Грант вместо флага. Право выражается парой «действие × цель» с эффектом «Разрешить», «Спросить» или «Запретить»; нет гранта — нет права.
- Только сужение. Слой полномочий стоит над правами инструментов и не расширяет их; «Спросить» не снимается режимом YOLO.
- Режимы. Выключен, «только журнал» (решение считается и пишется, но не применяется) и принуждение; включается конфигом, раздел «Полномочия» — только для чтения.
Подробнее — Полномочия.
Контекст и оптимизация¶
- Режимы контекста саб-агентов.
inherit/summary/none/last_n— баланс токенов и полноты контекста. - Ветвление сессий. Наследование контекста и межсессионное слияние.
- Сжатие контекста. История сворачивается в краткое резюме: суть сохраняется. Сжатие срабатывает и на границе шага — длинный ход не переполняет окно.
- Капы поиска и чтения. Строка совпадения и вывод инструмента ограничены, а поиск не заходит в зависимости и артефакты сборки: один запрос не «заливает» контекст сессии.
- Быстрые ответы. Мгновенные ответы на простые запросы без вызова большой модели — 0 токенов.
- Маршрутизация. Автоматический выбор модели по контенту и стоимости, контроль качества с эскалацией на fallback-модель.
События и автоматизация¶
- Приём внешних событий. Внешние системы — сервисы, чаты, планировщик — публикуют события в Synth; на событие отвечает сессия.
- Привязки источник → сессия. Чат, канал или внешний сервис закрепляется за сессией или проектом; есть режимы работы с разными сценариями (постоянная сессия, временная, очередь).
- Правила маршрутизации. Декларативные правила решают, куда направить событие; каждое решение попадает в журнал и объяснимо.
- Идентичности и права. Внешний отправитель сопоставляется с профилем; его права только сужаются, а несопознанный отправитель не получает прав Synth.
Подробнее — События и автоматизация.
Расписания¶
- Запуск по расписанию. Cron-выражение (пять полей, UTC) или интервал запускает задание в нужную сессию.
- История и контроль. История срабатываний, догон пропущенного запуска после простоя и принудительный запуск вручную.
Подробнее — Расписания.
Таймеры и будильники¶
- Вернуться позже без
sleep. Таймер — отсчёт «через N», будильник — конкретное время или ежедневный повтор; срабатывание приходит сообщением в сессию. - Комментарий — единственный смысл. Своего текста задания у таймера нет: агент понимает, зачем его разбудили, по комментарию и истории.
- Только в проекте. Таймер всегда привязан к проекту и сессии; до 50 активных на сессию, дубликаты отклоняются, а время в прошлом — ошибка.
- Управление и история. Пауза, продолжение, остановка и удаление; история срабатываний с опозданием и исходом; значки активных таймеров в дереве сессий.
Подробнее — Таймеры и будильники.
Пайплайны (preview)¶
- Многошаговый сценарий. Пайплайн — спецификация из шагов и переходов между ними; шаг бывает агентский, скриптовый, с инструментом или с человеком.
- Версии. Черновик правится свободно, прогон идёт только по опубликованной версии; у пайплайна не больше одного активного прогона.
- Прогон и журнал. Запуск в фоне, журнал по шагам, подтверждение человека с комментарием, отмена и артефакты прогона.
- Шаблоны и расписания. Шаблоны инстанса копируются в проект как черновик, а в расписаниях появилась цель «Пайплайн» — запуск по cron без создания сессии.
Preview
Пайплайны работают, но находятся в статусе preview: формат спецификации, набор шагов и экраны могут меняться между релизами.
Подробнее — Пайплайны.
Память агентов¶
- Память как расширение. Факты о проекте с источником и семантический поиск
по документам — в расширении «Память»; портал памяти и CLI
synth memoryработают в ядре. - Индексы с областью. Индекс в области проекта (виден только проекту) или общий индекс инстанса (виден всем пользователям).
- Прозрачность. Модель эмбеддингов, состояние индекса и пересборка — в админке; исключения секретов и предупреждение об отсутствии обфускации.
Подробнее — Память агентов.
Фоновая работа¶
- Фоновые саб-агенты и процессы. Саб-агент работает в отдельной дочерней сессии, шелл-команда — в фоне с логом в файл; диалог при этом свободен.
- Вкладка «Процессы». Единый реестр: фильтр по виду, тумблер «Только текущая сессия», остановка, удаление, открытие дочерней сессии и просмотр лога.
- Перевод в фон. У идущего прогона есть кнопка «В фон», а
ctrl+bпереводит в фон все блокирующие прогоны активной сессии; перевод односторонний. - Лимиты. На сессию — два саб-агента и пять процессов, до десяти записей в реестре, вложенность — один уровень, лог — до 10 МиБ.
Подробнее — Фоновая работа.
Терминал¶
- Настоящая оболочка в интерфейсе. Интерактивный терминал (PTY) в рабочем
каталоге проекта, отдельной вкладкой: ввод, история, полноэкранные программы,
sshиtmux. - Экран вместо потока. Для
htop,vimи редакторов агент снимает видимый экран — то, что видит человек, — вместо километров перерисовок. - В модель — только по кнопке. «Прикрепить вывод» вставляет блок в черновик сообщения, «Спросить агента» отправляет вопрос с выводом отдельным контекстом. Автоматически вывод терминала в модель не уходит.
- Лимиты и живучесть. Восемь живых терминалов на проект и 32 на инстанс, простой по умолчанию два дня; после перезапуска терминал восстанавливается из снимка, а завершённый можно перезапустить с сохранением истории.
Подробнее — Встроенный терминал.
Рабочие копии репозитория¶
- Своя копия на сессию. Git worktree даёт сессии отдельный рабочий каталог: сессия работает в своей копии, остальные — в каталоге проекта.
- Инвентарь и выбор. Раздел «Worktree'ы» во вкладке «Проект», селектор рабочего каталога во вкладке «Сессия» и бейдж привязки в шапке.
- Осторожное удаление. Копию, занятую живой сессией, удалить нельзя; грязная копия требует второго подтверждения.
- Общий репозиторий. У копий общий
.git: ветки, хуки и stash одни на проект; ignored-файлы (например,.env) в новую копию не попадают — нужен скрипт подготовки проекта.
Подробнее — Рабочие копии репозитория.
Мультимодальный ввод¶
- Что можно приложить. Изображения, PDF, аудио и видео: прикрепление, drag&drop, вставка из буфера, превью и повтор при ошибке загрузки.
- Три пути доставки. Нативно, через вспомогательную модель по модальности
(в диалог идёт текст) или с отбросом файла в
attachments/рабочего каталога — тогда агент видит путь к файлу. - Лимиты. По умолчанию 25 МиБ на файл, 10 файлов в сообщении и 1 ГиБ на сессию; лимиты, модальности и модели по модальностям настраиваются в админке и применяются сразу.
- Приватность. Метаданные срезаются только при отправке провайдеру, модель
сессии не меняется, а для аудио и кадров видео нужен
ffmpeg.
Подробнее — Мультимодальный ввод.
Публичный API и интеграции¶
- Service-ключи. Ключи инстанса для внешних сервисов: ограниченный набор прав (scopes) и проекция на разрешённые проекты.
- OpenAPI и SDK. Публичный OpenAPI-контракт и типизированный клиент для интеграций.
- Исходящие webhooks. Подписки на события Synth с подписью запросов, повторами при сбое и журналом доставок.
Подробнее — Публичный API и интеграции.
Decision-модели¶
- Быстрый decision-слой. Компактная decision-модель обслуживает микро-классификацию, быстрые ответы и маршрутизацию — дёшево и без вызова большой модели.
- Эскалация. При низкой уверенности запрос уходит на вторую пару провайдер/модель (тир эскалации), а не сразу к пользователю.
Подробнее — Decision-модели.
Интеграции с мессенджерами (Telegram)¶
- Общение из чата. Telegram-бот принимает сообщения и отвечает стримингом прямо в чате; доступны команды привязки чата к сессии и остановки ответа.
- Несколько ботов. Один шлюз обслуживает несколько ботов, каждый — со своей средой Synth.
Подробнее — Интеграция с Telegram.
Провайдеры¶
- OpenAI-совместимые — OpenAI, LM-Studio, vLLM, Together, Groq и другие.
- Anthropic-совместимые — Claude и совместимые сервисы.
- Ollama — локальные и бесплатные модели в полностью приватном контуре.
Настройка — через переменные окружения, CLI или интерфейс. Подробнее — Провайдеры и модели.
Исполнение: профили и пулы¶
- Где идут команды. Режим
inlineисполняет команды в процессе сервера,remote— в отдельных исполнителях; переключается конфигурацией и проверяется при старте, тихого отката нет. - Профили и пулы. Профиль задаёт адрес, таймаут, конкурентность и облик исполнителя; пул бывает общим на инстанс, на проект или на сессию. Профиль наследуется: сессия → агент → проект → профиль по умолчанию, а списки разрешённых профилей служат потолком.
- Изолированный исполнитель. Отдельный образ без root, с read-only корнем и
сетевым классом (
none/restricted/full); инструменты и терминал живут там же, где идут команды. - Песочница. Разовый запуск в профиле класса «sandbox»: другой образ и отдельный пул — не тот, где идут обычные команды области.
- Браузер. Браузерные инструменты обслуживает свой профиль с Chromium/Playwright; в браузерном профиле терминала нет.
Подробнее — Исполнение: профили и пулы.
Развёртывание¶
- Локально — одна команда
synth serve, без бэкенда, Keycloak и Kubernetes. - Сервис с автозапуском —
synth service installподнимает инстанс как сервис systemd пользователя: стартует вместе с машиной, переживает выход из сессии и поднимается заново после сбоя. - Обновления по каналам —
synth update --checkпоказывает доступную версию,--channel stable|betaвыбирает канал,--applyустанавливает. Автопроверка выключена по умолчанию. - Docker — готовый образ и
docker compose. - Kubernetes / Helm — публикуемый Helm-чарт для командной работы.
- Гибридный режим. Локальный core подключается к корпоративному серверу: один UI объединяет локальные и удалённые проекты, LLM-запросы идут через сервер.
Самопомощь инстанса¶
- Инстанс из чата. Команда
/instanceи инструментыsynth_*позволяют агенту самому разобраться в установке: версия, режим, каталог данных, состояние хранилища. - MCP-реестр из чата. Агент видит список серверов, статус и причину неактивности, может добавить, включить или переподключить сервер — без обращения к API вручную.
- Проекты и сессии. Агент видит список проектов и сессий и может открыть проект или присоединиться к нему.
- Секреты не выдаются. В ответах есть адреса и статусы, но не ключи, заголовки авторизации и переменные окружения.
Мобильный доступ¶
- Адаптивный интерфейс для компьютера, планшета и телефона.
- Установка как приложение (PWA), офлайн-заглушка и баннер обновления.
- Touch-first: увеличенные таргеты, дроверы панелей и учёт экранной клавиатуры.
Интерфейс и темы¶
- Дизайн-система. Единые поверхности, типографика, статусные цвета и контраст — во всех темах.
- 62 набора оформления — 31 схема в светлом и тёмном варианте, включая собственные темы Synth.
Подробнее — Дизайн-система и темы.
Скиллы и команды¶
- Скиллы — расширяемые инструкции в формате
SKILL.md, которые агент применяет по запросу. - Slash-команды — быстрый вызов типовых сценариев через
/. - MCP-инструменты — подключаемые инструменты и источники данных через Model Context Protocol, с учётом режимов сессии. Реестр серверов — единый источник истины и в локальном, и в серверном режиме; серверы из конфигурации переносятся в него при старте.
Расширения и плагины¶
- Пакет расширения. Один пакет ставит агентов-роли, скиллы, MCP-серверы и пайплайны одной операцией; новый пакет ждёт подтверждения администратора, а снятие удаляет и поставленные артефакты.
- Плагины. Код расширения добавляет блоки системного промпта, фильтры вызовов к LLM и инструменты агента; инструмент проходит через тот же слой прав, что и встроенный.
- Модель доверия. Уровень доверия (встроенный, проверенный, доверенный, сообщества), статический сканер с карантином и журнал действий плагинов.
- Два раздела. «Аддоны» — пакеты и пайплайны инстанса, «Плагины» — установка, версии, откат, карантин и политика слоя.
Подробнее — Плагины.
В планах¶
Ниже — направления развития. Ближайшая стадия — 0.14: то, что внедряем в первую очередь. Дальше — горизонт после 0.14. Отдельно собрано то, что уже работает сегодня.
0.14 — внедрение¶
- Каталог расширений. Устанавливаемые агенты, скиллы и пайплайны из доверенных источников: каталог, проверка безопасности и управление версиями ( Плагины).
- Мессенджеры. Telegram уже работает; VK, MAX и email — в планах на 0.14, чтобы подключать каналы без отдельной интеграции под каждый сервис ( Telegram).
- Бюджеты и квоты. Лимиты расхода токенов и стоимости на пользователя, проект и сессию — с предупреждениями и остановкой до исчерпания.
- Air-gapped «один артефакт». Поставка закрытого контура одним набором: пакеты, образы, чарты и проверка целостности ( Закрытый контур).
- Память из коробки. Готовая память без ручной сборки индексов: факты, семантический поиск и обслуживание в одном контуре ( Память агентов).
- Пайплайны — стабильный движок. Ветвление и откат шагов, расширенные шаблоны и стабильный формат спецификации вместо preview ( Пайплайны).
После 0.14 — горизонт¶
- HA и надёжность. Несколько реплик без общего файлового состояния, переживание потери узла и предсказуемое восстановление.
- Служебные агенты и консилиум. Независимая проверка результата, оценка по критериям и обсуждение несколькими моделями.
- Расширенная интеграция. MCP-сервер Synth для внешних агентов, обмен между инстансами, ревью-боты для pull request, метрики и аудит.
- Рабочее место в интерфейсе. Встроенные браузер и терминал, просмотр документации и планов без выхода из Synth.
- Канбан. Интерактивная доска, backlog, приоритеты и назначение задач агентам.
- Нативные приложения. Linux, macOS, Windows, Android и iOS в дополнение к вебу и PWA.
- Безопасность и корпоративная сеть. Прокси и TLS уже работают; дальше — DLP, защита журналов и Kerberos через промежуточный шлюз ( Сеть: прокси и TLS).
- Знания и поиск по коду. База знаний проекта, связи между фактами и поиск по репозиторию ( Память агентов).
Уже работает¶
- Telegram — приём сообщений и ответы стримингом в чате ( Интеграция с Telegram).
- Прокси и TLS — именованные профили, правила по хостам, доверенные CA и mTLS для исходящих соединений ( Сеть: прокси и TLS).
- Память — факты с источником, индексы проекта и инстанса, семантический поиск ( Память агентов).
- Пайплайны (preview) — шаги, версии, прогоны и подтверждение человека ( Пайплайны).
- Мультимодальность — изображения, PDF, аудио и видео в сообщении ( Вложения и мультимодальность).
- API, SDK и webhooks — service-ключи, OpenAPI, типизированный клиент и исходящие подписки ( Публичный API и интеграции).
- Офлайн-образы — поставка и развёртывание в закрытом контуре ( Закрытый контур).
- Темы — 62 набора оформления в светлом и тёмном варианте ( Дизайн-система и темы).
Что дальше¶
- Релиз 0.13.10 — что вошло в текущую версию и как обновиться.
- Плагины — пакеты расширений, доверие и журнал действий.
- Быстрый старт — установка и первый запуск.