ملخص سريع: تعمل وكلاء Pokee AI عبر واجهة Pokee Enterprise API؛ حيث يحصل كل مستأجر على بيئة معزولة (sandbox) خاصة ومستمرة يمكن للوكيل فيها العمل على جولة واحدة لما يصل إلى 90 دقيقة، مع وصول محدد النطاق للملفات، ومهارات مرفوعة، وملفات شخصية داخل .pokee/، وذاكرة تمتد عبر مختلف الجلسات. تتولى واجهة برمجة التطبيقات تشغيل الوكيل، بينما يظل فريقك بحاجة إلى منصة لتعيين هذا العمل، ومتابعته، ومراجعة مخرجاته قبل اعتمادها وإطلاقها.
صُممت Pokee للمهام التي تعجز نوافذ المحادثة التقليدية عن استيعابها: مثل إعداد تقرير سوقي من عشر صفحات، أو إجراء أبحاث تستغرق قرابة الساعة. ونظرًا لعدم وجود من يراقب جولة عمل تستمر 90 دقيقة بشكل متواصل، فلا بد أن يتولى شخص ما مسؤوليتها، وتدقيقها، وإقرار اكتمالها. وإذا كنت تدير بالفعل وكلاء برمجة عبر لوحة مهام موحدة، فإن Sharkly هي المكان الأمثل لاحتضان هذا العمل؛ وسنوضح ذلك بالتفصيل أدناه.
ما هي Pokee AI؟
تُعد Pokee منصة للوكلاء الأذكياء تقدم عبر Enterprise API «واجهة REST API لتشغيل مسارات عمل طويلة يقودها الوكلاء داخل بيئة معزولة ومخصصة ومستمرة». يحصل كل مستأجر على مساحة عمل خاصة، ورمز مصادقة (bearer token)، ونقاط نهاية (endpoints) للجلسات والملفات والمهارات والرسائل المتدفقة عبر عنوان مثل https://your-tenant.enterprise.pokee.ai. والوصول مخصص للشركات والمؤسسات: حيث توجه وثائق Pokee العملاء الجدد إلى خيار «طلب عرض تجريبي»، ولا تتضمن باقة مجانية أو خيار خدمة ذاتية.
تُدرج صفحة النماذج والأسعار مستويين من النماذج:
| النموذج | المدخلات (دولار/مليون توكن) | المخرجات (دولار/مليون توكن) | قراءة التخزين المؤقت (دولار/مليون توكن) |
|---|---|---|---|
pokee-isaac-high-reasoning |
$3 | $15 | $0.30 |
pokee-isaac |
$0.30 | $5 | $0.10 |
يتم تعيين مستوى التفكير المتقدم افتراضيًا للمستأجرين الجدد. ويتم تثبيت النموذج عند إنشاء الجلسة، وبذلك تعمل كل جولة داخل تلك الجلسة على المستوى نفسه.
نموذج وكيل Pokee: الجلسات، والبيئة المعزولة، والملفات، والمهارات، والذاكرة
يتألف نموذج وكيل Pokee من خمسة عناصر قابلة للإعداد، ويرتبط كل منها بقرار تنظيمي داخل الفريق.
- الجلسات: الجلسة هي عملية وكيل واحدة تعمل داخل بيئتها المعزولة الخاصة ضمن وحدة التشغيل (pod) المخصصة لك، ولها سجلها ونطاق ملفاتها وحالة انشغالها الخاصة.
- الوضع المستمر: تُحذف الجلسة الافتراضية تلقائيًا بعد 5 دقائق من آخر استجابة لها. وعند تفعيل
persistent: true، تظل نشطة حتى انتهاء مدة الصلاحية TTL (4 ساعات افتراضيًا) أو حتى تقوم بحذفها. - الوصول محدد النطاق للملفات: تُمرر مسارات القراءة (
read) والكتابة (write) عند إنشاء الجلسة. وتكون المسارات الخارجة عن هذا النطاق غير موجودة نهائيًا داخل نظام ملفات الوكيل. - المهارات: ترفع ملف zip يحتوي على
SKILL.mdفي مجلده الرئيسي، لتتاح المهارة لكل جلسة جديدة لدى المستأجر. - ملفات الشخصية والذاكرة: تُضاف ملفات Markdown الموجودة في
.pokee/إلى بداية التوجيه الأساسي للنظام، بينما ينقل ملف.memory/MEMORY.mdالحقائق والمعلومات عبر الجلسات المختلفة.
كيف تحدد Pokee نطاق الوصول إلى الملفات؟
يُطبق نطاق الوصول عبر مستويين. داخل الوكيل، تعمل مساحة أسماء التحميل (mount namespace) الخاصة بأداة bubblewrap على مستوى كل جلسة لحجب كل ما يقع خارج المسارات المصرح بها، بحيث يُرجع طلب القراءة الخطأ ENOENT. أما عبر واجهة برمجة تطبيقات الملفات عبر HTTP، فيُرجع الطلب نفسه الرمز 403 Forbidden.
يوضح دليل الوصول محدد النطاق للملفات جلسة يمكنها قراءة مجلد عميل واحد ومجلد قوالب مشتركة، والكتابة فقط في مجلد المخرجات الخاص بذلك العميل:
curl -X POST "$POKEE_API/v1/sessions" \
-H "Authorization: Bearer $POKEE_KEY" \
-H "Content-Type: application/json" \
-d '{
"persistent": true,
"ttl": 14400,
"metadata": {"board_task": "COIN-412", "client": "acme-corp"},
"file_access": {
"read": ["projects/acme-corp", "shared/templates"],
"write": ["projects/acme-corp/output"]
}
}'
نطاق الوصول ثابت لا يتغير طوال فترة حياة الجلسة. ولتوسيعه، يلزم إنهاء الجلسة وإنشاء جلسة جديدة؛ مما يعزز الامتثال الأمني ويفرض قرارًا واضحًا على الفريق: تحديد النطاق بدقة عند إسناد المهمة، وليس في منتصف تنفيذها.
ما وظيفة ملفات الشخصية .pokee/ والذاكرة؟
تُحمّل الملفات في workspace/.pokee/*.md هجائيًا داخل التوجيه الأساسي للنظام، تحت عنوان رئيسي ## <filename> لكل منها. ويستخدم دليل إعداد الشخصية الملف 00_soul.md لأسلوب الخطاب، و10_glossary.md للمصطلحات التخصصية، و20_style_guide.md لقواعد التنسيق، بحد أقصى قدره 1 ميجابايت للدليل بأكمله.
تسري التعديلات بدءًا من الجلسة التالية؛ بينما تحتفظ أي جلسة جارية بتوجيهها الحالي دون تغيير. كما يقرأ الوكيل ملف .memory/MEMORY.md ويحدثه في كل جلسة، ويمكنك تعديله عبر واجهة برمجة تطبيقات الملفات أو، وفقًا لما هو موضح في صفحة سياق الوكيل، طلب تعطيله من Pokee.
ماذا يعني استخدام وكلاء الذكاء الاصطناعي للمهام طويلة الأمد لفرق العمل؟
يغير وكلاء الذكاء الاصطناعي أصحاب فترات التشغيل الطويلة ثلاثة جوانب أساسية في روتين الفريق: من يطلق العمل، وكيف تتحقق من تقدمه، ومن يعتمده نهائيًا. وتحدد الحدود الافتراضية في Pokee هذه الأبعاد بوضوح.
| الحد | القيمة الافتراضية |
|---|---|
| الجلسات المتزامنة | 10 |
| مهلة الجولة الواحدة | 90 دقيقة |
| مدة صلاحية الجلسة (TTL) | 4 ساعات |
| الجولات في الساعة / في اليوم | 300 / 5,000 |
| التوكنز في الساعة / في اليوم | 20M / 200M |
| الحد الأقصى لحجم مساحة العمل | 100 GB |
تشير Pokee إلى إمكانية رفع أي من هذه الحدود عند الطلب.
من يتولى إسناد مهمة وكيل تستغرق 90 دقيقة؟
قد يبدو توفر عشر جلسات متزامنة متسعًا كافيًا، إلى أن يبدأ خمسة أشخاص مهمتي إعداد تقارير لكل منهم صباح يوم الاثنين. كما أن الجلسة المنشغلة ترفض استقبال رسالة ثانية وتعيد الخطأ 409. لذلك، لا بد أن يحدد شخص ما المهمة، ومستوى النموذج، ونطاق الملفات، والجلسة، وتدوين ذلك ضمن مهمة محددة بمسؤول واضح، لتجنب تشغيل شخصين لمهمة المعالجة نفسها التي تستغرق 90 دقيقة.
كيف تتابع مجريات جولة عمل طويلة للوكيل؟
يواصل الوكيل عمله حتى بعد انقطاع اتصال تطبيقك. يعتمد دليل المهام طويلة الأمد على استطلاع GET /v1/sessions/{id} كل 15 ثانية للتحقق من حالة busy، وقراءة أي مؤشرات تقدم يسجلها مسار العمل داخل metadata، ثم تنزيل ملف المخرجات.
while True:
s = c.get(f"/v1/sessions/{sid}").json()
if not s["busy"]:
break
print(f"metadata: {s['metadata']}")
time.sleep(15)
يستخدم تدفق البيانات تقنية Server-Sent Events، عبر أحداث message.created وmessage.completed وmessage.error وmessage.cancelled. وتتيح نقطة نهاية الاستئناف استعادة الاتصال بالتدفق المنقطع استنادًا إلى Last-Event-ID دون إعادة احتساب تكلفة التوكنز. يخبر ذلك برنامجك النصي بانتهاء الجولة، لكنه لا يفيدك بمدى جودة التقرير المنجز.
من يراجع المخرجات قبل اعتمادها؟
تكتب Pokee ملفًا داخل مساحة العمل، بينما تظل المراجعة خطوة بشرية خارج نطاق واجهة برمجة التطبيقات: يقوم أحدهم بفتح report.md، ومطابقته مع متطلبات المهمة، ثم اعتماده أو إعادته للتعديل. وعند تشغيل مهام وكلاء متعددة بالتوازي، تمثل هذه الخطوة غالبًا عنق الزجاجة، وهو المحور الرئيسي في مقال المراجعة البشرية هي عنق الزجاجة.

مثال عملي: إعداد تقرير لعميل من التكليف حتى المراجعة
يتشارك ثلاثة زملاء حساب مستأجر واحد في Pokee، والمهمة المطلوبة هي إعداد تقرير سوقي ربع سنوي لشركة «Acme Corp».
- التعيين: تنشئ دانا مهمة: «تقرير السوق للربع الثالث لشركة Acme»، وتحدد المسؤولة: دانا، والمراجع: سام، والموعد النهائي: الخميس.
- تحديد النطاق: تحدد المهمة نموذج Pokee المستخدم (
pokee-isaac-high-reasoning)، ومسارات القراءة (projects/acme-corpوshared/templates)، ومسار الكتابة (projects/acme-corp/output). - البدء: تنشئ دانا جلسة مستمرة مع تضمين معرف المهمة في
metadata، ثم ترسل رسالة واحدة تطلب فيها إنشاء التقرير داخلoutput/report.md. - المتابعة: يُسجل معرف الجلسة في تعليق على المهمة. ويرى أي شخص يستطلع
GET /v1/sessions/{id}الحالةbusy: trueحتى تكتمل الجولة. - الاستلام: فور تحول
busyإلى false، تقوم دانا بتنزيل الملف وإرفاقه بالمهمة. - المراجعة: يدقق سام التقرير بمقارنته بالموجز المطلوب؛ وفي حال وجود ملاحظات يُعاد التقرير مع تعليق لإطلاق جولة عمل جديدة، أما إذا استوفى الشروط فتنتقل المهمة للخطوة التالية.
- التنظيف: تقوم دانا بحذف الجلسة، أو يتولى أمر ليلي مجدول تنظيفها عبر
DELETE /v1/sessions?status=idle&older_than=1h.
الخطوات 1 و4 و6 ليست استدعاءات برمجية للـ API، بل هي إجراءات تنسيقية يتغاضى عنها الفريق غالبًا عندما يكون الوكيل سريعًا، ويندم على إهمالها عندما يستغرق العمل ساعة كاملة.
أين يكمن دور Sharkly في إدارة أعمال وكلاء Pokee؟
تُعد Sharkly منصة لإدارة أعمال الوكلاء الأذكياء: لوحة تحكم واحدة تُوزع فيها المهام على البشر والوكلاء معًا، وتُتتبع عمليات التشغيل، وتُحفظ المخرجات في انتظار المراجعة البشرية. وهي لا تتولى تشغيل جلسات Pokee نيابة عنك، ولا تضم رابطًا مباشرًا معها؛ بل تدير المهمة والمسؤول عنها وحالتها وإجراءات مراجعتها المتكاملة.
عمليًا، يتم ذلك على النحو التالي:
- التعيين: توضع مهمة Pokee على اللوحة مع تحديد المسؤول وحالة التقدم، بجوار سائر مهام الفريق. راجع مقال الفرق المعتمدة على الوكلاء للتعرف على أهمية التحديد الصريح للمسؤوليات.
- وكيل يدير واجهة برمجة التطبيقات: يعمل وكيل Sharkly على جهازك مباشرة عبر بيئة تشغيل مثل Claude Code. وبمنحه مهارة تتولى تنفيذ استدعاءات curl المذكورة، يمكنه إنشاء الجلسة، واستطلاع حالتها، وإعادة معرف الجلسة والنتائج مباشرة إلى المهمة.
- حدود تشغيل تتوافق مع إعدادات Pokee: يتمتع كل وكيل بإعدادات تشغيل خاصة: الحد الأقصى للمهام المتزامنة، وأقصى مدة تشغيل لكل مهمة، ومهلة الانتظار. في النموذج الموضح أدناه، تم تحديد السقف بمهمة واحدة و40 دقيقة؛ أما لأعمال Pokee، فيُفضل الحفاظ على التزامن عند 10 جلسات أو أقل وتعيين وقت تشغيل يغطي جولة الـ 90 دقيقة بالكامل، أو تكليف الوكيل ببدء الجولة ثم العودة للتحقق لاحقًا.

- المراجعة كحالة عمل وليس مجرد رسالة: يمكن للوكيل تحويل المهمة إلى حالة «بانتظار المراجعة البشرية»، لتظهر مباشرة في صندوق وارد المراجع. يوضح مقالا وكلاء البرمجة مع الإشراف البشري وبوابات الموافقة لوكلاء البرمجة الأماكن المثلى لتطبيق هذه المحطات الرقابية.
- مشغلات خارجية: تتيح أتمتة Sharkly استخدام محفزات webhook: وهو عنوان URL سري يطلق عملية التشغيل فور استلام طلب POST من خدمة خارجية، مما يتيح لبرنامجك استدعاءه لحظة انتهاء جولة Pokee.
توفر Sharkly إمكانية البدء مجانًا، وتبقى تكاليف استخدام النماذج مقصورة على حساباتك الحالية التي تدفع لها بالفعل. وللاطلاع بتوسع على أسلوب مراجعة المهام طويلة الأمد، راجع مقال عمليات تشغيل الوكلاء التي تستهلك ملايين التوكنز تتطلب قائمة انتظار للمراجعة.
متى تكون Pokee خيارًا ملائمًا ومتى ينبغي البحث عن بديل؟
استخدم Pokee عندما تتطلب المهمة إنتاج وثيقة أو مجموعة بيانات وليس تعديلاً على الشيفرة البرمجية، وتستغرق بين عدة دقائق وساعة كاملة، وتحتاج إلى بيئة معزولة ومستمرة. وهي خيار مثالي إذا تضمنت العقود شرطًا صارمًا بأن «يُحظر على الوكيل الوصول إلى بيانات العميل (ب)»، لأن فرض النطاق يتم على مستوى نظام الملفات مباشرة. كما يوفر الوضع غير المتصل بالإنترنت بيئة مستأجر يكون مسار الاتصال الخارجي الوحيد المتاح لها هو واجهة برمجة تطبيقات النموذج.
وابحث عن بديل آخر إن كنت تفضل البدء الفوري اليوم دون خوض محادثات مبيعات. وبالنسبة للمهام البرمجية المباشرة داخل مستودعات الكود الخاصة بك، فإن Claude Code أو Codex على أجهزتك يمثلان الحل الأنسب. وستجد العديد من الفرق نفسها تجمع بين الاثنين، وهو ما يؤكد أهمية وجود لوحة موحدة لإدارتهما معًا.
الخلاصة
يوفر وكلاء Pokee AI للفرق إمكانية إنجاز المهام طويلة الأمد ضمن بيئة عزل حقيقية. تجيب واجهة برمجة التطبيقات عن سؤال «هل انتهت الجولة؟»، بينما يقع على عاتق فريقك الإجابة عمن أطلق المهمة، وما الملفات التي استخدمتها، وهل النتيجة صحيحة ومقبولة.
ثبّت هذه الإجابات الثلاث داخل بطاقة المهمة قبل انطلاق الجلسة الأولى. وإذا كنت بحاجة إلى لوحة موحدة تضم تشغيلات Pokee ووكلاء البرمجة معًا، أنشئ مساحة عمل على Sharkly وأسند أولى مهامك طويلة الأمد إلى أحد الوكلاء هذا الأسبوع.
الأسئلة الشائعة
ما هي واجهة Pokee Enterprise API؟
هي واجهة REST API لتشغيل مسارات عمل طويلة يقودها الوكلاء داخل بيئة معزولة ومخصصة ومستمرة لكل مستأجر. وتوفر نقاط نهاية لإدارة الجلسات والملفات والمهارات والرسائل المتدفقة ومعدلات الاستخدام، وتتم المصادقة عبر رمز bearer token.
ما هي أقصى مدة يمكن لوكيل Pokee العمل خلالها؟
تستمر الجولة الواحدة لما يصل إلى 90 دقيقة افتراضيًا، بينما تستمر الجلسة حتى 4 ساعات؛ ويمكن رفع كلتا المهلتين عند الطلب.
هل Pokee AI مجانية؟
لا تتضمن الوثائق أي ذكر لباقة مجانية. وتتم إتاحة الوصول عبر طلب عرض تجريبي، وتُحسب التكلفة حسب استهلاك التوكنز: 3 دولارات للمدخلات و15 دولارًا للمخرجات لكل مليون توكن في نموذج pokee-isaac-high-reasoning، و0.30 دولار و5 دولارات في نموذج pokee-isaac.
ماذا يحدث إذا راسل شخصان جلسة Pokee نفسها؟
تتلقى الرسالة الثانية رمز الخطأ 409 لأن الجلسة منشغلة برسالة سابقة. إذ تعالج كل جلسة جولة واحدة في الوقت ذاته، مما يتطلب تشغيل جلسات منفصلة للمهام المتزامنة، بما يصل إلى الحد الافتراضي البالغ 10 جلسات.
هل يستطيع وكيل Pokee تذكر المعلومات بين الجلسات المختلفة؟
نعم، فهو يقرأ ملف workspace/.memory/MEMORY.md ويحدثه في كل جلسة، ويبقى الملف سليمًا حتى بعد إعادة تشغيل وحدة التشغيل (pod).
هل يمكن لمنصة Sharkly تشغيل وكلاء Pokee بشكل مباشر؟
لا، إذ لا تملك Sharkly أداة ربط مدمجة مع Pokee. ولكن يمكن لوكيل Sharkly يعمل على جهازك استدعاء واجهة برمجة تطبيقات Pokee من خلال مهارة محددة، بينما تتولى مهمة Sharkly حفظ التكليف ومتابعة الحالة وإدارة مراجعة الفريق.



