genie 命令组

Note

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

genie Databricks CLI 中的命令组包含 Genie 的命令。 请参阅 Genie Spaces

databricks genie 创建消息

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

databricks genie create-message SPACE_ID CONVERSATION_ID CONTENT [flags]

Arguments

SPACE_ID

    与开始对话的 Genie Space 关联的 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 Space。

databricks genie create-space WAREHOUSE_ID SERIALIZED_SPACE [flags]

Arguments

WAREHOUSE_ID

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

SERIALIZED_SPACE

    序列化的空间配置。

选项

--json JSON

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

全局标志

Examples

以下示例创建 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]

Arguments

SPACE_ID

    Genie Space 的 ID。

CONVERSATION_ID

    要删除的对话的 ID。

选项

全局标志

Examples

以下示例删除对话:

databricks genie delete-conversation abc123 conv456

databricks genie delete-conversation-message

从 Genie Space 中的对话中删除消息。

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

Arguments

SPACE_ID

    Genie Space 的 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 Space 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 Space 的 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 Space 创建评估运行。

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

Arguments

SPACE_ID

    Genie 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

    Genie Space 的 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 Space 的评估运行。

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

Arguments

SPACE_ID

    Genie 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

    Genie 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

列出 Genie Space 的评估运行。

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

Arguments

SPACE_ID

    Genie 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

    Genie Space 的 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 Space 关联的 ID。

CONVERSATION_ID

    与目标对话关联的ID。

MESSAGE_ID

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

选项

全局标志

Examples

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

databricks genie get-message abc123 conv456 msg789

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

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

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

Arguments

SPACE_ID

    Genie Space 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 Space 的 ID。

CONVERSATION_ID

    会话的 ID。

选项

--page-size int

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

--page-token string

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

全局标志

Examples

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

databricks genie list-conversation-messages abc123 conv456

databricks genie list-conversations

列出 Genie Space 中的对话。

databricks genie list-conversations SPACE_ID [flags]

Arguments

SPACE_ID

    Genie Space 的 ID。

选项

--page-size int

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

--page-token string

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

全局标志

Examples

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

databricks genie list-conversations abc123

databricks genie list-spaces

列出工作区中的 Genie Spaces。

databricks genie list-spaces [flags]

选项

--page-size int

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

--page-token string

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

全局标志

Examples

以下示例列出所有 Genie Spaces:

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 Space 的 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 Space 关联的 ID。

选项

全局标志

Examples

以下示例获取 Genie Space 的详细信息:

databricks genie get-space abc123

databricks genie 开始对话

启动新对话。

databricks genie start-conversation SPACE_ID CONTENT [flags]

Arguments

SPACE_ID

    与要在其中启动对话的 Genie Space 关联的 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 垃圾空间

将天才空间移到垃圾桶。

databricks genie trash-space SPACE_ID [flags]

Arguments

SPACE_ID

    要回收的吉尼空间的 ID。

选项

全局标志

Examples

以下示例回收了 Genie Space:

databricks genie trash-space abc123

databricks genie update-space

更新 Genie Space。

databricks genie update-space SPACE_ID [flags]

Arguments

SPACE_ID

    要更新的 Genie Space 的 ID。

选项

--json JSON

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

全局标志

Examples

以下示例更新 Genie Space:

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

全局标志

--debug

  是否启用调试日志记录。

-h--help

    显示 Databricks CLI、相关命令组或相关命令的帮助。

--log-file 字符串

    一个字符串,表示要将输出日志写入到的文件。 如果未指定此标志,则默认会将输出日志写入到 stderr。

--log-format 格式

    日志格式类型,textjson。 默认值是 text

--log-level 字符串

    一个表示日志格式级别的字符串。 如果未指定,则禁用日志格式级别。

-o, --output 类型

    命令输出类型为textjson。 默认值是 text

-p, --profile 字符串

     ~/.databrickscfg 文件中用于运行命令的配置文件的名称。 如果未指定此标志,则如果存在,将使用名为 DEFAULT 的配置文件。

--progress-format 格式

    显示进度日志的格式: defaultappendinplacejson

-t, --target 字符串

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