Een aangepaste agent bouwen met behulp van de Supervisor-API (bèta)

Important

Deze functie bevindt zich in de bètaversie. Accountbeheerders kunnen de toegang tot deze functie beheren vanaf de pagina Previews . Zie Azure Databricks previews beheren.

U kunt een Azure Databricks Apps-agent bouwen die gebruikmaakt van de Supervisor-API (bèta) voor indeling in plaats van de agentlus in uw eigen code te beheren. Het resultaat is hetzelfde als het ontwerpen van een aangepaste agent: een geïmplementeerde app met een chatgebruikersinterface, een /invocations eindpunt en verificatie. Het verschil is dat Azure Databricks de agentlus voor u uitvoert. Uw agent.py maakt één API-aanroep en Azure Databricks verwerkt de selectie, uitvoering en antwoordsynthese van hulpprogramma's.

De Supervisor-API werkt met een van de ondersteunde basismodellen. Wijzig het model veld om van provider te wisselen zonder uw hulpprogrammadefinities of handlerlogica aan te raken.

Wanneer gebruikt u de Supervisor-API?

De Supervisor-API werkt goed wanneer uw agent alleen Azure Databricks gehoste hulpprogramma's gebruikt en geen aangepaste logica nodig heeft tussen hulpprogramma-aanroepen. Gebruik in plaats daarvan een aangepaste agentlus als uw agent een van de volgende zaken vereist:

  • Hulpprogramma's voor functies aan de clientzijde (de Supervisor-API kan niet worden gemengd met gehoste en clienthulpprogramma's in één aanvraag)
  • Eindpunten van agenten behalve Agent Bricks Knowledge Assistant-eindpunten
  • Aangepaste retrievers, aangepaste invoer/uitvoer of fijnmazige streamingbesturing
  • Aangepaste Python logica tussen hulpprogramma-aanroepen, zoals voorwaardelijke vertakking of statusbeheer
  • Controle over inferentieparameters, zoals temperature

Zie Supervisor-API (bèta) voor de volledige API-verwijzing en ondersteunde parameters.

Requirements

Een aangepaste agent bouwen met behulp van de Supervisor-API

Het aanbevolen startpunt is om een nieuwe app te maken op basis van de nieuwste Databricks-app-sjabloon. De nieuwste sjablonen bevatten een ingebouwde use-supervisor-api vaardigheid voor AI-coderingsassistenten, evenals een add-tools vaardigheid voor het toevoegen van gehoste hulpprogramma's.

Zie Een AI-agent ontwerpen en implementeren in Databricks-apps om een nieuwe app te maken op basis van een sjabloon.

Zodra uw app is ingesteld vanaf de nieuwste sjabloon, opent u het project in uw AI-coderingsassistent en voert u het volgende uit:

Use the Supervisor API skill to update this agent to use the Databricks Supervisor API.

De vaardigheid werkt uw agent_server/agent.py bij om DatabricksOpenAI().responses.create() aan te roepen met gehoste hulpprogramma's, waarmee de handmatige agentlus wordt vervangen. Ook voegt het de databricks-openai afhankelijkheid toe en worden de bètabeperkingen genoteerd.

Het resultaat is dezelfde geïmplementeerde app, met een chatgebruikersinterface, verificatie en een /invocations eindpunt, maar met eenvoudigere agentcode. Zie Een AI-agent ontwerpen en implementeren in Databricks-apps voor de volledige implementatiewerkstroom (implementeren in apps, hulpprogramma's toevoegen, evalueren).

Ondersteunde hulpprogramma's en parameters

Zie Supervisor-API (bèta) voor de volledige lijst met ondersteunde hulpprogrammatypen, aanvraagparameters en codevoorbeelden.

Voor elk hulpprogramma dat u toevoegt, verleent u ook de bijbehorende resourcemachtiging in databricks.yml. Bekijk de add-tools vaardigheid in .claude/skills/ voor voorbeelden.

Volgende stappen 

  • Last updated on