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

बातचीतों की सूची दें

यूज़र के स्वामित्व वाले एजेंट की सभी बातचीत प्राप्त करें। किसी विशिष्ट एजेंट तक सीमित करने का विकल्प उपलब्ध है।

हेडर

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

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

cursorstringवैकल्पिक

अगला पेज फ़ेच करने के लिए इस्तेमाल होता है। रिस्पॉन्स में cursor लौटाया जाता है।

agent_idstringवैकल्पिक

एजेंट id (agent_…) या स्पीच इंजन बाहरी id (seng_), जो उसी अंतर्निहित रिसोर्स पर रिज़ॉल्व होती है।

visited_agent_idsstringवैकल्पिक

उन बातचीत को फ़िल्टर करें जिनमें इनमें से कोई एजेंट शामिल था। 50 से ज़्यादा वैल्यू नहीं हो सकतीं।

visited_agent_branch_idsstringवैकल्पिक

उन बातचीत को फ़िल्टर करें जिनमें इनमें से कोई एजेंट ब्रांच शामिल थी। 50 से ज़्यादा वैल्यू नहीं हो सकतीं।

triggered_procedure_idsstringवैकल्पिक

उन बातचीत को फ़िल्टर करें जिनमें इनमें से कोई प्रोसीजर ट्रिगर हुआ। 50 से ज़्यादा वैल्यू नहीं हो सकतीं।

call_successfulenumवैकल्पिक

सफलता मूल्यांकन का नतीजा

अनुमत मान:
call_start_before_unixintegerवैकल्पिक

इस आरंभ तिथि तक की बातचीत फ़िल्टर करने के लिए Unix टाइमस्टैम्प (सेकंड में)।

call_start_after_unixintegerवैकल्पिक

इस आरंभ तिथि के बाद की बातचीत फ़िल्टर करने के लिए Unix टाइमस्टैम्प (सेकंड में)।

call_duration_min_secsintegerवैकल्पिक

कॉल की न्यूनतम अवधि, सेकंड में।

call_duration_max_secsintegerवैकल्पिक

कॉल की अधिकतम अवधि, सेकंड में।

rating_maxintegerवैकल्पिक1-5

अधिकतम कुल रेटिंग (1-5)।

rating_minintegerवैकल्पिक1-5

न्यूनतम कुल रेटिंग (1-5)।

has_feedback_commentbooleanवैकल्पिक

यूज़र फ़ीडबैक टिप्पणियों वाली बातचीत फ़िल्टर करें।

user_idstringवैकल्पिक

उन्हें शुरू करने वाले यूज़र की ID के अनुसार बातचीत फ़िल्टर करें।

evaluation_paramsstringवैकल्पिक

evaluation फ़िल्टर। पैरामीटर दोहराएं। फ़ॉर्मैट: criteria_id:result, जहां result success|failure|unknown में से एक है। उदाहरण: eval=value_framing:success

data_collection_paramsstringवैकल्पिक

डेटा कलेक्शन फ़िल्टर। पैरामीटर दोहराया जा सकता है। फ़ॉर्मैट: id:op:value, जहाँ op इनमें से एक है: eq|neq|gt|gte|lt|lte|in। in के लिए वैल्यू को पाइप से अलग करें। खाली वैल्यू उन बातचीतों से मेल खाती है जहाँ फ़ील्ड कलेक्ट नहीं किया गया था (id:eq:), और खाली वैल्यू के साथ neq उन बातचीतों से मेल खाता है जहाँ वह कलेक्ट किया गया था (id:neq:)। eq सटीक समानता है। gt|gte|lt|lte के लिए संख्यात्मक वैल्यू चाहिए।

dynamic_variable_paramsstringवैकल्पिक

डायनामिक वेरिएबल फ़िल्टर। पैरामीटर दोहराएं। फ़ॉर्मैट: name:op:value, जहां op इनमें से एक है: eq|neq|gt|gte|lt|lte|in। in के लिए मानों को पाइप से अलग करें। खाली मान उन बातचीतों से मेल खाता है जहां वेरिएबल सेट नहीं था (name:eq:), और खाली मान के साथ neq वहां मेल खाता है जहां वह सेट था (name:neq:)। eq सटीक समानता है। gt|gte|lt|lte के लिए संख्यात्मक मान ज़रूरी है। ’:’ वाले नाम व्यक्त नहीं किए जा सकते।

data_collection_idsstringवैकल्पिक

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

evaluation_criteria_idsstringवैकल्पिक

हर बातचीत सारांश में शामिल करने के लिए evaluation criteria ID। पैरामीटर दोहराएं। छोड़ने पर evaluation_criteria_results नहीं लौटाया जाता।

tool_namesstringवैकल्पिक

कॉल के दौरान इस्तेमाल किए गए टूल नामों के अनुसार बातचीत फ़िल्टर करें।

tool_names_successfulstringवैकल्पिक

जिन टूल नामों की कॉल सफल हुई, उनके अनुसार बातचीत फ़िल्टर करें।

tool_names_erroredstringवैकल्पिक

जिन टूल नामों की कॉल में त्रुटि हुई, उनके अनुसार बातचीत फ़िल्टर करें।

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

उन टूल कॉल्स का भी मिलान करें जो कभी चले ही नहीं।

main_languagesstringवैकल्पिक

पहचानी गई मुख्य भाषा (भाषा कोड) के अनुसार बातचीत फ़िल्टर करें।

page_sizeintegerवैकल्पिक1-100डिफ़ॉल्ट: 30

ज़्यादा से ज़्यादा कितनी बातचीत लौटानी हैं। 100 से ज़्यादा नहीं हो सकतीं, डिफ़ॉल्ट 30 है।

summary_modeenumवैकल्पिकडिफ़ॉल्ट: exclude

क्या रिस्पॉन्स में ट्रांसक्रिप्ट सारांश शामिल करने हैं।

अनुमत मान:
searchstringवैकल्पिकDeprecated

ट्रांसक्रिप्ट मैसेज में फुल-टेक्स्ट या फ़ज़ी खोज

conversation_initiation_sourceenumवैकल्पिकडिफ़ॉल्ट: unknown

बातचीत शुरू होने के संभावित स्रोतों को दर्शाने वाला enum।

text_onlybooleanवैकल्पिक
conversation_product_typeenumवैकल्पिक

नतीजों को एक ही बातचीत प्रोडक्ट सरफेस तक सीमित करें।

अनुमत मान:
branch_idstringवैकल्पिक

ब्रांच ID के अनुसार बातचीत फ़िल्टर करें।

version_idstringवैकल्पिक

वर्ज़न ID के अनुसार बातचीत फ़िल्टर करें।

parent_conversation_idstringवैकल्पिक

सबएजेंट बातचीत के लिए पैरेंट conversation ID के अनुसार बातचीत फ़िल्टर करें।

topic_idsstringवैकल्पिक

टॉपिक डिस्कवरी के दौरान असाइन की गई टॉपिक ID के अनुसार बातचीत फ़िल्टर करें।

exclude_statusesenumवैकल्पिक

दिए गए स्टेटस वाली बातचीत को बाहर रखें। सूची व्यू से जारी / processing बातचीत छिपाने के लिए उपयोगी।

अनुमत मान:
tag_idsstringवैकल्पिक

conversation-tags एंडपॉइंट के ज़रिए असाइन की गई बातचीत टैग ID के अनुसार बातचीत फ़िल्टर करें।

workflow_node_entered_idstringवैकल्पिक

बातचीत को सिर्फ़ उन तक सीमित करें जो दिए गए नोड में गईं।

termination_reasonsstringवैकल्पिक

स्टोर किए गए termination_reason (metadata.termination_reason) के अनुसार बातचीत फ़िल्टर करें। कई में से किसी से मिलान के लिए पैरामीटर दोहराएं।

guardrail_typesenumवैकल्पिक

उन बातचीत तक फ़िल्टर करें जहाँ इन प्रकारों वाला कोई गार्डरेल ट्रिगर हुआ (metadata.triggered_guardrails.guardrail_type)। कई में से किसी से मिलान के लिए पैरामीटर दोहराएं।

custom_guardrail_namesstringवैकल्पिक

उन बातचीत तक फ़िल्टर करें जहाँ इन नामों वाला कोई कस्टम गार्डरेल ट्रिगर हुआ (metadata.triggered_guardrails.guardrail_name)। सिर्फ़ कस्टम गार्डरेल का नाम होता है। कई में से किसी से मिलान के लिए पैरामीटर दोहराएं।

sort_directionenumवैकल्पिक

कॉल शुरू होने के समय के अनुसार बातचीत को सॉर्ट करने की दिशा। डिफ़ॉल्ट रूप से अवरोही (सबसे नया पहले)।

अनुमत मान:

रिस्पॉन्स

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

conversationslist of objects
has_moreboolean
next_cursorstringवैकल्पिक

त्रुटियाँ

422
Conversations List Request Unprocessable Entity Error