POST /v1/agents/{agent_id}/chat և POST /v1/agents/{agent_id}/chat/stream, պահանջում են Idempotency-Key վերնագիր: Առանց դրա հարցումը 422 validation_error է:
Բանալու ընտրություն
Ցանկացած արժեք 1-255 նիշ երկարությամբ, որը եզակի է յուրաքանչյուր տրամաբանական հարցման համար: Ամենապարզ ընտրությունը UUID է, որը ստեղծվում է այն պահին, երբ որոշում եք ուղարկել հաղորդագրություն: Բանալիները սահմանափակված են ձեր API բանալու շրջանակով, ուստի այլ բանալիների հետ բախումների մասին անհանգստանալ պետք չէ:Ինչ է վերադարձնում կրկնությունը
ՆույնIdempotency-Key-ով և նույն մարմնով կրկնությունը վերադարձնում է պահված արդյունքը՝ սկզբնական request_id-ը, նույն օգնականի հաղորդագրությունը և նույն usage-ը: Երկրորդ պատասխան չի ստեղծվում, և ոչինչ կրկին չի գանձվում:
Գրառումները պահվում են 24 ժամ: Դրանից հետո նույն բանալին սկսում է նոր հարցում:
Պահված արդյունքն այն է, ինչ միջավայրն ամեն դեպքում պահպանել է. հարցման նույնացուցիչով նշված օգնականի հաղորդագրությունը և այդ նույնացուցիչի տակ վճարված LLM ծախսը: Հետևաբար, վերարտադրումը երբեք չի կանչում մոդելը և չի դիպչում հաշվեկշռին, նույնիսկ եթե առաջին փորձը կիսատ է ընդհատվել:
Բախումներ
Հոսք և անջատումներ
Հոսքային էնդփոինթի վրա կանոնները նույնն են: Եթե ձեր հաճախորդն անջատվում է հոսքի կեսին, պատասխանը շարունակում է ստեղծվել և պահվել: Նույն բանալիով կրկնությունը հոսքով ուղարկում էresponse.created, որին անմիջապես հաջորդում է response.completed՝ պահված արդյունքով, առանց դելտաները վերարտադրելու: Տե՛ս Հոսքային պատասխան: