# Как ставить задачи

> Как формулировать задачу агенту, что он делает сам и что проверить после.

> Оглавление всей документации: https://docs.getxflow.com/llms.txt

Агенту пишут задачу обычными словами, как сотруднику. Про устройство xflow он знает из
скилла, который CLI кладёт ему при входе.

## Хорошая задача

Назовите, кто пользуется, что он делает и какие данные нужны:

```text
Сделай приложение для склада: кладовщик видит остатки по товарам,
отмечает приход и расход. Каждое утро присылай в Telegram список
товаров, которых осталось меньше 10 штук.
```

Агент сам разложит это на части: таблицы в базе, функции, расписание, экраны.

| Лучше | Хуже |
|---|---|
| «Менеджер видит свои заявки, руководитель все» | «Сделай CRM» |
| «Данные из Wildberries, кабинет уже в интеграциях» | «Подключи WB» без кабинета |
| «Форма для клиентов без входа» | «Сделай публичным» |

## Что агент делает сам

- создаёт проект и приложения;
- пишет код, миграции базы и функции;
- отправляет код на сборку и публикует версии;
- ставит расписания и переменные окружения;
- смотрит ошибки приложения и функций и чинит их.

## Что сделать вам

- подключить кабинет сервиса в «Интеграциях», если задача про внешний сервис;
- открыть приложение людям: окно «Опубликовать», поле «Кто может открыть»;
- пригласить коллег в проект;
- выпустить ключ функции, если её зовёт внешний сервис.

Агент сам скажет, когда нужен один из этих шагов.

## После работы

- Откройте приложение по адресу, который прислал агент, и пройдите основной сценарий.
- Если что-то сломалось, опишите агенту, что сделали и что увидели. Ошибки из браузера и
  функций он прочитает сам: `xflow logs`, `xflow functions logs`.
- Прежнюю версию приложения можно вернуть за секунду, см. [Приложения](https://docs.getxflow.com/platform/apps.md).

## Если агент просит лишнего

Опасные действия выключены в [разрешениях](https://docs.getxflow.com/agent/setup.md) по умолчанию. Если агент
предлагает `--force`, удаление данных или файлов, сначала спросите, что именно пропадёт.