Ограничения Agent beta
Поймите, где Agent помогает, где нужны подтверждения и какие действия остаются только за владельцем.
Защищённый вход заявки через webhook можно настроить отдельным подтверждением после публикации автоматизации. Укажите входные поля, таблицу, окружение, сохранённое подключение и идентификатор события. Неверное тело отклоняется до записи; повтор события использует исходный результат. Agent проверяет конфигурацию входа, а доставка проверяется отдельно. Подробнее: приём заявки через webhook.
Если условия входа ещё не определены, Agent сначала уточняет их. Похожая опубликованная автоматизация может быть основой для настройки; её наличие само по себе не подтверждает, что она принимает нужные вам заявки.
Для распределения задач по условиям укажите окружение, таблицы, ответственных и правило для пустых или неизвестных значений. Если запрос неоднозначен, Agent уточнит, нужна ли автоматизация для новых обращений или разовое изменение существующих. Наличие подходящей записи в Live не означает, что вы поручили изменять её.
Что это
Agent beta помогает разбирать задачи проекта, предлагать действия и доводить результат до проверяемого состояния. Ограничения ниже показывают, где Agent может работать сам, где нужна роль пользователя, а где требуется отдельное подтверждение или помощь поддержки.
Когда использовать
- Вы впервые включаете Agent в организации.
- Agent недоступен, остановлен или показывает блокировку.
- Нужно понять, почему помощник просит подтверждение.
- Нужно безопасно передать задачу с секретами, оплатой или изменениями проекта.
- Команда проверяет поведение Agent после обновления.
Перед началом
- Встроенный Agent доступен участникам организаций после входа в платформу.
Подключаемый агент можно настроить в реестре, но запуск будет доступен только после проверки его подключения и возможностей.
- Поддержка может временно выключить Agent для отдельной организации при
расследовании инцидента или нестабильности.
- Ваши роли, safety-лимиты, предел расходов и рублёвый баланс продолжают
действовать для всех действий помощника.
- Доступные действия фильтруются по текущей роли в проекте. Если у вас нет
нужных прав, Agent не подготовит такое изменение и покажет блокировку.
- История диалогов хранит последние обращения организации в одном списке:
общие диалоги организации и диалоги проектов. Каждый диалог открывается с последним сохранённым контекстом. Название диалога берется из начала первого сообщения.
- В одном диалоге выполняется только одна задача одновременно. Статусы
Выполняется и Ожидает подтверждения блокируют следующее сообщение до завершения, отмены или остановки текущей задачи.
- Если платформа перезапускается во время выполнения, задача и её статус
сохраняются. Откройте тот же диалог и дождитесь восстановления хода работы; не создавайте для этого второй запуск.
- Если получение финального ответа прервалось, задача может завершиться ошибкой.
В диалоге будут перечислены уже выполненные действия; они не повторяются автоматически. Перед новым изменением проверьте текущее состояние проекта. Если расход последнего запроса ещё не подтверждён, его резерв сохраняется до сверки. Ошибка ответа не отменяет сохранённые изменения.
- При сбое связи с моделью во время сборки задача получает статус ошибки.
Очередные подготовленные изменения остаются невыполненными. Проверьте уже сохранённые результаты и состояние проекта перед продолжением; подтверждённый расход предыдущих ответов учитывается по обычному тарифу.
- При чтении большого объёма материалов сборка может продолжиться новым этапом
того же запуска. Помощник сохраняет проверенные справочные материалы и общий лимит задачи. Если расход ещё не подтверждён или остаются ожидающие изменения, автоматическое продолжение останавливается; уже выполненные действия сохраняются.
- При сборке исходники подготавливаются по частям. Появление отдельных файлов
ещё не подтверждает готовность приложения: дождитесь сохранения изменений, успешной сборки и проверки запрошенного сценария. Если выполнение прервалось, перед продолжением проверьте уже сохранённые файлы и результаты действий в исходном диалоге.
- При доработке бота сохраните исходные сценарии и настройки уже подготовленных
ответов. Новая маршрутизация не должна менять старую очередь и квитанции приватного архива. При чтении старого ответа проверяются текущие права. Если исходную настройку ответа или текущие права нельзя подтвердить, отправка блокируется; повторная попытка с новым ключом не заменяет проверку сохранённой квитанции.
- Медленно отвечающий запрос не должен задерживать новые диалоги. Если время
ожидания истекло, Agent завершит именно этот запуск с понятным статусом.
- Если страница была перезагружена во время выполнения или ожидания
подтверждения, снова откройте тот же диалог. Панель восстановит текущий ход работы и только текущую карточку подтверждения; уже завершённые карточки не появятся повторно. Не отправляйте ту же задачу ещё раз.
- На широком экране Agent занимает отдельную правую колонку, только если
текущему разделу хватает рабочей ширины. Для таблиц, редактора кода и других плотных экранов панель автоматически открывается поверх правой части интерфейса, не сжимая основной контент. Закройте Agent кнопкой в панели или верхней строке, чтобы увидеть перекрытую область; сворачивание левого меню иногда возвращает режим отдельной колонки.
- Повторное нажатие подтверждения после нестабильного соединения не запускает
второе изменение. Помощник покажет уже сохраненный статус: подтверждено, выполняется, готово или ошибка.
- После успешного изменения нескольких записей одной таблицы Agent показывает
общий итог с числом проверенных записей. Если часть действий завершилась ошибкой или результат не удалось проверить, смотрите отдельные статусы: полный успех в таком случае не подтверждён.
- В карточке шагов вращающийся индикатор означает, что помощник выполняет
работу или ждёт очереди. После завершения вместо него появится отметка Шаги выполнены; если работа остановилась, карточка покажет предупреждение и понятную причину. Отметки завершённого списка и его шагов имеют единый зелёный вид. Остановка на этапе планирования происходит до изменений в проекте. Успешное понимание задачи не считается готовым результатом: если следующий шаг недоступен, Agent показывает остановку и предлагает уточнить задачу или выбрать нужный объект в контексте. Если описание нового App, Data или Automation уже полностью сохранено в этом диалоге, короткое продолжение вроде Погнали или Подтверждаю использует его и не требует сначала выбирать ещё не созданный объект. При незавершённом описании Agent по-прежнему задаст недостающие вопросы. Agent сохраняет уже данные ответы и не повторяет такие вопросы; для несущественной детали он фиксирует понятное предположение и продолжает, а важные для безопасности или результата вопросы оставляет на подтверждение.
- Не вставляйте секреты, ключи, токены доступа или платежные данные в обычное
сообщение помощнику. Используйте защищенные формы Connections и Billing.
Что встроенный Agent может делать
- Найти доступный проект, прочитать состояние его приложений, данных и автоматизаций.
- Посчитать записи и показать данные выбранной таблицы.
- Прочитать явно заданные связи таблиц и проверить связанные записи при поиске
дублей клиентов. Совпадение телефона означает кандидата на проверку: номер может быть общим, а имена, компании и email — различаться. Попросите показать конфликты и связанные заявки без изменений. Заявки сохраняются отдельными; обсуждение объединения не выполняет его. Наличие связи в настройках проекта само по себе не означает, что обе таблицы уже доступны в выбранном окружении. Телефоны сравниваются с сохранением исходной записи; для национального формата помощник должен обозначить предположение о стране. Если часть номеров не удалось сравнить или проверена лишь часть большой базы, она остаётся непроверенной. Совпадение имени и телефона не подтверждает личность, а слова «старый» и «новый» в email не определяют основную карточку. Перед объединением нужно подтвердить личность, выбрать карточку и согласовать конфликтующие данные. Надёжное объединение карточек через встроенный Agent пока недоступно. При таком запросе обе карточки и связанные записи должны сохраниться; частичные правки не заменяют объединение. Другая роль пользователя не добавляет отсутствующую операцию. Итог отдельной проверки дублей собирается из полученных данных: помощник не выбирает email или основную карточку по собственному предположению. Если связанные записи не прочитаны полностью, в отчёте остаётся это ограничение. В одном анализе проверяется до 1000 записей и до десяти страниц; оставшаяся часть большой базы не считается проверенной. Другие задачи задавайте отдельно от этого анализа.
- Для отбора по датам укажите точный порог и часовой пояс. Время в ответе
должно соответствовать этому поясу; если показано исходное время UTC, оно обозначается отдельно.
- Архивировать выбранные записи через существующее поле архива. Попросите
сначала показать полный список и сохранить остальные значения. Если подходящего поля нет, можно явно запретить добавлять новые поля: тогда Agent должен объяснить ограничение и оставить записи без изменений.
- Прочитать сохранённые представления таблицы: группировку, фильтры и
сортировку. Перед изменением поля Agent может проверить, какие представления и доступные ему автоматизации используют это поле, и предложить порядок изменений. Удаление поля через встроенный Agent пока недоступно; такая проверка сама по себе не меняет данные. Настройки представлений общие для окружений проекта. Обзор приложений показывает состояние сервисов и публикаций. Он не проверяет исходный код: отсутствие опубликованного приложения не доказывает, что поле нигде не используется.
- Обсудить требования без изменения проекта.
Для напоминаний «два дня без контакта» сначала согласуйте событие отсчёта, 48 часов или календарные дни, часовой пояс, исключения закрытых заявок, получателя и канал, место создания задачи и правило повторов. Плановая дата следующего контакта не подтверждает последний состоявшийся контакт. Черновик автоматизации ещё не означает, что расписание и доставка проверены.
- Настроить отправку списка просроченных заявок по расписанию после согласования
поля срока, открытых статусов, канала и получателя. Agent читает безопасные сведения сохранённых подключений выбранного окружения; токен остаётся в защищённом поле. Например: Каждый будний день в 9 утра по Москве отправляй в Telegram-чат список открытых заявок с прошедшим следующим контактом. Укажите подключение и чат, затем попросите один тест и публикацию в нужном окружении. Каждый тест действительно отправляет сообщение. Готовность расписания подтверждается активной привязкой после публикации и ближайшими датами запусков, а доставка — результатом выполненного теста.
- В диалоге проекта подготовить таблицу Data сразу со всеми полями. Например:
Создай в Dev таблицу «Заявки»: имя, телефон, сумма, статус и дата обращения. В ответе после выполнения Agent перечисляет сохранённые представления. Предложение добавить доску или календарь само по себе их не создаёт.
- Сохранить новую командную Kanban-доску для существующей коллекции. Например:
Покажи заявки в Dev доской по Статусу, заголовок — Имя, поля карточки — Сумма и Ответственный; сохрани вид «Заявки по статусам». Перед созданием проверьте коллекцию, поля и название в подтверждении. Настройки общие для окружений проекта; записи показываются из выбранного окружения. Agent сохраняет основные и другие представления, записи и поля. Если название занято или выбранная структура ещё недоступна в окружении, новая доска не создаётся. Переименование, изменение существующих видов и создание календаря или галереи через встроенный Agent пока недоступны.
- Создать внутренний дашборд по существующей коллекции со статусами:
Сохрани в Dev дашборд «Сводка заявок»: всего заявок и количество по Статусу; проверь предпросмотр и опубликуй. Нужны права владельца или администратора организации. Сначала подтвердите создание нового черновика, затем отдельно — публикацию проверенной версии. Источники используют только выбранные проект и окружение. Записи и доступ сотрудников сохраняются, гостевые приглашения не создаются. Если имя занято, существующий дашборд не меняется. Этот сценарий поддерживает количество записей и категории; суммы, средние значения и изменение других дашбордов через него пока недоступны. Если запросить выручку, средний чек или маржу, Agent сначала проверит поля выбранной таблицы. Для выручки нужно определить выборку продаж и период; для маржи дополнительно нужны себестоимость и правило расчёта. Сумма заявки сама по себе не подтверждает оплату или прибыль. Для постоянного отображения таких показателей нужен подходящий источник дашборда или отдельное приложение.
- Дать внешнему получателю доступ только к числу записей. Укажите коллекцию,
окружение, название нового дашборда, email и точный срок в пределах суток: Создай отдельный дашборд «Количество заявок» по Заявкам в Dev, опубликуй для партнёра partner@example.com и отправь приглашение; доступ до 3 октября 2026, 18:00 по Москве, только число заявок, без клиентов и сумм. Владелец или администратор подтверждает создание, публикацию и отправку одного приглашения в одной карточке. Существующий внутренний дашборд не меняется. Гостевая ссылка приходит по email, в диалоге её нет. После срока источник перестаёт отдавать показатель, даже если гостевая сессия ещё открыта. Отозвать доступ можно в редакторе дашборда. Если отправка или проверка результата прервалась, проверьте дашборд и приглашения перед новым запросом: опубликованная часть может сохраниться.
- Добавить поле в существующую таблицу или поменять его отображаемое название:
Добавь в Dev необязательную дату следующего контакта; Переименуй «Сумма» в «Бюджет клиента», сохрани данные.
- Добавить запись или исправить конкретную запись. Например:
Добавь в Dev заявку: Анна, телефон +7 900 000-00-01, сумма 70 тысяч. При нескольких подходящих записях нужно уточнить, какую изменить.
- Связать существующие таблицы правилом «много к одному» и запретить удаление
объекта, на который ссылаются записи. Например: Свяжи клиентов и заявки, поле «Клиент» — ссылка; удаление клиента с заявками запрети. Таблица со ссылками должна быть пустой во всех окружениях. Обязательность и типы полей уже должны подходить. Определение общее для проекта, а проверка использует собственные записи каждого окружения. Перенос существующих ссылок и изменение физической структуры этим действием не выполняются.
- Импортировать CSV из Files в существующую таблицу выбранного окружения.
Например: В Dev импортируй «Заявки.csv» в заявки, пропусти повторы по email без учёта регистра и крайних пробелов. Некорректные строки пропусти с отчётом. Файл должен быть готовым и доступным команде. До подтверждения Agent показывает соответствие колонок полям, правила преобразования и количество новых записей, ошибок и повторов. Подтверждается весь этот план, в том числе пропуск некорректных строк. Сохраняется первая корректная строка каждого ключа; существующие записи остаются без изменений. Новый повтор или потеря доступа к источнику останавливает дальнейшую вставку. После выполнения Agent проверяет записи повторным чтением и показывает итог. Если новых корректных строк нет, данные не меняются и подтверждение не требуется. CSV должен быть в UTF-8, с запятой или точкой с запятой как разделителем: до 2 МиБ, 2000 строк и 64 колонок; в целевой таблице после импорта — до 10 000 записей. Для даты и времени укажите UTC; местный часовой пояс помощник не должен угадывать. Связи между таблицами этим CSV-сценарием не переносятся. Сопоставление колонки CSV с полем связи и импорт в таблицу с обязательной связью останавливаются до подготовки плана. Agent объяснит ограничение импорта; корректные ссылки в файле не должны считаться ошибочными строками. Для общего CSV со связанными таблицами используйте строгий перенос, описанный ниже; не исключайте колонки связей ради частичного импорта.
- Перенести общий CSV из Files в 2–4 пустые связанные таблицы одного окружения.
Например: В Dev перенеси клиентов и заявки из «Клиенты и заявки.csv». Сохрани старые ID и все связи; после подтверждения продолжай следующие этапы. Таблицы и связи должны уже существовать. Укажите колонки со старыми ID, значения для каждой таблицы и колонки ссылок. Agent проверит весь файл до первого импорта. Одинаковые старые ID объединяются только при совпадении всех значений и ссылок; конфликт, ошибка значения или отсутствующая ссылка останавливает подготовку целиком. В каждой строке нужны ID всех переносимых сущностей. Ссылки должны вести на переносимую таблицу, циклы пока недоступны. Файл должен быть в UTF-8, до 2 МиБ, 2000 строк и 64 колонок; для каждой таблицы допускается до 2000 связей. Нужны роль разработчика или администратора и разрешение на импорт в профиле агента. Сначала подтвердите таблицу, на которую ссылаются остальные. После проверки результата Agent автоматически подготовит следующий этап с отдельным подтверждением. Перед каждым этапом повторно проверяются файл, доступ, структура и данные таблиц. При остановке успешно выполненные этапы остаются; весь перенос завершён только после проверки всех строк и связей. Обязательные непустые связи и запись в непустые таблицы пока недоступны.
- Импортировать подготовленный JSONL.gz из Files со старыми ID и явными связями.
Например: В Dev импортируй «Клиенты.jsonl.gz» в таблицу клиентов, строго, без пропуска строк. Файл должен быть готовым и доступным команде, а таблица и определения связей — уже существовать. В плане видны число записей и связей; до подтверждения записей нет. Некорректная строка или отсутствующая ссылка блокирует весь план. Существующие записи не перезаписываются. Для связанных таблиц сначала подтвердите импорт клиентов и дождитесь проверки, затем попросите импортировать файл заявок. Agent сопоставит старые ID с новыми, восстановит связи и проверит записи и ссылки повторным чтением. Один файл относится к одной таблице; перенос нескольких таблиц за одно подтверждение и обязательные непустые ссылки пока недоступны. Лимиты этого сценария: 2 МиБ сжатого файла, 8 МиБ после распаковки, 2000 записей и 2000 связей. Нужны роль разработчика или администратора и разрешение на импорт в профиле агента.
- Выгрузить все записи таблицы выбранного окружения в CSV. Например:
В Dev выгрузи все события в CSV-файл, без обрезки. Не выводи записи в чат. Нужна роль администратора или разработчика и разрешение на экспорт в профиле агента. В ответе появятся имя файла, проверенное число записей и кнопка Скачать. Файл доступен только автору этого диалога; при скачивании права проверяются повторно. Он хранится час с момента создания и не добавляется в Files. После истечения срока попросите повторить экспорт. Один файл содержит до 10 000 записей и 8 МиБ; при превышении лимита, изменении данных во время проверки или неполной пагинации усечённый файл не выдаётся.
- Подготовить и проверить черновик автоматизации. Например:
Создай в Dev черновик: ручной запуск, затем сохранить входное сообщение в переменную. Для записи в существующую таблицу достаточно её названия и значений: Создай в Dev автоматизацию с ручным запуском: добавить тестовую заявку на 1000 рублей. Протестируй один раз и проверь запись; не публикуй. Подключение к таблице помощник определяет через Data выбранного проекта. Шаги нового сценария автоматически располагаются на холсте. При изменении существующего сценария расположение его шагов сохраняется.
- Изменить существующий черновик, отдельно опубликовать его или запустить
опубликованную версию в выбранном окружении. Например: В черновике «Проверка» поменяй текст сообщения, рабочую версию оставь.
- Прочитать состояние конкретного запуска и его шагов. Если причина ошибки
отсутствует в доступной сводке, Agent не должен её придумывать.
- Отменить конкретный ожидающий, выполняющийся или поставленный в очередь
запуск автоматизации в выбранном окружении. Например: В Dev отменяй только ожидающий запуск «Согласование заявки», затем проверь историю. Перед отменой нужно отдельно подтвердить найденный запуск. После отмены следующие шаги и повторные попытки не запускаются; уже начатый запрос, отправка или запись могут завершиться. Отмена не откатывает такие действия.
- Выполнить отдельный HTTPS GET и показать наблюдаемый HTTP-статус и ответ.
Для авторизации укажите сохранённое HTTP API подключение выбранного окружения; ключ остаётся в защищённом хранилище. Например: В Dev вызови GET https://api.example.com/orders/123 через подключение «Заказы» и покажи статус. Для POST укажите точный адрес и JSON. Agent показывает полные параметры и требует отдельного подтверждения, в том числе в режиме полной автономности. Смена подключения, его настроек или ключа после согласования блокирует отправку: попросите подготовить действие заново. Сам HTTP-ответ не доказывает создание бизнес-объекта: можно дополнительно попросить GET по возвращённому ID. Запрос не повторяется автоматически при неопределённом результате.
- Протестировать сохранённый черновик без публикации, целиком или до выбранного
шага включительно. Например: Протестируй только форматирование в Dev; следующие шаги не запускай. Тест выполняет реальные действия: он может изменить данные, отправить запрос или потратить средства. Проверьте это в карточке подтверждения.
При чтении указывайте среду: например, Сколько всего заявок в Dev?. Можно добавить условие: Сколько в Dev выигранных заявок на сумму больше 50 тысяч?. Dev («в разработке») обозначает окружение, а «В работе» — статус записи. Для графика по показанным строкам Agent отделяет сумму превью от общего числа записей; превью не заменяет итог по всей таблице.
Для итогов можно попросить: Посчитай сумму и средний чек выигранных заявок в Dev или Покажи выручку по каналам за весь период. Agent рассчитывает показатели по всем подходящим записям. Если список групп не помещается в ответ, он должен обозначить неполноту; общий итог рассчитывается отдельно. Текущий график в чате показывает отдельные записи. Сгруппированные показатели Agent пока выводит таблицей и объясняет это ограничение.
Для оценки конверсии укажите два периода и правило подсчёта: например, долю выигранных заявок среди всех поступивших. Если в периоде нет заявок, конверсия не определена. Текущий статус показывает результат когорты на момент запроса; он не восстанавливает результат на конец прошлого периода без истории переходов или даты продажи. Проверка диапазона дат может использовать общие показатели без выгрузки записей клиентов.
При сравнении периодов помощник отделяет расчёт изменения от гипотез о причинах. Для двух периодов таблица сравнения, суммы, средние и вклад количества и среднего рассчитываются по выбранной таблице с одним фильтром. Период без записей или с пропущенными суммами не выдаётся за полный нулевой результат. Отсутствующая история не означает нулевую выручку: без неё нельзя подтвердить или опровергнуть падение. Отсутствие истории само по себе не объясняет изменения в бизнесе и не исключает ухудшение продаж. В рекомендациях возможные причины остаются гипотезами, пока их не подтвердят данные. Если для дальнейшего анализа не хватает данных, Agent должен назвать их; похожая соседняя таблица сама по себе не заменяет историю выбранной выборки. Полная обработка записей таблицы не подтверждает, что в неё загружена вся история продаж. При оценке динамики это нужно проверить отдельно. Если периоды имеют разную длительность, помощник должен указать это; суммы сами по себе не становятся показателями за день.
Для очереди звонков можно указать дату и часовой пояс: Кому сегодня нужно перезвонить в Dev? Сейчас 29 сентября 2026, 12:00 Europe/Moscow. Помощник исключает закрытые заявки и показывает сначала просроченные контакты, включая назначенные на более раннее время сегодня. Даты контакта и граница суток определяются в указанном часовом поясе; полночь завтра уже не входит в сегодняшний список.
Для сводки по клиенту укажите имя, компанию и среду: например, Составь сводку в Dev по Дмитрию Орлову из «Маяка»: обращения, задачи и следующий шаг. Помощник использует явные связи и указывает таблицы, из которых взял сведения. Общий телефон разных людей не объединяет их истории. Срок задачи и дата её выполнения — разные сведения; предложенный следующий шаг остаётся рекомендацией. Если данные или часть связанных записей недоступны, сводка должна обозначить неполноту. Отсутствие записи в одной таблице не доказывает отсутствие всей истории клиента или назначенного контакта.
Диалог проекта работает только с этим проектом. Для чтения другого доступного проекта откройте его диалог или диалог организации. Ссылка на проект не даёт прав: если доступ закрыт, администратор должен проверить вашу роль и ограничения выбранного профиля Agent. Открытие нового диалога не обходит эти ограничения. По общему отказу в доступе нельзя определить, существует ли ресурс и какое именно право ограничено. Помощник должен назвать это ограничение без догадок о причине.
Если структура таблицы ещё не применена в выбранном окружении, помощник назовёт таблицу и окружение. По такому отказу нельзя определить число записей, выручку или динамику. Проверьте окружение и состояние структуры в Data, затем повторите запрос. Применение структуры — отдельное изменение; помощник не выполняет его автоматически ради чтения.
Широкую таблицу в ответе можно прокрутить по горизонтали. Телефоны и другие короткие значения сохраняют читаемую ширину даже в боковой панели.
Для изменения данных откройте диалог нужного проекта и укажите окружение. Если оно не задано, помощник предложит Dev. Проверьте карточку и подтвердите действие. Длинное описание раскрывается ссылкой «Показать изменения полностью»: прочитайте конкретные значения и окружение до подтверждения. До подтверждения изменение ещё не выполнено. После выполнения помощник проверит результат; таблица появится в Data, черновик — в Automations. Повторное нажатие подтверждения не создаёт второй ресурс.
Сохранение автоматизации не публикует и не запускает её. Можно попросить несколько шагов в одном сообщении: Измени черновик и протестируй его, рабочую версию оставь. После подтверждения и проверки первого изменения Agent продолжит оставшуюся задачу и при необходимости покажет следующую карточку подтверждения. Тест изменённого черновика готовится после его сохранения, чтобы выполнить именно новый вариант. Отмена или ошибка проверки останавливает цепочку. Если достигнут лимит запроса, выполненные действия сохраняются, а оставшиеся шаги не запускаются. Публикация может активировать настроенные триггеры. Обычный запуск использует опубликованную версию, а тест — сохранённый черновик. При тесте отдельного шага выполняются также все необходимые предыдущие шаги; последующие исключаются. Если версия или черновик изменились после подготовки подтверждения, старое предложение запуска отклоняется. Статус «В очереди» или «Выполняется» ещё не подтверждает завершение сценария.
Встроенный помощник ещё не удаляет записи и не развёртывает приложения. Эти шаги выполняются через соответствующие разделы платформы. В общем диалоге организации можно выбрать проект; для создания ресурсов перейдите в его диалог.
Название поля относится к общему каталогу проекта. Добавление поля применяет структуру только в выбранном окружении: Live может оставаться на предыдущей версии. Смена технического имени, типа или обязательности существующего поля требует отдельного плана в разделе схемы.
Новые действия работают через отдельное подтверждение. Автоматическое выполнение по заранее выданному разрешению сессии для встроенного помощника пока недоступно. Возможности подключаемых агентов зависят от их проверенного подключения и профиля; описанные далее правила работы с кодом и публикацией не расширяют список действий встроенного помощника.
Работа с App
Попросите помощника перечислить части App, показать файлы одной выбранной части или прочитать конкретный исходник. Он читает текущий черновик и скрывает закрытые пути и распознанные секреты. Большой файл или скрытое содержимое остаются непроверенными. Исходники общие для проекта: разрешение сессии только на одно окружение не даёт доступа к общему коду.
Для диагностики укажите приложение и окружение. Помощник проверит состояние именно выбранного сайта или API; доступные логи и метрики API потребуют отдельных разрешений профиля и сессии. Пустые метрики, недоступные логи и статус ресурса не подтверждают исправность формы или причину ошибки.
Если исходники приложения ещё не настроены, Agent сообщит, что чтение файлов недоступно. Это само по себе не означает нехватку прав и не устанавливает причину недоступности сайта. Запрос только на диагностику не настраивает исходники, не запускает сборку и не публикует приложение. Данные о состоянии сайта и назначенный адрес не доказывают, что сайт отвечает посетителю или что его домен работает. Без внешней проверки HTTP и DNS остаются непроверенными, а точная причина сбоя — неизвестной.
Встроенный помощник может подготовить создание стартового сайта, API или сайта с API в существующем Live. Нужна роль Developer или выше. Проверьте окружение и параметры в карточке действия. Создание выполняется после требуемого подтверждения, а итог проверяется чтением самих созданных ресурсов. Если окружение изменилось после подготовки, ресурсы по этой карточке не создаются. Запрос на Dev или Preview не переводится в Live автоматически. При создании через локального агента также выберите Live: подтверждение для Dev не разрешает создать ресурсы в Live.
Созданные стартовые ресурсы ещё не означают готовое приложение. Если вы также попросили изменить код и собрать приложение, помощник продолжит с отдельными действиями для записи файла, сохранения версии и сборки. Публикация, перенос между окружениями и откат через этот путь пока недоступны. Настройка входа выполняется отдельным действием. Создание бота и автоматизации также не входит в это действие. Помощник должен показать проверенный результат и оставшиеся шаги, а не сообщать, что весь сайт или пользовательский сценарий готовы.
При работе с кодом проверяйте результат каждого этапа отдельно: запись черновика, сохранение версии и сборка требуют своих точных действий. Исходники общие для проекта, поэтому разрешения только на одно окружение недостаточно. Для ограниченного пути работы с исходниками агент берёт один текстовый файл размером до 24 KiB; сохранение версии охватывает от 1 до 50 проверенных файлов выбранной части App. Удаление файлов и общие папки в этот путь не входят. Если содержимое не помещается в подготовленное действие, помощник сообщит об ограничении до записи файла.
Если после подготовки карточки кто-то изменил черновик или версию, подготовьте новое действие по актуальному состоянию. При неопределённом результате сначала проверьте сохранённые изменения: повторный запрос не должен повторять запись, сохранение версии или запуск сборки автоматически.
Если помощник сообщает, что достигнут лимит шагов, задача ещё не завершена. Уже выполненные действия сохраняются. Проверьте их статусы и попросите продолжить оставшуюся работу следующим сообщением. Система определяет предел работы сама; дополнительные этапы записи и проверки кода не обходят проверку доступного бюджета.
Статусы сборки «В очереди» и «Выполняется» означают, что результата ещё нет. Успешная сборка подтверждает только артефакт выбранной версии. Публикация, публичный адрес и работа формы или другого пользовательского сценария проверяются отдельно.
Ограничения
- Agent не получает общий список внутренних ресурсов проекта и не показывает
служебные идентификаторы. Он работает через продуктовые разделы и выбранный контекст.
- На уровне организации Agent не выполняет изменения внутри проекта без выбора
конкретного проекта и нужного подтверждения.
- Agent не читает значения сохраненных секретов и не показывает учетные данные
внешних сервисов. Для новых секретов используйте защищенный ввод.
- По запросу на новое подключение Agent может подготовить переход к защищённой
форме после подтверждения. Откройте её и введите ключ там. Подготовленная форма ещё не означает, что подключение сохранено или связь с сервисом проверена.
- Изменения проекта, схемы данных, автоматизации, публикация, откат, публичные
маршруты, удаления и действия с расходами требуют подтверждения.
- Когда Agent готовит действие, это еще не означает выполнение. Платформа
создает карточку подтверждения и ждет явного решения пользователя.
- Статус
Ожидает подтвержденияне означает ошибку. Если в задаче несколько
однородных файлов, они остаются в одной карточке с видимым именем каждого; выполнение продолжается только после подтверждения всей группы. Публикация, расходные, разрушительные и смешанные действия остаются отдельными карточками.
- Записанный черновик еще не означает, что сайт готов. Agent не должен показывать
итоговое Готово, пока не сохранена версия и не получен успешный проверяемый результат сборки. Публикация выполняется только отдельным действием.
- После запуска сборки нормально временно видеть статус
Выполняется. Agent проверяет именно эту сборку и не запускает её повторно. Пока нет итога, запуск остаётся активным, а кнопкаСтопдоступна. - Стартовое рабочее место нового сайта ещё не является готовым сайтом. Создание ресурсов, запись файла, сохранение версии и сборка проверяются отдельно; помощник продолжает только шаги вашего исходного запроса в пределах своего допуска.
- Перезапуск платформы не подтверждает и не выполняет ожидающее действие.
Карточку подтверждения нужно проверить и подтвердить отдельно после восстановления диалога.
- Подтверждение всегда проверяет текущий вход в аккаунт и права в проекте.
После перезагрузки откройте тот же диалог и подтвердите карточку заново; не требуется сохранять или переносить из старой вкладки какой-либо код.
- После подтверждения платформа заново проверяет роль, safety-лимиты, предел расходов
и доступный баланс. Если проверка не проходит, действие не запускается.
- Подтвержденное изменение выполняется один раз. Если работа прервалась в
момент, когда невозможно надежно определить результат, платформа не повторяет изменение автоматически и показывает ошибку. Проверьте фактический результат в нужном разделе проекта; при необходимости создайте новое действие и подтвердите его заново.
- Если один файл из общей группы не записался или его результат нельзя надежно
проверить, вся задача останавливается. Сохранение версии, сборка и публикация после такой ошибки не запускаются.
- Agent записывает код только в точно выбранную часть App. Если контекст не
выбран, недоступен или неоднозначен, подтверждение файлов не создаётся.
- Runtime SDK используется только в backend или worker. Если Agent обнаружит
SDK или server runtime token в Web-коде, запись файла будет отклонена. Web должен обращаться к публичному API или использовать сессию App Auth.
- Agent не придумывает методы SDK. Если нужной возможности нет в текущей
версии SDK, он должен использовать доступное действие продукта или показать ограничение, а не генерировать неработающий вызов.
- Agent может включить App Auth и настроить разрешённые адреса/срок сессии
после подтверждения. Секрет OAuth-провайдера вводится только в защищённой форме, а не в чате.
- Настройки App Auth действуют во всех окружениях проекта. Отключение требует
отдельного подтверждения и прекращает новые регистрации и входы. Если риск действия изменился, попросите Agent подготовить новую карточку: прежнее подтверждение не используется.
- Подтверждение не даёт права перезаписать более новый commit. Если репозиторий
изменился после подготовки карточки, сохранение версии останавливается; обновите контекст и попросите Agent подготовить действие заново.
- Если вы отменили все действия в общей карточке, запуск завершается как отменённый и сразу освобождает диалог. Если часть действий уже выполнена, а часть отменена, Agent останавливает следующие шаги и показывает частичный итог.
- Кнопка «Стоп» прекращает текущий запуск. Уже показанная часть ответа сохраняется в истории с отметкой о прерывании, в том числе после перезагрузки. Остановка не откатывает ранее выполненные изменения: их список показан в сохранённом итоге. Если список длинный, помощник указывает, сколько действий показано.
- Цены, карта, счета, предел расходов и пополнение баланса доступны только
владельцу организации и выполняются через отдельную защищённую форму.
- Все участники используют единый рублёвый баланс организации и могут
посмотреть расход помощника в разделе Агент. При создании рабочего пространства один раз начисляется бонус 1 000 ₽ для Агента, сборок, публикации и работы ресурсов; приглашения участников не повторяют начисление.
- Если доступного баланса недостаточно для безопасной оценки, новый запуск
завершается блокировкой с причиной нехватки средств и не уходит в минус. Такой отказ не должен оставлять диалог в бесконечном ожидании ответа. Сузьте задачу или попросите владельца проверить общий баланс организации. Уже работающие ресурсы живут по общим правилам нулевого баланса и не удаляются из-за одной задачи Агента.
- Успешное пополнение появляется в истории операций общего баланса. Бонус,
резерв и фактический расход показываются отдельными операциями.
- Agent не запускает скрытые автономные фоновые действия. Автоматизации должны
иметь понятное условие запуска, историю выполнения и, где нужно, ручное подтверждение.
- Переход по интерфейсу сам по себе не меняет контекст открытого диалога.
Между задачами можно добавить или удалить сущности в том же диалоге либо очистить выбор и вернуть автоматическое определение. Для отдельной темы создайте новый диалог кнопкой +.
- Пометка beta означает, что отдельные возможности ещё проверяются. Если
выбранный агент или модель недоступны, используйте доступный встроенный вариант либо обратитесь к администратору организации.
Как безопасно работать
- Откройте панель Agent и проверьте, что поле сообщения доступно, а панель
показывает текущий контекст.
- Чтобы начать отдельную тему, нажмите
+в верхней части панели. Чтобы
вернуться к старой теме, откройте историю диалогов и выберите нужный пункт.
- Для другой области измените контекст текущего диалога. Если это отдельная
тема, сначала создайте новый диалог кнопкой +, затем выберите его контекст.
- Формулируйте задачу результатом, без внутренних идентификаторов и секретов.
- Перед подтверждением проверьте, что именно изменится, возможные последствия,
срок действия карточки и оценку расхода, если она показана.
- Для секретов, интеграций, оплаты и лимитов переходите в защищенную форму,
которую показывает интерфейс.
- Если Agent показывает блокировку, сохраните видимую причину, период и
проект. Не отправляйте в поддержку секреты, полный технический ответ или внутренние идентификаторы.
Что дальше
Если задача прошла успешно, Agent должен назвать проверяемый результат и честно указать границу выполненного: например, Сборка завершена, публикация не выполнялась. Сообщение только о подготовленном черновике не означает готовый сайт. Если проверяемого результата нет, считайте запуск заблокированным и попросите помощника уточнить причину либо обратитесь к администратору организации.
Баланс, резерв, расход и покупки можно проверить в разделе Агент. Отдельного пользовательского экрана аномалий больше нет: технические проверки выполняет поддержка. Если данные выглядят неверно, передайте название организации и примерное время проблемы без текстов диалогов, секретов и платёжных данных.
Частые проблемы
| Проблема | Что сделать |
|---|---|
| Кнопка Agent не видна | Проверьте, включен ли Agent для организации и нет ли временного отключения. |
| Agent просит подтверждение | Проверьте, что именно изменится, последствия и свою роль, затем подтвердите только нужное действие. |
| Действие заблокировано ролью | Попросите Owner или Admin выполнить действие либо изменить доступ. |
| Agent не предлагает действие | Проверьте, что открыт нужный проект и у вас есть роль для этого изменения. |
После Погнали повторяется тот же ответ | Убедитесь, что в контексте выбран нужный App. Дождитесь общей карточки файлов и подтвердите её. Затем отдельно проверьте подтверждения сохранения версии и сборки. |
| Файлы ждут подтверждения | Это не ошибка: проверьте имена файлов в общей карточке и подтвердите или отмените группу. После подтверждения Agent проверит результат каждого файла. |
| Один файл завершился с ошибкой | Вся задача остановлена, а версия и сборка не запускаются. Проверьте указанное имя файла и безопасную причину, затем попросите подготовить действие заново. |
| Репозиторий изменился после подтверждения | Agent не перезапишет новую версию. Проверьте актуальные файлы и контекст, затем попросите подготовить изменение заново. |
| Сборка долго выполняется | Дождитесь итогового статуса в том же диалоге. Agent проверяет уже запущенную сборку; не повторяйте запрос. Если задача больше не нужна, нажмите Стоп. |
| Не хватает средств для запуска | Сузьте задачу или попросите владельца открыть общий баланс и пополнить его. |
| Провайдер не ответил | Дождитесь понятного итогового статуса, затем повторите более узкий запрос или откройте тот же диалог. |
| Нужен секрет или ключ | Не вставляйте значение в чат; откройте защищенную форму Connections. |
Agent не показывает Готово | Проверьте итоговый статус: задача может быть остановлена, заблокирована или завершена с ошибкой. |
| Проверка результата остановила выполнение | Изменения не признаны готовыми. Прочитайте причину в ответе и уточните задачу; завершённая проверка не блокирует поле сообщения. |
| Нельзя отправить сообщение | В текущем диалоге дождитесь завершения задачи, разберите подтверждение или нажмите Стоп. Другой диалог можно открыть или создать сразу. |
| Срок подтверждения истёк | Запуск завершится как заблокированный и освободит диалог автоматически. Попросите помощника подготовить действие заново. |
| Ответ на отправку не пришёл | Отправьте то же сообщение ещё раз: Agent вернёт исходную задачу, не создавая второй запуск. |
| Платформа или страница перезапускалась | Откройте тот же диалог и дождитесь восстановления статуса или карточки подтверждения; не отправляйте задачу и не подтверждайте действие повторно. |
| Открыт другой контекст | Продолжайте выбранный диалог: он использует сохраненный контекст. Для новой страницы нажмите +. |
| Agent перекрывает часть страницы | Это защитный режим для узкого рабочего пространства: основной экран сохраняет удобную ширину. Закройте Agent или сверните левое меню. |