Документация
Начать бесплатно

Документация/Агент

Инструменты агента

Что значат строки действий агента в ленте, как работают веб-поиск, генерация картинок и браузер агента, где описаны инструменты модулей.

Агент работает инструментами: читает и правит файлы, ищет по проекту и в интернете, запускает команды. Каждое действие видно в ленте чата отдельной строкой. По этим строкам можно понять, что агент делал, и проверить результат.

Как читать ленту

Несколько действий подряд сворачиваются в одну сводку, например «прочитал 4 файла · 2 поиска · изменил 1 файл · 3 команды». Нажмите на сводку, чтобы увидеть каждое действие. У каждой строки действия есть значок состояния и время. Нажмите на строку, и откроется вывод команды, результат поиска или дифф правки.

СтрокаЧто сделал агент
«Прочитано N файлов»Прочитал файлы проекта
«Изменён», «Создан»Поправил или создал файл. Шеврон у строки раскрывает дифф прямо в ленте
«Поиск»Искал по проекту: по именам файлов или по тексту
«Выполняется», «Выполнено», «Команда»Запустил команду в терминале. Если команда упала, значок у строки красный
«Поиск в сети»Искал в интернете (см. ниже)
«Открыто»Открыл веб-страницу по адресу и прочитал её
«Определение», «Ссылки», «Описание символа», «Символы», «Реализации», «Вызовы»Ходил по коду: где объявлено, где используется, кто вызывает. Для этого нужен языковой сервер — программа, которая разбирает код на языке файла. Ставить ничего не обязательно: приложение ищет сервер в системе, часть серверов скачивает само, а если сервера для языка нет, агент ищет по тексту
«Сгенерировал изображение»Нарисовал картинку по описанию (см. ниже)
«Субагент»Поручил часть задачи помощнику (см. Субагенты)
«Навык»Загрузил навык — готовую инструкцию для такого рода задач. Часть навыков приносят модули, свои можно поставить (см. Навыки)
«План обновлён»Обновил список шагов задачи

Рассуждения модели свёрнуты в «Рассуждения». Раскрыть их можно кнопкой «Показать рассуждение целиком».

Когда действие не выполнено

СтрокаЧто произошло
«Отклонено вами»Вы нажали «Запретить» на карточке разрешения
«Запрещено правилом»Действие запрещает правило режима или настроек
«Запрещено политикой безопасности агента»Действие закрыто в «Настройки → Безопасность агента» (см. Ограничения агента). Настройки открывает шестерёнка в шапке окна
«Чтение запрещено политикой: N файлов»Агент хотел прочитать закрытые файлы, например .env или ключи
«Прерван»Вы остановили агента, пока действие ещё шло
«Неверный вызов инструмента»Модель вызвала инструмент с ошибкой в параметрах

После «Отклонено вами» и «Прерван» агент останавливается и ждёт вашего следующего сообщения.

Веб-поиск

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

Запрос сначала уходит на сервер DevMachine. Сервер передаёт его поисковой системе Яндекса и возвращает результаты агенту. Ключ поисковика хранится только на сервере. Поиск тратит лимит подписки так же, как работа модели. Сколько лимита осталось, видно в «Настройки → Аккаунт и тариф» (см. Тарифы и лимиты).

  • Если в запросе оказался ключ, токен или пароль, агент искать не будет.
  • Если вы разрешили поиск навсегда, разрешение будет в «Настройки → Безопасность агента → Исключения → Запомненные ответы» под названием «Поиск в интернете». Там же его можно отозвать.
  • Если на сервере вашей организации поиск выключен, у агента этого инструмента нет.

Генерация изображений

Агент может нарисовать картинку по текстовому описанию: иллюстрацию, иконку, заглушку для макета, фон для страницы.

  • Файл ложится в рабочую папку чата, обычно в папку generated. Агент может сохранить его и в другое место, если задача того требует.
  • В ленте появляется строка «Сгенерировал изображение» и сама картинка. Нажмите на картинку, и она откроется в полный размер.
  • Размеры: 1024 × 1024, 1536 × 1024 или 1024 × 1536.
  • Инструмент рисует только новые картинки по описанию. Отредактировать готовое изображение им нельзя.

Запрос идёт через сервер DevMachine к моделям, которые рисуют, и тратит лимит подписки. На одну картинку уходит до пары минут. Если в описании оказался ключ или пароль, генерация не запустится.

Браузер агента

У агента есть отдельный браузер, встроенный в приложение. Агент открывает в нём страницы, нажимает кнопки, вводит текст и читает ошибки консоли. Так он проверяет свою работу, например запущенный сайт на localhost. Те же страницы видны вам: нажмите кнопку «Другие инструменты» в шапке окна, сразу после кнопок инструментов, и выберите «Браузер». Кнопкой «Перехватить» можно взять управление на себя: действия агента в браузере остановятся, пока вы не нажмёте «Вернуть агенту».

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

Git: ветка и merge request

Если в настройках добавлен git-аккаунт, агент может сам отправить ветку и открыть merge request в GitLab или pull request в GitHub, а потом прислать ссылку. Как добавить аккаунт — в разделе Git.

Инструменты модулей

Часть инструментов агент получает из модулей. Агент видит инструменты модуля, только когда модуль включён для проекта. Некоторые модули включены по умолчанию, остальные можно включить в «Настройки → Модули» (см. Модули). Каждый модуль описан на своей странице:

Свои инструменты можно подключить через MCP-серверы.

Ограничения

  • Веб-поиск и генерация картинок работают только через сервер DevMachine и тратят лимит подписки.
  • Что агенту можно делать без спроса, зависит от режима и настроек безопасности (см. Режимы агента и Разрешения и вопросы).

Что дальше

Обновлено · Нашли неточность? Напишите на support@devmachine.ai или в Telegram.