Использование «1С:Напарника» в разработке

«1С:Напарник» — это встроенный в «1С:Предприятие.Элемент Скрипт» интеллектуальный помощник, использующий технологии искусственного интеллекта для ускорения написания кода и решения прикладных задач. Он позволяет автоматизировать работу разработчика, помогая сократить рутину и сосредоточиться на более творческих задачах.

Основные возможности «1С:Напарника» включают:

• дополнение кода,
• генерацию кода по текстовому описанию,
• поиск и исправление ошибок,
• написание комментариев.

Подключение «1С:Напарника»

Чтобы подключить «1С:Напарника», выполните следующие действия:

1. Получите ключ доступа к «1С:Напарнику» на сайте code.1c.ai.

2. В строке состояния среды разработки нажмите на надпись 1С:Напарник (недоступен).

   

3. Откроется вкладка настроек «1С:Напарника». Введите полученный ключ в поле Ключ доступа пользователя. На этой вкладке вы также можете изменить режим автодополнения кода и указать количество строк, применяемых при автодополнении.

   

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

Вы также можете изменить настройки «1С:Напарника» в параметрах среды разработки. Для этого в левой панели действий нажмите Управление → Параметры и перейдите на вкладку 1С:Напарник.

Автодополнение кода

Если вы выбрали автоматический режим автодополнения, вам станет доступна интеллектуальная подсказка при написании кода. Нажмите Tab, если вы хотите принимать подсказку блоками в соответствии с настройкой Количество строк. Вы также можете принимать подсказку последовательно по одному слову с помощью комбинации клавиш Ctrl+→.

Если вы выбрали ручной режим автодополнения, нажмите Ctrl+Alt+Пробел, чтобы отобразить подсказку.

Чат с «1С:Напарником»

Вы можете использовать отдельный чат с «1С:Напарником» для решения своих задач. Чтобы открыть чат, нажмите Главное меню → Вид → Чат с 1С:Напарником (или Ctrl+Alt+I).

В чате напишите запрос к «1С:Напарнику». Например, попросите его реализовать метод для вычисления факториала числа. Вы можете скопировать получившийся код или вставить его в позицию курсора.

Далее вы можете выполнить рефакторинг сгенерированного метода, попросив «1С:Напарника» сделать метод рекурсивным. «1С:Напарник» опишет выполненные действия и предложит применить изменения в скрипте.

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

После того как вы закончили решать задачу, вы можете создать новый чат с «1С:Напарником», нажав на знак +.

Переменные чата

Вы можете использовать переменные в чате с «1С:Напарником», чтобы быстро добавлять в запрос структурированный контекст из среды разработки (например, код текущего метода, выделенный текст, содержимое файла и т. д.) без ручного копирования его содержимого.

Вставить переменную в чат можно двумя способами:

• Введите символ #, чтобы отобразить список выбора переменной. Для перемещения по списку используйте стрелки ↑ / ↓. Список поддерживает поиск переменной по имени. После выбора нужной переменной нажмите Ввод.
• Нажмите Управление → Переменные чата с 1С:Напарником (или Ctrl+Alt+Shift+V), чтобы открыть в среде разработки полный список поддерживаемых переменных. Кликните два раза по нужной переменной, и она появится в поле ввода сообщения чата.

Некоторые переменные поддерживают передачу в чат определенного значения. Например, переменная #МетодТекущегоМодуля: позволяет передать произвольный метод из редактора текущего скрипта. Для выбора значения поставьте курсор сразу после двоеточия в конце переменной и нажмите Ctrl+Пробел или Ctrl+I.

Полный список переменных приведен в таблице ниже.

Переменная	Передает в чат
#ВыделенныйКод	Выделенный код в текущем редакторе
#ИсключениеТекущегоМодуля:	Код произвольного исключения в текущем скрипте
#КонстантаТекущегоМодуля:	Код объявления константы в текущем скрипте
#КонтекстРедактора	Контекст активного редактора: файл, язык, выделение, позицию курсора и диагностику
#МетодТекущегоМодуля:	Код произвольного метода в текущем скрипте
#Модуль:	Код произвольного скрипта в рабочей области
#НомерСтроки	Номер текущей строки в текущем редакторе кода
#ОткрытыеРедакторы	Список всех открытых редакторов
#ОтносительныйПутьТекущегоФайла	Относительный путь текущего файла
#ОтносительныйПутьТекущейДиректории	Относительный путь текущей директории
#ПеречислениеТекущегоМодуля:	Код произвольного перечисления в текущем скрипте
#Сегодня	Текущую дату
#СодержимоеТекущегоФайла	Содержимое текущего файла
#СсылкиНаИсключениеТекущегоМодуля:	Все ссылки на произвольное исключение текущего скрипта
#СсылкиНаКонстантуТекущегоМодуля:	Все ссылки на произвольную константу текущего скрипта
#СсылкиНаМетодТекущегоМодуля:	Все ссылки на произвольный метод текущего скрипта
#СсылкиНаПеречислениеТекущегоМодуля:	Все ссылки на произвольное перечисление текущего скрипта
#СсылкиНаСтруктуруТекущегоМодуля:	Все ссылки на произвольную структуру текущего скрипта
#СтруктураТекущегоМодуля:	Код произвольной структуры в текущем скрипте
#ТекущийМетод	Код метода под курсором

История чатов

Вы можете просмотреть историю чатов с «1С:Напарником» и вернуться к любому из них. Для этого нажмите кнопку Показать чаты:

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

Контекстная подсказка

Действия над кодом

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

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

В таблице ниже приведены доступные действия всплывающего меню. Пункт Исправь отображается только при наличии ошибок в выделенном коде.

Действие	Текст отправляемого запроса
Исправь	Найди и исправь проблемы/ошибки в коде #КонтекстРедактора
Ревью	Сделай ревью кода #КонтекстРедактора
Объясни	Объясни, что делает код, для чего он был сделан, кем, когда и в рамках какой задачи? #ГитКтоИзменялВыделение #КонтекстРедактора

Контекстное меню

Вы также можете получить помощь «1С:Напарника» при редактировании кода с помощью контекстного меню Спросить 1С:Напарника, которое отображается при нажатии на выделенный участок кода правой кнопкой мыши.

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

В таблице ниже приведено описание команд, доступных в контекстном меню.

Пункт меню	Текст отправляемого запроса	Сочетание клавиш для вызова
Задать вопрос о коде	Заготовленный текст отсутствует. Вы можете ввести произвольный запрос	Alt+I, Alt+A
Исправить ошибки	Найди и исправь проблемы/ошибки в коде #КонтекстРедактора	Alt+I, Alt+C
Объяснить, что делает этот код	Объясни, что делает код, для чего он был сделан, кем, когда и в рамках какой задачи? #ГитКтоИзменялВыделение #КонтекстРедактора	Alt+I, Alt+E
Сделать ревью кода	Сделай ревью кода #КонтекстРедактора	Alt+I, Alt+R

Исправление ошибок с помощью «1С:Напарника» также доступно из контекстного меню панели Проблемы: