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 տեղեկատու

Հարցման և պատասխանի ամբողջական սխեմաներ՝ խաղահրապարակով: