Changelog

नए एंडपॉइंट्स

ElevenAgents

• बातचीत ट्रायेज टिकट के नौ एंडपॉइंट्स जोड़े गए:
  • बातचीत टिकट बनाएं - POST /v1/convai/triage-tickets। रिक्वेस्ट में conversation_id (string) ज़रूरी है और यह qa_comment (nullable string, 1–10,000 characters) व अधिकतम 200 टर्न टिप्पणियां स्वीकार करती है।
  • टिकट सूचीबद्ध करें - GET /v1/convai/agents/{agent_id}/triage-tickets, कर्सर पेजिनेशन के साथ।
  • मैन्युअल टिकट बनाएं - POST /v1/convai/agents/{agent_id}/triage-tickets। रिक्वेस्ट में qa_comment (string, 1–10,000 characters) ज़रूरी है।
  • असाइन किए जा सकने वाले यूज़र्स सूचीबद्ध करें - GET /v1/convai/agents/{agent_id}/triage-tickets/assignable-users। रिस्पॉन्स में गैर-सर्विस-अकाउंट वर्कस्पेस सदस्य और हर सदस्य के एजेंट एक्सेस की जानकारी होती है।
  • टिकट प्राप्त करें - GET /v1/convai/triage-tickets/{agentqa_ticket_id}।
  • टिकट अपडेट करें - PATCH /v1/convai/triage-tickets/{agentqa_ticket_id}। रिक्वेस्ट वैकल्पिक status और nullable assignee_user_id स्वीकार करती है।
  • टिकट हटाएं - DELETE /v1/convai/triage-tickets/{agentqa_ticket_id}।
  • टिप्पणी जोड़ें - POST /v1/convai/triage-tickets/{agentqa_ticket_id}/comments। रिक्वेस्ट में comment (string, 1–10,000 characters) ज़रूरी है।
  • टर्न टिप्पणी जोड़ें - POST /v1/convai/triage-tickets/{agentqa_ticket_id}/turn-comments। रिक्वेस्ट में शून्य-आधारित turn_index (integer) और comment (string, 1–10,000 characters) ज़रूरी हैं।

अपडेट किए गए एंडपॉइंट्स

ElevenAgents

• साइन किया गया URL प्राप्त करें - GET /v1/convai/conversation/get-signed-url
  • वैकल्पिक debug_events_request (boolean, डिफ़ॉल्ट false) जोड़ा गया। डीबग इवेंट के लिए एजेंट पर एडिटर एक्सेस ज़रूरी है।
• WebRTC टोकन प्राप्त करें - GET /v1/convai/conversation/token
  • वैकल्पिक debug_events_request (boolean, डिफ़ॉल्ट false) जोड़ा गया। पुराना GET /v1/convai/conversation/get_signed_url रूट भी यही पैरामीटर स्वीकार करता है।
• बातचीत सूचीबद्ध करें - GET /v1/convai/conversations
  • ऐसे बातचीत मिलाने के लिए वैकल्पिक triggered_procedure_ids (nullable string array, अधिकतम 50) जोड़ा गया, जिनमें कोई भी निर्दिष्ट प्रक्रिया चली थी।
  • न चलने वाले टूल कॉल शामिल करने के लिए वैकल्पिक include_invalid_tool_calls (boolean, डिफ़ॉल्ट false) जोड़ा गया।
  • कॉल शुरू होने के समय के लिए वैकल्पिक sort_direction (asc या desc, डिफ़ॉल्ट desc) जोड़ा गया।
• बातचीत संदेशों में टेक्स्ट खोजें - GET /v1/convai/conversations/messages/text-search
  • वैकल्पिक triggered_procedure_ids (nullable string array, अधिकतम 50) जोड़ा गया।
  • वैकल्पिक include_invalid_tool_calls (boolean, डिफ़ॉल्ट false) जोड़ा गया।
• एजेंट बातचीत टॉपिक प्राप्त करें - GET /v1/convai/agents/{agent_id}/topics
  • वैकल्पिक include_evaluation_criteria (boolean, डिफ़ॉल्ट true) जोड़ा गया।
  • sort_by में frustration जोड़ा गया।
  • टॉपिक रिस्पॉन्स में nullable success_rate (number) जोड़ा गया है, जबकि पूरे रिस्पॉन्स में aggregated_run_count (integer, डिफ़ॉल्ट 0) जोड़ा गया है।
  • from_unix_secs को उसके UTC दिन की शुरुआत तक फ़्लोर किया जाता है। सीमित रेंज पूरी हुई दैनिक डिस्कवरी रन को एग्रीगेट करती है; दोनों सीमाएं छोड़ने पर नवीनतम रन मिलता है।
• प्रक्रियाएं सूचीबद्ध करें (GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures) और प्रक्रिया प्राप्त करें (GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id})
  • किसी खास एजेंट वर्ज़न से प्रक्रियाएं प्राप्त करने के लिए वैकल्पिक nullable agent_version_id (string) जोड़ा गया।
• टेस्ट बनाएं और टेस्ट अपडेट करें
  • रिस्पॉन्स, सिमुलेशन और टूल-कॉल यूनिट टेस्ट स्कीमा में वैकल्पिक nullable environment (string) जोड़ा गया। यह वैल्यू एनवायरनमेंट-विशिष्ट URL, हेडर और ऑथ कनेक्शन चुनती है; इसका डिफ़ॉल्ट production है।
• URL दस्तावेज़ बनाएं, क्रॉल जॉब बनाएं और फ़ोल्डर बनाएं
  • ऑटो-सिंक के लिए वैकल्पिक nullable minimum_frequency_days (integer, 1–180) जोड़ा गया। डिफ़ॉल्ट 7 है और पैरेंट फ़ोल्डर की अधिक सख्त फ़्रीक्वेंसी को प्राथमिकता मिलती है।

संगीत

• Music Finetunes सूचीबद्ध करें - GET /v1/music/finetunes
  • अधिकतम page_size को 100 से बढ़ाकर 150 किया गया। डिफ़ॉल्ट 50 ही है।

स्कीमा बदलाव

ElevenAgents

• एजेंट अपडेट रिक्वेस्ट में वैकल्पिक nullable procedures (object<string, ProcedureVersionRef>) जोड़ा गया। हर वैल्यू में procedure_id और version_id (strings) ज़रूरी हैं। खाली ऑब्जेक्ट सभी प्रक्रियाएं हटा देता है।
• बातचीत इनिशिएशन कॉन्फ़िगरेशन में enable_procedure_ids_from_client (boolean, डिफ़ॉल्ट false) जोड़ा गया। इनिशिएशन डेटा में वैकल्पिक nullable procedure_ids (string array) जोड़ा गया है; खाली ऐरे शुरुआती एजेंट के लिए सभी प्रक्रियाएं बंद कर देता है।
• ClientEvent में context_usage जोड़ा गया।
• सॉफ़्ट-टाइमआउट ओवरराइड में वैकल्पिक nullable additional_soft_timeout_messages (string array) जोड़ा गया।
• विश्लेषण और स्कीमा ओवरराइड मॉडल में कॉन्स्टेंट वैल्यू अब null स्वीकार करती हैं।
• mic_muting_enabled और transcript_enabled के विजेट कॉन्फ़िगरेशन डिफ़ॉल्ट false से बदलकर true कर दिए गए हैं। पिछले व्यवहार को बनाए रखने के लिए इन्हें साफ़ तौर पर false पर सेट करें।

वर्कस्पेस

• यूज़र प्राप्त करें रिस्पॉन्स से UserResponseModel का xi_api_key हटा दिया गया।
• ResourceMetadataResponseModel.role_to_group_ids अब कुंजियों को admin, editor, commenter और viewer तक सीमित रखने के बजाय कस्टम रोल ID स्वीकार करता है।
• डायरेक्ट पब्लिशिंग रिस्पॉन्स में वैकल्पिक nullable restricted_to_user_email_domains (string array) जोड़ा गया।
• पेंडिंग सब्सक्रिप्शन स्विच रिस्पॉन्स में next_tier में go जोड़ा गया।