Genie Code の応答を改善するためのヒント

Genie Code の応答は、特定のプロンプトと明確なコンテキストによって大幅に改善されます。 必要な内容を明示的に記述し、 @を使用してテーブルとノートブックのセルを参照し、テキストが不十分な場合は画像を添付し、Genie Code がスキーマを理解できるように Unity カタログでテーブルと列を文書化します。

次の方法で、ニーズに合わせて Genie Code を調整することもできます。

  • Genie Code を好みに合わせてカスタマイズする 手順 を提供します。
  • Genie Code の機能を拡張するための エージェント スキル を作成します。
  • 外部ツールとデータ ソースに Genie Code を接続するための MCP サーバー を追加します。

具体的に指定する

Genie Code が提供する構造と詳細は、同じプロンプトであっても、随時異なります。 必要な形式、詳細レベルなどの情報を返すのに役立つ限り多くのガイダンスを Genie Code に提供してください。 次の操作を行うことを検討してください。

  • 探している詳細レベルを指定します。 たとえば、「いくつかの文でこのコードを説明する」や「このコードを 1 行ずつ説明する」などです。
  • Genie Code で使用するライブラリを指定します。 たとえば、「Matplotlib を使用して視覚化を作成する」や「Seaborn を使用して視覚化を作成する」などです。
  • 必要な応答の構造を指定します。 たとえば、"番号付き手順の指示を指定する" や "手順を箇条書きとして簡単な説明で指定する" などです。
  • プロンプトで具体的に指定します。 Genie Code はテーブルと列のスキーマとメタデータについて認識しているため、自然言語を使用して質問できます。 たとえば、「1 シーズンに 500 回を超える試行を行ったユーザーに対して、アクティブおよびリタイアされた NFL クオーターバックの合格率を一覧表示する」などです。Genie Code では、 s.player_ids.attemptsなどの列のデータを使用して回答します。

Genie Code はコンテキストを使用して、より良い回答を提供します

Genie Code には、テーブル、パイプライン、ノートブック、クエリ、ファイルなどの特定のコンテキストを指定できます。 Genie Code のチャット ウィンドウで、[ At] アイコンをクリックします。 コンテキストを追加 して、指定するリソースを手動で選択します。 チャット プロンプトに「 @<resource-name> 」と入力してコンテキストを参照することもできます。 選択した各コンテキストがプロンプト ボックスの上部に表示され、チャットに保持されます。

ノートブックでは、特定のセルを参照することもできます。 [ At] アイコンをクリックします。 コンテキストを追加し、[ セル] を選択し、参照するセルを選択します。 チャット プロンプトに「 @cell 」と入力し、表示される一覧からセルを選択することもできます。 これは、特定のセルのコードまたは出力について Genie Code に質問する場合に便利です。

Genie Code では、手動で指定したコンテキストに加えて、テーブルと列のスキーマとメタデータにアクセスできます。 これにより、自然言語を使用して、より正確なクエリを生成できます。 たとえば、テーブルに State という名前の列がある場合は、Genie Code に、ミシガン州に住むユーザーの一覧を生成するように依頼できます。

Genie Code では、次のコンテキストが使用されます。

  • 現在のノートブック セルまたは Databricks SQL エディター タブのコードまたはクエリ。
  • テーブル名と列名、およびその説明。
  • 以前のプロンプトの質問。
  • お気に入りテーブルとアクティブなテーブル。
  • エラー診断機能では、エラー出力のスタック トレースが使用されます。

Genie Code では会話履歴を使用して、より正確な回答を提供するため、プロンプト全体を書き換えることなく、Genie Code に以前の応答の出力を変更するよう依頼できます。 Genie Code のチャット履歴を使用して、Genie Code ペインで DataFrame を繰り返しクリーンアップ、探索、フィルター処理、スライスします。

プロンプトに画像を添付する

Genie Code プロンプトに画像を添付できます。 イメージをアタッチするには、次のいずれかの方法を使用します。

  • 画像をコピーしてチャット プロンプトに直接貼り付けます。
  • 画像をチャット プロンプトにドラッグ アンド ドロップします。
  • プラスアイコン 新規アイコン。 をクリックし、イメージ アイコン。イメージを添付して、ローカル コンピューターからイメージを選択します。

画像は、テキストだけでは簡単または正確に伝えることができない情報を追加する場合に便利です。 次の場合は、イメージを添付することを検討してください。

  • Genie Code にアクセスできない視覚的な情報を提供する必要があります。 Genie Code では、ワークスペース のファイルやノートブックに画像やグラフを表示できるため、外部イメージを添付するだけで済みます。
  • 図、フローチャート、アーキテクチャスケッチ、スライドスクリーンショット、ホワイトボード写真などの視覚的なコンテンツを理解するのに役立ちます。
  • 傾向、異常、ラベルが重視されるグラフ、チャート、ダッシュボード、またはレポートなど、表示されている外部データについて質問しています。
  • 画像から抽出されたテキスト (ドキュメントの写真やスキャン、手書きのメモ、ラベルや記号など) が必要です。
  • 実際の写真を操作していて、画像内で何が起こっているかについて質問したり、ドキュメントのシーンを説明したり、仕様に一致するものがあるかどうかを確認したりしたいと考えています。

Genie Code でのデータセットの操作を支援する

Genie Code は、使用しているテーブルに関するコンテキストにアクセスできます。 データセットを操作する際の対応を改善するために、次の操作を行うことができます。

  • テーブルを検索する場合は、"テーブルの検索" プロンプトまたはコマンド /findTables を使用して、より適切な応答を得られます。 たとえば、「NFL ゲームに関連するテーブルを検索する」などです。

  • プロンプトで特定のテーブルを参照するには、 @<table-name> を使用します。 [ At] アイコン をクリックして、テーブルを手動で選択することもできます。 チャットにコンテキストを追加します。 Genie Code は、そのテーブルを使用するように応答を調整します。

  • DataFrame から列を選択する場合は、開始クエリを指定することで、より正確な結果を得ることができます。 たとえば、 SELECT * FROM <table_name>などのステートメントを指定します。 これにより、Genie Code は列名を取得でき、推測する必要はありません。

  • 列データ型変換を使用して操作を実行する必要がある場合は、詳細を指定する必要があります。 たとえば、「pandas DataFrame を PySpark DataFrame に変換するために必要なコードを含め、このコードを pandas から PySpark に変換し、列チャーンのデータ型をブール値から整数に変更する」などです。

  • Unity カタログ内のテーブルと列を記録する。 「AI が生成したコメントを Unity Catalog オブジェクトに追加する」を参照してください。 これにより、Genie Code にデータに関するより多くのコンテキストが得られます。 カタログ エクスプローラーでテーブルまたは列のコメントを使用して、サンプル データの行を追加します。 たとえば、高さの列が feet-inches形式であるとします。 Genie Code がデータを解釈できるように、「高さの列は文字列形式で、ハイフンで区切られています。」などのコメントを追加します。 例: '6-2'。テーブルと列のコメントの詳細については、「 データと AI 資産にコメントを追加する」を参照してください。

Genie Code チャット ウィンドウでコードを編集して実行する

Genie Code ペインでコードを実行して検証するか、スクラッチパッドとして使用します。 コードの実行は、Azure Databricksのすべてのページで使用できます。 Genie Code の既定値は、現在使用しているページの現在のコンピューティング リソースです。 現在使用されているコンピューティング リソースがない場合、Genie Code ではサーバーレス コンピューティング リソースが使用されます。 Genie Code は、チャットでコードを実行する前にアクセス許可を求めます。 今後の要求を自動的に承認するには、承認モードを [自動承認] に設定します。 「 ツールアクションの承認」を参照してください。 承認すると、出力がチャット ウィンドウに直接表示されます。

次のタブは、Pythonと SQL コードの例を示しています。

Python

アシスタント ウィンドウでPythonコードを実行します。

SQL

アシスタント ウィンドウで SQL コードを実行します。

Shift + Enterを使用してチャット テキスト ボックスに新しい行を追加する

Shift + Enterを使用して、Genie Code のチャット テキスト ボックスに新しい行を追加します。 これにより、Genie Code へのメッセージの書式設定と整理が簡単になります。

ノートブックでセルアクションを使用する

セル アクションには、ドキュメント化 (コメント化)、修正、コードの説明など、一般的なタスクへのショートカットが含まれます。

/doc セルアクションは、コードをコメントするようにアシスタントに求めます。

その他のリソース