| name | fmapi-codingagent-doctor |
| description | Run comprehensive FMAPI diagnostics — dependencies, configuration, profile, auth, connectivity, and model validation |
| user_invocable | true |
FMAPI Doctor
Run comprehensive diagnostics to identify issues with your Databricks Foundation Model API (FMAPI) configuration.
Instructions
- Run the doctor command:
setup-fmapi-codex doctor
-
Present the output to the user. The doctor runs seven diagnostic categories:
- Dependencies — Checks that jq, databricks, codex, and curl are installed; reports versions
- Environment — Detects OS, WSL version, and headless state
- Configuration — Verifies config file is valid TOML, the FMAPI provider block is present, and helper script exists and is executable
- Profile — Confirms the Databricks CLI profile exists in
~/.databrickscfg
- Auth — Tests whether the OAuth token is valid
- Connectivity — Tests HTTP reachability to the Databricks serving endpoints API. When AI Gateway v2 is configured, also tests gateway endpoint reachability.
- Models — Validates the configured model name exists and is ready
-
Each check shows PASS, FAIL, WARN, or SKIP with an actionable fix suggestion for failures.
-
If the command exits with code 1, some checks failed. Guide the user through fixing the reported issues. Common fixes:
- Missing dependencies: install via the suggested command
- Auth failures: suggest
$fmapi-codingagent-reauth
- Missing config: suggest
$fmapi-codingagent-setup
- Model issues: suggest
$fmapi-codingagent-list-models to discover available endpoints
