skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
databricks/databricks-agent-skills298 installs

databricks-genie-agents

Create, manage, and query Databricks Genie Agents (formerly Genie Spaces): curated agents over Unity Catalog tables, Metric Views, and documents in UC volumes. Use when building, migrating, tuning, or asking a specific Agent, and for document Q&A or docs + data agents (replaces the legacy Knowledge Assistant and Supervisor Agent). For data questions across the workspace, use databricks-data-discovery.

How do I install this agent skill?

npx skills add https://github.com/databricks/databricks-agent-skills --skill databricks-genie-agents
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    This skill provides tools for managing Databricks Genie Agents using official Databricks CLI commands and SDKs. It adheres to security best practices for handling data, credentials, and external dependencies.

  • Socketpass

    No alerts

  • Snykfail

    Risk: CRITICAL · 1 issue

What does this agent skill do?

Databricks Genie Agents

A Genie Agent is a curated agent scoped to one business area: its tables / Metric Views, documents (UC volumes), sample questions, and instructions. It answers by writing SQL on a warehouse and, in Agent mode, by searching its documents, so one turn can combine SQL results and cited files. Distinct from Genie One (databricks-data-discovery), which answers across your data without a curated Agent.

Replaces Knowledge Assistant and Supervisor Agent for docs + data. Both are legacy ("For new low-code agents over your documents and data, use Genie Agents"). Document Q&A (was a KA) = an Agent with a volume: no endpoint, no sync. Routing between data and docs (was a Supervisor over Genie + KA) = one Agent with tables + a volume. See Documents. An Agent can also attach Databricks-provided MCP connectors (Google Drive, Microsoft 365, Slack, Jira/Confluence, GitHub, ...; Beta, set up in the UI, Agent mode only). Custom MCP servers, UC functions, or other endpoints aren't supported; build a code agent (databricks-ml-training). To maintain an existing KA / Supervisor: legacy-ka-supervisor.md.

Genie Agent Lifecycle

PhaseReferenceLoad whenTypical CLI
Create / updatecreate-genie-agent.mdBuilding or editing an Agent: the workflow, the serialized_space payload format, and the CLIdiscover-schema → create-space / update-space
Attach documentscreate-genie-agent.md § DocumentsDocument Q&A, docs + data, replacing a KA / Supervisorvolumes create → update-space → probe in Agent mode
Query / converse / validatequery-genie-agent.mdConversation API (tables), Agent mode API (needed for documents), Metric View SQLstart-conversation / Agent mode responses
Improve (inspect / diagnose / benchmark / fix)improve-genie-agent.mdWorking with an existing Agent: wrong/empty answers, quality tuning, benchmark evaluationget-space; genie-create-eval-run; update-space
Export / migrategenie-agent-cicd.mdExport, import, cross-workspace migration, batch migration, DABs/CI-CDget-space → remap → create-space
Optimization historyuc-persistence.mdSetting up UC Delta tables for multi-pass optimization history (CREATE TABLE DDL only)
Legacylegacy-ka-supervisor.mdMaintaining or migrating an existing Knowledge Assistant / Supervisor Agentknowledge-assistants / supervisor-agents

Typical flow: create → query/validate → improve (diagnose / benchmark / fix, as needed).

Commands

An Agent is defined by a serialized_space JSON object (sources, sample questions, per-column context, instructions), kept in a local genie_agent.json and passed to the CLI. Core commands below; the lifecycle table points to the full workflow, payload schema, and flags.

databricks genie list-spaces                                          # find Agents
databricks genie get-space SPACE_ID --include-serialized-space        # inspect config
databricks genie create-space WAREHOUSE_ID "$(jq -c . genie_agent.json)" \
  --title "..." --parent-path /Workspace/Users/you@company.com/genie_spaces   # create
databricks genie update-space SPACE_ID --serialized-space "$(jq -c . genie_agent.json)"  # full-replace edit
databricks genie start-conversation --no-wait SPACE_ID "a question"   # converse / validate (tables only)
databricks genie trash-space SPACE_ID                                 # delete

Documents (replaces KA and Supervisor)

Attach a managed UC volume in data_sources.volumes[]: create-space / update-space start indexing automatically, and documents are read in Agent mode only (the chat-mode start-conversation ignores them). Setup, waiting for indexing, adding documents to an existing Agent, permissions, limits, and evaluation: create-genie-agent.md § Documents.

Prerequisites

  • Tables / Metric Views in Unity Catalog and/or a managed UC volume of documents
  • SQL Warehouse to execute queries (auto-detected if not specified)

Related Skills

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/databricks/databricks-agent-skills/databricks-genie-agents">View databricks-genie-agents on skillZs</a>