Внешние агенты

Внешний агент — другая программа, которая ставит задачи агенту DevMachine на этом компьютере. Это может быть ваш личный агент, оркестратор задач или любой клиент, который умеет подключать MCP-серверы. По протоколу MCP программы отдают агенту инструменты. Сервер для внешнего агента — сам DevMachine.

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

Внешний агент подключается только по ключу, который вы выдаёте в приложении. У ключа свои проекты, срок, потолок режима и предел расхода. По умолчанию функция выключена.

#Что нужно

• DevMachine ADE на macOS или на Linux с установленным bubblewrap — песочницей для команд (sudo apt install bubblewrap, см. Ограничения агента). На Windows функция пока не работает.
• Проект на этом компьютере. Проекты на сервере по SSH внешнему агенту недоступны.
• Два включённых пункта в «Настройки → Безопасность агента → Где работает»: «Только папка проекта и выбранные папки» и «Запускать команды агента в песочнице». Без них внешний агент работал бы с вашими правами, поэтому включить функцию нельзя. Они действуют и в ваших чатах: агент пишет только в эти папки, а песочница не даёт командам писать вне них и ходить в сеть мимо списка.

#Как включить

1. Откройте «Настройки → Безопасность агента», вкладку «Где работает».
2. Включите «Только папка проекта и выбранные папки» и «Запускать команды агента в песочнице», затем сохраните.
3. Откройте «Настройки → Внешние агенты» (группа «Безопасность»).
4. Включите «Разрешить внешних агентов».

Под переключателем видно состояние: «Включено», «Запускается», «Не работает» или «Выключено». Если что-то мешает, ниже появится карточка с причиной:

#Выдать ключ

Нажмите «Выдать ключ» и заполните поля в окне:

Внизу окна — согласие: «Код проекта, вывод команд и ответы агента будут уходить во внешнюю систему.» Без имени, проекта и согласия кнопка «Выдать» не нажимается.

После выдачи окно покажет ключ (он начинается с dma_) и готовые настройки для клиента.

#Подключить клиента

Адрес сервера — в разделе «Внешние агенты», в блоке «Подключение» → «Адрес». Подключиться к нему могут только программы на этом компьютере. Окно выдачи ключа даёт готовые настройки двух видов:

• «Настройка клиента по HTTP» — для клиента, который подключает MCP-серверы по адресу. Обычно она выглядит так:

  { "type": "http", "url": "http://127.0.0.1:47821/mcp", "headers": { "Authorization": "Bearer dma_…" } }
  

• «Настройка клиента через stdio» — для клиента, который умеет только запускать команду. Путь к команде окно подставит само. DevMachine при этом должен быть открыт.

Вставьте настройку туда, где клиент подключает MCP-серверы. Подключение работает, если после первого вызова у ключа «ещё не использовался» сменилось на «последний раз …», а в журнале появилась запись «Внешний агент».

Если внешний агент работает в Docker на этом же компьютере, включите «Разрешить из контейнера на этом компьютере». Тогда окно выдачи ключа покажет отдельную настройку для контейнера.

#Что видно, пока работает внешний агент

• Чаты ключа помечены в списке чатов. Подсказка: «Сессию ведёт внешний агент …». Это обычные чаты: их можно открыть, продолжить, остановить.
• В шапке окна видна надпись «Подключён внешний агент», пока работает хотя бы один чат ключа. Если нажать на неё, откроется раздел «Внешние агенты».
• В журнале («Настройки → Журнал действий») каждый вызов внешнего агента записан как «Внешний агент»: что он вызвал, каким ключом и чем кончилось. Содержимое запросов в журнал не попадает.
• У ключа в списке — проекты, потолок режима, срок, сколько потрачено сегодня и когда ключ использовался последний раз.

#Отозвать ключ

В разделе «Внешние агенты» нажмите «Отозвать» у ключа и подтвердите. Внешняя система сразу теряет доступ, работающие чаты ключа останавливаются. Когда срок ключа истекает, происходит то же самое.

Аварийная остановка агента (⇧ ⌘ Esc на macOS, Ctrl Alt Shift Esc на Windows и Linux) действует и на внешних агентов: все их чаты останавливаются, и новые задачи они не поставят, пока вы снова не включите агента.

#Что уходит с компьютера

Всё, что внешний агент получает из чатов, уходит в его систему: код проекта, вывод команд и ответы агента. Сами запросы к моделям идут через сервер DevMachine, как и в обычном чате (см. Данные и приватность).

#Ограничения

• Только macOS и Linux с bubblewrap. Windows пока не поддерживается.
• Только проекты на этом компьютере. Пока открыт проект на сервере, внешнему агенту доступных проектов нет.
• Сервер принимает подключения только с этого компьютера. Подключиться с другой машины по сети нельзя.
• Выдать ключ можно только в окне приложения.

#Что дальше

• Ограничения агента — песочница, файлы и сеть.
• Режимы агента — что значат «Авто» и «Полный».
• Аварийная остановка и журнал действий.
• Список чатов — где видны чаты внешних агентов.