Перейти к содержанию

FAQ

Частые вопросы о запуске, провайдерах, правах и доступе. Если ответа нет — см. Диагностика.

Общее

Что такое Synth?

Synth — AI-платформа для командной работы. Люди и LLM-агенты работают в одной среде: человек задаёт направление, агент выполняет работу с файлами, shell и git. Всё — в едином веб-интерфейсе, с общей историей и аудитом. Подробнее — Что такое Synth.

Чем Synth отличается от обычного чата с LLM?

Обычный чат только отвечает текстом. Synth даёт агенту инструменты: он читает и изменяет файлы, запускает команды, работает с git, ведёт план проекта и todo сессии. Плюс роли и права, общая история на сервере, аудит запросов и режимы, в которых агент спрашивает подтверждение перед действиями.

Нужен ли интернет?

Не обязателен. С локальными моделями (например, через Ollama) можно работать полностью без внешних сервисов. Интернет нужен, только если вы подключаете облачного провайдера или корпоративный сервер.

Установка и запуск

Можно ли работать локально, без сервера и Keycloak?

Да. Команда synth serve поднимает локальный сервер и интерфейс на одной машине — без бэкенда, Keycloak и Kubernetes. Рабочий каталог, история и настройки остаются у вас. Подробнее — Локальный запуск.

Как подключить свою модель?

Добавьте провайдера: через веб-интерфейс в разделе «Провайдеры» или командой synth config provider add. Поддерживаются Ollama, OpenAI-совместимые и Anthropic-совместимые API. Подробнее — Провайдеры и модели.

Как обновить версию?

Проверить и установить новую версию можно прямо из CLI:

synth update --check     # что доступно (ничего не ставится)
synth update --apply     # установить найденную версию
npm install -g @itphx/synth@latest
docker pull git.itphx.ru/itphx/synth:0.13.10

Тег latest не публикуется — фиксируйте конкретную версию в теге (в примере — :0.13.10).

В интерфейсе, установленном как приложение, появится баннер обновления — подтвердите его. Подробнее — Мобильный интерфейс и PWA.

Если инстанс работает как сервис, после установки новой версии выполните synth service restart. Подробнее — Обслуживание.

Как переключить канал обновлений на беты и обратно?

Канал выбирается флагом --channel или задаётся в конфигурации (секция updates).

synth update --channel beta --check   # что доступно в бета-канале
synth update --channel beta --apply   # поставить бету
synth update --channel stable --apply # вернуться на стабильную линию

Переход с беты на стабильную версию — это понижение версии, поэтому он требует подтверждения. Данные при этом не откатываются. По умолчанию канал выводится из установленной версии (auto), а автопроверка обновлений выключена — инстанс не ходит в реестры без явного согласия.

Данные и безопасность

Где хранятся ключи провайдеров?

В командном режиме ключи провайдеров хранятся только на сервере и не попадают к клиентам. В локальном режиме ключи остаются в вашем каталоге данных. Ключ доступа к самому Synth вводится в интерфейсе или передаётся команде при запуске. Подробнее — Безопасность.

Куда попадает история переписки?

Сессии и сообщения хранятся на сервере (в локальном режиме — на вашей машине), а не в браузере. Поэтому историю видно с другого устройства после входа, а несколько пользователей могут работать в одной сессии. Подробнее — Сессии и проекты.

Что уходит в LLM и что маскируется?

В модель уходит контекст сессии: ваши сообщения и необходимые фрагменты файлов проекта. LLM Gateway скрывает секреты (токены, ключи, пароли) до отправки, ограничивает частоту запросов и пишет журнал аудита — кто, когда и какую модель вызывал. Подробнее — Безопасность.

Возможности

Как добавить скилл?

Скиллы описываются в файлах SKILL.md и подключаются на уровне инстанса, проекта или сессии. Готовые скиллы можно включать и отключать в настройках, а команды вызывать через / в поле ввода. Подробнее — Скиллы и команды.

Есть ли мобильное приложение?

Отдельного приложения в магазинах нет. Интерфейс Synth адаптирован под телефоны и планшеты, а установить его можно как приложение (PWA) прямо из браузера. Подробнее — Мобильный интерфейс и PWA.

О проекте

Где исходный код и под какой лицензией?

Репозиторий — gitverse.ru/itphx/synth. Лицензия — MIT: код можно свободно использовать, изменять и распространять. Юридическую силу имеет английский текст лицензии в репозитории.

Что дальше