Agentoverdracht

Overzicht

Met agent-naar-agentoverdracht kan een ElevenLabs-agent het lopende gesprek overdragen aan een andere aangewezen agent wanneer aan specifieke voorwaarden wordt voldaan. Dit maakt gelaagde conversationele workflows mogelijk, waarin verschillende agents specifieke taken of complexiteitsniveaus afhandelen.

Een initiële agent (Orchestrator) kan bijvoorbeeld algemene vragen afhandelen en het gesprek vervolgens, op basis van de context, doorsturen naar een gespecialiseerde agent. Overdrachten kunnen ook worden genest:

Orchestrator Agent (Initial Qualification)
│
├───> Agent 1 (e.g., Availability Inquiries)
│
├───> Agent 2 (e.g., Technical Support)
│     │
│     └───> Agent 2a (e.g., Hardware Support)
│
└───> Agent 3 (e.g., Billing Issues)

Doel: Gesprekken overdragen tussen gespecialiseerde AI-agents op basis van gebruikersbehoeften.

Triggervoorwaarden: De LLM moet deze tool aanroepen wanneer:

• Het verzoek van de gebruiker gespecialiseerde kennis of andere agentmogelijkheden vereist
• De huidige agent de vraag niet goed genoeg kan afhandelen
• De gespreksstroom aangeeft dat een ander agenttype nodig is

Parameters:

• reason (string, optioneel): De reden voor de agentoverdracht
• agent_number (integer, vereist): Nummer vanaf nul van de agent waarnaar moet worden overgedragen (op basis van geconfigureerde overdrachtsregels)

Indeling van functieaanroep:

{
  "type": "function",
  "function": {
    "name": "transfer_to_agent",
    "arguments": "{\"reason\": \"User needs billing support\", \"agent_number\": 0}"
  }
}

Implementatie: Definieer overdrachtsregels die voorwaarden aan specifieke agent-ID’s koppelen. Configureer naar welke agents de huidige agent kan overdragen. Agents worden in de overdrachtsconfiguratie aangeduid met nummers vanaf nul.

Agentoverdracht inschakelen

Je configureert agentoverdracht met de systeemtool transfer_to_agent.

1

De overdrachtstool toevoegen

Schakel agentoverdracht in door in de configuratie van je agent op het tabblad Agent de systeemtool transfer_to_agent te selecteren. Kies “Transfer to AI Agent” wanneer je een tool toevoegt.

2

Toolbeschrijving configureren (optioneel)

Je kunt een aangepaste beschrijving opgeven om het LLM te sturen bij het bepalen wanneer een overdracht moet worden gestart. Als je dit leeg laat, wordt een standaardbeschrijving gebruikt die de gedefinieerde overdrachtsregels omvat.

3

Overdrachtsregels definiëren

Configureer de specifieke regels voor overdracht naar andere agents. Geef voor elke regel het volgende op:

• Agent: De doelagent waarnaar het gesprek wordt overgedragen.
• Voorwaarde: Een beschrijving in natuurlijke taal van de omstandigheden waaronder de overdracht moet plaatsvinden (bijvoorbeeld: “Gebruiker vraagt naar factureringsgegevens”, “Gebruiker vraagt technische ondersteuning voor product X”).
• Vertraging vóór overdracht (milliseconden): De minimale vertraging (in milliseconden) voordat de overdracht plaatsvindt. Standaard is dit 0 voor directe overdracht.
• Overdrachtsbericht: Een optioneel aangepast bericht dat tijdens de overdracht wordt afgespeeld. Als je dit leeg laat, vindt de overdracht stilzwijgend plaats.
• Eerste bericht inschakelen: Of de overgedragen agent na de overdracht zijn eerste bericht moet afspelen. Standaard staat dit uit.

Het LLM gebruikt deze voorwaarden samen met de toolbeschrijving om te bepalen wanneer en naar welke agent (op nummer) moet worden overgedragen.

Zorg ervoor dat het gebruikersaccount dat de agent maakt minimaal viewerrechten heeft voor alle doelagents die in de overdrachtsregels zijn opgegeven.

Overdrachtsgedrag

Wanneer een overdracht plaatsvindt, geeft de bovenliggende agent (de agent die de overdracht start) bepaalde configuratiewaarden door aan de onderliggende agent (de agent die het gesprek ontvangt), terwijl andere volledig worden gereset.

Overerving van configuratie

De bovenliggende agent overschrijft de volgende waarden bij elke onderliggende agent, ongeacht de eigen configuratie van die agent:

Daarnaast wordt de huidige taal van de bovenliggende agent overgenomen. Als de onderliggende agent deze niet ondersteunt, valt deze terug op zijn eigen standaardtaal. De configuratie voor post-call-webhooks en -analyse (inclusief evaluatiecriteria en gegevensverzamelingsitems) geldt ook voor het hele gesprek.

Niet overgenomen

Alle andere configuraties worden ingesteld door de onderliggende agent, waaronder, maar niet beperkt tot:

• Prompt, eerste bericht, LLM, workflow, stem, tools en kennisbank
• TTS-stem, model, stabiliteit en andere steminstellingen (behalve agent_output_audio_format)
• ASR-model, kwaliteit en trefwoorden (behalve user_input_audio_format)
• Beurt/time-out, taalpresets, maximale duur enzovoort

Een agent die een Realtime-model gebruikt, kan alleen overdragen aan en ontvangen van andere agents die een Realtime-model gebruiken.

Transcript en chatgeschiedenis

Het volledige transcript blijft behouden gedurende het hele gesprek. Berichten van gebruikers en agents van alle voorafgaande agents blijven in de chatgeschiedenis staan.

Tijdens een overdracht worden toolaanroepen van transfer_to_agent verwijderd uit de geschiedenis die zichtbaar is voor het LLM van de onderliggende agent, zodat deze het gesprek voortzet zonder de overdracht te noemen.

Evaluatie na het gesprek

Het LLM voor evaluatie na het gesprek ontvangt het volledige, ongefilterde transcript: alle berichten van gebruikers en agents, en alle toolaanroepen, inclusief de overdracht.

Afzonderlijke berichten bevatten geen veld agent_id. Om te bepalen welke agent welke berichten heeft geproduceerd, gebruikt de evaluator de toolaanroep transfer_to_agent als grensmarkering in het transcript.

API-implementatie

Je kunt de systeemtool transfer_to_agent configureren wanneer je via de API een agent maakt of bijwerkt.

from elevenlabs import AgentConfig, ConversationalConfig, ElevenLabs
elevenlabs = ElevenLabs(api_key="YOUR_API_KEY")
# Define transfer rules with new options
transfer_rules = [
    {
        "agent_id": "AGENT_ID_1",
        "condition": "When the user asks for billing support.",
        "delay_ms": 1000,  # 1 second delay
        "transfer_message": "I'm connecting you to our billing specialist.",
        "enable_transferred_agent_first_message": True,
    },
    {
        "agent_id": "AGENT_ID_2",
        "condition": "When the user requests advanced technical help.",
        "delay_ms": 0,  # Immediate transfer
        "transfer_message": None,  # Silent transfer
        "enable_transferred_agent_first_message": False,
    },
]
response = elevenlabs.conversational_ai.agents.create(
    conversation_config=ConversationalConfig(
        agent=AgentConfig(
            first_message="Hi, how can I help you today?",
            prompt={
                "prompt": "You are a helpful assistant.",
                "built_in_tools": {
                    "transfer_to_agent": {
                        "type": "system",
                        "name": "transfer_to_agent",
                        # Optional custom description
                        "description": "Transfer the user to a specialized agent based on their request.",
                        "params": {
                            "system_tool_type": "transfer_to_agent",
                            "transfers": transfer_rules,
                        },
                    }
                },
            },
        ),
    ),
)
print(response)