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
مخططات الطلب والرد الكاملة، مع ساحة تجربة.