Режим плана: ассистент показывает план до того, как что-то менять
Как встроенный ассистент Opfield работает с реальными изменениями: изучает состояние инструментами только для чтения, показывает план, ждёт вашего подтверждения, выполняет его в фоне и проверяет результат.
Автор: команда Opfield4 мин чтенияОбновлено
В интерфейс Opfield встроен ассистент — AI Workspace. Вы обычными словами говорите, чего хотите добиться, а он сам определяет шаги. Если работа меняет инфраструктуру, он сначала показывает план и ждёт. Пока вы не подтвердите, ничего не меняется. Ниже о том, как это устроено и где проходят границы.
Опишите результат
Начать можно двумя способами: написать, какой результат нужен, или выбрать готовый сценарий. Сценарии покрывают типовые задачи: первоначальную настройку, состояние инфраструктуры, узлы, Docker, публикацию и диагностику маршрутов, TLS, логирование, уведомления, базы данных, страницы статуса и делегирование доступа. Запрос в свободной форме работает так же: чтобы начать, достаточно написать «Выпусти payments-api 2.4.2 без простоя».
На обычные вопросы ассистент просто отвечает: объясняет, как что-то работает, читает документацию или смотрит состояние ресурса. Он знает, на какой странице вы находитесь, поэтому «почему этот маршрут не работает» относится к маршруту, который у вас перед глазами.
Сначала изучение, потом изменения
Если в работе несколько шагов, она затрагивает несколько ресурсов, требует долгого изучения или несёт реальный риск, ассистент переходит в режим плана. Включить режим плана можно и самому.
В режиме плана у ассистента есть только инструменты для чтения. Он смотрит на текущее состояние: релиз, логи, метрики, маршруты и затронутые узлы. Если что-то неясно, он задаёт уточняющий вопрос, а не угадывает. Ответ на уточняющий вопрос ничего больше не разрешает.
The new version expects STRIPE_KEY, which the production environment does not have.
План, который вы подтверждаете
Изучение заканчивается структурированным планом. В нём отдельно указано, что найдено, проверка намерения и безопасности, шаги, которые нужно выполнить, и финальная проверка.
Действия, которые что-либо меняют, становятся доступны только после того, как вы явно подтвердите план. До этого ассистент ничего не может изменить, как бы ни шёл разговор.
Проверяйте план так же, как изменение коллеги. В нём должны быть названы конкретные ресурсы, а не «все затронутые сервисы», и сказано, что заметят клиенты, когда откатываться и как будет проверен результат. Если один из шагов — команда в shell или прямое изменение базы данных, спросите, нельзя ли сделать то же обычной операцией Opfield.
Выполнение в фоне
Подтверждённый план выполняется в фоне. Вы видите прогресс по шагам и можете поставить его на паузу, продолжить или отменить. Выполнение принадлежит Opfield, а не вкладке браузера, так что закрытая панель его не останавливает.
Когда шаги выполнены, отдельный проверочный запуск проверяет результат. Успешный вызов инструмента ещё не значит, что цель достигнута, поэтому план заканчивается этой проверкой, а не последним шагом. После этого всё равно стоит самому проверить путь, которым идут клиенты.
В каждой рабочей сессии (Work Session) одновременно активен один план. Разные рабочие сессии выполняют свои планы независимо.
Ваши права, и не больше
Собственного доступа у ассистента нет. Он действует от имени пользователя, который его попросил, и работает только через инструменты Opfield, которые проверяют права. Модель получает только те инструменты, которые разрешают ваши права, а Opfield при каждой операции заново проверяет права, то, что входит в вашу лицензию, корректность данных и состояние ресурса. Если вы не можете что-то сделать в интерфейсе, ассистент тоже не может.
Планирование отделено от режима одобрения. Планирование всегда только читает. Подтверждённый план выполняется по вашим текущим настройкам одобрения, так что действия, которые требуют вашего одобрения, по-прежнему его запрашивают. Ассистент также учитывает доступ к инструментам для каждого пользователя. Он спрашивает, прежде чем показать или сменить учётные данные или экспортировать закрытые ключи, и не может менять ваши способы входа, MFA и сессии. Сценарии подчиняются тем же правилам.
Каждое действие в журнале аудита
Ассистент использует те же операции, что интерфейс, REST API и MCP, и его действия попадают в тот же журнал аудита — от имени пользователя, который его попросил. Чтобы узнать, что изменил план, откройте журнал аудита и созданные им задачи, а не полагайтесь на сводку в чате.
Если вам удобнее работать через собственного агента в редакторе или чат-приложении, те же инструменты и правила доступны через MCP — об этом в статье Управление инфраструктурой с ИИ-агентами через MCP.
По желанию и с моделью на ваш выбор
AI Workspace по умолчанию выключен. Администратор включает его и выбирает модель: настроенного OpenAI-совместимого провайдера или опубликованную модель Opfield Inference. До этого никакие данные не уходят к провайдеру ИИ. Модель закрепляется за каждым разговором, и ассистент предупреждает, прежде чем вы смените модель посреди чата.
Всё, что делает ассистент, доступно и без ИИ: в Operations Console, через REST API и MCP. Чат есть на любом плане. Для режима плана и сценариев нужен Personal или выше.
С чего начать
Попросите администратора включить AI Workspace и подключить модель, а затем начните с вопроса только на чтение о сервисе, который вы хорошо знаете. На странице AI Workspace в документации https://docs.opfield.dev описаны права, работа с данными и список проверок для плана.