Click: تشغيل وكلاء الذكاء الاصطناعي داخل تطبيقك عبر API

ما فائدة Click؟ شرح مبسّط

Click خدمة API مُدارة للمطورين الذين يريدون تشغيل وكلاء الذكاء الاصطناعي داخل تطبيقاتهم. توفّر مفتاح النموذج والتعليمات والأدوات المسموح بها، ويتولى Click استدعاءات النموذج والأدوات وحفظ سجل المحادثة واستعادة التنفيذ. يستقبل تطبيقك النتائج عبر API أو تدفق الأحداث أو webhooks.

مثلًا، يمكن إضافة مساعد يقرأ ملف CSV للمبيعات ويُعد تقريرًا. تطبيقك يتحكم في الواجهة والمستخدمين والوصول إلى البيانات والموافقات، بينما يوفّر Click تنفيذ الوكيل. تدير الخدمة شركة Click AI Labs, Inc. وهي مناسبة للمهام متعددة الخطوات والعمل الطويل في الخلفية. تحتاج إلى تكامل في الخادم وفحص النتائج قبل اعتمادها.

من مفتاح API إلى أول نتيجة

1. جهّز مفتاح منصة Click ومفتاح مزوّد نموذج مدعوم. تتطلب الوثائق التحقق من بطاقة قبل إنشاء الموارد أو تعديلها، مع احتمال إعفاء حسابات قائمة. التحقق لا يفرض رسومًا ولا يبدأ اشتراكًا مدفوعًا.
2. احفظ مفتاح النموذج عبر POST /credentials واحتفظ بمعرّف بيانات الاعتماد. يجب إبقاء المفتاحين في الخادم الخلفي.
3. استخدم GET /models لاختيار نموذج يتوافق مع مزوّد المفتاح.
4. أنشئ الوكيل عبر POST /agents مع النموذج والتعليمات وصلاحيات الأدوات. احفظ latest_version.id ثم أنشئ جلسة عبر POST /sessions.
5. أرسل المهمة إلى POST /sessions/{session_id}/submissions. استخدام request_id يعيد الإرسال الأصلي عند تكرار الطلب.
6. انتظر حالة done أو cancelled أو failed. عند النجاح اقرأ سجل الإجابة المشار إليه، وفي الحالات الأخرى افحص السبب.

استجابة HTTP 202 تعني حفظ المدخل فقط، وليست دليلًا على اكتمال المهمة. اربط معرّف الجلسة بالمستند أو التذكرة في نظامك لمتابعة المحادثة بسجلها، وتحقق من صلاحية المستخدم قبل إرجاع البيانات.

ربط الأدوات والتعامل مع الملفات

يدعم Click خوادم MCP باستخدام Streamable HTTP ونقاط HTTP مخصصة عبر HTTPS متاح علنًا. بعد إنشاء الاتصال، امنح الوكيل الأدوات المطلوبة صراحةً. تصف أدوات HTTP المعاملات باستخدام JSON Schema وتتلقى طلب JSON POST، بمهلة موثقة قدرها 120 ثانية.

يمكن لنقطة قراءة التذاكر التحقق من رمز قصير العمر مقيّد بعميل معين. تظل مصادقة المستخدمين والميزانيات والموافقات وقواعد العمل مسؤولية تطبيقك.

تشمل الإمكانات المدمجة البحث على الويب وأتمتة المتصفح وعمليات الملفات والأوامر داخل sandbox. تشرح الوثائق أيضًا خيارات Blaxel وDaytona واستخدام بيانات اعتماد Browserbase الخاصة بك. راجع شروط كل مزوّد وتكاليفه بشكل مستقل.

لمهام الملفات استخدم sandbox مُدارًا من Click: ارفع المدخل عبر POST /files، وأدرج معرّفه في المهمة، ثم اطلب من الوكيل نشر الناتج بواسطة publish_file. بعد ذلك استعلم عن artifacts ونزّل الملف عبر GET /files/{file_id}. ملف العمل داخل sandbox ليس وحده ناتجًا دائمًا؛ تحقق من نشره ومن محتواه.

متابعة المهام الطويلة في الخلفية

يعيد GET /sessions/{session_id}/events لقطة كاملة للحالة أولًا، ثم تحديثات النص والأدوات وحالة المهمة. عند إعادة الاتصال استبدل الحالة المحلية باللقطة الجديدة. انقطاع التدفق لا يوقف العمل؛ ويُغلق التدفق عندما تدخل الجلسة وضع standby.

يمكن تسجيل webhooks موقّعة لأحداث submission.updated وartifact.created. بعد الإشعار اقرأ المورد المرتبط للحصول على حالته الحالية قبل عرض الناتج أو تحديث بيانات المنتج.

الخطة المجانية وتكلفة Pro والنماذج

هذه أسعار شهرية عامة بالدولار الأمريكي، جرى التحقق منها في 3 نوفمبر 2026 على صفحة الأسعار الرسمية. ليست أسعارًا نهائية بالريال السعودي أو ضمانًا لوسائل الدفع المحلية والضرائب.

• Free: صفر دولار شهريًا. جلستان مقيمتان متزامنتان، و100 MB للملفات، وساعة sandbox مُدار وساعة متصفح مُدار و100 عملية بحث كل شهر.
• Pro: ‏199 دولارًا شهريًا. 50 جلسة مقيمة متزامنة و10 GB، و100 ساعة sandbox و100 ساعة متصفح و5000 عملية بحث شهريًا.
• Enterprise: سعر وسعة حسب الاتفاق.

BYOK يعني استخدام مفاتيحك الخاصة؛ لذلك احسب تكلفة مزوّد النموذج بشكل منفصل. الخدمات الخارجية التي توصلها قد تفرض رسومًا أخرى. التخزين سعة حالية وليس رصيدًا جديدًا كل شهر. حصص الخدمات المُدارة مشتركة داخل المستأجر؛ Free يتجدد حسب الشهر الميلادي بتوقيت UTC وPro حسب فترة الاشتراك المدفوعة.

تُحتسب الجلسات النشطة والخاملة ذات بيئة التشغيل ضمن التزامن، ولا يُحتسب standby. نفاد الحصة قد يمنع الأدوات ويوقف المهام. توضح الوثائق عدم وجود رسوم تجاوز تلقائية.

أين تذهب البيانات ومن يتحكم بالصلاحيات؟

تشمل سياسة الخصوصية التعليمات والرسائل والملفات وطلبات الأدوات ونتائجها وبيانات الاعتماد. قد تُرسل البيانات إلى مزوّدي النماذج والأدوات لتنفيذ العمل، وقد تنطبق سياساتهم كذلك.

قد يصل فريق Click إلى المحتوى للمساعدة في البدء والدعم وتشخيص المشكلات وتحسين الخدمة. ترتبط مدة الاحتفاظ بالحاجة المعقولة ولا توجد مدة موحدة ثابتة معلنة. قد تتم المعالجة في الولايات المتحدة ودول أخرى. لا يعني ذلك استضافة سعودية أو عدم احتفاظ بالبيانات أو ضمانًا عامًا لعدم استخدامها في التدريب.

ضع الأسرار في إعدادات بيانات الاعتماد المخصصة، لا في الرسائل أو الملفات. وتطلب السياسة عدم إرسال معلومات شديدة الحساسية خاضعة للتنظيم.

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

هل يمكن استخدام Click مجانًا؟

نعم ضمن حدود Free. قد توجد رسوم منفصلة لدى مزوّد النموذج، ويتطلب إنشاء الموارد عادةً التحقق من البطاقة.

هل أحتاج إلى مفتاح API خاص بالنموذج؟

نعم. المسار الرسمي يحفظ مفتاح المزوّد ويختار نموذجًا متوافقًا من GET /models. مفتاح Click ومفتاح النموذج لهما وظيفتان مختلفتان ويجب حفظهما في الخادم.

هل يمكن ربط أدواتي وواجهاتي الحالية؟

نعم عبر MCP أو أدوات HTTPS بصلاحيات صريحة. يبقى التحقق من وصول العميل والموافقة على الإجراءات المهمة ضمن تطبيقك.

موارد رسمية للمطورين

• مرجع API: الأدوات والأحداث وwebhooks والملفات.
• البدء السريع: إعداد أول وكيل وجلسة ومهمة.
• شروط الخدمة والدعم: شروط الخدمة المستضافة وطريقة الدعم الرسمية.