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 տասնորդական նիշով տող է. այն, ինչ այս հարցումն արժեցել է սեփականատիրոջ հաշվեկշռին:
Շարունակել խոսակցությունը
Ուղարկեք երկրորդ հաղորդագրություն նույնexternal_user_id-ով և նոր Idempotency-Key-ով.
409 conversation_busy՝ Retry-After: 2-ով; սպասեք և կրկնեք:
Հաջորդ քայլեր
Հոսքային պատասխան
Ցուցադրեք պատասխանն այն պահին, երբ այն ստեղծվում է:
Խոսակցություններ
Ստացեք խոսակցությունների ցանկը և էջ առ էջ կարդացեք հաղորդագրությունները:
Սխալներ
Յուրաքանչյուր կոդ, որ API-ն կարող է վերադարձնել, և ինչ անել դրա հետ:
API տեղեկատու
Հարցման և պատասխանի ամբողջական սխեմաներ՝ խաղահրապարակով: