Перейти к содержимому
ШагоматШагоматШагоматДокументация
shagomat.ruВойтиПопробовать бесплатно

ИИ-агент

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

Прежде чем ответить, агент проверяет проект так же, как сборка (компиляция и проверка типов), и исправляет найденные ошибки, поэтому обычно отвечает вместе с проектом, который собирается.

Нажмите Агент на тулбаре проекта. Чат открывается в правой панели вместо истории версий. Панель относится ко всему проекту: переключение вкладок не прерывает выполняющийся запрос. Кнопка × в шапке панели закрывает её.

  • Новый проект с агентом. Если проектов ещё нет, на странице Проекты можно сразу описать задачу — проект создастся, и агент начнёт работу (см. Первый проект).
  • Пустой проект (без триггеров, функций и типов) открывается сразу с панелью агента.
  • Читать и менять любые триггеры, функции и типы проекта, а не только открытый документ.
  • Создавать новые документы и интеграции. Учётные данные он оставляет пустыми — заполните их сами в документе Интеграции.
  • Подбирать подходящую интеграцию по смыслу (например, триггер Telegram «При команде» для команды бота).
  • Для мессенджер-бота без токена — создать интеграцию с тест-ботом платформы, чтобы бота можно было сразу попробовать.
  • Работать в проекте, где ещё ничего нет.

Шаги под ответом показывают, что агент делал: какие документы читал и записывал и когда проверял проект.

Каждая запись документа агентом — один шаг отмены. Кнопка «Отменить» в панели откатывает их по одному, «Повторить» возвращает. Ваши собственные правки после ответа агента — отдельные шаги. Любое состояние проекта можно также вернуть через историю версий.

Переписка хранится сессиями внутри проекта: можно начать новую, переключаться между ними, переименовать, удалить или сохранить сессию в JSON-файл. Новая сессия называется по началу первого сообщения. Сессии хранятся в вашем браузере.

Если от ответа зависит устройство результата (например, какую интеграцию использовать), агент не гадает, а спрашивает. О деталях, которые можно разумно выбрать самому, он не спрашивает.

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

Если вопросы не нужны, включите «Не спрашивать, просто делать» в шапке панели. Настройка запоминается для проекта в вашем браузере.

Агент оплачивается с баланса по числу обработанных токенов. Над чатом видно текущий баланс, под каждым ответом — сколько токенов он потратил. Платит тот, кто отправил запрос, даже в чужом проекте.

  • Описывайте результат, а не шаги: что должно происходить, для кого и что считать успехом.
  • Большую задачу проще сделать за несколько сообщений: сначала основной сценарий, потом уточнения.
  • Проверяйте результат на тестовом стенде — агент собирает проект, но не нажимает кнопки в вашем боте.
  • Отдельный шаг удобно описать прямо на схеме — магическим узлом.