How rob-mckenna/foundry-databricks-genie-connector works
This repository is a Foundry-to-Databricks Genie connector: it validates configuration and provisions a reusable Toolbox and OAuth project connection, which Foundry agents use to reach either Genie Agent or Genie One. The optional bootstrap provisions a dedicated test agent and can run a consent-aware smoke test; the separate test-agent command exercises an existing agent. Edges between runtime services follow the README’s documented flow. Source excerpts show CLI dispatch, setup and bootstrap ownership; the implementation of agent_test.py and some setup details was not sampled.
Main entry points: cli.py Command CLI · setup.py Resource setup · bootstrap.py Test-agent bootstrap · agent_test.py Existing-agent test
Components 17
Configuration and CLI
- Command CLI
src/foundry_databricks_genie/cli.py - Configuration validation
src/foundry_databricks_genie/config.py
Foundry provisioning
- Resource setup
src/foundry_databricks_genie/setup.py - Reusable Toolbox
- OAuth project connection
Agent testing
- Test-agent bootstrap
src/foundry_databricks_genie/bootstrap.py - Existing-agent test
src/foundry_databricks_genie/agent_test.py - Consent-aware smoke test
src/foundry_databricks_genie/smoke.py - Foundry agents
Databricks analytics
- Databricks workspace
- Unity Gateway
- Genie One
- Curated Genie Agent
- Unity Catalog data
Other components
- Operator
- Azure Developer CLI
- End user
Connections 21
- Operator → Command CLI: runs commands
README.md - Command CLI → Configuration validation: loads settings
src/foundry_databricks_genie/cli.py - Command CLI → Resource setup: dispatches setup
src/foundry_databricks_genie/cli.py - Command CLI → Test-agent bootstrap: dispatches bootstrap
src/foundry_databricks_genie/cli.py - Command CLI → Existing-agent test: dispatches test
src/foundry_databricks_genie/cli.py - Resource setup → Azure Developer CLI: runs provisioning commands
src/foundry_databricks_genie/setup.py - Resource setup → Reusable Toolbox: creates and checks
src/foundry_databricks_genie/setup.py - Resource setup → OAuth project connection: creates or verifies
src/foundry_databricks_genie/setup.py - Test-agent bootstrap → Resource setup: provisions resources
src/foundry_databricks_genie/bootstrap.py - Test-agent bootstrap → Consent-aware smoke test: runs optional test
src/foundry_databricks_genie/bootstrap.py - Foundry agents → Reusable Toolbox: calls tools through
README.md - Reusable Toolbox → OAuth project connection: uses connection
README.md - OAuth project connection → Databricks workspace: authenticates to
README.md - End user → OAuth project connection: authorizes per user
README.md - Databricks workspace → Unity Gateway: routes Genie One via
README.md - Unity Gateway → Genie One: dispatches queries
README.md - Databricks workspace → Curated Genie Agent: serves curated MCP
README.md - Genie One → Unity Catalog data: queries governed data
README.md - Curated Genie Agent → Unity Catalog data: queries governed data
README.md - Existing-agent test → Foundry agents: tests existing agent
README.md - Consent-aware smoke test → Foundry agents: invokes test agent