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

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

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

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

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

Боковая панель Genie Code с несколькими чатами, открытыми как вкладки.

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

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

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

Выберите определённый уровень усилий

Селектор в поле ввода запроса показывает текущий уровень усилий и позволяет изменить его для беседы:

  • Авто (рекомендовано): Этот уровень обеспечивает высочайшее качество для любой задачи.
  • Низкий: Этот уровень снижает стоимость более простых задач.

Genie Code сохраняет ваш выбор для разговора. Если уровней нет, селектор не появляется.

Вложение файлов

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

Код Genie поддерживает следующие типы файлов: .png, .jpg, , .jpeg.gif.webp, .pdf, .csv, .xlsx.xls.jsonи ..jsonl

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

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

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

  • Переключите чат: нажмите вкладку, чтобы активировать этот чат. Чат продолжает работать в фоне, когда вы переключаете вкладки, так что вы можете начать длинную задачу в одном чате и продолжить работу в другом.
  • Откройте новый чат: нажмите иконку «Новый чат».Новый чат для начала чата в новой вкладке.
  • Откройте прошлый чат: нажмите на иконку «История».Откройте историю чата и выберите чат, чтобы открыть его во вкладке.
  • Управление чатом: используйте значок меню кебаба. Меню кебаба на активной вкладке для управления чатом, или нажмите значок Закрыть, чтобы закрыть вкладку.

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

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

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

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

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

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

Онтология Джини

Important

Эта функция доступна в общедоступной предварительной версии. Чтобы присоединиться к этой предварительной версии, свяжитесь с командой вашей учетной записи Azure Databricks.

Note

В настоящее время клиенты не будут нести затраты на подбор онтологических фрагментов. Однако Azure Databricks могу обновлять цены на эту функцию в любое время, уведомив вас и/или обновив нашу страницу с ценами databricks.com.

Genie Ontology — это унифицированный контекстный слой, который предоставляет Genie Code бизнес-ориентированную карту вашей организации. Она объединяет две категории контекста:

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

Например, выведенные фрагменты могут содержать:

  • Определения метрик: Например, «„Активный пользователь“ — это уникальный пользователь без дублирования на всех платформах».
  • Авторитетные источники: Например: «На вопросы о выручке следует отвечать с помощью специализированного агента Finance Genie.»
  • Правила бизнеса: Например, «Квалифицированный лид» засчитывается только после того, как демо уже забронировано.»

Unity Catalog контролирует доступ к фрагментам, поэтому Genie Code использует только фрагменты, извлечённые из ресурсов, к которым у вас есть доступ.

Режим агента

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

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

Requirements

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

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

Genie Code на всю страницу

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

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

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

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

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

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

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

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

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

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

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

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

    Important

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

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

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

Общий доступ к чату

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

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

  1. В панели Genie Code нажмите на иконку History.История чатов для открытия истории чата.

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

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

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

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

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

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

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

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

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, основывающийся на документации.

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

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

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

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