eWوثائق eWasl

جلسات المساعد (Copilot)

اعرض جلسات المساعد وافحص نصّ الجلسة وخطتها الحيّة.

تُجمَّع محادثات المساعد في جلسات. كل استدعاء ask_copilot ينتمي إلى جلسة (جديدة أو متابَعة عبر sessionId) ويراكم نصّ الرسائل بالإضافة إلى خطة مهام حيّة. تتيح لك نقاط القراءة هذه عرضها وفحصها. وكلها محكومة لمالك مفتاح API.

عرض الجلسات

GET/api/v1/copilot/sessions
copilot
limitintegerOptional
Default: 20

أقصى عدد جلسات تُعاد (1–50)، الأحدث أولاً.

Response Example

{
  "data": [
    {
      "id": "9c3f0a1e-7b2d-4e54-9c2a-1f3b6d8e0a44",
      "title": null,
      "status": "active",
      "estimatedCostUsd": 0.0142,
      "createdAt": "2026-05-28T19:30:00.000Z",
      "updatedAt": "2026-05-28T19:42:11.000Z"
    }
  ]
}

جلب جلسة

GET/api/v1/copilot/sessions/{id}
copilot

يعيد بيانات الجلسة، ونصّ رسائلها، والخطة الحالية. يعيد 404 إن لم توجد الجلسة أو كانت تخصّ مستخدماً آخر.

data.sessionobject

بيانات الجلسة (id، title، status، estimatedCostUsd، الطوابع الزمنية).

data.messagesarray

النصّ، الأقدم أولاً — لكل عنصر role و content و createdAt.

data.todosarray

الخطة الحيّة — position، text، status.

جلب الخطة الحيّة

GET/api/v1/copilot/sessions/{id}/todos
copilot

عرض مركّز لعناصر المهام/الخطة المرتّبة لجلسة فقط — مفيد لاستطلاع الخطة أثناء تقدّمها. يعيد 404 إن لم تكن الجلسة مملوكة للمفتاح.

Response Example

{
  "data": [
    { "position": 0, "text": "تحليل أداء آخر 7 أيام", "status": "done", "updatedAt": "2026-05-28T19:41:02.000Z" },
    { "position": 1, "text": "اقتراح إعادة توزيع الميزانية", "status": "in_progress", "updatedAt": "2026-05-28T19:41:55.000Z" }
  ]
}

في هذه الصفحة