Skip to main content
Ба шумо идентификатори агент ва калид бо иҷозати full лозим аст (ниг. Калиди API-ро гиред). Ҳамаи мисолҳо онҳоро аз се тағйирёбандаи муҳит мехонанд:

Фиристодани паём

POST /v1/agents/{agent_id}/chat як паёми корбарро мефиристад ва ҷавобро интизор мешавад. Ғайр аз Content-Type ду сарлавҳа муҳим аст:
  • Authorization: Bearer <key>
  • Idempotency-Key: ҳар қимати беназир аз 1-255 аломат барои ҳар дархости мантиқӣ. UUID интихоби хуб аст. Он дар ҳарду эндпоинти чат ҳатмӣ аст; ниг. Идемпотентӣ.

Хондани ҷавоб

  • request_id инчунин ҳамчун сарлавҳаи X-Request-ID бармегардад.
  • conversation_id муколамаест, ки мубодила дар он нигоҳ дошта шудааст. Паёми дигарро бо ҳамон external_user_id фиристед ва он дар ҳамон ҷо идома меёбад.
  • usage.charged_usd сатри даҳӣ бо 8 рақам пас аз вергул аст: ин дархост ба баланси соҳиб чӣ қадар арзид.
Вақте ки агент абзорҳо ё пойгоҳи дониши калонро истифода мебарад, ҷавоб метавонад вақти зиёд гирад. Ба дархост мӯҳлати саховатманд диҳед (мисолҳо 120 сонияро истифода мебаранд) ё эндпоинти ҷараёнӣ-ро истифода баред, то матнро ҳангоми тавлид нишон диҳед.

Идомаи муколама

Паёми дуюмро бо ҳамон external_user_id ва Idempotency-Keyнав фиристед:
Агент мубодилаи пешинаро ҳамчун таърих мебинад. Фиристодани паём барои корбари берунае, ки ҷавоби пешинаи ӯ ҳанӯз тавлид мешавад, 409 conversation_busy бо Retry-After: 2 бармегардонад; интизор шавед ва такрор кунед.

Қадамҳои навбатӣ

Ҷавоби ҷараёнӣ

Ҷавобро ҳангоми тавлид нишон диҳед.

Муколамаҳо

Муколамаҳоро рӯйхат кунед ва паёмҳоро саҳифа ба саҳифа хонед.

Хатоҳо

Ҳар коде, ки API бармегардонад, ва бо он чӣ бояд кард.

Маълумотномаи API

Схемаҳои пурраи дархост ва ҷавоб, бо майдони озмоиш.