नेविगेशन पर जाएँ

बातचीत सारांश पाएं

किसी बातचीत का संक्षिप्त सारांश प्राप्त करें: उसका शीर्षक, जनरेट किया गया ट्रांसक्रिप्ट सारांश, कॉल सफल रही या नहीं और — सिर्फ़ बातचीत छोटी होने पर — सादे चैट मैसेज। रिस्पॉन्स छोटा रखने के लिए टूल कॉल, टूल रिज़ल्ट और कॉन्टेक्स्टुअल अपडेट शामिल नहीं किए जाते। जब आपको सिर्फ़ सार चाहिए हो, तब पूरे बातचीत एंडपॉइंट के बजाय इसका इस्तेमाल करें (जैसे कई बातचीत पढ़ने वाला एजेंट); टूल कॉल और कॉन्टेक्स्टुअल अपडेट के साथ पूरा ट्रांसक्रिप्ट चाहिए हो, तो GET /v1/convai/conversations/{conversation_id} इस्तेमाल करें।

पाथ पैरामीटर

conversation_idstringआवश्यक

उस बातचीत की id जिस पर आप कार्रवाई कर रहे हैं।

हेडर

xi-api-keystringवैकल्पिक

क्वेरी पैरामीटर

max_messagesintegerवैकल्पिक1-200डिफ़ॉल्ट: 40

इनलाइन शामिल किए जाने वाले चैट संदेश टर्न की अधिकतम संख्या। बातचीत में इससे अधिक टर्न होने पर संदेश हटा दिए जाते हैं और messages_omitted सेट किया जाता है।

रिस्पॉन्स

सफल रिस्पॉन्स

conversation_idstring
agent_idstring
statusenum
अनुमत मान:
message_countinteger

बातचीत में साधारण chat message turns की संख्या।

notestring

एजेंट को पूरा ट्रांसक्रिप्ट पाने का तरीका बताने वाला मार्गदर्शन।

call_summary_titlestring or nullवैकल्पिक

conversation के लिए छोटा generated title।

transcript_summarystring or nullवैकल्पिक

कॉल का जनरेट किया गया सामान्य भाषा में सारांश।

call_successfulenum or nullवैकल्पिक
अनुमत मान:
messageslist of objects or nullवैकल्पिक

सादे चैट मैसेजेस (केवल role और text)। केवल तब शामिल होते हैं जब message_count, अनुरोधित max_messages से अधिक न हो; अन्यथा null होता है और messages_omitted true होता है।

messages_omittedbooleanवैकल्पिकडिफ़ॉल्ट: false

बातचीत बहुत लंबी होने की वजह से चैट संदेश छोड़े जाने पर true। संदेशों के लिए पूरा ट्रांसक्रिप्ट फ़ेच करें।

त्रुटियाँ

422
Unprocessable Entity Error