Настройка Кода Genie с помощью пользовательских инструкций

Настройте Genie Code с помощью пользовательских инструкций и инструкций рабочей области, в которых задаются предпочтения, правила оформления кода, ролевой контекст и рекомендации. Genie Code применяет эти инструкции ко всем ответам, включая встроенные подсказки и Suggest Fix. Быстрое исправление и автозаполнение являются исключениями.

Например, инструкции могут включать:

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

За исключением Quick Fix и Autocomplete, Genie Code применяет инструкции ко всем создаваемым им ответам, включая встроенные подсказки, чат и Suggest Fix.

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

Genie Code поддерживает два типа инструкций: инструкции пользователя и инструкции рабочей области. Если не указано иное, Genie Code обычно отдает приоритет инструкциям рабочей области над инструкциями пользователя.

Добавление инструкций пользователя

Инструкции пользователя позволяют предоставлять системные инструкции в Genie Code. Это постоянный способ совместного использования контекста, предпочтений или предпочитаемых методов разработки. Эти инструкции относятся к вам и применяются только к взаимодействию с Genie Code.

Чтобы добавить инструкции пользователя, выполните следующие действия.

1. Откройте область кода Genie, щелкнув В правом верхнем углу рабочей области.

2. На панели «Genie Code» щелкните , чтобы открыть настройки Genie Code.

   

3. В разделе "Инструкции пользователя" нажмите кнопку "Добавить файл инструкций". При этом создается .assistant_instructions.md файл в каталоге рабочей области пользователя по умолчанию (/Users/<your-username-or-email>) и открывается на новой вкладке файла.

   Если вы уже создали файл инструкций, нажмите кнопку "Открыть файл инструкций ", чтобы открыть файл.

4. Измените файл, чтобы добавить пользовательские .assistant_instructions.md инструкции. Databricks рекомендует добавлять ваши инструкции на простом английском языке, разделяя каждую инструкцию как новый пункт списка или абзац. См. рекомендации по инструкциям по коду Genie.

Genie Code автоматически воспринимает инструкции при следующем взаимодействии с ним.

Вы также можете использовать код Genie для добавления инструкций для вашего удобства. На панели "Код Genie" попросите Genie Code вспомнить что-то.

Инструкции по добавлению и просмотру рабочих областей

Замечание

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

Инструкции по рабочей области настраиваются администратором рабочей области и предоставляют дополнительные контексты для Genie Code, чтобы помочь ему следовать рекомендациям и эффективно работать в рабочей области.

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

1. В каталоге Workspace/ рабочей области создайте файл с именем .assistant_workspace_instructions.md.
2. Измените файл, чтобы добавить инструкции для Genie Code, которые должны применяться на уровне рабочей области. Databricks рекомендует добавлять ваши инструкции простым текстом, оформляя каждую инструкцию отдельным пунктом списка или абзацем. См. рекомендации по инструкциям по коду Genie.

Genie Code автоматически загружает новые рабочие инструкции пространства в следующий раз, когда пользователь взаимодействует с ним.

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

1. Откройте область кода Genie, щелкнув В правом верхнем углу рабочей области.

2. На панели «Genie Code» щелкните , чтобы открыть настройки Genie Code.

3. В разделе "Инструкции по рабочей области" нажмите кнопку "Просмотреть файл". Откроется .assistant_workspace_instructions.md файл на новой вкладке.

4. Если вы являетесь администратором рабочей области, вы можете изменить файл и добавить инструкции, применимые к поведению Genie Code во всей рабочей области. Дополнительные сведения о добавлении инструкций см. в рекомендациях по использованию Genie Code .

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

   

Рекомендации по инструкциям по коду Genie

Важно учитывать потенциальные ограничения Genie Code при предоставлении инструкций. Ниже приведены некоторые общие рекомендации и советы по написанию инструкций по оптимизации взаимодействия и наиболее эффективной работы с этой функцией.

• Напишите четкие, конкретные инструкции: Будьте явными и однозначно при написании инструкций.
• Следуйте инструкциям в 20 000 символов: Файлы инструкций ограничены 20 000 символами. Genie Code не использует никаких инструкций после этого ограничения. Будьте краткими и отдавайте приоритет важным инструкциям.
• Используйте заголовки и разделители для структуры: Инструкции приведены в файлах Markdown. Используйте форматирование Markdown в инструкциях для предоставления структуры. Используйте маркеры в качестве разделителей для разделения отдельных инструкций. Используйте заголовки для группировки набора инструкций. Например, у вас может быть заголовок "Конвенции по коду Python", который включает маркированный список рекомендаций, специфичных для Python, которые Genie Code должна соблюдать при работе с Python.
• Область применения: Genie Code применяет инструкции к каждому ответу, который он генерирует, когда вы взаимодействуете с ним с помощью Inline Genie Code, General Chat, Suggest Fix и аналогичных функций. Однако Genie Code не учитывает инструкции для Quick Fix и Autocomplete. Чтобы избежать непреднамеренного поведения, следуйте инструкциям, имеющим широкое отношение к различным функциям Genie Code.
• Укажите контекст и ссылки: В то время как Genie Code использует окружающий контекст, например код записной книжки и метаданные таблицы, он пока не получает дополнительные сведения на основе инструкций. Чтобы обеспечить полезные ответы, добавьте все ключевые сведения непосредственно в инструкции, например, когда следует использовать определенную таблицу или функцию.