Voximplant

एजेंट बनाएं या चुनें

ElevenAgents में एजेंट बनाएं। अगर कॉल कनेक्ट होते ही उसे बोलना चाहिए, तो उसे पहला संदेश दें। ऑडियो formats इंटीग्रेशन द्वारा सेट होते हैं, इसलिए एजेंट के कॉन्फ़िगर किए गए formats का इस्तेमाल Voximplant कॉल के लिए नहीं होता।

End call सक्षम करें

एजेंट को बातचीत खत्म करने देने के लिए Agent → Tools → System tools में End call सक्षम करें। कॉल खत्म करते समय एजेंट जो कारण देता है, वह decision के साथ आपके scenario को भेजा जाता है।

Voximplant ट्रांसफ़र नियम जोड़ें (वैकल्पिक)

एजेंट को कॉलर को किसी इंसान के पास भेजने देने के लिए, उसे Transfer to number system tool दें, जिसमें provider configuration voximplant वाला ट्रांसफ़र नियम हो। इस नियम में कोई destination नहीं होता: बातचीत transfer-to-agent decision के साथ खत्म होती है और आपका scenario कॉलर को रूट करता है। ट्रांसफ़र नियम API के ज़रिए कॉन्फ़िगर किए जाते हैं। एजेंट पर PATCH करके tool जोड़ें:

curl -X PATCH "https://api.elevenlabs.io/v1/convai/agents/agent_7101k5zvyjhmfg983brhmhkd98n6" \
  -H "xi-api-key: $ELEVENLABS_API_KEY" -H "Content-Type: application/json" \
  -d '{
    "conversation_config": {"agent": {"prompt": {"built_in_tools": {
      "end_call": {"type": "system", "name": "end_call", "description": "",
                   "params": {"system_tool_type": "end_call"}},
      "transfer_to_number": {
        "type": "system", "name": "transfer_to_number", "description": "",
        "params": {
          "system_tool_type": "transfer_to_number",
          "transfers": [],
          "transfer_rules": [{
            "condition": "the caller asks to speak with a human",
            "provider_configs": [
              {"type": "voximplant", "config": {"type": "voximplant_handoff"}}
            ]
          }]
        }
      }
    }}}}
  }'

एजेंट का पूरा built_in_tools object भेजें, जिसमें उसके मौजूदा tools भी शामिल हों, जैसे end_call। एजेंट जो option वापस भेजता है, वह तय token voximplant होता है, इसलिए हर tool के लिए एक Voximplant नियम काफ़ी है। अन्य providers के लिए कॉन्फ़िगर किए गए फोन नंबर और SIP URIs, Voximplant कॉल पर उपलब्ध नहीं होते।

अलग API key बनाएं

एजेंट वाले workspace में API key बनाएं और इसे ElevenAgents तक सीमित रखें। केवल Voximplant से कनेक्शन स्वीकार करने के लिए, key के allowed IP addresses को Voximplant के media servers तक सीमित करें, जिनकी सूची Voximplant यहां देता है: https://api.voximplant.com/getMediaResources?with_mediaservers।

WebSocket URL नोट करें

scenario एक ऐसे URL से कनेक्ट होता है जिसमें आपकी agent ID होती है:

एजेंट की किसी branch को pin करने के लिए ?branch_id=<branch_id> जोड़ें।

Application बनाएं

Voximplant control panel में Applications खोलें और Create application पर क्लिक करें। इसे कोई नाम दें, उदाहरण के लिए elevenlabs-agent, और Create पर क्लिक करें।

API key को secret के रूप में स्टोर करें

Application में Secrets खोलें और Add secret पर क्लिक करें। इसका नाम ELEVENLABS_API_KEY रखें, एजेंट के workspace के लिए बनाई गई API key को Value में पेस्ट करें और Add secret पर क्लिक करें। scenario इसे VoxEngine.getSecretValue() से पढ़ता है, इसलिए key कभी scenario code में दिखाई नहीं देती।

Scenario बनाएं

Scenarios खोलें, Create scenario पर क्लिक करें, इसका नाम elevenlabs_agent रखें, नीचे दिया code पेस्ट करें, ELEVENLABS_URL में agent ID बदलें और Save पर क्लिक करें। यह इनबाउंड कॉल रिसीव करता है, उसे एजेंट को स्ट्रीम करता है और बातचीत खत्म होने पर decision के अनुसार कार्रवाई करता है। आउटबाउंड कॉल के लिए, की गई कॉल के CallEvents.Connected handler में WebSocket खोलें।

const ELEVENLABS_URL =
  "wss://api.elevenlabs.io/v1/convai/conversation/voximplant/agent_7101k5zvyjhmfg983brhmhkd98n6";
VoxEngine.addEventListener(AppEvents.CallAlerting, ({ call }) => {
  call.answer();
  let decision = null;
  const ws = VoxEngine.createWebSocket(ELEVENLABS_URL, {
    headers: [
      {
        name: "Authorization",
        value: `Bearer ${VoxEngine.getSecretValue("ELEVENLABS_API_KEY")}`,
      },
    ],
  });
  ws.addEventListener(WebSocketEvents.OPEN, () => {
    call.sendMediaTo(ws, {
      encoding: WebSocketAudioEncoding.PCM16_8KHZ,
      customParameters: { customer_name: "Ana", task_id: "task-7" },
    });
    ws.sendMediaTo(call);
  });
  ws.addEventListener(WebSocketEvents.MESSAGE, ({ text }) => {
    const message = JSON.parse(text);
    if (message.customEvent === "elevenlabs-decision") {
      decision = message.payload;
      Logger.write(`ElevenLabs decision: ${JSON.stringify(decision)}`);
    }
  });
  ws.addEventListener(WebSocketEvents.CLOSE, (e) => {
    Logger.write(`ElevenLabs socket closed: code=${e.code} reason=${e.reason}`);
    if (decision?.action === "transfer-to-agent") {
      // Route the caller to a human here, for example with VoxEngine.callPSTN().
      call.say("Connecting you to an agent.", { language: VoiceList.Amazon.en_US_Joanna });
      call.addEventListener(CallEvents.PlaybackFinished, () => call.hangup());
      return;
    }
    call.hangup();
  });
  call.addEventListener(CallEvents.Disconnected, () => {
    ws.close();
    VoxEngine.terminate();
  });
});

कॉल को scenario पर रूट करें

Routing खोलें, Create rule पर क्लिक करें, इसे नाम दें और elevenlabs_agent scenario असाइन करें। डिफ़ॉल्ट pattern .* application की हर कॉल को scenario के ज़रिए भेजता है; अगर application दूसरी कॉल भी संभालता है, तो इसे किसी फोन नंबर तक सीमित करें। फोन नंबर रूट करने के लिए, उसे Numbers में application से अटैच करें।

टेस्ट कॉल करें

आप फोन नंबर के बिना browser से application को कॉल कर सकते हैं:

1. Users खोलें, Create user पर क्लिक करें और पासवर्ड के साथ एक user बनाएं।

   

2. Routing में Test tools और फिर Softphone पर क्लिक करें। उस user के रूप में sign in करें, microphone access की अनुमति दें, कोई भी destination डालें और कॉल करें। एजेंट अपने पहले संदेश के साथ जवाब देगा।

3. कॉल खत्म होने पर Call history खोलें। हर कॉल में कॉल के साथ एक WebSocket leg भी सूचीबद्ध होता है। session देखने के लिए View log पर क्लिक करें।

   

   Log में ElevenLabs का भेजा हुआ decision, WebSocket close और scenario की अगली कार्रवाई दिखाई देती है। इस उदाहरण में कॉलर ने किसी व्यक्ति से बात करने को कहा था, इसलिए decision एजेंट द्वारा दिए कारण के साथ transfer-to-agent है।