genie 命令组

Note

此信息适用于 Databricks CLI 版本 0.205 及更高版本。 Databricks CLI 目前处于公共预览阶段。

Databricks CLI 的使用须遵守 Databricks 许可和 Databricks 隐私声明，包括任何数据使用规定。

genie Databricks CLI 中的命令组包含 Genie 的命令。 请参阅 什么是 Genie 空间。

databricks genie 创建消息

在对话中创建新邮件。 AI 响应使用对话中以前创建的所有消息进行响应。

databricks genie create-message SPACE_ID CONVERSATION_ID CONTENT [flags]

Arguments

SPACE_ID

    与启动对话的 Genie 空间关联的 ID。

CONVERSATION_ID

    与对话关联的 ID。

CONTENT

    用户消息内容。

选项

--json JSON

    包含请求正文的内联 JSON 字符串或 @path 到 JSON 文件。

--no-wait

    不要等待进入 COMPLETED 状态。

--timeout duration

    达到已完成状态的最大时间（默认为 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

创建 Genie 空间。

databricks genie create-space WAREHOUSE_ID SERIALIZED_SPACE [flags]

Arguments

WAREHOUSE_ID

    要与空间关联的 SQL 仓库的 ID。

SERIALIZED_SPACE

    序列化的空间配置。

选项

--json JSON

    包含请求正文的内联 JSON 字符串或 @path 到 JSON 文件。

全局标志

Examples

以下示例创建 Genie 空间：

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

databricks genie delete-conversation

从 Genie 空间中删除对话。

databricks genie delete-conversation SPACE_ID CONVERSATION_ID [flags]

Arguments

SPACE_ID

    Genie 空间的 ID。

CONVERSATION_ID

    要删除的对话的 ID。

选项

全局标志

Examples

以下示例删除对话：

databricks genie delete-conversation abc123 conv456

databricks genie delete-conversation-message

从 Genie 空间中的对话中删除消息。

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

Arguments

SPACE_ID

    Genie 空间的 ID。

CONVERSATION_ID

    会话的 ID。

MESSAGE_ID

    要删除的消息的 ID。

选项

全局标志

Examples

以下示例删除消息：

databricks genie delete-conversation-message abc123 conv456 msg789

databricks genie 执行消息附件查询

执行消息查询附件的 SQL。 当查询附件已过期且需要重新执行时，请使用此命令。

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

Arguments

SPACE_ID

    Genie 空间 ID。

CONVERSATION_ID

    对话 ID。

MESSAGE_ID

    消息 ID。

ATTACHMENT_ID

    附件 ID。

选项

全局标志

Examples

以下示例执行邮件附件查询：

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]

Arguments

SPACE_ID

    Genie 空间的 ID。

CONVERSATION_ID

    会话的 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

为 Genie 空间创建评估运行。

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

Arguments

SPACE_ID

    Genie 空间的 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

    Genie 空间的 ID。

EVAL_RUN_ID

    评估运行的 ID。

RESULT_ID

    计算结果的 ID。

选项

全局标志

Examples

以下示例获取评估结果详细信息：

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

databricks genie genie-get-eval-run

获取 Genie 空间的评估运行。

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

Arguments

SPACE_ID

    Genie 空间的 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

    Genie 空间的 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

列出 Genie 空间的评估运行。

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

Arguments

SPACE_ID

    Genie 空间的 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

    Genie 空间的 ID。

CONVERSATION_ID

    会话的 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 精灵 获取消息

从对话中获取消息。

databricks genie get-message SPACE_ID CONVERSATION_ID MESSAGE_ID [flags]

Arguments

SPACE_ID

    与目标对话所在的 Genie 空间关联的 ID。

CONVERSATION_ID

    与目标对话关联的ID。

MESSAGE_ID

    与指定对话中的目标消息关联的 ID。

选项

全局标志

Examples

以下示例从对话中检索消息：

databricks genie get-message abc123 conv456 msg789

databricks Genie 获取消息附件查询结果

如果消息具有查询附件，则获取 SQL 查询的结果。 仅当邮件具有查询附件且消息状态为EXECUTING_QUERY或COMPLETED时，此功能才可用。

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

Arguments

SPACE_ID

    Genie 空间 ID。

CONVERSATION_ID

    对话 ID。

MESSAGE_ID

    消息 ID。

ATTACHMENT_ID

    附件 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

    Genie 空间的 ID。

CONVERSATION_ID

    会话的 ID。

选项

--page-size int

    每页要返回的最大消息数。

--page-token string

    用于获取下一页结果的令牌。

全局标志

Examples

以下示例列出对话中的消息：

databricks genie list-conversation-messages abc123 conv456

databricks genie list-conversations

列出 Genie 空间中的对话。

databricks genie list-conversations SPACE_ID [flags]

Arguments

SPACE_ID

    Genie 空间的 ID。

选项

--page-size int

    每个页面要返回的最大会话数。

--page-token string

    用于获取下一页结果的令牌。

全局标志

Examples

以下示例列出空格中的对话：

databricks genie list-conversations abc123

databricks genie list-spaces

列出工作区中的 Genie 空格。

databricks genie list-spaces [flags]

选项

--page-size int

    每页要返回的最大空格数。

--page-token string

    用于获取下一页结果的分页令牌。

全局标志

Examples

以下示例列出所有 Genie 空格：

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

    Genie 空间的 ID。

CONVERSATION_ID

    会话的 ID。

MESSAGE_ID

    消息的 ID。

RATING

    消息的反馈分级。

选项

--json JSON

    包含请求正文的内联 JSON 字符串或 @path 到 JSON 文件。

全局标志

Examples

以下示例对消息发送正反馈：

databricks genie send-message-feedback abc123 conv456 msg789 POSITIVE

databricks genie 获取空间

获取 Genie Space 的详细信息。

databricks genie get-space SPACE_ID [flags]

Arguments

SPACE_ID

    与 Genie 空间关联的 ID。

选项

全局标志

Examples

以下示例获取 Genie 空间的详细信息：

databricks genie get-space abc123

databricks genie 开始对话

启动新对话。

databricks genie start-conversation SPACE_ID CONTENT [flags]

Arguments

SPACE_ID

    与你要在其中启动对话的 Genie 空间关联的 ID。

CONTENT

    启动对话的消息的文本。

选项

--json JSON

    包含请求正文的内联 JSON 字符串或 @path 到 JSON 文件。

--no-wait

    不要等待进入 COMPLETED 状态。

--timeout duration

    达到已完成状态的最大时间（默认为 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 垃圾空间

将 Genie 空间移到垃圾箱。

databricks genie trash-space SPACE_ID [flags]

Arguments

SPACE_ID

    要回收的 Genie 空间的 ID。

选项

全局标志

Examples

以下示例会回收 Genie 空间：

databricks genie trash-space abc123

databricks genie update-space

更新 Genie 空间。

databricks genie update-space SPACE_ID [flags]

Arguments

SPACE_ID

    要更新的 Genie 空间的 ID。

选项

--json JSON

    包含请求正文的内联 JSON 字符串或 @path 到 JSON 文件。

全局标志

Examples

以下示例更新 Genie 空间：

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、 append、 inplace或 json

-t, --target 字符串

    如适用，要使用的捆绑包目标