ElevenAgentsConversations

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

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

Headers

xi-api-keystringOptional

Query parameters

cursorstring or nullOptional

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

agent_idstring or nullOptional

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

visited_agent_idslist of strings or nullOptional

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

visited_agent_branch_idslist of strings or nullOptional

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

triggered_procedure_idslist of strings or nullOptional

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

call_successfulenum or nullOptional

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

Allowed values:
call_start_before_unixinteger or nullOptional

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

call_start_after_unixinteger or nullOptional

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

call_duration_min_secsinteger or nullOptional

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

call_duration_max_secsinteger or nullOptional

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

rating_maxinteger or nullOptional1-5

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

rating_mininteger or nullOptional1-5

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

has_feedback_commentboolean or nullOptional

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

user_idstring or nullOptional

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

evaluation_paramslist of strings or nullOptional

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

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

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

tool_nameslist of strings or nullOptional

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

tool_names_successfullist of strings or nullOptional

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

tool_names_erroredlist of strings or nullOptional

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

include_invalid_tool_callsbooleanOptionalDefaults to false

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

main_languageslist of strings or nullOptional

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

page_sizeintegerOptional1-100Defaults to 30

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

summary_modeenumOptionalDefaults to exclude

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

Allowed values:
searchstring or nullOptionalDeprecated

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

conversation_initiation_sourceenum or nullOptionalDefaults to unknown

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

text_onlyboolean or nullOptional
conversation_product_typeenum or nullOptional

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

Allowed values:
branch_idstring or nullOptional

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

version_idstring or nullOptional

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

parent_conversation_idstring or nullOptional

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

topic_idslist of strings or nullOptional

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

exclude_statuseslist of enums or nullOptional

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

Allowed values:
tag_idslist of strings or nullOptional

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

workflow_node_entered_idstring or nullOptional

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

termination_reasonslist of strings or nullOptional

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

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

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

Allowed values:

Response

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

conversationslist of objects
has_moreboolean
next_cursorstring or nullOptional

Errors

422
Unprocessable Entity Error