> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yahont.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Запланированные задачи

> Автоматически запускайте запрос Craft по повторяющемуся расписанию

Запланированная задача выполняет для вас запрос Craft по повторяющемуся расписанию.
Каждый запуск открывает в фоне новую сессию Craft,
записывает результат в историю запусков и продолжается независимо от того, открыт ли у вас Yahont.

Используйте запланированные задачи для работы с предсказуемой периодичностью и чётким критерием готовности.

| Сценарий | Пример |
| - | - |
| **Ежедневная сводка** | Каждое утро обобщать новые эскалации клиентов и отправлять важные пункты в канал Slack. |
| **Отслеживание изменений** | Регулярно проверять почтовый ящик, проект или источник данных и сообщать только о существенных изменениях, требующих внимания. |
| **Регулярный отчёт** | Еженедельно собирать свежие цифры, обновлять типовой отчёт и сохранять его в нужное место. |
| **Поддержка рабочего процесса** | Просматривать открытые задачи по расписанию, находить устаревшие и добавлять одобренный комментарий или следующий шаг при необходимости. |

> [!TIP]
>
> Сначала проверьте запрос в обычной сессии Craft. Ставьте его на расписание,
> только когда он надёжно находит нужную информацию, выдаёт нужный результат и безопасно обрабатывает отсутствие данных.

## К чему имеет доступ каждый запуск

Запланированные задачи выполняются от имени создавшего их человека. Каждый запуск использует текущие для этого человека:

* Права в Yahont и доступ к знаниям компании.
* Подключённые приложения и права во внешних аккаунтах.
* Доступные навыки.
* Файлы из пользовательской библиотеки.

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

> [!NOTE]
>
> Запланированная задача не отправляет вам результат автоматически. Если результат нужно отправить в Slack, Gmail,
> Google Drive или другое место, укажите это в запросе и настройте это приложение для работы без присмотра.
> В остальных случаях смотрите результат в истории запусков задачи.

## Создание запланированной задачи

Откройте **Запланированные задачи** на боковой панели Craft и нажмите **Новая запланированная задача**.

**1. Назовите задачу**

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

**2. Напишите самодостаточный запрос**

Опишите, что Craft должен проверять, временное окно, что попадает в результат,
нужный формат вывода и куда его доставить. Введите **/**,
чтобы выбрать конкретный навык или подключённое приложение в подборщике запроса.

**3. Выберите расписание**

Используйте **Интервал**, чтобы запускать задачу через заданное число минут или часов.
Используйте **Ежедневно / еженедельно**, чтобы выбрать время и, при желании, конкретные дни недели.

**4. Проверьте заранее одобренные приложения**

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

**5. Сохраните и проверьте**

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

![Форма новой запланированной задачи с названием, запросом, расписанием и заранее одобренными приложениями](https://mintcdn.com/yahont-ai/uOUoHpXrpfUMZdwx/assets/overview/core_features/craft_scheduled_task_new.png?fit=max\&auto=format\&n=uOUoHpXrpfUMZdwx\&q=85\&s=c04783b6b85821505b7b09230663825d)

### Как написать запрос, который выполняется без присмотра

Craft не может задать вам полезный уточняющий вопрос, пока запланированная задача выполняется в фоне.
Заранее укажите решения, которые иначе потребовались бы от вас:

| Что указать | Пример |
| - | - |
| **Область** | «Просмотри сообщения в `#customer-escalations` и открытые задачи P1 в Linear». |
| **Временное окно** | «Учти активность за последние 24 часа». |
| **Критерии отбора** | «Включай только заблокированные, просроченные или требующие решения руководителя пункты». |
| **Формат вывода** | «Используй таблицу с колонками: аккаунт, ответственный, проблема, влияние, следующий шаг». |
| **Место доставки** | «Опубликуй итоговую сводку в `#support-leads` в Slack». |
| **Запасной вариант** | «Если подходящих пунктов нет, опубликуй „Новых эскалаций нет“ и ничего не выдумывай». |

Например:

> Просмотри Slack-канал `#customer-escalations` и открытые задачи P1 в Linear за последние 24 часа.
> Включай только заблокированные, просроченные или требующие решения руководителя пункты. Сгруппируй их по аккаунтам и укажи ответственного,
> влияние и следующий шаг. Опубликуй итоговую сводку в `#support-leads`. Если ничего не подходит, опубликуй «Новых эскалаций нет».

> [!TIP]
>
> Используйте относительное временное окно, соответствующее периодичности,
> например «за последние 24 часа» для ежедневной задачи. Фиксированные даты в повторяющемся запросе быстро устаревают.

### Как работает время расписания

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

> [!NOTE]
>
> Сохранённое расписание не подстраивается автоматически при изменении вашего смещения от UTC.
> Проверьте и пересохраните задачи с привязкой ко времени после поездок,
> смены часового пояса или перехода на летнее или зимнее время.

## Осторожно с заранее одобренными приложениями

Действия приложений с политикой **Спрашивать** обычно приостанавливаются до вашего одобрения.
Поскольку запланированная задача выполняется без присмотра,
выбор приложения в разделе **Заранее одобренные приложения** позволяет задаче выполнять эти действия,
не спрашивая во время запуска.

| Политика приложения | Во время запланированной задачи |
| - | - |
| **Автоодобрение** | Действие выполняется без запроса, независимо от того, выбрано ли приложение для предварительного одобрения. |
| **Спрашивать** | Действие выполняется без присмотра, только если приложение заранее одобрено для задачи. |
| **Запрещать** | Действие остаётся заблокированным. Предварительное одобрение не отменяет политику «Запрещать». |

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

> [!WARNING]
>
> Делайте запрос и список заранее одобренных приложений как можно более узкими.
> Особенно осторожны будьте с приложениями, которые могут отправлять сообщения, изменять данные клиентов,
> удалять содержимое или публиковать информацию во внешнем мире. Yahont записывает уведомление,
> когда запланированная задача использует заранее одобренное действие приложения.

Подробнее о подключениях и политиках действий читайте в разделе [Приложения](https://docs.yahont.ai/overview/core_features/craft_apps.md).

## История запусков

Откройте задачу, чтобы увидеть заранее одобренные приложения и историю запусков. В таблице показано,
когда начался каждый запуск, его статус и длительность, краткое описание и источник:
расписание или **Запустить сейчас**.

Выберите запуск после того, как он создал сессию, чтобы изучить его сообщения, файлы, предпросмотры и артефакты.
У запусков в очереди сессии ещё нет, а пропущенные запуски её не создают, поэтому такие строки открыть нельзя.

| Статус | Значение |
| - | - |
| **В очереди** | Ожидает, пока рабочий процесс начнёт запуск. |
| **Выполняется** | Craft активно работает в созданной сессии. |
| **Успешно** | Craft завершил запуск в штатном режиме. |
| **Сбой** | В запуске произошла ошибка, или он превысил окно выполнения. Откройте его сессию, если она доступна, чтобы разобраться. |
| **Пропущен** | Запуск не начался, обычно потому что предыдущий запуск ещё был в очереди или выполнялся, либо Craft был отключён для владельца. |
| **Ожидает одобрения** | Запуск дошёл до действия приложения, требующего одобрения, но приложение не было одобрено заранее. Автоматически он не продолжится. |

Следите за уведомлениями Yahont, когда запуск завершается сбоем или переходит в статус **Ожидает одобрения**.
Запуски со сбоем и заблокированные на одобрении не повторяются автоматически.

> [!WARNING]
>
> Для запуска в статусе **Ожидает одобрения** откройте созданную сессию, чтобы увидеть, какое действие его остановило.
> Затем измените заранее одобренные приложения задачи или сузьте запрос, чтобы он не использовал это действие,
> и повторите попытку через **Запустить сейчас**.

## Управление задачей

На странице сведений о задаче доступны действия:

| Действие | Что делает |
| - | - |
| **Запустить сейчас** | Ставит в очередь разовый запуск, не меняя повторяющееся расписание. Работает и для задачи на паузе. |
| **Пауза** | Останавливает будущие запуски по расписанию. Уже стоящий в очереди или выполняющийся запуск не отменяется. |
| **Возобновить** | Снова включает расписание и вычисляет следующий запуск от текущего времени. |
| **Изменить** | Меняет название, запрос, расписание или заранее одобренные приложения для будущих запусков. |
| **Удалить** | Удаляет задачу и останавливает будущие запуски. Сессии, созданные предыдущими запусками, остаются в вашей истории Craft. |

Удаление задачи не отменяет запуск, который уже стоит в очереди или выполняется.
Если нужно лишь временно остановить будущие запуски, поставьте задачу на паузу.

## Устранение неполадок

> [accordion] Запуск выполнен успешно, но я ничего не получил
>
> Откройте сессию запуска из истории и изучите её результат. Если задача должна доставлять результат в другое место,
> добавьте в запрос явное место доставки, подключите это приложение и одобрите его заранее,
> если для действия доставки выбрана политика **Спрашивать**.

> [accordion] Запуск был пропущен
>
> Посмотрите краткое описание в строке. Если предыдущий запуск ещё был в очереди или выполнялся,
> сделайте запрос меньше или задайте более редкое расписание. Запуск также может быть пропущен,
> если Craft отключён для владельца задачи.

> [accordion] Запуск завершился сбоем
>
> Откройте созданную сессию, если она доступна. Убедитесь, что нужные приложения по-прежнему подключены,
> навыки и файлы пользовательской библиотеки существуют, а запрос можно выполнить за один запуск.
> После исправления задачи нажмите **Запустить сейчас**.

> [accordion] Задача выполнилась в неожиданное время
>
> Ежедневные и еженедельные расписания используют местное время браузера на момент сохранения.
> Измените и пересохраните задачу после смены часового пояса или перехода на летнее или зимнее время.
> Для интервального расписания помните, что запуски привязаны к повторяющимся границам часов.

> [card] [Подключение приложений](https://docs.yahont.ai/overview/core_features/craft_apps.md)
>
> Подключите места доставки и разберитесь с одобрениями, прежде чем запускать работу без присмотра.

> [card] [Для администраторов](https://docs.yahont.ai/admins/managing_features/craft.md)
>
> Включите Craft и изучите требования к развёртыванию, рабочим процессам, приложениям и средствам управления.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.