genie コマンド グループ
この情報は、Databricks CLI バージョン 0.205 以降に適用されます。Databricks CLI は パブリック プレビュー段階です。
Databricks CLI 使用には、使用状況データを含む Databricks ライセンス および Databricks プライバシー通知が適用されます。
Databricks CLI内のgenieコマンド グループには、 Genieのコマンドが含まれています。 Genieスペースとは何か」を参照してください。
atabricks genie create-message
会話で新しいメッセージを作成します。AI 応答は、会話で以前に作成されたすべてのメッセージを使用して応答します。
databricks genie create-message SPACE_ID CONVERSATION_ID CONTENT [flags]
引数
SPACE_ID
会話が開始されたGenie Spaceに関連付けられたID。
CONVERSATION_ID
会話に関連付けられている ID。
CONTENT
ユーザーメッセージの内容。
オプション
--json JSON
インライン JSON 文字列、またはリクエスト本文を含む JSON ファイルへの@path。
--no-wait
COMPLETED 状態に達するのを待たないでください。
--timeout duration
COMPLETED 状態に達するまでの最大時間 (デフォルトは 20 分 0 秒)。
例
次の例では、会話にメッセージを作成します。
databricks genie create-message abc123 conv456 "What were our sales last quarter?"
次の例では、JSON 設定でメッセージを作成します。
databricks genie create-message abc123 conv456 "Show me top customers" --json '{"additional_context": "Include revenue data"}'
次の例では、完了を待たずにメッセージを作成します。
databricks genie create-message abc123 conv456 "Analyze customer trends" --no-wait
データブリックス ジーニー クリエイトスペース
Genieスペースを作成します。
databricks genie create-space WAREHOUSE_ID SERIALIZED_SPACE [flags]
引数
WAREHOUSE_ID
スペースに関連付けるSQLウェアハウスのID。
SERIALIZED_SPACE
シリアル化された空間構成。
オプション
--json JSON
インライン JSON 文字列、またはリクエスト本文を含む JSON ファイルへの@path。
例
次の例では、Genie Spaceを作成します。
databricks genie create-space my-warehouse-id '{}' --json @space-config.json
databricks genie delete-conversation
Genie Spaceから会話を削除します。
databricks genie delete-conversation SPACE_ID CONVERSATION_ID [flags]
引数
SPACE_ID
GenieスペースのID。
CONVERSATION_ID
削除する会話のID。
オプション
例
次の例は、会話を削除する例です。
databricks genie delete-conversation abc123 conv456
databricks genie 会話メッセージ削除
Genie Space内の会話からメッセージを削除します。
databricks genie delete-conversation-message SPACE_ID CONVERSATION_ID MESSAGE_ID [flags]
引数
SPACE_ID
GenieスペースのID。
CONVERSATION_ID
会話のID。
MESSAGE_ID
削除するメッセージのID。
オプション
例
次の例はメッセージを削除するものです。
databricks genie delete-conversation-message abc123 conv456 msg789
databricks genie execute-message-attachment-query
メッセージクエリ添付ファイルのSQLを実行します。このコマンドは、クエリの添付ファイルの有効期限が切れており、再実行する必要がある場合に使用します。
databricks genie execute-message-attachment-query SPACE_ID CONVERSATION_ID MESSAGE_ID ATTACHMENT_ID [flags]
引数
SPACE_ID
GenieスペースID。
CONVERSATION_ID
会話 ID。
MESSAGE_ID
メッセージ ID。
ATTACHMENT_ID
添付ファイル ID。
オプション
例
次の例では、メッセージ添付ファイルクエリを実行します。
databricks genie execute-message-attachment-query abc123 conv456 msg789 attach001
databricks genie generate-download-full-query-result
メッセージ添付ファイルのクエリ結果全体をダウンロードします。
databricks genie generate-download-full-query-result SPACE_ID CONVERSATION_ID MESSAGE_ID ATTACHMENT_ID [flags]
引数
SPACE_ID
GenieスペースのID。
CONVERSATION_ID
会話のID。
MESSAGE_ID
メッセージのID。
ATTACHMENT_ID
添付ファイルのID。
オプション
例
次の例では、クエリ結果全体をダウンロードするファイルを生成します。
databricks genie generate-download-full-query-result abc123 conv456 msg789 attach001
databricks genie genie-create-eval-実行
Genie Space の評価実行を作成します。
databricks genie genie-create-eval-run SPACE_ID [flags]
引数
SPACE_ID
GenieスペースのID。
オプション
--json JSON
インライン JSON 文字列、またはリクエスト本文を含む JSON ファイルへの@path。
例
次の例は、評価実行を作成するものです。
databricks genie genie-create-eval-run abc123 --json @eval-config.json
databricks genie genie-get-eval-result-details
評価結果の詳細を入手してください。
databricks genie genie-get-eval-result-details SPACE_ID EVAL_RUN_ID RESULT_ID [flags]
引数
SPACE_ID
GenieスペースのID。
EVAL_RUN_ID
評価実行のID。
RESULT_ID
評価結果のID。
オプション
例
以下の例は、評価結果の詳細を取得するものです。
databricks genie genie-get-eval-result-details abc123 run456 result789
databricks genie genie-get-eval-実行
Genie Space の評価実行を取得します。
databricks genie genie-get-eval-run SPACE_ID EVAL_RUN_ID [flags]
引数
SPACE_ID
GenieスペースのID。
EVAL_RUN_ID
評価実行のID。
オプション
例
以下の例では、評価が実行されます。
databricks genie genie-get-eval-run abc123 run456
databricks genie genie-list-eval-results
評価実行時の評価結果を一覧表示します。
databricks genie genie-list-eval-results SPACE_ID EVAL_RUN_ID [flags]
引数
SPACE_ID
GenieスペースのID。
EVAL_RUN_ID
評価実行のID。
オプション
--page-size int
1ページあたりに返される評価結果の最大数。
--page-token string
次のページの結果を取得するための不透明なトークン。
例
以下の例は、評価結果の一覧です。
databricks genie genie-list-eval-results abc123 run456
databricks genie genie-list-eval-実行
リスト評価はGenie Spaceに対して実行されます。
databricks genie genie-list-eval-runs SPACE_ID [flags]
引数
SPACE_ID
GenieスペースのID。
オプション
--page-size int
1ページあたりに返される評価実行の最大回数。
--page-token string
次のページの結果を表示するためのトークン。
例
以下の例は、評価実行の一覧です。
databricks genie genie-list-eval-runs abc123
databricks genie get-download-full-query-result
以前に生成された完全なクエリ結果をダウンロードしてください。
databricks genie get-download-full-query-result SPACE_ID CONVERSATION_ID MESSAGE_ID ATTACHMENT_ID DOWNLOAD_ID DOWNLOAD_ID_SIGNATURE [flags]
引数
SPACE_ID
GenieスペースのID。
CONVERSATION_ID
会話のID。
MESSAGE_ID
メッセージのID。
ATTACHMENT_ID
添付ファイルのID。
DOWNLOAD_ID
ダウンロードのID。
DOWNLOAD_ID_SIGNATURE
ダウンロードIDの署名。
オプション
例
以下の例では、クエリ結果全体をダウンロードします。
databricks genie get-download-full-query-result abc123 conv456 msg789 attach001 dl001 sig001
databricks genie get-message
会話からメッセージを取得する。
databricks genie get-message SPACE_ID CONVERSATION_ID MESSAGE_ID [flags]
引数
SPACE_ID
対象となる会話が行われているGenie Spaceに関連付けられたID。
CONVERSATION_ID
ターゲットの会話に関連付けられている ID。
MESSAGE_ID
識別された会話のターゲット メッセージに関連付けられている ID。
オプション
例
次の例では、会話からメッセージを取得します。
databricks genie get-message abc123 conv456 msg789
databricks genie get-message-attachment-query-result
メッセージにクエリの添付ファイルがある場合、SQL クエリの結果を取得します。これは、メッセージにクエリの添付ファイルがあり、メッセージの状態が EXECUTING_QUERY または COMPLETEDの場合にのみ使用できます。
databricks genie get-message-attachment-query-result SPACE_ID CONVERSATION_ID MESSAGE_ID ATTACHMENT_ID [flags]
引数
SPACE_ID
GenieスペースID。
CONVERSATION_ID
会話 ID。
MESSAGE_ID
メッセージ ID。
ATTACHMENT_ID
添付ファイル ID。
オプション
例
次の例では、メッセージ添付ファイルのクエリ結果を取得します。
databricks genie get-message-attachment-query-result abc123 conv456 msg789 attach001
Databricks Genie 会話メッセージ一覧
会話内のメッセージを一覧表示します。
databricks genie list-conversation-messages SPACE_ID CONVERSATION_ID [flags]
引数
SPACE_ID
GenieスペースのID。
CONVERSATION_ID
会話のID。
オプション
--page-size int
1ページあたりに返されるメッセージの最大数。
--page-token string
次のページの結果を表示するためのトークン。
例
次の例は、会話内のメッセージを一覧表示したものです。
databricks genie list-conversation-messages abc123 conv456
データブリックス ジニー リスト会話
Genie Space内の会話を一覧表示します。
databricks genie list-conversations SPACE_ID [flags]
引数
SPACE_ID
GenieスペースのID。
オプション
--page-size int
1ページあたりに表示する会話の最大数。
--page-token string
次のページの結果を表示するためのトークン。
例
次の例は、ある空間における会話の一覧です。
databricks genie list-conversations abc123
データブリックス ジニー リストスペース
ワークスペース内のGenie Spacesを一覧表示します。
databricks genie list-spaces [flags]
オプション
--page-size int
1ページあたりに返される最大空白数。
--page-token string
次のページの結果を取得するためのページネーショントークン。
例
以下の例は、すべての Genie Space を一覧表示したものです。
databricks genie list-spaces
Databricks Genie のメッセージフィードバック送信
Genieの会話メッセージにフィードバックを送信する。
databricks genie send-message-feedback SPACE_ID CONVERSATION_ID MESSAGE_ID RATING [flags]
引数
SPACE_ID
GenieスペースのID。
CONVERSATION_ID
会話のID。
MESSAGE_ID
メッセージのID。
RATING
メッセージに対するフィードバック評価。
オプション
--json JSON
インライン JSON 文字列、またはリクエスト本文を含む JSON ファイルへの@path。
例
次の例は、メッセージに対して肯定的なフィードバックを送る例です。
databricks genie send-message-feedback abc123 conv456 msg789 POSITIVE
databricks genie get-space
Genie Space の詳細を取得します。
databricks genie get-space SPACE_ID [flags]
引数
SPACE_ID
Genieスペースに関連付けられたID。
オプション
例
次の例では、Genie Space の詳細を取得します。
databricks genie get-space abc123
databricks genie start-conversation
新しい会話を開始します。
databricks genie start-conversation SPACE_ID CONTENT [flags]
引数
SPACE_ID
会話を開始したいGenie Spaceに関連付けられたID。
CONTENT
会話を開始するメッセージのテキスト。
オプション
--json JSON
インライン JSON 文字列、またはリクエスト本文を含む JSON ファイルへの@path。
--no-wait
COMPLETED 状態に達するのを待たないでください。
--timeout duration
COMPLETED 状態に達するまでの最大時間 (デフォルトは 20 分 0 秒)。
例
次の例では、新しい会話を開始します。
databricks genie start-conversation abc123 "What are our top performing products this month?"
次の例では、JSON 設定で会話を開始します。
databricks genie start-conversation abc123 "Show me sales data" --json '{"context": "Q4 2024"}'
次の例では、完了を待たずに会話を開始します。
databricks genie start-conversation abc123 "Analyze customer behavior" --no-wait
データブリックス ジーニー ゴミ箱
Genieスペースをゴミ箱に移動します。
databricks genie trash-space SPACE_ID [flags]
引数
SPACE_ID
ゴミ箱に入れるGenie SpaceのID。
オプション
例
以下の例は、Genie Space を破棄する例です。
databricks genie trash-space abc123
データブリックス ジーニー アップデートスペース
Genieスペースを更新する。
databricks genie update-space SPACE_ID [flags]
引数
SPACE_ID
更新するGenie SpaceのID。
オプション
--json JSON
インライン JSON 文字列、またはリクエスト本文を含む JSON ファイルへの@path。
例
以下の例は、Genie Spaceを更新するものです。
databricks genie update-space abc123 --json '{"title": "Updated Space Title"}'
グローバルフラグ
--debug
デバッグログを有効にするかどうか。
-h または --help
Databricks CLI、関連するコマンド グループ、または関連するコマンドのヘルプを表示します。
--log-file string
出力ログの書き込み先となるファイルを表す文字列。このフラグが指定されていない場合、デフォルトでは出力ログが stderr に書き込まれます。
--log-format format
ログ・フォーマット・タイプ ( text または json) 。デフォルト値は textです。
--log-level string
ログ形式レベルを表す文字列。指定しない場合、ログ・フォーマット・レベルは使用不可になります。
-o, --output タイプ
コマンド出力タイプ text または json。デフォルト値は textです。
-p, --profile string
コマンドの実行に使用する ~/.databrickscfg ファイル内のプロファイルの名前。このフラグが指定されていない場合、存在する場合は、 DEFAULT という名前のプロファイルが使用されます。
--progress-format format
進行状況ログを表示する形式: default、 append、 inplace、 json
-t, --target string
該当する場合は、使用するバンドル・ターゲット