genie 命令群組

Note

Databricks CLI 的使用受限於 Databricks 授權 和 Databricks 隱私權聲明，包括任何使用數據條款。

genie Databricks CLI 中的指令群組包含 Genie 的指令。 請參考 《精靈特工》。

Databricks Genie Ask

提出一個數據問題，然後得到 Genie 的回答。

databricks genie ask QUESTION [flags]

Arguments

QUESTION

    要問精靈的數據問題。

選項

--include-sql

    顯示代理執行的 SQL 查詢。 適用於文字輸出;JSON 輸出總是包含這些。

--raw

    列印原始的 SSE 事件，而不是渲染的輸出。

-s、--session string

    使用 Session ID（任意字串）來持續通話對話。

--warehouse-id string

    SQL 倉庫 ID。 若省略則自動解決。

全域旗標

Examples

以下範例提出一個資料問題：

databricks genie ask "What were total sales last month?"

以下範例提出一個針對特定 SQL 倉庫的問題：

databricks genie ask "Revenue by region" --warehouse-id 1234567890abcdef

以下範例繼續使用您選擇的會話 ID 進行跨通話的對話：

databricks genie ask -s sales "What were total sales by quarter?"
databricks genie ask -s sales "Break that down by region"

Databricks Genie create-message-comment

在對話訊息中留言。

databricks genie create-message-comment SPACE_ID CONVERSATION_ID MESSAGE_ID CONTENT [flags]

Arguments

SPACE_ID

    與 Genie 空間相關聯的標識碼。

CONVERSATION_ID

    與某項交談相關聯的識別碼。

MESSAGE_ID

    與訊息相關的ID。

CONTENT

    留言文字內容。

選項

--json JSON

    內嵌的 JSON 字串或 @path 整合至包含要求內容的 JSON 檔案。

全域旗標

Examples

以下範例用於對訊息產生註解：

databricks genie create-message-comment abc123 conv456 msg789 "Great analysis!"

databricks Genie 建立訊息

在交談中建立新訊息。 AI 回應會使用交談中所有先前建立的訊息來回應。

databricks genie create-message SPACE_ID CONVERSATION_ID CONTENT [flags]

Arguments

SPACE_ID

    對話開始時，與精靈代理人相關聯的ID。

CONVERSATION_ID

    與某項交談相關聯的識別碼。

CONTENT

    使用者訊息內容。

選項

--json JSON

    內嵌的 JSON 字串或 @path 整合至包含要求內容的 JSON 檔案。

--no-wait

    請勿等候到達 COMPLETED 狀態。

--timeout duration

    達到 COMPLETED 狀態的時間上限（預設為 20m0s）。

全域旗標

Examples

下列範例會在交談中建立訊息：

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

Databricks Genie Create-Space

創造一個精靈代理人。

databricks genie create-space WAREHOUSE_ID SERIALIZED_SPACE [flags]

Arguments

WAREHOUSE_ID

    用來關聯該空間的 SQL 倉庫 ID。

SERIALIZED_SPACE

    序列化的空間配置。

選項

--json JSON

    內嵌的 JSON 字串或 @path 整合至包含要求內容的 JSON 檔案。

全域旗標

Examples

以下範例可建立精靈代理人：

databricks genie create-space my-warehouse-id '{}' --json @space-config.json

Databricks Genie Delete-Conversation

刪除精靈代理人的對話。

databricks genie delete-conversation SPACE_ID CONVERSATION_ID [flags]

Arguments

SPACE_ID

    精靈特工的身份證。

CONVERSATION_ID

    要刪除對話的ID。

選項

全域旗標

Examples

以下範例是刪除一段對話：

databricks genie delete-conversation abc123 conv456

Databricks Genie 刪除對話訊息

刪除 Genie Agent 對話中的訊息。

databricks genie delete-conversation-message SPACE_ID CONVERSATION_ID MESSAGE_ID [flags]

Arguments

SPACE_ID

    精靈特工的身份證。

CONVERSATION_ID

    交談的標識碼。

MESSAGE_ID

    要刪除的訊息 ID。

選項

全域旗標

Examples

以下範例是刪除訊息：

databricks genie delete-conversation-message abc123 conv456 msg789

Databricks Genie 下載-訊息-附件-視覺化

下載訊息視覺化附件的渲染影像。 此功能僅在附件為視覺化且訊息狀態為完成時使用。

databricks genie download-message-attachment-visualization NAME [flags]

Arguments

NAME

    渲染附件的資源名稱，格式為 spaces/{space_id}/conversations/{conversation_id}/messages/{message_id}/attachments/{attachment_id}。

選項

全域旗標

Examples

以下範例下載了一個訊息附件視覺化：

databricks genie download-message-attachment-visualization "spaces/abc123/conversations/conv456/messages/msg789/attachments/attach001"

databricks Genie execute-message-attachment-query

執行訊息查詢附件的 SQL。 當查詢附件已過期且需要重新執行時，請使用此命令。

databricks genie execute-message-attachment-query SPACE_ID CONVERSATION_ID MESSAGE_ID ATTACHMENT_ID [flags]

Arguments

SPACE_ID

    精靈特工身份證。

CONVERSATION_ID

    交談識別碼。

MESSAGE_ID

    訊息 ID。

ATTACHMENT_ID

    附件標識碼。

選項

全域旗標

Examples

下列範例會執行訊息附件查詢：

databricks genie execute-message-attachment-query abc123 conv456 msg789 attach001

Databricks Genie 生成-下載-full-query-result

產生一個下載檔案，以取得訊息附件的完整查詢結果。

databricks genie generate-download-full-query-result SPACE_ID CONVERSATION_ID MESSAGE_ID ATTACHMENT_ID [flags]

Arguments

SPACE_ID

    精靈特工的身份證。

CONVERSATION_ID

    交談的標識碼。

MESSAGE_ID

    訊息的 ID。

ATTACHMENT_ID

    附件的ID。

選項

全域旗標

Examples

以下範例會產生完整查詢結果的下載：

databricks genie generate-download-full-query-result abc123 conv456 msg789 attach001

Databricks Genie Genie-create-eval-run

為精靈代理人建立評估跑動。

databricks genie genie-create-eval-run SPACE_ID [flags]

Arguments

SPACE_ID

    精靈特工的身份證。

選項

--json JSON

    內嵌的 JSON 字串或 @path 整合至包含要求內容的 JSON 檔案。

全域旗標

Examples

以下範例建立一個評估運算：

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]

Arguments

SPACE_ID

    精靈特工的身份證。

EVAL_RUN_ID

    評估的ID。

RESULT_ID

    評估結果的識別碼。

選項

全域旗標

Examples

以下範例可獲得評估結果細節：

databricks genie genie-get-eval-result-details abc123 run456 result789

Databricks genie genie-get-eval-run

幫精靈特工做一次評估。

databricks genie genie-get-eval-run SPACE_ID EVAL_RUN_ID [flags]

Arguments

SPACE_ID

    精靈特工的身份證。

EVAL_RUN_ID

    評估的ID。

選項

全域旗標

Examples

以下範例會進行一次評估跑：

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]

Arguments

SPACE_ID

    精靈特工的身份證。

EVAL_RUN_ID

    評估的ID。

選項

--page-size int

    每頁可返回的評估結果數量。

--page-token string

    不透明令牌以取得下一頁的結果。

全域旗標

Examples

以下範例列出評估結果：

databricks genie genie-list-eval-results abc123 run456

Databricks Genie Genie-List-eval-Runs

精靈特工的列表評估會跑。

databricks genie genie-list-eval-runs SPACE_ID [flags]

Arguments

SPACE_ID

    精靈特工的身份證。

選項

--page-size int

    每頁回傳的評估執行次數。

--page-token string

    取得下一頁結果的令牌。

全域旗標

Examples

以下範例列出評估執行次數：

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]

Arguments

SPACE_ID

    精靈特工的身份證。

CONVERSATION_ID

    交談的標識碼。

MESSAGE_ID

    訊息的 ID。

ATTACHMENT_ID

    附件的ID。

DOWNLOAD_ID

    下載的 ID。

DOWNLOAD_ID_SIGNATURE

    下載 ID 的簽名。

選項

全域旗標

Examples

以下範例將下載完整的查詢結果：

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]

Arguments

SPACE_ID

    與目標對話所在的精靈代理相關聯的 ID。

CONVERSATION_ID

    與目標交談相關聯的標識碼。

MESSAGE_ID

    已識別的對話中與目標訊息相關聯的識別碼。

選項

全域旗標

Examples

下列範例會從交談擷取訊息：

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]

Arguments

SPACE_ID

    精靈特工身份證。

CONVERSATION_ID

    交談識別碼。

MESSAGE_ID

    訊息 ID。

ATTACHMENT_ID

    附件標識碼。

選項

全域旗標

Examples

下列範例會取得訊息附件的查詢結果：

databricks genie get-message-attachment-query-result abc123 conv456 msg789 attach001

Databricks Genie List-conversation-messages

在對話中列出訊息。

databricks genie list-conversation-messages SPACE_ID CONVERSATION_ID [flags]

Arguments

SPACE_ID

    精靈特工的身份證。

CONVERSATION_ID

    交談的標識碼。

選項

--page-size int

    每頁可回傳的最大訊息數。

--page-token string

    取得下一頁結果的令牌。

全域旗標

Examples

以下範例列出對話中的訊息：

databricks genie list-conversation-messages abc123 conv456

Databricks Genie 列表對話

在精靈代理人中列出對話。

databricks genie list-conversations SPACE_ID [flags]

Arguments

SPACE_ID

    精靈特工的身份證。

選項

--page-size int

    每頁最多可返回的對話數。

--page-token string

    取得下一頁結果的令牌。

全域旗標

Examples

以下範例列出空間中的對話：

databricks genie list-conversations abc123

Databricks Genie 列表-對話-評論

列出對話中所有訊息中的留言。

databricks genie list-conversation-comments SPACE_ID CONVERSATION_ID [flags]

Arguments

SPACE_ID

    與 Genie 空間相關聯的標識碼。

CONVERSATION_ID

    與某項交談相關聯的識別碼。

選項

--page-size int

    每頁最多可回覆的評論數。

--page-token string

    分頁標記用於取得下一頁的結果。

全域旗標

Examples

以下範例列出對話中的所有評論：

databricks genie list-conversation-comments abc123 conv456

Databricks Genie 列表-訊息-評論

列出對特定對話訊息的評論。

databricks genie list-message-comments SPACE_ID CONVERSATION_ID MESSAGE_ID [flags]

Arguments

SPACE_ID

    與 Genie 空間相關聯的標識碼。

CONVERSATION_ID

    與某項交談相關聯的識別碼。

MESSAGE_ID

    與訊息相關的ID。

選項

--page-size int

    每頁最多可回覆的評論數。

--page-token string

    分頁標記用於取得下一頁的結果。

全域旗標

Examples

以下範例列出對訊息的註解：

databricks genie list-message-comments abc123 conv456 msg789

Databricks Genie 列表空間

在工作空間中列出 Genie 代理。

databricks genie list-spaces [flags]

選項

--page-size int

    每頁回傳的最大空格數。

--page-token string

    分頁標記用於取得下一頁的結果。

全域旗標

Examples

以下範例列出所有精靈代理人：

databricks genie list-spaces

Databricks Genie Send-Message-Feedback

在 Genie 對話中傳送訊息回饋。

databricks genie send-message-feedback SPACE_ID CONVERSATION_ID MESSAGE_ID RATING [flags]

Arguments

SPACE_ID

    精靈特工的身份證。

CONVERSATION_ID

    交談的標識碼。

MESSAGE_ID

    訊息的 ID。

RATING

    訊息的回饋評分。

選項

--json JSON

    內嵌的 JSON 字串或 @path 整合至包含要求內容的 JSON 檔案。

全域旗標

Examples

以下範例對訊息發送正向回饋：

databricks genie send-message-feedback abc123 conv456 msg789 POSITIVE

databricks Genie get-space

取得精靈特工的詳細資料。

databricks genie get-space SPACE_ID [flags]

Arguments

SPACE_ID

    與精靈特工相關聯的身份證。

選項

全域旗標

Examples

以下範例介紹了一位精靈代理人的細節：

databricks genie get-space abc123

databricks Genie 開始會話

開始新的交談。

databricks genie start-conversation SPACE_ID CONTENT [flags]

Arguments

SPACE_ID

    你想開始對話的精靈代理人所對應的ID。

CONTENT

    啟動交談之訊息的文字。

選項

--json JSON

    內嵌的 JSON 字串或 @path 整合至包含要求內容的 JSON 檔案。

--no-wait

    請勿等候到達 COMPLETED 狀態。

--timeout duration

    達到 COMPLETED 狀態的時間上限（預設為 20m0s）。

全域旗標

Examples

下列範例會啟動新的交談：

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

Databricks Genie 垃圾空間

把一個精靈特工丟進垃圾桶。

databricks genie trash-space SPACE_ID [flags]

Arguments

SPACE_ID

    神燈探員的身分證明被丟棄。

選項

全域旗標

Examples

以下範例是如何貶低精靈特工：

databricks genie trash-space abc123

Databricks Genie Update-Space

更新一位精靈特工。

databricks genie update-space SPACE_ID [flags]

Arguments

SPACE_ID

    精靈代理人的ID更新。

選項

--json JSON

    內嵌的 JSON 字串或 @path 整合至包含要求內容的 JSON 檔案。

全域旗標

Examples

以下範例是更新精靈代理人的：

databricks genie update-space abc123 --json '{"title": "Updated Space Title"}'

全域旗標

--debug

  是否要啟用偵錯記錄。

-h 或 --help

    顯示 Databricks CLI、相關命令群組或相關命令的幫助說明。

--log-file 字串

    字串，表示要寫入輸出記錄檔的檔案。 若未指定此旗標，則預設值是將輸出記錄寫入 stderr。

--log-format 格式

    記錄格式類型，text 或 json。 預設值是 text。

--log-level 字串

    表示日誌格式層級的字串。 若未指定，則日誌的格式層級功能將被停用。

-o, --output 類型

    指令輸出類型，text 或 json。 預設值是 text。

-p, --profile 字串

    用於執行命令的~/.databrickscfg檔案中的配置檔名稱。 如果未指定此旗標，則如果存在，則會使用名為 DEFAULT 的配置檔。

--progress-format 格式

    顯示進度記錄的格式：default、、appendinplace、 或json

-t, --target 字串

    如果適用，要使用的套件組合目標