Агент планирования проектов помогает сформировать структуру работ проекта в Timetta: задачи, этапы, зависимости, сроки, оценки трудозатрат, generic-команду проекта и назначения исполнителей.
Агент является системным ИИ-агентом Timetta и работает как отдельный микросервис. Он обращается к публичному API Timetta по временному токену, который выпускается для пользователя, запустившего агента.
Агент работает только с тем проектом, из карточки которого он был запущен. Он не анализирует и не изменяет другие проекты.
С точки зрения ролевой модели Timetta агент имеет те же права, что и пользователь, который его запустил.
Это означает, что агент может выполнить только те действия, которые доступны самому пользователю. Если у пользователя нет прав на создание, изменение или удаление задач либо участников команды, агент также не сможет выполнить эти действия. В таком случае в окне выполнения будет показано понятное сообщение об ошибке.
Откройте карточку проекта.
На верхней панели действий откройте выпадающий список Роботы.
Выберите Агент планирования.
В открывшемся модальном окне заполните инструкцию — техническое задание для агента.
Нажмите Выполнить.
После запуска проект становится недоступен для редактирования на все время выполнения агента. В модальном окне отображается сообщение:
Робот Агент планирования выполняется…
Внизу доступны кнопки Отменить и Выйти.
Если нажать Выйти, пользователь будет возвращен в список всех проектов. Сам агент при этом продолжит выполнение.
Если снова открыть проект, для которого агент еще выполняется, будет автоматически открыто модальное окне выполнения. Редактировать проект до завершения работы агента нельзя. В зависимости от инструкции агент может выполнять работу от нескольких секунд до минут. Для запросов, требующих создание большого количества задач, может понадобиться от 10 минут.
Агент может выполнять команды, связанные с планированием текущего проекта.
Агент может создать или пересоздать план проекта: сформировать WBS, этапы, задачи, сроки, зависимости, оценки трудозатрат, команду и назначения.
Примеры инструкций:
Спланируй проект внедрения CRM для отдела продаж.
Сформируй WBS проекта разработки мобильного приложения, создай команду и назначь исполнителей на задачи.
По умолчанию при полном перепланировании агент очищает существующую структуру задач и команду проекта, затем создает новый план.
Агент может создать структуру задач без создания команды и без назначений.
Примеры инструкций:
Сформируй WBS проекта, но команду не создавай.
Пересоздай задачи без исполнителей, не меняй команду.
В этом режиме команда проекта не изменяется, а задачи создаются без назначенных исполнителей.
Если в проекте нет задач, кроме главной задачи проекта, агент может добавить новые задачи или этапы.
Примеры инструкций:
Добавь этапы: Аналитика, Разработка, Тестирование.
Создай задачи для запуска корпоративного сайта.
Агент может создать команду из дженериков, не изменяя задачи.
Примеры инструкций:
Сгенерируй команду проекта.
Создай команду для проекта внедрения ERP, задачи не трогай.
Агент может добавить одного или нескольких дженериков в команду проекта.
Примеры инструкций:
Добавь senior QA.
Добавь одного архитектора и middle backend-разработчика.
В этом режиме агент добавляет только явно указанных участников, не очищает и не достраивает полную команду проекта.
Агент может удалить задачи проекта, если это разрешено текущим состоянием задач и правами пользователя.
Пример инструкции:
Очисти задачи проекта.
Главная задача проекта не удаляется.
Агент может удалить всех членов команды проекта, для которых нет фактических данных в системе.
Пример инструкции:
Очисти команду проекта.
Агент может очистить и задачи, и команду проекта.
Примеры инструкций:
Очисти проект.
Удали все задачи и команду проекта.
Агент может одновременно очистить задачи проекта и добавить указанного участника команды.
Пример инструкции:
Очисти задачи проекта и добавь senior backend-разработчика.
Агент работает только в рамках текущего проекта. Он не может изменять другие проекты, даже если пользователь укажет их в инструкции.
Агент не работает с сущностями, которые не относятся к планированию проекта. Он не создает, не изменяет и не удаляет клиентов, контакты, компании, юридические лица, счета, договоры, пользователей и другие административные или справочные сущности.
Агент не выполняет общие запросы вне проектного планирования. Например, он не пишет письма, не отвечает на произвольные вопросы и не выполняет команды без проектного смысла.
Агент не добавляет задачи в непустой проект без предварительной очистки или перепланирования. Если в проекте уже есть задачи, а пользователь просит «добавить задачу» или «добавить этап», агент покажет сообщение о том, что добавление задач в непустой проект запрещено. Чтобы изменить план, нужно явно попросить очистить задачи или пересоздать план.
Агент не использует существующую команду проекта для назначений на задачи. Назначения выполняются только на универсальных исполнителей, созданных агентом в текущем запуске. Если команда не создается в текущем запуске, задачи будут созданы без назначений.
Агент использует только доступные в Timetta роли и уровни. Он не придумывает новые роли или уровни и не изменяет существующие справочники ролей и уровней.
Агент не изменяет главную задачу проекта. Он создает подчиненную структуру работ внутри уже существующего проекта.
Агент не может частично изменить или удалить существующих членов команды или задачи.
Агент не удаляет задачи, если их нельзя безопасно удалить. Например, задачи с фактическими или плановыми трудозатратами могут быть недоступны для удаления. В таком случае будет показано сообщение об ошибке.
Работа агента проходит в несколько этапов.
После нажатия Выполнить Timetta запускает отдельный процесс выполнения агента. Агент получает идентификатор проекта, инструкцию пользователя и временный токен доступа.
Агент получает данные текущего проекта и текущую структуру задач. На этом этапе он определяет, есть ли в проекте задачи кроме главной задачи проекта.
Агент анализирует инструкцию и определяет, что именно нужно сделать:
создать или пересоздать план;
создать задачи без команды;
создать или заменить команду;
добавить участников команды;
очистить задачи;
очистить команду;
очистить проект полностью;
остановиться с понятной ошибкой, если запрос не относится к возможностям агента.
Если инструкция требует работы с командой, агент получает доступные роли и уровни Timetta, формирует команду и создает участников в проекте.
Если требуется пересоздание команды, старая команда предварительно очищается.
Если инструкция требует работы с задачами, агент формирует структуру работ: этапы, задачи, сроки, трудозатраты, зависимости и контрольные точки.
Перед созданием задач агент проверяет структуру на корректность: даты, иерархию, зависимости, циклы и дубликаты.
Если требуется перепланирование, существующие задачи проекта предварительно очищаются. Затем новые задачи создаются в безопасном порядке: сначала родительские задачи и предшественники, затем дочерние и зависимые задачи.
Если в текущем запуске была создана команда и инструкция допускает назначения, агент назначает на задачи созданных исполнителей.
Если команда не создавалась или пользователь указал «без исполнителей», задачи создаются без назначений.
После выполнения агент передает в Timetta итоговый статус.
При успешном выполнении в модальном окне плашка загрузки сменится на сообщение:
Агент успешно обработал запрос.
После этого модальное окно можно закрыть, а проект снова станет доступен для редактирования.
Если во время выполнения произошла ошибка, в этом же модальном окне будет показан понятный текст ошибки. Например, если пользователь просит агента выполнить действие, которое находится вне его возможностей, агент объяснит, что именно невозможно выполнить и что нужно уточнить.
Во время выполнения агента можно нажать Отменить.
После нажатия Отменить агент останавливается в течение 5 секунд. Затем в модальном окне отображается сообщение:
Агент остановлен.
После этого модальное окно можно закрыть, а проект снова станет доступен для редактирования.
Агент работает с публичным API Timetta по временному токену пользователя, который запустил агента.
Во время работы агент использует API Timetta:
| Метод | Эндпоинт | Назначение |
|---|---|---|
GET |
/odata/Projects({project_id}) |
Получить данные текущего проекта |
GET |
/odata/Projects({project_id})/GetTasks |
Получить задачи проекта |
POST |
/odata/ProjectTasks |
Создать задачу |
PATCH |
/odata/ProjectTasks({task_id}) |
Обновить параметры задачи, например назначения |
DELETE |
/odata/ProjectTasks({task_id}) |
Удалить задачу |
GET |
/odata/Roles |
Получить доступные роли |
GET |
/odata/Levels |
Получить доступные уровни |
GET |
/odata/Projects({project_id})/ProjectTeamMembers?$select=id&$expand=resource($select=id,name) |
Получить команду проекта |
POST |
/odata/Projects({project_id})/CreateGeneric |
Добавить в команду универсальный ресурс |
DELETE |
/odata/ProjectTeamMembers({team_member_id}) |
Удалить участника команды проекта |
GET |
/odata/AgentRuns({run_id}) |
Проверить статус выполнения агента |
POST |
/odata/AgentRuns({run_id})/UpdateStatus |
Обновить статус выполнения агента |
Для генерации текста используются модели, предоставляемые сервисом Yandex AI Studio, с отключенным логированием.
Чем подробнее инструкция, тем точнее будет результат. Агенту важно понимать не только название проекта, но и ожидаемый результат, ограничения и желаемую детализацию.
Хорошая инструкция обычно содержит:
цель проекта;
тему или предметную область;
ожидаемый результат;
желаемую структуру этапов;
ограничения по срокам;
примерный объем работ или трудозатраты;
требования к команде;
нужно ли создавать назначения;
нужно ли трогать существующую команду;
нужно ли очистить или пересоздать текущие задачи;
важные контрольные точки;
исключения: что не нужно делать.
Опишите цель проекта:
Нужно спланировать проект внедрения CRM для отдела продаж на 80 пользователей.
Уточните желаемый результат:
Нужна WBS со сроками, зависимостями, оценками в часах и контрольными точками.
Укажите ограничения:
Проект должен занять не больше 3 месяцев. Общая оценка — около 1200 часов.
Опишите команду:
Создай минимальную команду: project manager, бизнес-аналитик, backend-разработчик, frontend-разработчик, QA.
Уточните, нужны ли назначения:
Создай команду и назначь исполнителей на задачи.
Или наоборот:
Команду не создавай, задачи сделай без исполнителей.
Уточните, что делать с текущим планом:
Очисти текущие задачи и создай новый план.
Команду не трогай, пересоздай только задачи.
Добавьте этапы и контрольные точки:
Предусмотри этапы: обследование, проектирование, разработка, тестирование, обучение пользователей, запуск. Добавь контрольные точки после проектирования, завершения тестирования и промышленного запуска.
Спланируй проект внедрения CRM для отдела продаж на 80 пользователей.
Нужно создать WBS с этапами, задачами, сроками, зависимостями и оценками в часах.
Проект должен занять около 3 месяцев, общий бюджет работ — примерно 1200 часов.
Предусмотри этапы:
1. Анализ и сбор требований.
2. Проектирование решения.
3. Настройка CRM.
4. Интеграция с сайтом и телефонией.
5. Миграция данных.
6. Тестирование.
7. Обучение пользователей.
8. Запуск и поддержка после запуска.
Создай реалистичную команду и назначь исполнителей на задачи.
Добавь контрольные точки после проектирования, завершения тестирования и промышленного запуска.
Пересоздай задачи проекта внедрения CRM, но команду не трогай и назначения не делай.
Нужна WBS по этапам: аналитика, проектирование, настройка, интеграции, миграция данных, тестирование, обучение, запуск.
Для каждой задачи укажи сроки, зависимости и оценку в часах.
Сгенерируй команду проекта внедрения CRM.
Нужны роли для управления проектом, аналитики, настройки системы, интеграций, тестирования и обучения пользователей.
Задачи не создавай и не удаляй.
Очисти задачи проекта.
Или:
Очисти проект полностью: удали задачи и команду.
Пишите инструкцию как задачу для проектного менеджера: что нужно получить, для какого проекта, с какими ограничениями и в каком виде.
Если в проекте уже есть задачи и нужен новый план, явно пишите «очисти задачи» или «пересоздай план». Не используйте формулировку «добавь задачи» для непустого проекта.
Если команда не нужна, прямо укажите: «команду не создавать», «без исполнителей» или «без назначений».
Если нужно сохранить текущую команду, напишите: «команду не изменяй».
После завершения работы агента рекомендуется проверить созданный план: сроки, зависимости, трудозатраты, состав команды и назначения. Агент формирует проектный план автоматически, но итоговое решение остается за пользователем.
Перейти на русскую версию?