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

مخططات الطلب والرد الكاملة، مع ساحة تجربة.