Быстро разбирайтесь в логике отчетов (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С.
- Важно: При установке снимите флаги "Безопасный режим" и "Защита от опасных действий", так как расширение использует внешние компоненты (COM) и доступ к файловой системе (для чтения EPF/ERF и исходников конфигурации).
- Получите API ключ для Gemini (API key).
- Настройте модель AI:
- Откройте справочник Модели.
- Создайте новый элемент.
- Укажите "Имя модели" (ознакомится со списком моделей можно тут (Модели)).
- Вставьте ваш API ключ.
- Задайте системный промпт (инструкцию для AI, например: "Ты - опытный разработчик 1С. Анализируй предоставленный код и метаданные отчетов/обработок 1С и отвечай на вопросы пользователя максимально точно и понятно. Приводи фрагменты кода для иллюстрации.").
Опционально (для анализа из исходников конфигурации):
- Выгрузите конфигурацию в файлы через Конфигурация -> Выгрузить конфигурацию в файлы....
- Убедитесь, что у пользователей, которые будут использовать эту функцию, есть права на чтение в папке с выгруженными файлами.
- Укажите путь к этой папке в соответствующей константе настроек.
Опционально (для вызова из форм обработок):
- Добавьте команду на форму обработки.
- Вставьте код
Как использовать:
- Способ 1: Анализ открытого объекта (если настроена интеграция):
- Откройте нужный отчет или обработку в режиме 1С:Предприятие.
- Нажмите на добавленную кнопку/команду вызова анализатора.
- Способ 2: Анализ файла EPF/ERF:
- Откройте основную форму диалога (через меню "Мастер 1С" -> "Диалог").
- Нажмите кнопку выбора файла и укажите путь к .epf или .erf файлу, который хотите проанализировать.
- Задайте вопрос: Введите ваш вопрос о работе объекта на естественном языке в поле для ввода.
- Получите ответ: Нажмите кнопку "Задать вопрос" (или аналогичную). Расширение отправит запрос к Gemini, передав ему контекст (код, структуру) и ваш вопрос. Ответ AI будет отображен в специальном поле.
Пример:
Пользователь задает вопрос о конкретном показателе. AI предоставляет развернутый ответ, объясняя логику расчета.
Технические требования:
- Доступ в Интернет (для работы Gemini API).
- Возможно Вам потребуется VPN и DNS для обхода блокировок.
- API ключ Gemini: Необходимо получить собственный ключ и указать его в настройках расширения (в справочнике "Модели").
- Возможность использования COM-объекта VBScript.RegExp.
