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 агымлата, дельталар кабат уйнатылмый. Агымлы җавап битен карагыз.