Как устроен DevMachine

DevMachine состоит из двух частей: приложения DevMachine ADE у вас на компьютере и сервера DevMachine. Агент работает в приложении, рядом с проектом. Сервер отвечает за вход, лимит и доступ к языковым моделям — нейросетям, которые пишут ответы агента. Разберём, что где происходит, — тогда станет понятно, что видит модель, а что остаётся у вас.

#Схема

Ваш компьютер
  DevMachine ADE
  ├─ агент: читает и правит файлы, запускает команды, работает с git
  ├─ проект, терминал, подключения к базам, кластерам и очередям
  └─ чаты, журнал действий, настройки безопасности
        │
        │  запрос к модели: ваше сообщение и то, что агент прочитал для задачи
        ▼
Сервер DevMachine
  ├─ вход, тариф, лимит и оплата
  ├─ ключи к моделям (на вашем компьютере их нет)
  └─ веб-поиск, распознавание голоса, генерация картинок
        │
        ▼
Поставщик модели  →  ответ возвращается тем же путём

#Что работает на вашем компьютере

• Приложение и агент. Всё, что нужно агенту, входит в одну установку: отдельно ставить ничего не надо. Приложение есть для macOS, Windows и Linux (см. Установка и обновления).
• Работа с проектом. Агент читает и правит файлы в папке проекта, запускает команды, собирает проект, гоняет тесты и работает с git. Всё это он делает у вас на компьютере, с правами вашей учётной записи.
• Подключения. Базы данных, кластеры Kubernetes и брокеры сообщений агент видит через приложение и только на том уровне, который вы разрешили (см. Доступ к базам и кластерам).
• Ваши данные. Чаты, память агента, навыки, журнал действий и настройки безопасности хранятся у вас на компьютере.

По умолчанию агент работает так же, как другие агенты для разработки: без песочницы, с доступом ко всему диску и к интернету. Песочница — средство операционной системы: она не даёт командам агента писать вне разрешённых папок и ходить в сеть мимо списка адресов. Ключи и пароли в домашней папке, например SSH-ключи и доступы к облакам, по умолчанию закрыты для него во всех режимах. Их можно открыть в настройках, и тогда каждое обращение агента к ним попадёт в журнал. Файлы .env с паролями и ключами проекта агент открывает только с вашего разрешения. Как ограничить агента сильнее — на странице Ограничения агента.

#Что идёт через сервер DevMachine

• Каждый запрос к модели. В запросе — ваше сообщение и контекст задачи: файлы, которые прочитал агент, вывод команд, вложения. Ключи поставщиков моделей хранятся только на сервере, поэтому подключить свой API-ключ нельзя, а без входа в аккаунт агент не работает.
• Веб-поиск, голос и картинки. Поиск в интернете, распознавание голоса при диктовке и генерация изображений тоже идут через сервер и тратят лимит подписки.
• Аккаунт. Вход, тариф, расход лимита и оплата.
• Политика организации, если вы работаете в организации.

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

#Что хранится на сервере

Коротко: данные аккаунта и учёт расхода, запросы к модели и её ответы (учётные данные в них маскируются перед записью), отчёты об ошибках, если вы их отправили, и копия истории чатов в облачной версии. Облачная версия — это обычная работа через сервер DevMachine, в отличие от своего контура компании (о нём ниже). Весь проект на сервер не попадает: туда уходит только то, что агент прочитал для задачи. Подробно — на странице Данные и приватность.

#Если сервер не отвечает

Приложение продолжает работать. Внизу слева появляется карточка «Сервер не отвечает»: «Чаты, файлы и git работают как обычно. Агент ответит, когда связь вернётся — проверяем каждые 15 с.» Чтобы проверить связь сразу, нажмите «Проверить сейчас». Если мешает VPN, карточка подскажет, что делать (см. Если что-то не работает).

#Проект на сервере по SSH

Этот раздел нужен, только если проект лежит на вашем Linux-сервере, отдельном от сервера DevMachine. Тогда окно приложения остаётся у вас на компьютере, а проект и агент — на этом сервере. Приложение подключается к нему по SSH (так входят на удалённый компьютер), само ставит и запускает там агента. Агент читает файлы и выполняет команды там же, на сервере, и оттуда же отправляет запросы к модели через сервер DevMachine. Поэтому Linux-серверу нужен выход в интернет. Как подключить — на странице Проект на сервере.

#Доступ с телефона

С телефона можно следить за сессиями этого компьютера и отвечать агенту. По умолчанию функция выключена. Телефон подключается через ваш собственный туннель или через сервер DevMachine (в настройках — «Через DevMachine»), который только пересылает запросы и ничего не хранит. Файлы и терминал с телефона недоступны. Опасные действия, которые вы подтверждаете при каждом вызове, можно разрешить только за компьютером. Подробно — на странице Доступ с телефона.

#Организации

Команда может работать и платить по одной подписке. Владелец и администраторы организации управляют участниками в веб-кабинете и задают «Политику агента»: что агенту можно делать на компьютерах сотрудников. Приложение само получает эту политику с сервера. Подробно — на странице Организации.

#Для компаний: свой контур

Компания может поставить сервер DevMachine в своей инфраструктуре, вплоть до сети без интернета. Тогда и запросы к моделям идут через прокси внутри контура, а модель можно взять свою. На рабочих местах стоит то же приложение. Об этом варианте — на странице Для компаний и на сайте в разделе DevMachine для бизнеса.

#Что дальше

• Данные и приватность — что именно уходит с компьютера и что хранится на сервере.
• Обзор безопасности — как приложение держит агента в рамках.
• Установка и обновления — как поставить приложение.
• Быстрый старт — первая задача агенту.