# Агенты

Источник: https://novyrazum.ru/docs/agents

> Агент — это чат с задачей. Он читает файлы, запускает команды, открывает сайты и возвращает результат.

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

Модели Claude, GPT, DeepSeek и другие — без VPN, с оплатой в рублях.

## Поле ввода

Под полем ввода нового чата — настройки, с которых начинается работа:

* **Проект** — папка, в которой работает агент. В меню проекта — git-ветка, если проект в
  git: можно переключиться на другую ветку или создать новую. → [Проекты и папки](https://novyrazum.ru/docs/agents/projects)
* **Место** — «Локально» (на этом компьютере) или «Облако». → [Облачные агенты](https://novyrazum.ru/docs/agents/cloud)
* **Режим разрешений** — кнопка со щитом: «Проверять» (по умолчанию) или «Спрашивать». Решает,
  кто одобряет шаги агента, которые могут что-то изменить. → [Разрешения](https://novyrazum.ru/docs/agents/permissions)

Слева от поля — меню «+»:

| Пункт                                 | Что делает                                                                                                   |
| ------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| Добавить файл или фото                | Приложить любой файл: картинку, PDF, таблицу. Можно просто перетащить в окно                                 |
| Добавить папку                        | Дать агенту ещё одну папку рядом с проектом. → [Дополнительные папки](https://novyrazum.ru/docs/agents/projects#дополнительные-папки) |
| Навыки, Правила, Подключения, Плагины | Явно подключить к задаче нужное. Обычно агент находит это сам                                                |
| Поиск в интернете                     | Разрешить агенту искать в сети                                                                               |
| Только чат                            | Агент ничего не меняет: только читает, обсуждает и ищет информацию                                           |

Приложенный файл агент открывает сам. PDF он читает по страницам; модель, которая видит
картинки, смотрит на сами страницы, поэтому ей доступны и сканы, формулы, таблицы.

Поиск в интернете идёт через ваш аккаунт «Разума» и входит в расход, как запросы к модели.

Чтобы сослаться на файл проекта, откройте панель «Файлы», нажмите на файл правой кнопкой и
выберите «Добавить в чат». Так же можно добавить выделенные строки из просмотра файла.

## Модель

Модель выбирается под полем ввода, справа: нажмите на её имя. «Авто» — лучшая на сегодня
модель по соотношению цены и качества; подходит для большинства задач. У модели с
рассуждением рядом с именем — вторая кнопка, глубина рассуждения: от «Нет» до «Максимум».
Глубже — дольше и дороже, но точнее на сложных задачах.

Цены моделей в рублях — на странице [Модели](https://novyrazum.ru/models). → [Модели и свой ключ](https://novyrazum.ru/docs/customize/models)

## Пока агент работает

* **Дописать уточнение.** Новое сообщение либо встанет в очередь к следующему ответу, либо
  прервёт текущий ход и уйдёт сразу. Что делает <kbd>Enter</kbd>, написано в поле
  ввода, а <kbd>⌘</kbd> <kbd>Enter</kbd> (<kbd>Ctrl</kbd> <kbd>Enter</kbd>) делает обратное;
  поменять их местами — «Настройки → Чат → Очередь сообщений во время работы».
  Команда, которую агент уже запустил (сборка, тесты, сервер), при этом не обрывается:
  в следующем ходе агент её видит и может дождаться.
* **Смотреть за долгой командой.** Сервер, сборку или деплой агент оставляет работать в
  фоне, и его строка в чате помечена «в фоне». Нажмите на строку — откроется вывод
  команды, он дописывается, пока она работает. Кнопка «Остановить» в той же строке
  завершает команду и всё, что она запустила, даже когда агент уже ответил. Когда
  команда закончится, вместо пометки появится «завершилась», «остановлена» или код выхода.
* **Остановить** — кнопка «Стоп». Она останавливает ответ агента и команды, которые он
  оставил работать в этом чате. Команды чата останавливаются и когда его архивируют.
* **Ответить на вопросы.** Если агенту нужно ваше решение, он задаст вопросы карточкой с
  вариантами; вариант, который агент выбрал бы сам, помечен «рекомендую». Можно выбрать
  вариант, написать свой или пропустить. Карточка вопроса,
  разрешения или подключения ждёт вас сколько угодно, а агент не стоит на ней: делает то,
  что от ответа не зависит, или заканчивает ход. Ваш ответ продолжает работу: после
  «Разрешить» агент повторяет шаг, и он проходит без карточки. Обычное сообщение в чат
  карточку не закрывает. Чат, где вас ждёт карточка, отмечен в боковой панели.
* **Следить за планом.** На длинных задачах агент ведёт список шагов «Задачи» и отмечает
  выполненные.

## После ответа

* **Скопировать ответ** или блок кода. Правый клик по тексту агента — «Копировать как
  Markdown»: исходный текст с разметкой, таблицами и ссылками.
* **Прослушать** — кнопка под ответом читает его вслух, без кода и ссылок. Повторное
  нажатие останавливает чтение.
* **Процитировать** — выделите фрагмент, нажмите правой кнопкой и выберите «Цитировать
  в ответе»: он встанет в поле ввода цитатой. Без выделения цитируется всё сообщение.
* **Дублировать чат** — целиком или «Дублировать отсюда», чтобы попробовать другой путь
  с середины разговора.
* **Изменить сообщение** и отправить заново.
* **Посмотреть расход** — процент заполненного контекста под полем; клик открывает
  подробности: токены, запросы, скорость.

Озвучка идёт через ваш аккаунт «Разума» и входит в расход, как поиск в интернете. Агента
можно попросить и об аудиофайле — например, озвучить текст для поста: файл появится в
проекте, в папке `assets/generated`.

Когда разговор становится длинным, агент сам сжимает старый контекст — в чате появится
строка «Контекст сжат». Работу это не прерывает.

## Список чатов

Боковая панель держит все чаты: ваши, агентов сотрудников, облачные и локальные.

* **Новый чат** — <kbd>⌘</kbd> <kbd>N</kbd>; **Поиск** — <kbd>⌘</kbd> <kbd>K</kbd>: чаты по названию и тексту,
  [настройки](https://novyrazum.ru/docs/account/settings), сотрудники и проекты, а также действия — новый
  сотрудник, тема, вкладки правой панели, переименовать или закрепить открытый чат.
* **Группировка** — по дате, по папкам, по состоянию («Ждут ответа», «В работе»,
  «Непрочитанные») или в свои группы. **Сортировка** — по активности, созданию или названию.
* **Порядок групп и папок** — перетащите группу или папку за заголовок.
* **Избранное** — выберите «Добавить в Избранное» или нажмите булавку на строке чата.
  Когда Избранное уже есть, чаты можно перетаскивать в него, из него и внутри него.
* **Архив** — «Архивировать» прячет чат, не удаляя его. «Архивировать все ниже» чистит
  старое одним действием.
* **Несколько чатов сразу** — выберите их: <kbd>⇧</kbd>-клик — все чаты подряд,
  <kbd>⌥</kbd>-клик — по одному, правый клик по пустому месту списка → «Выбрать все». Правый
  клик по выбранному чату открывает меню: прочитать, переместить в группу, архивировать
  или удалить их вместе. Обычный клик или <kbd>Esc</kbd> снимает выбор.
* **Удалить** — чат удаляется насовсем вместе с перепиской, вложениями, рутинами и
  скрытыми агентами, которых он запустил; сами вы его не восстановите, поэтому «Разум»
  сначала спрашивает. Если агент работал, его останавливают. Агенты, которые
  стоят в списке отдельной строкой, остаются, а артефакты — в
  [«Артефактах»](https://novyrazum.ru/docs/artifacts), откуда их удаляют отдельно.

## Что ещё

<Cards>
  <Card title="Изменения и ревью" href="/agents/review">
    Дифф по файлам, «Проверить» и коммит из приложения.
  </Card>

  <Card title="Агенты запускают агентов" href="/agents/subagents">
    Большая задача делится между помощниками.
  </Card>

  <Card title="Терминал, браузер и файлы" href="/agents/tools">
    Правая панель с инструментами.
  </Card>

  <Card title="Разрешения" href="/agents/permissions">
    Что агент делает сам, а что — после вашего «да».
  </Card>

  <Card title="Проверка разрешений" href="/agents/permission-review">
    Как проверка решает за вас и где у неё пределы.
  </Card>
</Cards>
