Skip to main content

Մեկ խոսակցություն՝ յուրաքանչյուր արտաքին օգտատիրոջ համար

Խոսակցությունը նույնականացվում է երկու բանով՝ API բանալիով և ձեր ուղարկած external_user_id-ով: Դուք երբեք խոսակցություն բացահայտորեն չեք ստեղծում; նոր external_user_id-ի առաջին չատ-հարցումն այն ստեղծում է, և նույն արտաքին օգտատիրոջ յուրաքանչյուր հետագա հաղորդագրություն նույն բանալիով շարունակում է այն: Հետևանքները, որոնք արժե իմանալ.
  • Մեկուսացում ըստ բանալու: Նույն external_user_id-ը, որին դիմում են երկու տարբեր բանալիներով, երկու տարբեր խոսակցություն է, նույնիսկ եթե երկու բանալիներն էլ պատկանում են նույն գործակալին: Բանալին երբեք չի տեսնում մեկ այլ բանալու կամ մեկ այլ ալիքի (Telegram, վիջեթ և այլն) երկխոսությունները:
  • Թարմացումը պահպանում է պատմությունը: Բանալու թարմացումը փոխում է նրա գաղտնիքը, ոչ թե նույնացուցիչը, ուստի նրա խոսակցությունները մնում են կցված:
  • external_user_id-ը ձերն է: Օգտագործեք ձեր սեփական համակարգի կայուն նույնացուցիչ, 1-255 նիշ: Մի՛ դրեք դրա մեջ անձնական տվյալներ, որոնք չէիք ցանկանա պահել երկխոսության կողքին:
  • Մեկ պատասխան միաժամանակ: Եթե արտաքին օգտատիրոջ հաղորդագրությունը գալիս է, երբ նախորդ պատասխանը դեռ ստեղծվում է, API-ն պատասխանում է 409 conversation_busy՝ Retry-After: 2-ով: Սպասեք և կրկին ուղարկեք:

Խոսակցությունների ցանկ

GET /v1/agents/{agent_id}/conversations-ը վերադարձնում է բանալու խոսակցությունները՝ վերջին թարմացվածներն առաջինը: Այն կարող են կանչել և՛ read-only, և՛ full բանալիները:
last_message_preview-ը օգտատիրոջ կամ օգնականի վերջին տեքստն է՝ կրճատված մինչև 160 նիշ, կամ null՝ դատարկ խոսակցության դեպքում:

Կարդալ հաղորդագրությունները

GET /v1/agents/{agent_id}/conversations/{conversation_id}/messages-ը վերադարձնում է մեկ խոսակցության հաղորդագրությունները՝ նորագույններն առաջինը: Վերադարձվում են միայն user և assistant հաղորդագրությունները; գործիքների փոխանակումները, գործիքների գործունեության տողերը և համակարգային հրահանգը երբեք չեն բացահայտվում: Յուրաքանչյուր հաղորդագրություն ունի id, role (user կամ assistant), type (text, image, file, …), content (տեքստ; ոչ տեքստային բովանդակությունը ներկայացվում է իր տեքստով կամ անվանումով) և created_at: Խոսակցության նույնացուցիչը, որը պատկանում է մեկ այլ բանալու կամ ալիքի կամ գոյություն չունի, 404 conversation_not_found է: API-ն այդ երկու դեպքերը չի տարբերում:

Էջավորում

Յուրաքանչյուր ցանկ {"data": [...], "next_cursor": "..." | null} է: Հաջորդ էջը ստանալու համար next_cursor-ը հետ փոխանցեք որպես cursor և կանգ առեք, երբ այն null է: Կուրսորներն անթափանց են; սխալ ձևավորվածը 422 validation_error է:

Ամսաթվեր

Ամսաթվերը ISO-8601 են: Ժամային գոտիով արժեքները փոխակերպվում են UTC-ի, առանց գոտու արժեքները կարդացվում են որպես UTC, իսկ date_to-ն բացառող է: date_from-ից ավելի վաղ date_to422 validation_error է: