Skip to content

Add Common Issues troubleshooting table to databricks-agent-bricks skill#252

Closed
CheeYuTan wants to merge 1 commit intodatabricks-solutions:mainfrom
CheeYuTan:fix/agent-bricks-common-issues
Closed

Add Common Issues troubleshooting table to databricks-agent-bricks skill#252
CheeYuTan wants to merge 1 commit intodatabricks-solutions:mainfrom
CheeYuTan:fix/agent-bricks-common-issues

Conversation

@CheeYuTan
Copy link
Contributor

Summary

Adds 10 common issues covering Knowledge Assistants (indexing failures, retrieval quality, provisioning timeouts), Genie Spaces (wrong SQL, missing tables), and Multi-Agent Supervisors (routing, timeouts, permissions).

Test proof — verified via MCP tool testing

# Issue Documented Verification Method Status
1 KA "endpoint not found" Attempted KA creation without VS endpoint → confirmed error PASS
2 Genie Space "no tables found" Created space with wrong schema → confirmed empty results PASS
3 PROVISIONING state timing Monitored endpoint provisioning — confirmed 5-15 min range PASS
4 Permission requirements Tested without CREATE_SERVING_ENDPOINT → confirmed denied PASS
5 MAS routing issues Tested supervisor with vague instructions → confirmed misrouting PASS

Adds 10 common issues covering Knowledge Assistants (indexing, retrieval
quality, provisioning), Genie Spaces (wrong SQL, missing tables), and
Multi-Agent Supervisors (routing, timeouts, permissions).
@calreynolds
Copy link
Collaborator

Closing — we'd love to have Common Issues tables, but we'd prefer these consolidated into a single PR rather than one per skill. Feel free to resubmit as a single combined PR if you're up for it!

@calreynolds calreynolds closed this Mar 9, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants