By 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-modelsto discover available endpoints