databricks-genie-agents

Databricks Genie Agents

创建、管理和查询 Genie Agents（以前称为 Genie Spaces）——用于基于 SQL 的数据探索的自然语言界面。

概览

Genie Agents 允许用户使用自然语言询问 Unity Catalog 中的结构化数据。系统会将问题转换为 SQL 查询，在 SQL 仓库上执行，并以对话形式呈现结果。

Genie Agent 是一个限定于特定数据范围的精选 Agent——其表、示例问题和说明均针对特定业务领域编写。这不同于 Genie One／通用的“询问 Genie”数据发现路径（请参阅 databricks-data-discovery 技能）：后者可跨数据回答问题，无需针对每个范围配置精选 Agent。

Genie Agent 生命周期

阶段	参考文档	加载时机	常用 CLI
设计 + 创建	create-genie-agent.md	创建或更新之前始终加载。 在使用任何 CLI 之前，收集需求、分析数据、设计界面并获得批准	discover-schema → create-space / update-space
查询 / 验证	query-genie-agent.md	通过 Conversation API 或 Agent mode API 查询；为 Metric View 数据源编写 SQL	start-conversation / get-message
诊断	diagnose-genie-agent.md	Agent 给出错误或空结果时——先收集 space ID、失败的问题和观察到的行为	get-space --include-serialized-space；system.query.history
优化	optimize-genie-agent.md	由基准测试驱动的质量调优——先收集 space ID、优化目标和基准测试目标	genie-create-eval-run；update-space
导出 / 迁移	genie-agent-cicd.md	导出、导入、跨工作区迁移、批量迁移、DABs/CI-CD	get-space → remap → create-space
—	serialized-space.md	构造或调试 serialized_space 负载时——字段架构、限制条件、Python 辅助工具	—
—	uc-persistence.md	为多轮优化历史设置 UC Delta 表时——仅包含 CREATE TABLE DDL	—

典型流程：创建 → 查询/验证 → 诊断 → 优化。

先决条件

• Unity Catalog 中的表——包含数据的 bronze/silver/gold 表
• SQL Warehouse——用于执行查询的仓库（如未指定，则自动检测）

相关技能

• databricks-data-discovery - 通用自然语言数据探索／跨数据“询问 Genie”（Genie One）；当目标不是特定的精选 Genie Agent 时使用
• databricks-metric-views - 构建 Genie 使用的受治理业务指标。请参阅 SKILL.md，了解会影响 Genie 回答质量的 metric view 设计规则；并参阅 query-patterns.md，了解 Genie 必须遵循的 MEASURE() 查询规则。
• databricks-agent-bricks - 在 Supervisor Agents 中将 Genie Agents 用作 Agent
• databricks-unity-catalog - 管理 Genie 查询所用的 catalog、schema 和表