حل المشكلات
الأعطال التي يصطدم بها الناس فعلًا في جلستهم الأولى، وما يعنيه كل منها. وأغلبها نظامٌ يطبّق قاعدة لا نظامٌ يتعطّل؛ وهذه الصفحة تخبرك أي قاعدة.
get_next_task لا يعيد شيئًا، ولوحتي مليئة بالمهام
الاختيار انتقائي عن قصد. لا تُعاد المهمة إلا إذا تحقّق كل ما يلي؛ افحصها بالترتيب:
- أن تكون في «جاهز»، أو مهمة في «الانتظار» تحمل معايير قبول. يُختار «جاهز» أولًا؛ ومهام الانتظار بلا معيار واحد لا تُختار أبدًا. فاللوحة المليئة بمهام انتظار غير محددة النطاق لا تُنتج شيئًا، بالتصميم.
- ألا تكون محجوبة. المهمة ذات تبعية
blocksغير مكتملة (ولو في مشروع آخر) تُتخطّى حتى يكتمل حاجبها. - ألا تكون محجوزة أصلًا. المهمة التي يعمل عليها وكيل بنشاط تكون غير مرئية للاختيار حتى ينتهي التشغيل أو يتقادم.
- أن تكون في المشروع الذي يسأل عنه الوكيل. الاختيار محصور بالمشروع؛ انظر القسم التالي.
يبدو أن الوكيل يبحث في المشروع الخطأ
يعمل list_tasks وget_next_task على مشروع واحد في كل مرة. وحين يكون الاتصال محصورًا بمشروع واحد يكون الاختيار تلقائيًا؛ أما في مساحة عمل متعددة المشاريع فيزوّد الوكيل projectId (ويكتشف المعرّفات عبر get_workspace_context). فإن أبلغ وكيل عن لوحة فارغة وأنت تعلم أنها مليئة، فاسأله أي مشروع استعلم عنه.
مهمة عالقة «قيد التنفيذ» تحت وكيل ميت
الحجز مؤقّت لا قفل دائم. وتقارير التقدّم هي نبض القلب؛ فحين يصمت وكيل (جلسة انهارت، حاسوب أُغلق) يتقادم الحجز وتعود المهمة إلى اللوحة من تلقاء نفسها. ويتناسب زمن ذلك مع تعقيد المهمة: 45 دقيقة صمت لمهمة trivial أو small، و90 لمهمة medium، و3 ساعات لمهمة large، و4 لمهمة xl. ويعمل المسح كل بضع دقائق، فيقع التعافي بعد انتهاء النافذة بلحظات. ولا حاجة إلى تحرير يدوي؛ وإن لم تستطع الانتظار فأي عضو يستطيع تغيير حالة المهمة يدويًا.
اتصل الوكيل بمساحة العمل الخطأ
يرتبط العميل الواحد بمساحة عمل واحدة في كل مرة، وآخر موافقة هي التي تفوز. أعد الاتصال واختر مساحة العمل الصحيحة في شاشة الموافقة؛ ولتشغيل عميل واحد مقابل مساحتَي عمل في آنٍ واحد، استخدم نقطة النهاية الصريحة لكل مساحة عمل الموصوفة في تسليم MCP.
OAuth يعيد الطلب باستمرار أو يفشل في الاكتمال
- أكمل عملية المتصفح بحساب Masaro نفسه المنتمي إلى مساحة العمل التي تختارها؛ فالوكلاء لا يستطيعون العمل إلا داخل مساحات أنت عضو فيها.
- إن دار العميل في حلقة، فاحذف الخادم من إعدادات العميل ثم أضفه من جديد وأعد الموافقة. الموافقة لكل عميل؛ وإعادة الإضافة رخيصة.
- ألغيت الاتصال في Masaro؟ هذا يقطع الوصول فورًا؛ وسيعيد العميل التحدّي عند الاستخدام التالي، وهو ما يبدو فشلًا لكنه مجرد إلغاء يعمل كما ينبغي.
أنشأ وكيل مهامًا لا أراها على اللوحة
إنها في الفرز. فضمن السياسة الافتراضية الخاضعة للإشراف، تنتظر المهام العليا التي ينشئها وكيل هناك قبولك أو رفضك بدل الوصول إلى اللوحة. انظر استقلالية الوكيل لمعرفة السياسة وكيفية توسيعها.
لم يصل الرابط السحري
افحص البريد المزعج أولًا؛ والروابط تنتهي صلاحيتها سريعًا، فاطلب رابطًا جديدًا بدل التنقيب عن الرسالة القديمة. وتسجيل الدخول عبر Google هو البديل بلا بريد على الشاشة نفسها.
التالي: مرجع الأدوات · المسرد