AgentSession Not Found

agentsession-not-found · 404

لم تعثر الـ API على جلسة agent بهذا المعرف في الـ workspace الذي أرسل منه النداء.

كل الصفحات

معرف الجلسة هو قيمة X-Ghaym-Session التي اختارها الـ agent، والـ resourceId يحمله. والجلسة الموجودة في workspace آخر تعيد الـ 404 نفسه.

إضافة إلى الحقول التي في كل خطأ، يضيف هذا النوع resourceType و resourceId.

الأسباب الشائعة

  • لم يرسل أي نداء كتابة ولا نداء محجوز بهذا المعرف في X-Ghaym-Session: القراءة لا تفتح جلسة.
  • الجلسة في workspace غير الذي أرسل منه النداء: يعمل النداء في الـ workspace الذي يسميه الـ header X-Ghaym-Workspace، أو ?workspace=<id> في البث حين يغيب الـ header.
  • في المعرف خطأ كتابي.

كيف تصلح الطلب

  • اقرأ resourceId وقارنه بالقيمة التي قصدت إرسالها.
  • اعرض الجلسات بـ ghaym cloud sessions list وخذ المعرف من جوابها.
  • أرسل X-Ghaym-Workspace باسم الـ workspace الذي عمل فيه الـ agent.
  • لا تعد المحاولة دون تغيير: النداء نفسه يعيد الـ 404 نفسه ما دام لم يتغير شيء.

مثال على الرد

json
{
  "type": "agentsession-not-found",
  "title": "AgentSession Not Found",
  "detail": "AgentSession with ID '0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401' was not found",
  "resourceType": "AgentSession",
  "resourceId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401",
  "requestId": "req-1785231000000-4f7b2c9ae",
  "timestamp": "2026-07-28T09:30:00.000Z",
  "path": "/v1/agent-sessions/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401",
  "method": "GET",
  "instance": "GET /v1/agent-sessions/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401",
  "status": 404,
  "docs": "https://ghaym.me/docs/errors/agentsession-not-found"
}