メインコンテンツまでスキップ

Genie Codeを使用する

Genie Code は、開発者が Databricks ノートブック、SQL エディター、ジョブ、AI/BI ダッシュボード、およびファイル エディターでコードの生成、最適化、説明、修正を行うのに役立ちます。説明と迅速なコード生成にはチャットモードを、Genie Codeが複数ステップのタスクを自律的に計画および完了できるようにするにはエージェントモード(デフォルト)を使用します。

注記

パートナーを利用したAI機能を無効にすると、Genie CodeはDatabricksホスト型モデルによって提供されるチャットモードでのみ実行されます。エージェントモードにはパートナー提供のAI機能が必要です。

Genie Code がコーディングにどのように役立つかについては、 「Genie Code からコーディングのヘルプを取得する」を参照してください。

Genie Codeペインのツアー

Genie Codeペインを開くには、ページの右上隅にあるきらめくGenie Codeアイコンをクリックします。

複数のチャットスレッドがタブとして開いているGenie Codeサイドペイン。

ペインの下部にあるテキストボックスにプロンプトを入力し、 Enter キーを押すか、送信アイコン。をクリックします。次のことができます。

  • プラスアイコン。 プラスアイコンをクリックして、MCPサーバーに接続するかファイルを添付します。
  • アイコンで。アイコンをクリックするか、 @ を入力して、Genie Codeが参照するリソースを選択します。
  • / を入力して、スラッシュコマンド を選択し、実行します。

Genie Code にコード作成の支援を依頼した場合、提案された変更の実行、承諾、または拒否を案内します。

複数のスレッドをタブとして操作する

Genie Code ペインには、開いているチャット スレッドがペイン上部にタブとして表示されます。一度に複数のタスクを実行でき、現在の場所を失うことなくスレッド間を移動できます。

  • スレッドを切り替える :タブをクリックして、そのスレッドをアクティブにします。タブを切り替えるとスレッドはバックグラウンドで実行され続けるため、あるスレッドで時間のかかるタスクを開始し、別のスレッドで作業を続行できます。
  • 新しいスレッドを開く : 新しいチャットアイコン。 新しいチャット をクリックして、新しいタブでスレッドを開始します。
  • 過去のスレッドを再度開く : 歴史アイコン。 [スレッド履歴] をクリックし、スレッドを選択してタブで開きます。
  • スレッドを管理する :ケバブメニューアイコン。アクティブなタブでケバブメニューを開いてスレッドを管理するか、クリックしてください閉じるアイコン。タブを閉じる。

Genie Codeペインコントロール

Genie Codeペインヘッダーには以下のコントロールがあります。

制御

説明

新しいチャットアイコン。 新規チャット

新しいタブで新しいスレッドを開始します。

歴史アイコン。 スレッド履歴

過去のチャットスレッドを表示し、タブで再開します。

ケバブメニューアイコン。 その他

[設定] 歯車アイコン。 およびその他のオプションにアクセスします。Genie Code設定を参照してください。

閉じるアイコン。 閉じる

Genie Codeペインを折りたたみます。

Genie Code設定

Genie Code の設定を開くには、ペインヘッダーの その他ケバブメニューアイコン。メニューをクリックし、次に 設定 歯車アイコン。 をクリックします。設定パネルには、次の項目が含まれます。

設定

説明

アクション

Genie Code がツールを使用する前に承認を要求する方法を設定します。ツールアクションの承認を参照してください。

MCPサーバー

MCPサーバーと組み込みコネクタを使用して、外部ツールとデータソースに接続します。

パネル表示を切り替え

Genie Codeを ドッキング ペインビューと サイド ペインビューのどちらで使用するかを選択します。

ユーザー手順

Genie Codeがどのように応答するかをガイドするユーザー指示を追加します。

ワークスペースの指示

ワークスペース内のすべてのユーザーに適用されるワークスペースの指示を追加します。

スキル

Genie Codeがタスクに適用できる、再利用可能なエージェントスキルを追加します。

ワークスペーススキル

職場にいる全員が利用できるスキルを追加する。

サーバーレス使用ポリシー

チャット出力でGenie Codeが生成するコードを実行するためのサーバレス使用ポリシーを設定します。

チャットおよびエージェントモード

Genie Codeは、迅速な質問とコード生成のためのチャット、および自律的な多段階ワークフローのためのエージェントという2つのモードで動作します。エージェントモードがデフォルトです。

注記

エージェントモードには以下のものが必要です。

モードを切り替えるには、Genie Codeペインの下部にあるモードセレクターを使用します。

以下の表は、2 つの Genie Code モードをまとめたものです。

モード

機能

いつ使うか

プロンプトの例

Chat

コードと概念を理解するのに役立つ質問に答えます。チャット内でコードを生成して実行します。

  • コードやエラーの説明
  • Databricksの概念について学ぶ
  • シンプルなコード生成
  • 「この機能は何をするものですか?」
  • 「 Unity Catalogとは何ですか?」
  • 「この関数の単体テストを書いてください」

エージェント

複数ステップのワークフローを自動化し、ソリューションを計画し、関連するアセットを取得し、コードを実行し、セル出力を使用して結果を改善し、エラーを自動的に修正するなど、さまざまなことができます。

  • 探索的データ分析
  • ノートブックの整理
  • ダッシュボード生成
  • パイプラインの作成
  • @example_tableでEDAを実行し、知見をまとめてください。」
  • 「各ノートブックのセルに適切な名前を付けます。」
  • 「@bakehouse のデータを分析し、知見を表示するダッシュボードを作成します。」
  • @example_table毎日更新するパイプラインを作成します。」

Genie Codeは、モードに応じて異なるデータをモデルに送信します。

  • チャットモード は、プロンプト、およびテーブルと列の名前、説明、作業中のコードなどの関連するメタデータを送信します。お客様のテーブルからデータを送信しません。
  • エージェントモードで は、テーブルからデータサンプルを読み込み、セルの出力を分析して、複数ステップのタスクを完了することもできます。

モデルに送信されるすべてのデータは、Unity Catalog権限を遵守します。各モードが送信する内容の詳細については、プライバシーとセキュリティに関するFAQを参照してください。

全ページGenie Code(ベータ)

Genie Codeには、全画面表示のコマンドセンターエクスペリエンスがあり、アクティブなスレッドが目立つように表示され、必要に応じてノートブックやファイルなどのアセットがタブとして表示されます。See Full page Genie Code.

ツールアクションを承認

Genie Codeがコードを実行したり、ノートブックを編集したり、テーブルを照会したりするなど、ツールを使用する必要がある場合、続行する前に承認を求めます。各リクエストを個別に承認することも、残りの現在のスレッド、または将来のすべてのスレッドに適用される承認モードを設定することもできます。

単一のリクエストを承認する

Genie Codeがツールの使用許可を求めた場合、アクションを承認するには 許可 をクリックするか、拒否するには スキップ をクリックしてください。

現在のスレッドでGenie Codeが今後の承認リクエストを処理する方法を変更するには、同じプロンプトから以下のいずれかを選択してください。

オプション

挙動

毎回確認

Genie Codeはツールを使用するたびに承認を求めます。これがデフォルトです。

現在のスレッドで許可

Genie Codeは、現在のスレッドが続く限り、要求されたツールを確認なしで使用できます。

常に許可

Genie Codeはリクエストされたツールをすべてのスレッドで尋ねることなく使用できます。

自動承認

Genie Codeは、現在のスレッドの残りのツールアクションを自動的に承認します。AI分類器は各アクションを審査し、リスクのあるアクションをブロックします。(推奨)。

デフォルトの承認モードを設定

すべてのGenie Codeスレッドに同じ承認モードを適用するには、Genie Code設定でデフォルトを設定してください。Genie Code ペインヘッダーにある 歯車アイコン。 をクリックして、設定を開きます。

次のいずれかを選択してください。

  • 事前に承認を求める:実行時に各ツールを承認してください。ツールごとのオーバーライドは引き続き適用されます。

  • 自動承認 :AI分類器が、表明された意図に基づいて提案された各アクションをレビューし、承認またはブロックします。これにより、リスクのあるアクションをブロックし、手動承認を最小限に抑えます。

重要

自動承認は生産性向上機能であり、セキュリティ境界ではありません。 この分類器はベストエフォート型のヒューリスティックであり、誤りがある場合があります。安全でないアクションを承認したり、安全なアクションをブロックしたりする可能性があります。セキュリティ、コンプライアンス、またはアクセス制御の要件を実施するために、それに依存しないでください。不適切な承認が重大な結果を招く可能性のある本番運用データ、機密性の高いワークスペース、または共有リソースを操作する際は、自動承認をオフにしてください。Genie Codeの結果については、引き続きお客様が責任を負うものとします。

自動承認が有効な場合、Genie Code は通常、読み取り専用クエリ、自身のワークスペースファイルとノートブックへの編集、自身が所有するテーブルへの書き込み、および既に参照しているジョブやパイプラインの実行など、リスクの低い操作を許可します。スコープの拡大や共有リソースに影響を与える可能性のあるもの、例えば破壊的な操作、本番運用のデプロイ、権限とシークレットの変更、サードパーティへの外部呼び出し、強制プッシュなどの危険なソース管理操作は、すべてブロックされます。

アクションがブロックされると、Genie Code はその理由を把握し、例えば、より狭いスコープで再試行するなどして調整します。

チャットスレッドを共有する

Genie Codeのチャットスレッドは、他のユーザー、グループ、またはサービスプリンシパルと共有できます。

チャットスレッドを共有するには:

  1. Genie Codeペインで、歴史アイコン。 スレッド履歴 をクリックしてチャット履歴を開きます。

  2. 共有したいチャットスレッドにカーソルを合わせ、ケバブメニューアイコン。ケバブメニュー。

  3. クリック共有アイコン。 共有

  4. 共有ダイアログで、共有相手のユーザー、グループ、またはサービスプリンシパルを追加します。受信者はチャットスレッド上で 「閲覧可能」の 権限を受け取ります。Genie CodeのチャットACLを参照してください。

  5. (オプション) 新しく追加されたユーザーに 電子メール 通知を送信するには、「新規ユーザーに電子メールを送信」をオンにします。

  6. (オプション)チャットスレッドへの直接リンクを共有するには、リンクアイコン。共有ダイアログの下部にある リンクをコピーしてください

  7. 「追加」 をクリックして会話を共有してください。

コードに関するヘルプ

Genie Code からのコードに関するヘルプをノートブック内で直接入手できます。Genie Code は以下を提供します:

Genie Code によって生成されたコードは間違いが起こることがあるため、実行する前に必ずコードを確認してください。

Genie Code がコーディングにどのように役立つかについて詳しくは、 Genie Code からコーディングのヘルプを受ける」を参照してください。

Databricks環境向けに最適化されたコード

Genie Code で生成されたコードは、Databricks コンピュート環境で実行することを目的としています。Databricksでサポートされているプログラミング言語、フレームワーク、およびダイアレクトでコードを作成するために最適化されています。汎用プログラミングアシスタントとして意図されたものではありません。

Genie Code は、ユーザーのクエリによりよく答えるために、 Databricksドキュメント Web サイトやナレッジ ベースなどのDatabricksリソースからの情報を使用することがよくあります。 ユーザーの質問が、 Databricksドキュメント、 Unity Catalog 、およびワークスペースのユーザー コードからの知識で回答できる質問に関連している場合に、最もパフォーマンスが高くなります。

ドキュメントからソースを取得して回答を得る

Genie Code はDatabricksを検索して質問に答えます。 ドキュメントを参照する場合、応答に 検索されたドキュメントの ステップが表示されます。Genie Code にソースを引用するように依頼すると、関連するドキュメント ページへのリンクが提供されます。

ドキュメントソースの回答を示すGenie Code の応答。

Genie Codeの回答にフィードバックする

Genie Code の回答が役に立つかどうかをお知らせください。

  1. Genie Code の回答の真下にカーソルを合わせてください。
  2. 便利な親指を立てたアイコン。または役に立たない親指を下げるアイコン。ボタン。

追加情報