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 белән икенче хәбәр җибәрегез:
Агент элекке алмашуны тарих буларак күрә. Алдагы җавабы әле ясалып торган тышкы кулланучы өчен хәбәр җибәрү Retry-After: 2 белән 409 conversation_busy кайтара; көтегез һәм кабатлагыз.

Киләсе адымнар

Агымлы җавап

Җавапны ясалган саен күрсәтегез.

Диалоглар

Диалоглар исемлеген алыгыз һәм хәбәрләрне битләп карагыз.

Хаталар

API кайтара алган һәр код һәм аның белән нәрсә эшләргә.

API белешмәсе

Тулы сорау һәм җавап схемалары, уен мәйданчыгы белән.