Когда агентов в организации становится больше нескольких, плоский список перестаёт помогать. Папки позволяют сгруппировать агентов на странице агентов — по команде, по клиенту, по кампании, как вам удобно.
Эта страница — про папки для агентов. Она не имеет отношения к folder ID в Yandex Cloud, который вы указываете при настройке Yandex как inference provider: там это идентификатор каталога ресурсов Yandex Cloud, а не папка Агентики.

​
Как страница агентов группирует агентов

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

​
Создание папки

Нажмите Новая папка на странице агентов и задайте имя.
Имя обрезается по краям, должно быть длиной 1–100 символов и уникально внутри организации — дубликат отклоняется с кодом 409.

​
Перенос агента в папку

У каждой строки агента есть меню Переместить со списком всех папок организации и вариантом «Без категории». Выбор вызывает:
Отправьте {"folder_id": null}, чтобы вынуть агента из всех папок — именно это делает вариант «Без категории». Агент одновременно находится максимум в одной папке. Папка другой организации отклоняется с 404, поэтому положить своего агента в чужую папку нельзя.

​
Переименование и удаление

Меню ⋮ в заголовке папки предлагает переименование и удаление.
  • Переименование (PUT /api/v1/folder/{folder_id}) подчиняется тем же правилам, что и создание, включая проверку уникальности имени в организации.
  • Удаление (DELETE /api/v1/folder/{folder_id}) удаляет только папку. Агенты внутри не удаляются — они переходят в «Без категории», и позже их можно разложить по другим папкам.
Папки — исключительно средство организации. Помещение агента в папку никак не влияет на то, как он работает, сколько стоит и кто может ему звонить: за это по-прежнему отвечает организация, которой принадлежит агент.