ИИ-агент

AI Agent позволяет работать с ИИ-агентами прямо из десктопного приложения FlutterFlow. Не нужно открывать терминал, переходить в папку проекта и настраивать инструменты командной строки — FlutterFlow проверяет окружение и готовит всё сам.

После выбора агента FlutterFlow запускает его с нужным контекстом проекта: при необходимости ставит или проверяет CLI, разворачивает локальное рабочее пространство, регистрирует сервер MCP и проводит через авторизацию. Дальше вы описываете, что нужно изменить, смотрите план агента и применяете правки.

Работа с проектом идёт через FlutterFlow CLI по той же схеме, что описана в разделе про работу с ИИ-агентами.

инфо
Только десктопное приложение

AI Agent есть только в десктопном приложении FlutterFlow — в браузерной версии его нет. Скачать: FlutterFlow desktop app.

заметка
Не путать с ИИ внутри приложения

Эта страница — про внешних агентов, которые правят ваш проект FlutterFlow. Если нужно встроить ИИ в само приложение — чат, синтез и распознавание речи, генерацию картинок и видео, — см. ИИ-агенты.

Что удобно поручать агенту:

  • создание и правку страниц и компонентов;
  • настройку свойств виджетов, раскладки, оформления и адаптивности;
  • связывание действий, блоков действий, состояния и событий приложения;
  • обновление темы, токенов оформления и навигации;
  • разбор структуры проекта и поиск проблем;
  • точечные правки конкретного виджета через Copy AI Selector.

Что агент может и чего не может — см. область правок агента.

Что нужно заранее

Настройка

При первом открытии AI Agent проверяет, готово ли окружение.

инфо

Отдельное десктопное приложение агента ставить не нужно: панель настройки сама проверит нужные инструменты командной строки и предложит доустановить недостающие.

  1. Откройте проект в десктопном приложении FlutterFlow.
  2. Нажмите значок мозга на панели инструментов.
  3. В панели Set up your AI agent выберите Claude или Codex.
  4. Посмотрите список проверок: CLI агента, Flutter SDK, FlutterFlow CLI, локальное рабочее пространство и вход в аккаунт.
  5. Если чего-то не хватает, нажмите Install required tools.
  6. После установки и входа нажмите Re-check.
  7. Войдите в аккаунт выбранного агента — Anthropic для Claude, ChatGPT для Codex.

Агент работает на вашем аккаунте и подчиняется его лимитам. CLI выполняется локально на вашем компьютере и отправляет запросы, контекст проекта и ответы модели через выбранного поставщика — по его правилам обработки и хранения данных. FlutterFlow ваши переписки не получает и не хранит.

Работа

  1. Опишите задачу: «создай страницу настроек профиля», «почини действие кнопки входа», «приведи эту карточку к новому макету».
  2. Просмотрите предложенные изменения, прежде чем применять.
  3. Проверьте результат глазами в редакторе.
совет

Для точечной правки щёлкните по виджету правой кнопкой и выберите Copy AI Selector. Вставьте селектор в запрос — агент найдёт именно тот виджет, который вы имели в виду.

Настройки

Значок Settings в панели AI Agent открывает параметры подключения:

  • Workspace location — где создаются локальные рабочие пространства MCP и какое из них соответствует открытому проекту.
  • Claude — вход в аккаунт и разрешения: какие инструменты Claude может запускать без отдельного подтверждения. Файл разрешений — ~/.claude/settings.json.
  • Codex — текущий аккаунт ChatGPT, тариф и остаток лимитов по данным Codex CLI. Отсюда же выполняется выход.
  • Codex permissions — разрешения Codex; файл — ~/.codex/config.toml.
  • Terminal — какой терминал открывать по команде Open in terminal.
  • Show conversation recap — краткая сводка переписки над полем ввода после нескольких сообщений.
  • Troubleshooting — выгрузка диагностических журналов: установка инструментов, разворачивание рабочего пространства, запуск CLI, ошибки. Переписки и личные данные в журналы не попадают.
  • Privacy — напоминание о том, что CLI работает локально, а переписки обрабатываются по правилам выбранного поставщика.
совет

Если после установки инструментов или входа состояние не обновилось, нажмите Re-check. Не помогло — перезапустите десктопное приложение и откройте панель заново.

Что стоит учесть

  • Описывайте желаемый результат, а не только виджет, который нужно поменять.
  • Пользуйтесь Copy AI Selector, когда похожих виджетов несколько или нужный лежит глубоко в дереве.
  • Перед крупными изменениями попросите агента сначала разобраться в текущей структуре проекта.
  • Проверяйте правки в визуальном редакторе, прежде чем давать следующий запрос.
  • Держите Live Session запущенной только пока действительно работаете.
перевод официальной документации FlutterFlow

обновлено

ESC