supervisor-api

Delegate agent tool looping to the Databricks Supervisor API via responses.create().

4|Updated May 9, 2026
One-click install
npx skills add https://github.com/victorlou/housing-assistant --skill supervisor-api
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: supervisor-api
Source: https://github.com/victorlou/housing-assistant/tree/main/app/app-templates/.claude/skills/supervisor-api
Command: npx skills add https://github.com/victorlou/housing-assistant --skill supervisor-api

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It removes the burden of managing tool-selection, looping, and synthesis logic on the client by delegating the full agent loop to the Databricks Supervisor API.

Core Features & Use Cases

  • Server-side tool orchestration: Declare hosted tools and let responses.create() handle the iterative loop and final synthesis.
  • Hosted + client-side function tools in one request: Mix Databricks-hosted tools (e.g., Genie space, UC functions, knowledge assistants) with your own Python-callable function tools.
  • Production integration patterns: Drop-in changes for agent_server/agent.py, support for model selection at runtime, and optional MLflow distributed tracing.

Quick Start

Use the Databricks Supervisor API by defining your hosted and function tools, then replace your existing agent invoke/stream handlers so they call responses.create() to let Databricks run the tool loop server-side.

Frequently Asked Questions about supervisor-api

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I move agent tool orchestration server-side with Databricks?

Call the Supervisor API via `responses.create()` after declaring hosted tools as a structured list to delegate iterative tool-selection, looping, and synthesis logic to Databricks server-side.

Can I mix Databricks hosted tools with client-side function tools in the same request?

Yes, you can mix Databricks-hosted tools like Genie spaces, Unity Catalog functions, and knowledge assistants with your own Python-callable client-side function tools within the same `responses.create()` request.

What is the Databricks Supervisor API used for in agent loops?

The Databricks Supervisor API is used to replace client-managed agent tool looping with server-side orchestration. It handles the iterative execution and final synthesis of AI responses, removing the burden of managing tool-selection logic on the client.

Does the Supervisor API support streaming and background modes at the same time?

No, the Supervisor API enforces mutually exclusive stream and background modes. You must choose one mode per request and follow constraints around unsupported inference parameters and token scoping, as on-behalf-of (OBO) token scoping is not supported.

How do I enable MLflow distributed tracing for server-side agent loops?

To enable MLflow distributed tracing for server-side agent loops, apply the optional MLflow tracing configurations alongside drop-in changes for `agent_server/agent.py`, which supports model selection at runtime while calling `responses.create()`.