Использование функций ИИ в Конвертум Мастер

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

Доступны следующие функции искусственного интеллекта:
Запрос проекта (Project Prompt) — определяет специфичные для данного проекта инструкции, применяемые к запросам ИИ.
ИИ Чат (AI Chat) — позволяет пользователям задавать вопросы и анализировать файлы миграции.
ИИ-предложение (AI Suggestion) — анализирует текущий открытый файл и предлагает изменения в коде.
Результаты, сгенерированные искусственным интеллектом, всегда следует проверять прежде чем использовать их к файлам миграции.

Настройка функций ИИ

Для настройки функциональности ИИ:

  1. Откройте глобальные настройки (Global Settings).
  2. В секции ИИ-функции (AI Features) включите ИИ-функции (AI Features).
  3. Если модели ИИ нужно будет анализировать исходные или сконвертированные файлы, включите Доступ к файлам (File Access).
  4. Выберите провайдера ИИ.
  5. Укажите URL-адрес провайдера, API-ключ и другие необходимые параметры подключения.
  6. Нажмите Подключиться (Connect).
  7. Выберите основную модель и модель суб-агента (дополнительную модель).
  8. Нажмите Применить настройки (Apply Settings).

В поддерживаемые провайдеры могут входить:

  • YandexGPT
  • GigaChat
  • Ollama
  • Custom (Open AI-compatible)
  • Другие провайдеры, совместимые с OpenAI

После успешного подключения Конвертум Мастер отображает набор доступных моделей.
Основная модель генерирует основные ответы искуссвенного интеллекта. Дополнительная модель используется для поддержки задач анализа файлов и чтения кода.

После сохранения настроек перезапуск приложения не требуется.

AI_functions_1

Доступ к файлам

Включите доступ к файлам, если инструменту ИИ нужно читать файлы проекта миграции.

Доступ к файлам необходим для выполнения таких задач, как:

  • Анализ текущего открытого файла
  • Проверка исходного или сконвертированого кода
  • Анализ нескольких объектов проекта
  • Внесение изменений с помощью предложений ИИ Когда доступ к файлам выключен, Чат ИИ может отвечать на общие вопросы, но не может просматривать файлы проекта.

Промпт проекта

В разделе Промпт проекта оределены общие инструкции для запросов к ИИ в рамках текущего проекта.

Они содержат:

  • Правила наименования
  • Стандарты кодирования
  • Требования к целевой базе данных
  • Правила миграции, специфичные для проекта
  • Инструкции по предоставлению рекомендаций

Для настройки нужно:

  1. Открыть проект миграции.
  2. Нажать на Промпт проекта на панели инструментов проекта.
  3. Ввести необходимые инструкции.
  4. Нажать Сохранить.

Например:

Используй верхний регистр имен во всех названиях столбцов.
Проверь сконвертированный код на совместимость с целевой базой данных.
Сохрани исходную логику объекта.
Объясни все предложенные изменения.

Промпт проекта применяется как к чату с использованием ИИ, так и к предложеним ИИ в рамках текущего проекта.

AI_functions_2

ИИ Чат

ИИ Чат предоставляет интерактивный интерфейс для работы с настроенной моделью искусственного интеллекта.

Он может ипользоваться для:

  • Анализа файлов миграции
  • Проверки сконвертированного SQL-кода
  • Выявления проблем совместимости
  • Изучения результатов преобразования
  • Запроса рекомендаций
  • Задания общих вопросов, касающихся миграции

Чтобы открыть ИИ Чат нажмите на кнопку ИИ Чат на панели инструментов проекта.
Нажмите +Новый чат, введите запрос и нажмите Enter или используйте кнопку для отправки.

AI_functions_3

Режим чата

Режим чата предназначен для стандартных вопросов и целенаправленного анализа. Пример запросов:

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

В сообщении необходимо указать требуемый объем анализа. ИИ Чат может анализировать:

  • Текущий открытый файл
  • Файлы определенного типа объектов
  • Весь миграционный проект

Режим анализа файлов

В режиме анализа файлов выполняется более детальный анализ с использованием настроенных основной и дополнительной моделей.

Сгенерированный отчет может включать в себя:

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

Используйте анализ файлов для работы со сложными объектами, проверки нескольких файлов или проверки совместимости в рамках всего проекта.

AI_functions_4

История чата

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

ИИ-предложение

ИИ-предложение анализирует открытый на данный момент файл и генерирует предлагаемые изменения кода.

Чтобы использовать:

  1. Откройте файл в Редакторе файлов.
  2. Нажмите ИИ-предложение в панели инструментов редактора.
  3. При необходимости введите дополнительные инструкции.
  4. Нажмите Отправить.

Например:

Проверь файл на наличие неподдерживаемого синтаксиса в целевой базе данных и исправь выявленные ошибки.

AI_functions_5

Результат отображается в виде блока содержащего:

  • ТЕКУЩИЙ(CURRENT) — существующее содержимое файла
  • ПРЕДЛОЖЕНИЕ ИИ(AI SUGGESTION) — предлагаемые изменения

AI_functions_6

Доступны следующие действия:

Действие Описание
Предыдущее / Следующее Перемещение между предлагаемыми изменениями
Отклонить все Отклонить все сгенерированные изменения
Принять все Применить все сгенерированные изменения
Сохранить Сохранить принятые изменения в файл

Перед тем как нажать Принять все ознакомьтесь с полным списком изменений.

На данный момент ИИ-предложение не поддерживает принятие каждого изменения по отдельности. Когда требуется внести только часть предложений, внесите необходимые изменения вручную в редакторе файла.

Рекомендции

Для получения более точных и соответствующих результатов с помощью ИИ:

  1. Добавьте четкие требования в описание проекта.
  2. В каждом запросе необходимо указывать область анализа.
  3. Используйте Анализ файла для сложных и многофайловых проверок.
  4. Проверяйте все сгенерированные изменения прежде чем применять их.
  5. Убедитесь, что измененный код сохраняет исходную логику.
  6. Проверяйте сохраненные изменения в целевой базе данных.
  7. Сохраняйте настройки ИИ после изменения провайдера или модели. Функциональность ИИ дополняет стандартный процесс конвертации и проверки Конвертум Мастер. Она не должна заменять ручную проверку и тестирование в целевой среде.

Другие материалы по теме:
Как запустить конвертацию в режиме трассировки
Советы и рекомендации

Если у вас есть вопросы, пожалуйста, обращайтесь в нашу службу поддержки: support@convertum.ru