ИИ-агент (десктоп)

В десктопных приложениях — Falang и Falang для Arduino — есть встроенный ИИ-агент: опишите обычными словами, что нужно изменить, и он правит схемы теми же действиями, что и вы вручную (вставка, перемещение и удаление иконок, изменение их текста). Каждое изменение сразу видно на холсте, и его можно отменить. У веб-конструктора Workflow свой агент, см. ИИ-агент в разделе Workflow.

Настройка

Агент работает с любым OpenAI-совместимым API: с самим OpenAI, с другим провайдером с совместимым API или с локальным сервером. Выберите Настройки → Агент… и заполните:

• Base URL — корневой адрес API, например https://api.openai.com/v1;

• API key — ваш ключ для этого API;

• Model — имя модели, например gpt-4o-mini.

Настройки относятся к приложению на этом компьютере и действуют для всех проектов. Они хранятся в собственном файле настроек приложения, а не в папке проекта, поэтому ключ не попадёт в проект, которым вы делитесь или который коммитите. Пока агент не настроен, его панель показывает подсказку открыть Настройки → Агент….

Как открыть агента

Выберите Проект → Агент (в приложении для Arduino — Скетч → Агент). Чат открывается в правой боковой панели, которую он делит с историей версий, — одновременно показывается что-то одно. Чат относится ко всему проекту, а не к одной вкладке: переключение вкладок не прерывает выполняющийся запрос. Кнопка «Остановить» отменяет его.

Что агент умеет менять

• В Falang: функции проектов конструктора логики и схемы проектов с кодом. Текстовые проекты не поддерживаются.

• В Falang для Arduino: setup, loop и остальные ваши схемы. В документе Devices агент может читать и заменять таблицы выводов и устройств.

• Агент не ограничен открытой вкладкой: он может читать и менять другие схемы проекта и сам открывает вкладку схемы, с которой начинает работать.

• Новые документы он не создаёт — создайте схему сами и попросите агента её заполнить или воспользуйтесь агентом для программирования, который это умеет.

Отмена

Один запрос — это один шаг отмены в каждой затронутой схеме. Кнопки «Отменить» и «Повторить» в панели (или Ctrl+Z в схеме) откатывают и возвращают весь запрос разом; ваши собственные правки, сделанные после него, — отдельные шаги.

Сессии чата

Разговоры хранятся как сессии проекта: можно начать новую, переключаться между ними, переименовать, удалить или экспортировать сессию в JSON-файл. Сессии сохраняются в папке проекта, по файлу на сессию в falang/agent-sessions/. Под каждым ответом панель показывает, сколько токенов он потратил, а отдельные шаги агента можно раскрыть.

Уточняющие вопросы

Если запрос неоднозначен так, что от этого зависит результат, агент останавливается и задаёт один вопрос с несколькими вариантами вместо того, чтобы гадать. Нажмите на вариант, выберите «Другое…», чтобы ввести свой ответ, или «Реши сам», чтобы агент выбрал сам; ответ продолжает тот же разговор. Подряд агент задаёт не больше трёх вопросов. Чтобы вопросов не было совсем, включите в панели «Не спрашивать, просто делать» — настройка запоминается для каждого проекта.