ИИ-помощник · 0.8.1

Первая модель с ИИ: описать, уточнить и проверить

Создайте RELATED_ENTITY_NAME и ENTITY_NAME через переписку и проверьте поля и связи до Apply.

На этой странице

В этом примере добавим в проект небольшой каталог товаров. Начните с проекта, в котором ещё нет RELATED_ENTITY_NAME и ENTITY_NAME: помощник создаёт новые сущности и дорабатывает дополнения, которые пока не приняты.

1. Подготовьте проект

Откройте проект и сохраните или отмените незавершённые изменения в других формах генератора. AI работает с конкретной сохранённой версией модели. Он не объединяет запрос с незаполненной формой Content и не перезаписывает изменения, внесённые во время ожидания ответа.

Откройте Account, войдите и проверьте, что для AI assistant указан статус Available. Затем перейдите в AI Model.

2. Опишите результат

В поле Describe new entities перечислите нужные сущности, поля и связи. Если не уверены в реализации, опишите задачу — не обязательно заранее выбирать техническое решение.

Например:

Создай новый модуль Catalog с persistent-сущностями RELATED_ENTITY_NAME и ENTITY_NAME. В RELATED_ENTITY_NAME нужно обязательное название. В ENTITY_NAME — обязательное название, текстовое описание, цена и связь belongsTo с категорией. Создай связанные структуры вместе. Все существующие сущности и модули оставь без изменений.

Нажмите Send. В панели появится текущий этап обработки. Пока идёт запрос, можно просматривать модель: результат не применяется автоматически.

3. Уточните предложение до сохранения

Прочитайте объяснение помощника и посмотрите карточки сущностей. Правдоподобное название или тип поля ещё не означает, что они подходят вашему приложению.

До Apply можно продолжить переписку:

В этом предложении добавь ENTITY_NAME логическое поле published, а описание сделай переводимым на английский и русский. RELATED_ENTITY_NAME оставь как в предложении.

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

4. Проверьте связи

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

Если сохранённой сущности нужно добавить обратное поле, сделайте это вручную в Content / Relationships. Помощник не сможет изменить сохранённую сторону, чтобы завершить связь. Отклонённое предложение не меняет модель.

5. Разделите Apply и Generate

Примите предложение по инструкции Проверка, Apply и Undo. После Apply дополнения появятся в Content. Затем откройте Generate, посмотрите план и diff и запустите генерацию, когда будете готовы.

Дальнейшие изменения принятой ENTITY_NAME вносите в Content. AI сможет создать другую новую сущность, но уже не сможет дорабатывать ENTITY_NAME после её сохранения.