Supervisor Agent gebruiken om een gecoördineerd multiagentsysteem te maken

Op deze pagina wordt beschreven hoe u Supervisor Agent gebruikt om een supervisorsysteem met meerdere agents te maken waarmee AI-agents en -hulpprogramma's worden ingedeeld om samen te werken aan complexe taken. U kunt hun coördinatie verbeteren op basis van feedback in natuurlijke taal van uw vakexperts.

Wat is Supervisor Agent?

Gebruik Supervisor Agent om een supervisorsysteem te maken dat Genie Spaces, agenteindpunten, Unity Catalog-functies, MCP-servers en aangepaste agents coördineert om complexe taken uit te voeren in verschillende gespecialiseerde domeinen. Supervisor Agent maakt gebruik van geavanceerde AI-indelingspatronen voor het beheren van agentinteracties, taakdelegering en resultaatsynthese om uitgebreide oplossingen te leveren. Het ondersteunt meerdere talen.

Supervisor Agent bouwt het systeem voor u en stelt u in staat om het in de loop van de tijd te verbeteren met menselijke feedback. Het is ideaal voor het ondersteunen van de volgende gebruiksvoorbeelden:

• Bied marktanalyse en inzichten door te zoeken in onderzoeksrapporten en gebruiksgegevens.
• Beantwoord vragen over interne processen en automatiseer de afhandeling van een ticketachterstand.
• Versnel de klantenservice door beleid, veelgestelde vragen, accounts en andere vragen te beantwoorden.

Supervisor Agent stelt u in staat om de coördinatiekwaliteit van de supervisor te verbeteren en het gedrag van agents aan te passen op basis van feedback in natuurlijke taal van uw vakexperts. Geef voorbeelden en richtlijnen voor het optimaliseren van de prestaties van het systeem.

Supervisor Agent maakt een uitgebreid eindpunt dat u downstream kunt gebruiken voor uw toepassingen. U kunt bijvoorbeeld communiceren met het eindpunt door prompts in Playground in te dienen of een chattoepassing te bouwen met databricks-apps. De supervisor heeft ingebouwde toegangsbeheer, zodat eindgebruikers alleen toegang hebben tot de subagents en gegevens waartoe ze toegang hebben.

Supervisor Agent maakt gebruik van standaardopslag voor het opslaan van tijdelijke gegevenstransformaties, modelcontrolepunten en interne metagegevens die elke agent aandrijven. Bij het verwijderen van agents worden alle gegevens die aan de agent zijn gekoppeld, verwijderd uit de standaardopslag.

Requirements

• Een werkruimte met het volgende:
  • Serverloze rekenkracht beschikbaar (standaard ingeschakeld in werkruimten met Unity Catalog in een ondersteunde regio).
  • Unity Catalog ingeschakeld. Zie Een werkruimte inschakelen voor Unity Catalog.
  • Toegang tot modelaanbieding.
  • Toegang tot een serverloos gebruiksbeleid met een niet-nulbudget.
• Een werkruimte in een van de ondersteunde regio's.
• U moet agents of hulpprogramma's hebben die klaar zijn voor gebruik. U moet ten minste één subagent opgeven.
• Eindgebruikers van de supervisoragent hebben expliciete toegang nodig om met elke subagent te communiceren. Zie Ondersteunde subagents en hulpprogramma's voor vereiste machtigingen.

Ondersteunde subagenten en hulpmiddelen

Wanneer u een supervisor maakt, moet u subagenten opgeven die deze kan coördineren en eindgebruikers expliciet toegang geven tot elk van deze subagenten. De volgende tabel bevat ondersteunde subagenttypen, het maken van elke subagent en de vereiste machtigingen voor eindgebruikers. De supervisor heeft ingebouwde toegangsbeheer, zodat eindgebruikers alleen toegang hebben tot de subagents en gegevens waartoe ze toegang hebben. Zonder expliciete toegang kan de supervisor geen nuttige antwoorden van een subagent retourneren.

Een supervisorsysteem met meerdere agents maken

Ga naar Agents in het linkernavigatiedeelvenster van uw werkruimte. Klik op Agent maken en selecteer Supervisor Agent.

Stap 1: Uw supervisor configureren

Configureer uw supervisor en voeg de agents toe die deze gaat coördineren.

1. Voeg onder Hulpmiddelen en subagenten in het linkerdeelvenster uw hulpmiddelen en subagenten toe. Klik op het type hulpprogramma/agent dat u wilt toevoegen en selecteer vervolgens in de vervolgkeuzelijst die wordt weergegeven. Of gebruik de zoekbalk om hulpprogramma's/agents te selecteren. U kunt maximaal 30 verschillende agents en hulpprogramma's selecteren.

2. Geef voor betere resultaten een beschrijving op voor elk hulpprogramma/subagent. Klik op het hulpmiddel/subagent om de beschrijving aan te passen. De supervisor gebruikt de informatie in de beschrijving om agents te coördineren. Geef zoveel mogelijk details op om de taakdelegering te verbeteren.

3. Als u machtigingen voor elk hulpprogramma/elke agent wilt beheren, plaatst u de muisaanwijzer op de tegel tool/agent en klikt u op Hiermee opent u dat hulpprogramma/de agent in Azure Databricks en kunt u daar machtigingen configureren. Zie Ondersteunde subagents en hulpprogramma's voor vereiste machtigingen voor eindgebruikers.

   Note

   Als de eindgebruiker geen toegang heeft tot subagenten, beëindigt de supervisor het gesprek. Als de eindgebruiker toegang heeft tot sommige, maar niet alle subagents, stuurt de supervisor het gesprek weg van subagents die de gebruiker niet kan openen.

4. (Optioneel) Geef in het veld Instructies richtlijnen op voor hoe de supervisor moet reageren.

5. (Optioneel) Geef in het veld Beschrijving een samenvatting op van wat deze supervisor doet. Deze beschrijving wordt weergegeven voor gebruikers en wordt gebruikt voor zoekopdrachten.

Stap 2: Test uw supervisor-agent

Nadat uw supervisor klaar is met initialiseren, test u deze om te zien hoe goed de supervisor meerdere agenten coördineert om complexe taken uit te voeren. Chat in het rechterdeelvenster met de agent om diens reacties te evalueren.

1. (Optioneel) U kunt de agent ook testen in AI Playground. Klik op Openen in Speeltuin. Hiermee wordt AI Playground geopend met het eindpunt van uw supervisor verbonden. Als ai-ondersteunende functies zijn ingeschakeld, kunt u ai-rechter en synthetische taakgeneratie inschakelen om u te helpen uw supervisor te evalueren.
2. Voer een complexe vraag of taak in voor uw supervisor.
3. Evalueer het antwoord. Zorg ervoor dat de supervisor taken naar de juiste agents delegeert.
4. Tijdens interactie met de supervisor wordt u mogelijk gevraagd richtlijnen toe te voegen om het antwoord ervan te verbeteren. Geef antwoordrichtlijnen op en genereer het antwoord opnieuw.
5. Pas op basis van de antwoorden van uw agent de velden Beschrijving en Instructies aan de linkerkant aan om de configuratie te verbeteren.

Als u tevreden bent over de prestaties van uw supervisor, kunt u de supervisor blijven gebruiken as-is.

Stap 3: De supervisor verbeteren

Supervisor Agent kan het gedrag van de supervisor aanpassen op basis van feedback in natuurlijke taal. Verzamel feedback van experts via de configuratiepagina om de coördinatiekwaliteit van uw supervisor te verbeteren. Het verzamelen van gelabelde gegevens voor uw supervisor kan de prestaties verbeteren. Supervisor Agent zal de supervisor opnieuw trainen en optimaliseren op basis van de nieuwe gegevens.

Voeg op het tabblad Voorbeelden vragen en taakscenario's toe voor de supervisor.

1. Vragen toevoegen aan label:

   1. Klik op + Toevoegen om een vraag toe te voegen.
   2. Voer uw vraag in het modaal toevoegen van een vraag in.
   3. Klik op Toevoegen. De vraag moet worden weergegeven in de gebruikersinterface.
   4. Herhaal dit totdat u alle vragen hebt toegevoegd die u wilt evalueren.
   5. Als u een vraag wilt verwijderen, klikt u op het kebabmenu en vervolgens op Verwijderen.

2. Nadat u klaar bent met het toevoegen van uw vragen, kunt u de agent delen met anderen om te controleren om u te helpen bij het bouwen van een gelabelde gegevensset van hoge kwaliteit. Deel een koppeling naar de configuratiepagina van de Supervisor-agent om feedback van experts te verzamelen.

3. Zorg ervoor dat de experts toegang hebben tot de supervisoragent en de juiste subagenten:

   1. Klik in de rechterbovenhoek op het om machtigingen te beheren. Verdeel de experts CAN_MANAGE machtigingen zodat ze toegang hebben tot de agent en feedback kunnen geven.
   2. Zorg ervoor dat de SME toegang heeft tot elke subagent. Zie Ondersteunde subagenten en hulpprogramma's voor de vereiste machtigingen per subagenttype.

   Als de SME geen toegang heeft tot subagenten, beëindigt de supervisor het gesprek. Als de eindgebruiker toegang heeft tot sommige, maar niet alle subagents, stuurt de supervisor het gesprek weg van subagents die de gebruiker niet kan openen.

4. Als u gegevens wilt labelen, klikt u op een vraag en voegt u richtlijnen toe in het deelvenster dat wordt weergegeven. Richtlijnen gelden direct nadat ze zijn opgeslagen.

5. Test de agent opnieuw op de configuratiepagina of AI Playground om de verbeterde prestaties te zien. Voeg indien nodig meer vragen en richtlijnen toe om het gedrag te blijven verbeteren.

Stap 4: Machtigingen beheren

Standaard hebben alleen auteurs van agents en werkruimtebeheerders machtigingen voor de agent. Als u wilt dat andere gebruikers uw agent kunnen bewerken of er query's op kunnen uitvoeren, moet u hen expliciet toestemming geven.

Machtigingen voor uw agent beheren:

1. Open uw agent op de pagina Agents .
2. Klik bovenaan op het het kebabmenu.
3. Klik op Machtigingen beheren.
4. Selecteer in het venster Machtigingsinstellingen de gebruiker, groep of service-principal.
5. Selecteer de machtiging die u wilt verlenen:
   • Kan beheren: hiermee kunt u de agent beheren, inclusief het instellen van machtigingen, het bewerken van de agentconfiguratie en het verbeteren van de kwaliteit.
   • Kan query's uitvoeren: Hiermee kunt u query's uitvoeren op het eindpunt van de agent in AI Playground en via de API. Gebruikers met alleen deze machtiging kunnen de agent niet weergeven of bewerken op de pagina Agents.
6. Klik op Toevoegen.
7. Klik op Opslaan.

Stap 5: Het eindpunt van de agent opvragen

Klik op de agentpagina op Eindpunt om het agenteindpunt te openen en details te bekijken.

Er zijn meerdere manieren om een query uit te voeren op het gemaakte supervisor-eindpunt. Gebruik de codevoorbeelden in AI Playground als uitgangspunt.

1. Klik op Openen in speeltuin.
2. Klik in Playground op Code ophalen.
3. Kies hoe u het eindpunt wilt gebruiken:
   • Selecteer Curl-API voor een codevoorbeeld om een query uit te voeren op het eindpunt met behulp van curl.
   • Selecteer Python API voor een codevoorbeeld voor interactie met het eindpunt met behulp van Python.

Supervisoragents beheren met behulp van de Databricks SDK

U kunt de Databricks SDK voor Python gebruiken om programmatisch supervisoragents en hun hulpprogramma's te maken en te beheren. Zie de Supervisor Agents SDK-naslag voor de volledige lijst van beschikbare bewerkingen.

Een supervisoragent maken

In het volgende voorbeeld wordt een nieuwe supervisoragent gemaakt met een weergavenaam, beschrijving en instructies.

from databricks.sdk import WorkspaceClient
from databricks.sdk.service.supervisoragents import SupervisorAgent

w = WorkspaceClient()

supervisor_agent = SupervisorAgent(
    display_name="<display-name>",
    description="<description>",
    instructions="<instructions>",
)
created = w.supervisor_agents.create_supervisor_agent(supervisor_agent=supervisor_agent)
print(created)

Vervang , <display-name>en <description> door <instructions>de waarden voor uw supervisoragent.

Tools (subagents) beheren

U kunt hulpprogramma's (subagents) toevoegen, bijwerken en verwijderen op een bestaande supervisoragent met behulp van de SDK. Hulpprogramma's vertegenwoordigen subagents zoals kennisassistenten, Genie Spaces, Unity Catalog-functies en andere agenteindpunten.

Een hulpprogramma toevoegen (subagent)

In het volgende voorbeeld wordt een kennisassistent toegevoegd als hulpmiddel voor een bestaande supervisoragent.

from databricks.sdk import WorkspaceClient
from databricks.sdk.service.supervisoragents import Tool, KnowledgeAssistant

w = WorkspaceClient()

tool = Tool(
    tool_type="knowledge_assistant",
    description="<tool-description>",
    knowledge_assistant=KnowledgeAssistant(
        knowledge_assistant_id="<knowledge-assistant-id>",
    ),
)

created_tool = w.supervisor_agents.create_tool(
    parent="supervisor-agents/<supervisor-agent-id>",
    tool=tool,
    tool_id="<tool-id>",
)
print(created_tool)

Vervang <supervisor-agent-id> door de id van uw supervisoragent, <knowledge-assistant-id> door de id van de kennisassistent die moet worden toegevoegd als een hulpprogramma en <tool-id> door een unieke id voor het hulpprogramma.

Een hulpprogramma bijwerken (subagent)

In het volgende voorbeeld wordt de beschrijving van een bestaand hulpprogramma bijgewerkt.

from databricks.sdk import WorkspaceClient
from databricks.sdk.service.supervisoragents import Tool
from databricks.sdk.common.types.fieldmask import FieldMask

w = WorkspaceClient()

updated_tool = w.supervisor_agents.update_tool(
    name="supervisor-agents/<supervisor-agent-id>/tools/<tool-id>",
    tool=Tool(
        tool_type="knowledge_assistant",
        description="<new-description>",
    ),
    update_mask=FieldMask(["description"]),
)
print(updated_tool)

Toegestane velden in update_mask: description.

Een hulpprogramma verwijderen (subagent)

In het volgende voorbeeld wordt een hulpprogramma verwijderd van een supervisoragent.

from databricks.sdk import WorkspaceClient

w = WorkspaceClient()

w.supervisor_agents.delete_tool(
    name="supervisor-agents/<supervisor-agent-id>/tools/<tool-id>",
)

Limitations

• U kunt niet meer dan 20 agents gebruiken in één supervisorsysteem.
• Subagents voor AI Search-indexen ondersteunen alleen Delta Sync-indexen. Zie AI Search-eindpunten en -indexen maken.
• Zoeken op internet is niet beschikbaar in werkruimten waarvoor HIPAA/BAA-naleving is ingeschakeld. Webzoekopdrachten zijn alleen beschikbaar in regio's met een systeemeigen model dat geschikt is voor zoeken op internet of regio's waarvoor verwerking tussen geografische gebieden is ingeschakeld. De supervisor blokkeert het toevoegen van het hulpprogramma voor zoeken op internet in niet-in aanmerking komende werkruimten.
• Werkruimten waarvoor Verbeterde beveiliging en naleving zijn ingeschakeld, worden niet ondersteund. Zie add-on voor uitgebreide beveiliging en naleving.

Volgende stappen 

Langlopende taken van supervisoragent