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

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

Path parameters

conversation_idstringRequired

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

Headers

xi-api-keystringOptional

Query parameters

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

Response

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

conversation_idstring
agent_idstring
statusenum
Allowed values:
message_countinteger
बातचीत में साधारण chat message turns की संख्या।
notestring
एजेंट को पूरा ट्रांसक्रिप्ट पाने का तरीका बताने वाला मार्गदर्शन।
call_summary_titlestring or nullOptional
conversation के लिए छोटा generated title।
transcript_summarystring or nullOptional
कॉल का जनरेट किया गया सामान्य भाषा में सारांश।
call_successfulenum or nullOptional
Allowed values:
messageslist of objects or nullOptional
सादे चैट मैसेजेस (केवल role और text)। केवल तब शामिल होते हैं जब message_count, अनुरोधित max_messages से अधिक न हो; अन्यथा null होता है और messages_omitted true होता है।
messages_omittedbooleanOptionalDefaults to false
बातचीत बहुत लंबी होने की वजह से चैट संदेश छोड़े जाने पर true। संदेशों के लिए पूरा ट्रांसक्रिप्ट फ़ेच करें।

Errors

422
Unprocessable Entity Error