Создание агентов с ИИ и управление ими

Обзор

Настройте агентов с ИИ, которые реагируют на активность в ваших проектах и самостоятельно создают задачи, добавляют комментарии или отправляют письма — на основе инструкций, которые вы напишете.

Агент состоит из четырёх частей, и у каждой своя роль:

• Инструкции сообщают агенту, что делать, — вашими словами и с любой степенью детализации. Именно здесь описывается сама работа.
• Триггеры определяют, когда агент начинает проверку. Они не определяют, будет ли он действовать.
• Действия задают границы того, что агенту разрешено делать. Они не определяют, что именно он делает.
• Проект — это единственный проект, за которым следит агент, и единственные данные, которые он может читать.

Триггеры и действия задают рамки; инструкции выполняют работу внутри них. Например, чтобы агент оставлял комментарий, когда задача решена, задайте ему триггер Задача обновлена, чтобы он проверял каждое изменение задачи, и укажите в инструкциях, что действовать нужно только тогда, когда статус меняется на Решено.

Эти события агент может использовать в качестве триггеров:

• Задача создана
• Задача обновлена
• Комментарий добавлен к задаче
• Файл загружен (в Документах)
• Новая версия файла (в Документах)

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

Эти действия может быть разрешено выполнять агенту:

• Создать задачу
• Добавить комментарий (в задаче)
• Отправить сообщение по электронной почте (участникам проекта)

Всё, что создаёт агент, носит его имя: в созданной им задаче или комментарии указано имя агента от лица человека, который его создал. Подробнее в Recognise Work Done by AI Agents.

Вы также можете задать глобальные инструкции для всего аккаунта, которые применяются к каждому агенту, и настроить уведомления агентов для всего аккаунта. Подробнее в Configure AI Agents for your Account.

Не поддерживается в текущей версии:

• Изменение или удаление существующих задач, документов или планов. Агент только создаёт.
• Запуск по расписанию. Агент реагирует только на события в своём проекте.
• Работа с несколькими проектами. Каждый агент работает ровно в одном проекте — создайте по одному агенту на каждый нужный проект.
• Отправка писем людям вне проекта. Письма можно отправлять только участникам проекта.

Эта функция расходует ваш лимит использования ИИ. Подробнее в AI Usage Limits and Upgrades.

Подробнее о Privacy & Security for AI Features.

Как открыть агентов с ИИ

1. Нажмите Агенты с ИИ

Вы увидите агентов своего аккаунта:

Создание агента

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

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

С нуля

Чтобы создать нового агента без шаблона:

1. Нажмите Создать нового агента
   
2. Напишите инструкции, например: создавать подзадачи на основе комментариев о незавершённых работах
   Подробнее ниже в Написание инструкций.
3. Нажмите Далее
   
4. Добавьте Проект, Триггеры и Действия
   Подробнее ниже в Настройка проекта, Настройка триггеров и Настройка действий.
   
5. Нажмите Просмотреть и протестировать
   
6. Нажмите Тестовый запуск
   Подробнее ниже в Тестирование агента.
   
7. Нажмите Активировать агента
   Подробнее ниже в Активация агента.
   

Из шаблона

В ваш аккаунт входят четыре готовых агента. Каждый полностью описан — инструкции, триггер и действия уже заданы, не хватает только проекта.

Чтобы создать агента из шаблона:

1. Нажмите Создать нового агента
   
2. В разделе Наши шаблоны нажмите нужный шаблон
   
3. Нажмите Добавить в разделе Проект
   
4. Выберите проект
5. Нажмите Сохранить
   
6. Проверьте Имя агента, Описание и Инструкции и при необходимости измените их.
7. Нажмите Тестовый запуск
   
8. Нажмите Активировать агента
   

Настройка и редактирование агента

Всё, что нужно агенту, задаётся на его собственном экране: имя, описание, инструкции, проект, триггеры и действия.

Чтобы отредактировать агента-черновик:

1. Нажмите на агента
   

Чтобы отредактировать активного или приостановленного агента:

1. Нажмите на агента
   
2. Нажмите Редактировать агента
   

Архивированных агентов нельзя редактировать. Сначала их нужно восстановить.

Экран агента одинаков и при создании нового агента, и при редактировании существующего. Здесь можно добавить или изменить следующее:

1. Имя агента (должно быть уникальным — если имя уже занято, добавляется номер)
2. Описание
3. Инструкции — подробнее ниже в Написание инструкций
4. Проект — подробнее ниже в Настройка проекта
5. Триггеры — подробнее ниже в Настройка триггеров
6. Действия — подробнее ниже в Настройка действий

Экран агента с панелью Тестирование справа:

Сохранение изменений не меняет статус агента. Агенты остаются черновиком, приостановленными или активными.

Написание инструкций

Инструкции — это сердце агента: всё, что он делает, следует из них. Пишите их так, как объясняли бы задачу коллеге.

Например:

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

Чтобы написать инструкции:

1. В поле Инструкции опишите, что должен делать агент.
   
2. Необязательно: нажмите Переписать с помощью ИИ, чтобы получить вариант ИИ с более понятной формулировкой ваших инструкций.
   
3. Необязательно: вы можете оставить предложенный вариант, отменить его кнопкой Отменить или написать свою версию.
   

Инструкции могут содержать до 4 000 символов.

Чтобы развернуть поле ввода инструкций:

1. Нажмите значок Развернуть
   

Чтобы свернуть развёрнутое поле ввода:

1. Нажмите значок Свернуть
   

Настройка проекта

Агент работает ровно в одном проекте и никогда не читает ничего за его пределами.

Чтобы изменить проект:

1. В разделе Проект нажмите Редактировать
   
2. Выберите проект, в котором работает агент
3. Нажмите Сохранить
   

Настройка триггеров

Триггер — это событие, которое запускает выполнение. У агента может быть несколько триггеров, и он запускается при любом из заданных событий.

Чтобы изменить триггеры:

1. В разделе Триггеры нажмите Редактировать
   
2. В поле Источник выберите, реагирует ли агент на Задачи или на Документы.
   
3. В поле Событие выберите событие, которое запускает выполнение.
   
4. Нажмите Сохранить
   

Каждый триггер — это один источник и одно событие:

Чтобы добавить больше триггеров:

1. Нажмите + Добавить триггер
2. Выберите Источник и Событие, как описано выше
   

С помощью Области можно сузить триггер, чтобы агент реагировал только на часть проекта:

• Триггеры по задачам можно ограничить Слоем, Формой или тем и другим.
• Триггеры по документам можно ограничить Папкой.

Чтобы ограничить область триггера по задачам:

1. Нажмите Расширенные настройки
2. Выберите Слой и/или Форму
   

Чтобы ограничить область триггера по документам:

1. Нажмите Расширенные настройки
2. Выберите Папку
   

Триггер по документам следит за папкой, а не за отдельным файлом. Чтобы агент реагировал на один конкретный документ, переместите его в отдельную папку и ограничьте триггер этой папкой.

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

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

Триггеры по документам доступны для аккаунтов с Управление документами.

Настройка действий

Действия — это то, что агенту разрешено записывать. Добавьте те, которые ему нужны; агент сам решает, когда использовать каждое из них, исходя из ваших инструкций. Каждое действие можно добавить один раз.

Чтобы изменить действия:

1. В разделе Действия нажмите Редактировать
   
2. Нажмите Добавить действие
3. Нажмите Создать задачу, Добавить комментарий или Отправить сообщение по электронной почте.
   
4. Необязательно: заполните настройки, которые агент должен использовать всегда.
   Для Создать задачу можно задать: Слой, Форма. А в разделе Указать конкретные значения полей: Название, Ответственное лицо, Приоритет, Статус
   Для Отправить сообщение по электронной почте можно задать: Кому, Копия, Тема
5. Нажмите Сохранить
   

Тестирование агента

Панель Тестирование перечисляет четыре вещи, которые нужны агенту, и отмечает каждую по мере выполнения. Когда все четыре готовы, можно выполнить тест.

Тестовый запуск читает реальные данные вашего проекта, но ничего не записывает. Результат показывает, что агент создал бы, прокомментировал или отправил. В вашем проекте ничего не создаётся и не изменяется. Изменения можно протестировать до сохранения.

Чтобы протестировать агента:

1. На панели Тестирование нажмите Тестовый запуск.
   
2. Прочитайте, что сделал бы агент.

Тест, который завершился без каких-либо действий агента, — нормальный результат. Это значит, что агент счёл действия ненужными.

Тест расходует ваш лимит использования ИИ так же, как реальный запуск.

Активация агента

Агент начинает работать только после того, как вы его активируете.

Чтобы активировать агента:

1. Нажмите Активировать агента
   

Агент отображается в списке как Активный и с этого момента запускается каждый раз, когда происходит одно из событий, заданных в триггерах.

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

Сохранить агента как черновик вместо активации:

Каждый запуск агента фиксируется. Откройте Журнал действий, чтобы увидеть, что он сделал и почему. Подробнее в Monitor AI Agents in the Activity Log.

Управление агентами

• Каждый, у кого есть разрешение Агенты с ИИ, видит агентов, работающих в проектах, к которым у него есть доступ, включая агентов, созданных коллегой. То же относится к Архивированным агентам и Журналу действий.
• Человек, создавший агента, владеет им, и только он может редактировать, тестировать, активировать, приостанавливать, архивировать, восстанавливать или удалять его.

Дублирование

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

Чтобы дублировать агента:

1. Откройте меню Ещё у агента
2. Нажмите Дублировать агента
   

Копия получает имя оригинала с добавлением (copy) и начинается как черновик. Измените проект или что-то ещё, затем протестируйте и активируйте её.

Приостановка

Приостановка останавливает работу агента и сохраняет все его настройки, поэтому вы можете снова включить его в любой момент.

Чтобы приостановить агента:

1. Откройте его из списка агентов
   
2. Откройте меню Ещё
3. Нажмите Приостановить работу агента
   

Архивирование и восстановление

Архивирование перемещает агента в Архивированные агенты и останавливает его работу, ничего не удаляя.

Чтобы архивировать агента:

1. Откройте меню Ещё у агента
2. Нажмите Архивировать агента
   

Чтобы восстановить агента:

1. Нажмите Архивированные агенты
2. Откройте меню Ещё у агента
3. Нажмите Восстановить агента
   

Восстановленные агенты всегда приостановлены. Активируйте их, когда будете готовы.

Удаление

Удаляйте агента только если уверены, что никогда не захотите его восстановить. Если не уверены, лучше архивируйте. Его запуски остаются в Журнале действий, поэтому вы по-прежнему сможете увидеть, что он делал.

Чтобы удалить агента:

1. Откройте меню Ещё у агента
2. Нажмите Удалить агента
   
3. Нажмите Удалить для подтверждения
   

Когда агент приостанавливает себя сам

Агент приостанавливает себя в следующих случаях:

• Ваш аккаунт достиг лимита использования ИИ.
• Запуски постоянно завершались с ошибкой, потому что объём содержимого, отправляемого модели ИИ, был слишком большим. Сократите инструкции или направьте агента на меньшие формы либо меньшее число документов.
• Агент достиг предела числа действий за один запуск.
• Проект агента был архивирован или удалён.
• За короткое время было запущено слишком много выполнений.
• Владелец агента был переведён в неактивные, потерял разрешение Агенты с ИИ или потерял доступ к проекту.

Вы получаете уведомление, и агент остаётся приостановленным, пока вы снова его не активируете.

Уведомления о неудачном запуске агента или об автоматической приостановке можно отключить для всего аккаунта. Подробнее в Configure AI Agents for your Account.

Агент никогда не запускается сам заново. Наведите курсор на статус Приостановленный, чтобы увидеть, почему он остановился.