Использование кода Genie

Genie Code помогает разработчикам создавать, оптимизировать, объяснять и исправлять код в записных книжках Azure Databricks, редакторе SQL, заданиях, панелях мониторинга ИИ/BI и редакторе файлов.

Чтобы узнать, как Genie Code помогает с кодом, смотрите Получение помощи с кодом от Genie Code.

Обзор панели Genie Code

Чтобы открыть панель Genie Code, щелкните в правом верхнем углу страницы.

Введите запрос в текстовом поле в нижней части области, а затем нажмите клавишу ВВОД или нажмите кнопку Можно сделать следующее:

• Нажмите значок плюса, чтобы подключиться к серверам MCP или прикрепить файлы.
• Щелкните значок или введите @, чтобы выбрать ресурсы, на которые Genie Code сможет ссылаться.
• Введите /, чтобы выбрать и выполнить слэш-команду.

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

Работайте с несколькими потоками как с вкладками

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

• Переключение потоков. Щелкните вкладку, чтобы сделать этот поток активным. Поток продолжает работать в фоновом режиме при переключении вкладок, поэтому можно запустить длинную задачу в одном потоке и продолжить работу в другом.
• Откройте новый поток: Новый чат для запуска потока на новой вкладке.
• Снова откройте предыдущую ветку: Нажмите История веток и выберите ветку, чтобы открыть её во вкладке.
• Управление цепочкой: используйте в активной вкладке, чтобы управлять цепочкой, или нажмите , чтобы закрыть вкладку.

Элементы управления панели кода Genie

Заголовок панели Genie Code содержит следующие элементы управления:

Control	Description
Новый чат	Начните новое обсуждение в новой вкладке.
История обсуждения	Просмотрите предыдущие ветки чата и заново откройте одну из них на вкладке.
Ещё	Откройте Параметры и другие параметры. См. параметры кода Genie.
Закрыть	Свернуть панель кода Genie.

Параметры кода Genie

Чтобы открыть параметры Кода Genie, щелкните Дополнительное меню в заголовке панели и Параметры. Область параметров включает в себя следующее:

Setting	Description
Actions	Задайте, как Genie Code запрашивает утверждение, прежде чем он использует инструмент. См. Подтверждение действий инструмента.
Серверы MCP	Подключитесь к внешним средствам и источникам данных с помощью серверов MCP и встроенных соединителей.
Переключить вид панели	Выберите, использовать ли Genie Code в режиме закрепленной панели или в режиме боковой панели.
Инструкции пользователя	Добавьте инструкции для пользователя, которые определяют, как Genie Code отвечает вам.
Инструкции по рабочей области	Добавьте инструкции рабочей области , которые применяются ко всем пользователям в рабочей области.
Навыки	Добавьте переиспользуемые навыки агента, которые Genie Code может применять к задачам.
Навыки рабочего пространства	Добавьте навыки , доступные всем пользователям в рабочей области.
Политика бессерверного использования	Задайте политику бессерверного использования для выполнения кода, который Genie Code создает в выходных данных чата.

Режим агента

Genie Code выполняется в режиме агента, который автоматизирует многофакторные рабочие процессы, планы решений, извлекает соответствующие ресурсы, выполняет код, использует выходные данные ячеек для улучшения результатов и автоматически устраняет ошибки. Если вы хотите прямой ответ на беседу без автономного выполнения задач, скажем так в запросе, например: "Просто объяснить это мне, не выполняйте код".

Для выполнения задач Genie Code отправляет запрос и соответствующий контекст модели, включая имена таблиц и столбцов, описания, код, с которыми вы работаете, примеры данных из таблиц и выходных данных ячеек. Все данные, отправляемые в модель, соответствуют вашим правам доступа в Unity Catalog. Дополнительные сведения см. в разделе Данные, отправляемые в модели.

Requirements

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

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

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

Полный код Genie (бета-версия)

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

Подтвердить действия инструмента

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

Утверждение одного запроса

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

Чтобы изменить, как Genie Code обрабатывает будущие запросы на утверждение в текущем потоке, выберите один из следующих вариантов в том же запросе:

Опция	Behavior
Спрашивайте каждый раз	Genie Code запрашивает утверждение каждый раз, когда он использует инструмент. Это значение по умолчанию.
Разрешить в текущем потоке	Genie Code может использовать запрошенный инструмент для остальной части текущего потока без запроса.
Всегда разрешать	Genie Code может использовать запрошенный инструмент в каждом потоке без запроса.
Автоматическое утверждение	Genie Code автоматически одобряет действия инструмента до конца текущего диалога. Классификатор ИИ проверяет каждое действие и блокирует рискованные. (Рекомендуется.)

Настройка режима утверждения по умолчанию

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

Выберите один из следующих вариантов:

• Сначала спрашивать: подтверждать запуск каждого инструмента. Переопределения для отдельных инструментов по-прежнему применяются.

• Автоматическое утверждение: классификатор ИИ проверяет каждое предлагаемое действие в отношении указанного намерения и утверждает или блокирует каждый из них, минимизируя утверждения вручную при блокировке рискованных действий.

  Important

  Автоматическое утверждение — это функция повышения производительности, а не граница безопасности. Классификатор — это эвристика лучших усилий, которая может быть неправильной. Он может утверждать небезопасные действия или блокировать безопасные. Не полагаться на него, чтобы обеспечить соблюдение требований к безопасности, соответствию или контролю доступа. Оставляйте автоматическое утверждение отключённым при работе с продуктивными данными, конфиденциальными рабочими областями или общими ресурсами, где последствия ошибочного утверждения могут быть существенными. Вы по-прежнему несете ответственность за просмотр результатов Genie Code.

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

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

Поделиться веткой чата

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

Чтобы поделиться веткой чата:

1. На панели Genie Code щелкните История чата, чтобы открыть историю чата.

2. Наведите указатель мыши на поток чата, который вы хотите поделиться, и щелкните

3. Щелкните Общий доступ.

4. В диалоговом окне общего доступа добавьте пользователей, группы или субъекты службы, с которыми нужно поделиться. Получатели получают разрешение на просмотр в потоке чата. См. ACL для чата Genie Code.

5. (Необязательно) Установите флажок Отправлять новым пользователям уведомление по электронной почте, чтобы отправить уведомление по электронной почте новым пользователям.

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

7. Нажмите кнопку "Добавить ", чтобы поделиться беседой.

Получить справку по коду

Получите помощь с кодом из Genie Code непосредственно в блокнотах. Genie Code предлагает:

• Используйте Код Genie для обработки и анализа данных, чтобы спланировать и автоматизировать многофакторные рабочие процессы обработки и анализа данных.
• Автозавершение на основе ИИ.
• Фильтрация данных с помощью запросов на естественном языке.
• Отладка кода с помощью Diagnose Error.
• Краткое исправление, представляющее автоматические рекомендации по исправлению ошибок кода, которые можно принять и запустить.
• Выполнение бессерверного кода.

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

Дополнительные сведения о том, как Genie Code может помочь с написанием кода, см. в разделе Как получить помощь с написанием кода от Genie Code.

Код, оптимизированный для среды Azure Databricks

Код, созданный Genie Code, предназначен для запуска в вычислительной среде Databricks. Он оптимизирован для создания кода на языках программирования, поддерживаемых Databricks, платформах и диалектах. Это не предназначено для помощника по программированию общего назначения.

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

Получите ответы из документации

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

Дайте отзыв о ответах Genie Code

Сообщите Databricks о том, полезны ли ответы на код Genie:

1. Наведите указатель мыши непосредственно под ответом Genie Code.
2. Нажмите кнопку , если вы считаете это полезным, или кнопку , если это не полезно.

Дополнительные ресурсы

• Код Genie
• Получите помощь в кодировании от Genie Code
• Измерение влияния кода Genie
• Советы по улучшению ответов Genie Code
• Модель, обслуживающая наблюдаемость с помощью Кода Genie