Создать и настроить агента
Как завести агента, что написать в инструкции и какие настройки поменять после создания.
Агента создают владелец и администраторы рабочей области: остальные участники кнопку Новый агент не видят и работают с уже созданными агентами.
Создать агента
- Откройте Агенты и нажмите Новый агент.
- Выберите начало. С нуля — вы сами задаете имя, инструкцию и рантайм. Собрать с ИИ — вы описываете агента в разговоре, а сборщик предлагает имя, описание и инструкцию.
- Проверьте форму. В ней четыре раздела: Личность, Поведение и возможности, Выполнение и Доступ.
- Нажмите Создать и открыть агента. Откроется страница нового агента, и ему можно сразу назначить работу кнопкой Назначить работу.
В режиме Собрать с ИИ разговор идет слева, а черновик настроек справа — его можно править прямо по ходу разговора. Кнопка Сбросить очищает черновик.
Обязательные поля
Обязательно только Имя. Оно должно быть уникальным в рабочей области: занятое имя не подойдет, даже если тот агент в архиве.
Если не выбрать, где работает агент, останется вариант Как в проекте: среда зависит от задачи и настроек ее проекта. Остальные поля можно оставить как есть и поменять позже.
Описание и инструкция
Описание — короткая подпись для людей. Оно видно в списке агентов, на странице агента и в пустом чате с ним. В запуск описание не попадает.
Инструкцию агент получает в каждом запуске. Обычно в ней пишут:
- за что агент отвечает и за что нет;
- что проверить, когда пришла работа;
- что ему можно менять;
- как сдавать результат;
- когда остановиться и спросить человека.
Например:
Ты проверяешь статьи блога перед публикацией.
Сначала прочитай задачу и текст статьи. Проверяй только:
- факты и цифры: у каждой есть источник;
- заголовок и описание страницы;
- ссылки.
Текст сам не правь. Замечания пиши комментарием в задаче,
от важных к мелким. Если замечаний нет, так и напиши.
После создания инструкция лежит на вкладке Возможности → Инструкции, в поле Системная инструкция. Поддерживается Markdown.
Навыки
При создании нажмите Добавить навыки из пространства и отметьте нужные навыки. Позже их меняют на вкладке Возможности → Навыки.
Навык подходит для способа работы, который нужен нескольким агентам. То, что касается только этого агента, лучше написать в инструкции.
Подсказки для чата
Подсказки для чата показывают, с чем идти к агенту. Их видно в новом чате с агентом над полем ввода. У каждой подсказки есть короткая подпись и полный текст запроса. Нажатие на подсказку сразу отправляет этот текст агенту.
Подсказок может быть до трех. Если не добавить ни одной, чат покажет встроенные общие подсказки. После создания подсказки меняют на вкладке Возможности → Инструкции. Тем, кто может менять агента, пустой чат показывает ссылку Настроить подсказки.
Где работает агент, модель и размышление
В поле Где работает агент три варианта:
| Вариант | Где идут запуски |
|---|---|
| Как в проекте | Зависит от задачи и настроек ее проекта. |
| Облако Otdano | На сервере Otdano. |
| Свой компьютер | На вашем компьютере, в выбранном инструменте, например Claude Code или Codex. |
Дальше можно выбрать Модель и глубину рассуждения: в форме создания это поле Рассуждение, в настройках агента — Размышление. У Codex есть еще Скорость: Быстрая или Обычная. Пустые поля берут значения рантайма по умолчанию. Если сменить рантайм, модель, рассуждение и скорость сбрасываются.
Доступ
| Вариант | Что значит |
|---|---|
| Только я | Запускать агента можете только вы. Стоит по умолчанию. |
| Все пространство | Запускать агента может каждый участник рабочей области. |
| Выбранные люди | Запускать агента могут только выбранные участники. Нужно выбрать хотя бы одного. |
Доступ меняет только владелец агента: Настройки → Доступ. Администраторы области меняют остальные настройки, но не доступ чужого агента.
Настройки после создания
На странице агента можно менять:
| Настройка | Где | Что делает |
|---|---|---|
| Сколько запусков одновременно | Настройки → Общие | Сколько запусков агент ведет одновременно, от 1 до 50. По умолчанию 6, остальные ждут в очереди. |
| Окружение | Настройки → Окружение | Переменные окружения, которые получает инструмент при запуске. |
| Аргументы запуска | Настройки → Аргументы запуска | Аргументы командной строки, которые добавляются к запуску инструмента. |
| MCP | Возможности → MCP | Серверы MCP агента. |
| Мессенджеры | Возможности → Мессенджеры | Telegram для агента, кнопка Подключить Telegram. Настраивают владелец и администраторы области. |
Правка настроек не меняет запуски, которые уже идут. Новые запуски берут настройки, сохраненные к моменту выдачи запуска.
Окружение
Сюда кладут учетные данные с узкими правами, которые нужны агенту в работе, например доступ к сервису только на чтение. Пароль администратора базы данных и другие доступы с полными правами сюда не кладите.
Раздел Окружение видят только владелец агента, владелец и администраторы области. Значения скрыты, пока их не раскрыть кнопкой Раскрыть и изменить. Каждое раскрытие и изменение попадает в Журнал изменений и в журнал аудита области. Агент во время запуска значения других агентов не читает.
Служебные имена задать нельзя: HOME, PATH, USER, SHELL, TMPDIR, CODEX_HOME и все имена, которые начинаются с OTDANO_. Переменных может быть до 64.
Аргументы запуска
Аргументы добавляют кнопкой Добавить аргумент. Каждый элемент списка передается инструменту одним аргументом, порядок сохраняется. Итоговую команду видно в Предпросмотре команды. Аргументов может быть до 64.
Не пишите в аргументы пароли и другие учетные данные: аргументы командной строки видны другим программам на компьютере. Для них есть Окружение.
MCP
На вкладке Возможности → MCP серверы разбиты на три группы:
| Группа | Откуда сервер |
|---|---|
| Под управлением Otdano | Сервер только этого агента. Кнопка Добавить MCP: команда STDIO или адрес Streamable HTTP, в визуальном редакторе или в JSON. |
| Из библиотеки области | Общий сервер рабочей области, назначенный агенту. |
| Унаследовано от рантайма | Серверы из настроек инструмента на компьютере агента. Их видно, когда компьютер в сети; здесь их только смотрят. У облака Otdano своих серверов нет. |
Если имена совпадают, сервер агента главнее общего, а оба главнее сервера с компьютера. Проигравший отмечен Перекрыт или Перекрыт Otdano.
Общие серверы MCP
Если один сервер нужен нескольким агентам, его не нужно вводить у каждого заново.
- Владелец или администратор открывает Настройки → MCP-серверы, нажимает Добавить сервер и вводит имя и настройки.
- Новый сервер никому не назначен. На вкладке MCP нужного агента в группе Из библиотеки области выберите его в Добавить из области.
- У каждого назначения свой переключатель: сервер можно выключить у одного агента, не убирая его.
В списке MCP-серверы у сервера видно, сколько агентов им пользуются, или «Не назначен агентам». Сохраненные адреса, команды, заголовки и переменные больше не показываются никому. Чтобы их изменить, нажмите Заменить настройки и введите настройки целиком; назначения агентам сохранятся. Удаленный сервер пропадает у всех агентов, которым он был назначен.
Менять общие серверы могут владелец и администраторы области. Назначать сервер агенту могут владелец агента, владелец и администраторы области.
Дублировать агента
Владелец и администраторы области могут скопировать агента: меню агента → Дублировать открывает форму с настройками исходного агента. Имя получает приписку «(копия)». Копируются описание, инструкция, аватар, подсказки для чата, навыки, доступ, аргументы запуска и число запусков одновременно. Рантайм, модель, рассуждение и скорость переходят, если рантайм исходного агента доступен; иначе их нужно выбрать заново.
Переменные окружения, серверы MCP и подключенные приложения не копируются: их настраивают у копии отдельно.