Запись [Инфостарт] AI-Анализатор 1С на базе Gemini (Иван Гончаров)

​

Быстро разбирайтесь в логике отчетов (ERF) и обработок (EPF) 1С с помощью AI! Расширение анализирует код, позволяя задавать вопросы и получать понятные объяснения о работе объекта на естественном языке.

Проблема, которую решает расширение:

Понимание логики работы сложных или незнакомых отчетов и обработок в 1С часто требует значительных усилий и времени на изучение кода. Документация может отсутствовать или быть неактуальной, а быстрый поиск ответа на конкретный вопрос ("Как рассчитывается этот показатель?", "Где используется этот реквизит?") затруднен.

Это ваш интеллектуальный помощник для работы с отчетами и обработками 1С. Используя мощь искусственного интеллекта Google Gemini, расширение анализирует код и структуру объектов, чтобы отвечать на ваши вопросы о их функциональности и логике работы. Оно помогает быстро разобраться даже в самом запутанном коде.

Почему выбрал Gemini?

Мой выбор в пользу Gemini обусловлен значительным размером его контекстного окна, достигающим 1 миллиона токенов. Такой объем позволяет передавать на анализ целиком даже очень крупные и сложные обработки или отчеты, что критически важно для глубокого анализа кода.

Ключевые возможности:

• Детальный анализ структуры EPF/ERF:
  • Автоматически разбирает внутреннюю структуру файлов .epf и .erf, извлекая все компоненты: модуль объекта, формы, макеты (включая СКД).
    
    
  • Понимает взаимосвязи между элементами объекта.
• Извлечение исходного кода:
  • Собирает полный текст модулей объекта, модулей форм, содержимое макетов СКД для предоставления AI наиболее полного контекста.
    
    
  • Опционально: Может анализировать объекты непосредственно из исходных файлов конфигурации (при настроенном пути).

• Интерактивный Диалог с AI (Google Gemini):
  • Предоставляет AI (Gemini) извлеченный код как основу для ответов.
    
    
  • Задавайте вопросы на естественном языке! Например:
    • "Объясни простыми словами, что делает эта обработка?"
      
      
    • "Как рассчитывается показатель 'Сумма взаиморасчетов' в этом отчете?"
      
      
    • "Где в коде используется реквизит 'Контрагент'?"
      
      
    • "Какие основные шаги выполняет процедура 'Сформировать печатную форму'?"
      
      
    • "Найди все запросы к базе данных в этом объекте."
• Интеграция и удобство:
  • Может быть вызвано непосредственно из формы анализируемого отчета или обработки.
    
    
  • Предоставляет интуитивно понятный интерфейс для ввода вопроса и просмотра ответа.
    
    
  • Отображает ответ AI в формате Markdown с подсветкой синтаксиса кода, что облегчает чтение и понимание.

Для кого это расширение:

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

Как начать:

1. Установите расширение в вашу конфигурацию 1С.
   • Важно: При установке снимите флаги "Безопасный режим" и "Защита от опасных действий", так как расширение использует внешние компоненты (COM) и доступ к файловой системе (для чтения EPF/ERF и исходников конфигурации).
2. Получите API ключ для Gemini (API key).
   
   
3. Настройте модель AI:
   • Откройте справочник Модели.
     
     
   • Создайте новый элемент.
     
     
   • Укажите "Имя модели" (ознакомится со списком моделей можно тут (Модели)).
     
     
   • Вставьте ваш API ключ.
     
     
   • Задайте системный промпт (инструкцию для AI, например: "Ты - опытный разработчик 1С. Анализируй предоставленный код и метаданные отчетов/обработок 1С и отвечай на вопросы пользователя максимально точно и понятно. Приводи фрагменты кода для иллюстрации.").

Опционально (для анализа из исходников конфигурации):

• Выгрузите конфигурацию в файлы через Конфигурация -> Выгрузить конфигурацию в файлы....
  
  
• Убедитесь, что у пользователей, которые будут использовать эту функцию, есть права на чтение в папке с выгруженными файлами.
  
  
• Укажите путь к этой папке в соответствующей константе настроек.
  
  

Опционально (для вызова из форм обработок):

• Добавьте команду на форму обработки.
  
  
• Вставьте код

Как использовать:

1. Способ 1: Анализ открытого объекта (если настроена интеграция):
   • Откройте нужный отчет или обработку в режиме 1С:Предприятие.
     
     
   • Нажмите на добавленную кнопку/команду вызова анализатора.
2. Способ 2: Анализ файла EPF/ERF:
   • Откройте основную форму диалога (через меню "Мастер 1С" -> "Диалог").
     
     
   • Нажмите кнопку выбора файла и укажите путь к .epf или .erf файлу, который хотите проанализировать.
3. Задайте вопрос: Введите ваш вопрос о работе объекта на естественном языке в поле для ввода.
   
   
4. Получите ответ: Нажмите кнопку "Задать вопрос" (или аналогичную). Расширение отправит запрос к Gemini, передав ему контекст (код, структуру) и ваш вопрос. Ответ AI будет отображен в специальном поле.

Пример:

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

Технические требования:

• Доступ в Интернет (для работы Gemini API).
  
  
• Возможно Вам потребуется VPN и DNS для обхода блокировок.
  
  
• API ключ Gemini: Необходимо получить собственный ключ и указать его в настройках расширения (в справочнике "Модели").
  
  
• Возможность использования COM-объекта VBScript.RegExp.