Genie コードを使用する

Genie Code は、開発者がAzure Databricksノートブック、SQL エディター、ジョブ、AI/BI ダッシュボード、ファイル エディターでコードを生成、最適化、説明、修正するのに役立ちます。

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

Genie Code ペインの概要

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

ウィンドウの下部にあるテキスト ボックスにプロンプトを入力し、 Enter キーを押すか、[ をクリックします。 次のようにすることができます。

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

Genie Code にコードのサポートを求めるメッセージが表示されると、提案された変更の実行、受け入れ、または拒否が行われます。

複数のチャットをタブとして扱う

Genie Codeのパネルは、開いているチャットを上部にタブで表示します。 複数のタスクを同時に実行でき、チャット間を移動しても自分の位置を失いません。

• チャットを切り替える:タブをクリックしてそのチャットをアクティブにします。 タブを切り替えるとチャットがバックグラウンドで動き続けるので、長いタスクを一つのチャットで始めて別のチャットで作業を続けられます。
• 新しいチャットを開く: 新しいタブ でチャットを始めるために新しいチャットを開く。
• 過去のチャットを再開してください: チャット履歴 を表示し、タブでチャットを開いてください。
• チャット管理: を使ってチャットを管理してください。アクティブなタブのKebabメニューを使い、タブを閉じるには「 をクリックしてください。

Genie Code ペインのコントロール

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

コントロール	説明
新しいチャット	新しいタブで新しいチャットを始めましょう。
チャット履歴	過去のチャットを確認し、タブで再度開くことができます。
その他	アクセス 設定 とその他のオプション。 Genie Code の設定を参照してください。
閉じる	Genie Code ペインを折りたたみます。

Genie Code の設定

Genie Code の設定を開くには、ウィンドウ ヘッダーの [その他] メニューで、[設定。 設定ウィンドウには、次のものが含まれます。

Setting	説明
Actions	Genie Code がツールを使用する前に承認を求める方法を設定します。 「 ツールアクションの承認」を参照してください。
MCP サーバー	MCP サーバーと 組み込みコネクタを使用して、外部ツールとデータ ソースに接続します。
パネル ビューの切り替え	ドッキング ペイン ビューとサイド ペイン ビューのどちらで Genie Code を使用するかを選択します。
ユーザーの指示	Genie Code の応答方法をガイドする ユーザーの指示 を追加します。
ワークスペースの手順	ワークスペース内のすべてのユーザーに適用されるワークスペース の指示 を追加します。
スキル	Genie Code がタスクに適用できる再利用可能な エージェント スキル を追加します。
ワークスペースのスキル	ワークスペース内のすべてのユーザーが使用できる スキル を追加します。
サーバーレス使用ポリシー	Genie Code がチャット出力で生成するコードを実行するための サーバーレス使用ポリシー を設定します。

エージェント モード

Genie Code はエージェント モードで実行され、マルチステップ ワークフローの自動化、ソリューションの計画、関連する資産の取得、コードの実行、セル出力の使用による結果の改善、エラーの自動修正を行います。 自律的なタスクの実行を伴わない直接の会話応答が必要な場合は、プロンプトで「これを説明するだけで、コードを実行しないでください」などと言います。

タスクを完了するために、Genie Code はプロンプトと関連コンテキストをモデルに送信します。これには、テーブルと列名、説明、操作しているコード、テーブルからのデータ サンプル、セル出力が含まれます。 モデルに送信されるすべてのデータは、Unity カタログのアクセス許可を尊重します。 詳細については、「 モデルに送信されるデータ」を参照してください。

要求事項

Genie Code のエージェント機能を使用するには、ワークスペースに次のものが必要です。

• アカウントとワークスペースの両方で有効になっているパートナーを利用した AI 機能。 パートナーを利用した AI 機能を参照してください。
• ワークスペースは、サポートされているリージョンに存在する必要があります。 Genie Code は、Geos を使用してデータ所在地を管理する 指定サービス です。 Genie Code 機能の Geo 可用性を参照してください。

パートナー提供の AI 機能が無効になっている場合でも、Genie Code は引き続き利用できますが、Databricks がホストするモデルを使用するため、エージェント機能は利用できません。

ページ全体の Genie コード

Genie Codeは全ページのコマンドセンター体験があり、アクティブなチャットが目立つように表示され、必要に応じてノートブックやファイルなどの資産がタブとして表示されます。 Genie コードの完全なページを参照してください。

ツール アクションの承認

Genie Code でコードの実行、ノートブックの編集、テーブルのクエリなどのツールを使用する必要がある場合は、続行する前に承認を求められます。 各リクエストを個別に承認することも、現在のチャット全体や今後のすべてのチャットに適用される承認モードを設定することも可能です。

1 つの要求を承認する

Genie Code がツールを使用するためのアクセス許可を要求したら、[ 許可 ] をクリックしてアクションを承認するか 、スキップ して拒否します。

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

Option	Behavior
毎回質問する	Genie Code は、ツールを使用するたびに承認を求めます。 これが既定値です。
現在のチャットを許可する	Genie Codeは、リクエストされたツールを現在のチャットの残りの時間に許可せずに使えます。
常に許可	Genie Codeは、すべてのチャットでリクエストされたツールを許可せずに使うことができます。
自動承認	Genie Codeは現在のチャットの残りの部分でツールアクションを自動的に承認します。 AI 分類子は、各アクションを確認し、リスクの高いものをブロックします。 (推奨)。

既定の承認モードを設定する

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

次のいずれかのオプションを選びます。

• 最初に質問する: 実行時に各ツールを承認します。 ツールごとのオーバーライドは引き続き適用されます。

• 自動承認: AI 分類子は、提示された意図に対して提案された各アクションをレビューし、それぞれを承認またはブロックし、リスクの高いアクションをブロックしながら手動承認を最小限に抑えます。

  Important

  自動承認は生産性機能であり、セキュリティ境界ではありません。 分類子は、間違っている可能性があるベスト エフォートヒューリスティックです。 安全でないアクションを承認したり、安全なアクションをブロックしたりする可能性があります。 セキュリティ、コンプライアンス、またはアクセス制御の要件を適用するために、この要件に依存しないでください。 本番データ、機密性の高いワークスペース、または共有リソースを扱う場合や、誤った承認の影響が重大になる可能性がある環境では、自動承認はオフのままにしてください。 Genie Code の結果を確認する責任は引き続きお客様にあります。

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

アクションがブロックされると、Genie Code は理由を受け取り、たとえば、より狭いスコープで再試行することで適応します。

チャットを共有する

Genie Codeのチャットは他のユーザー、グループ、サービス担当者と共有できます。

チャットを共有するために:

1. ジーニーコードの画面で チャット履歴 を開くためにチャット履歴を開けてください。

2. 共有したいチャットにカーソルを合わせて、 ケバブメニュー。

3. [ 共有。

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

5. (省略可能) [新しいユーザーに電子メール を送信する] をオンにして、新しく追加されたユーザーに電子メール通知を送信します。

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

7. [ 追加] をクリックして会話を共有します。

コードに関するヘルプを表示する

Genie Code のコードに関するヘルプをノートブックに直接表示します。 Genie Code では、次の内容が提供されます。

• Genie Code for Data Science を使用して 、複数ステップのデータ サイエンス ワークフローの計画と自動化に役立ちます。
• AI ベースのオートコンプリート。
• 自然言語プロンプトを使用したデータ フィルター。
• [診断エラー] を使用したコードのデバッグ。
• クイック修正は、コード エラーを修正するための自動推奨事項を示します。これを 受け入れて実行できます。
• サーバーレス コードの実行。

Databricks では、Genie Code によって生成されたコードを実行する前に常に確認することをお勧めします。これは、間違いを犯すことがあるためです。

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

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

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

Genie Code では、多くの場合、Databricks のドキュメント Web サイトやナレッジ ベースなどの Databricks リソースの情報を使用して、ユーザー のクエリに対する回答を向上させます。 ユーザーの質問が、ワークスペース内の Databricks ドキュメント、Unity カタログ、およびユーザー コードの知識を使用して回答できる質問に関連している場合に最適に実行されます。

ドキュメントから回答を取得する

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

Genie Code の回答に関するフィードバックを提供する

Genie Code の回答が役に立つかどうかを Databricks に知らせます。

1. Genie Code の回答のすぐ下にマウス ポインターを置きます。
2. 便利な または不便な ボタンをクリックします。

その他のリソース

• ジーニーコード
• Genie Code からコーディングに関するヘルプを取得する
• Genie Code の影響を測定する
• Genie Code の応答を改善するためのヒント
• Genie Code を使用して可観測性を提供するモデル