تخطي إلى المحتوى
Clevera Help Center

إنشاء رمز API لوكيل AI

أنشئ رمز API من خلال معالج مكون من أربع خطوات (الغرض، الأذونات، الحدود، مراجعة): الإعدادات المسبقة، الأذونات، انتهاء الصلاحية، مواقع المستندات، حدود الإنفاق، وقائمة السماح لعناوين IP. يتم عرض الرمز مرة واحدة فقط.

تم التحديث وقت القراءة 7 دقائق

يتيح رمز API لـ Claude Code أو Codex أو Cursor أو برنامجك الخاص العمل في مساحة العمل الخاصة بك بصفتك أنت، مع الوصول الذي تختاره فقط. يمكنك إنشاؤه في معالج من أربع خطوات (الغرض، الأذونات، الحدود، مراجعة)، وتعرض Clevera الرمز مرة واحدة فقط.

قبل البدء

  • تتوفر ميزة AI agents & API في خطط Pro وBusiness وCustom. في الخطط الأخرى، تظهر رسالة رمز جديد كالتالي: "الوصول إلى API والوكيل متاح في خطة Pro وما فوق."
  • يمكن لأي عضو في مساحة العمل إنشاء رموز لنفسه. لا يمكن للرمز الحصول إلا على الأذونات التي يسمح بها دورك. راجع أذونات الوكيل.
  • يمكن أن تحتوي مساحة العمل على 50 رمزاً نشطاً. عند الوصول إلى هذا الحد، يتم تعطيل رمز جديد: "وصلت مساحة العمل الخاصة بك إلى حد 50 رمزاً نشطاً. قم بإلغاء أحدها أولاً."
  • استخدم رمزاً واحداً لكل وكيل أو برنامج نصي، حتى تتمكن من معرفة ما قام به كل واحد وإلغاء رمز واحد دون إيقاف الآخرين.

إنشاء رمز

  1. افتح علامة تبويب الرموز

    افتح قائمة مساحة العمل واختر AI agents & API. في علامة تبويب الرموز، انقر على رمز جديد.

  2. الغرض: قم بتسميته واختر ما هو مخصص له

    امنحه الاسم الذي ستتعرف عليه في قائمة الرموز وسجل النشاط، بحد أقصى 100 حرف، مثل "كاتب المستندات (Claude Code)". تحت ما الغرض منه؟، اختر إعداداً مسبقاً. سيقوم بتحديد الأذونات الخاصة بهذه الوظيفة؛ يمكنك ضبطها بدقة في الخطوة التالية.

    الخطوة 1 من معالج رمز API الجديد: اسم واختيار إعدادات الغرض المسبقة مثل كاتب، ناشر، ومساعد الدعم.
    اختر الإعداد المسبق الأقرب لوظيفة الوكيل.
    الإعداد المسبق استخدمه لـ
    كاتب "مسودات الوكلاء؛ يقوم شخص بالمراجعة والنشر." مسودات مواقع المستندات.
    ناشر "أتمتة موثوقة قد تغير ما يراه القراء." مواقع المستندات، بما في ذلك النشر.
    مساعد الدعم "إجابات من مستندات منشورة. لا شيء آخر." روبوت مساعدة.
    للقراءة فقط "البحث، التدقيق، وفحوصات الترجمة."
    محلل "يقرأ المحتوى وإشارات القراء لاقتراح إصلاحات."
    منتج "يصيغ المحتوى ويبدأ العمل المدفوع ضمن حدود الإنفاق." طلب الفيديوهات والمقاطع والمقالات.
    وكيل مساحة العمل "كل ما يمكن للوكيل القيام به في مساحة العمل هذه، ضمن حدود الإنفاق."

    يحتوي الإعداد المسبق غير النشط (الرمادي) على إذن لا يمكن لدورك منحه: "لا يمكن لدورك منح كل القدرات في هذا الإعداد المسبق."

  3. الأذونات: تحقق من كل إذن

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

    الخطوة 2، الأذونات: أذونات إعداد الكاتب المسبق محددة، ومجمعة حسب مجموعة الأدوات، مع وصف قصير وشارة قراءة أو تعديل أو نشر أو إدارة لكل منها.
    يوضح كل إذن نوع الأشياء التي يسمح بها.

    ما يسمح به كل إذن: أذونات الوكيل.

  4. الحدود: ضبط انتهاء الصلاحية، المواقع، الإنفاق، والعناوين

    الخطوة 3، الحدود: انتهاء الصلاحية، مواقع المستندات، حدود الإنفاق لكل وظيفة، يومياً وشهرياً، الموافقة تلقائياً أدناه، وقائمة السماح لعناوين IP تحت خيارات متقدمة.
    يظهر الإنفاق فقط عندما يمكن للرمز إنفاق الأرصدة.

    راجع خيارات الحدود أدناه.

  5. مراجعة وإنشاء

    توضح المراجعة بكلمات بسيطة ما يمكن للرمز القيام به (يمكنه القراءة، يمكنه الإنشاء والتحرير، يمكنه النشر، يمكنه إدارة المواقع، يمكنه إنفاق الأرصدة) وحدوده. "يعمل الرمز بصفتك أنت، ضمن ما يسمح به دورك." انقر على إنشاء رمز.

    الخطوة 4، مراجعة: ما يمكن للرمز الجديد القيام به بكلمات بسيطة، وتاريخ انتهاء صلاحيته، ومواقع المستندات، وقائمة السماح لعناوين IP، قبل إنشائه.
    راجع الملخص، ثم انقر على إنشاء رمز.

  6. انسخ الرمز

    يعرض تم إنشاء الرمز الرمز، بدءاً بـ clv_agent_: "انسخه الآن: لن تراه مرة أخرى." انسخه إلى مخزن سري أو متغير بيئة. يحتوي ربط وكيل أسفله على إعداد جاهز لـ Claude Code وCodex CLI و.mcp.json وcurl وClaude.ai، ChatGPT. انقر على لقد قمت بتخزينه عند الانتهاء.

    مربع حوار تم إنشاء الرمز الذي يعرض الرمز الجديد مرة واحدة، مع أوامر إعداد جاهزة للنسخ لـ Claude Code وCodex CLI و.mcp.json وcurl.
    يتم عرض الرمز مرة واحدة فقط.

يحفظ رجوع كل ما أدخلته. إغلاق المعالج بعد تغيير شيء ما يطرح السؤال "هل تريد تجاهل هذا الرمز؟": "سيتم فقدان الإعداد الذي بدأته. لم يتم إنشاء أي رمز."

خيارات الحدود

الخيار ما يفعله الافتراضي
تنتهي الصلاحية بعد 7 أيام، 30 يوماً، 90 يوماً، أو سنة واحدة. يظهر التاريخ أدناه ("في التاريخ"). تنتهي صلاحية الرموز دائماً. 90 يوماً
مواقع المستندات يظهر عندما يكون للرمز أذونات مواقع المستندات. كل المواقع ("كل موقع مستندات في مساحة العمل هذه، بما في ذلك المواقع الجديدة.") أو المواقع المختارة. المواقع المختارة عندما تحتوي مساحة العمل على أكثر من موقع مستندات، وإلا كل المواقع
الإنفاق ← لكل وظيفة الحد الأقصى الذي قد يتم تقديره لبدء تشغيل واحد، بالرصيد. فارغ: لا يوجد حد. لا يوجد حد
الإنفاق ← يومياً / شهرياً الحد الأقصى الذي يمكن للرمز إنفاقه (والاحتفاظ به للوظائف قيد التشغيل) في يوم تقويمي أو شهر. لا يوجد حد
الإنفاق ← الموافقة تلقائياً أدناه يبدأ العمل المقدر بأقل من هذا العدد من الأرصدة دون تدخل بشري. "0 يعني أن الشخص يوافق على كل بدء تشغيل مدفوع. تسمح خطتك بما يصل إلى 500." (1,000 في خطة Custom.) 0
خيارات متقدمة ← قائمة السماح لعناوين IP "اختياري. عنوان واحد أو نطاق واحد لكل سطر؛ يتم رفض المكالمات من أي مكان آخر." ما يصل إلى 20 عنوان IPv4/IPv6 أو نطاقات CIDR، مثل 203.0.113.7 أو 198.51.100.0/24. فارغ: أي عنوان

يظهر الإنفاق فقط عندما يكون للرمز credits:spend (إعدادات منتج ووكيل مساحة العمل المسبقة). كيف تعمل الحدود والموافقات معاً: التحكم في إنفاق الوكيل والموافقات.

ماذا يحدث بعد ذلك

  • يعمل الرمز على الفور عبر MCP (https://app.clevera.ai/mcp) وREST API.
  • يتلقى مالك مساحة العمل والمسؤولون إشعاراً: "تم إنشاء رمز API جديد، الاسم، لـ مساحة العمل"، مع توضيح من قام بإعداده وما هي صلاحياته.
  • يظهر الرمز في علامة تبويب الرموز مع آخر أربعة أحرف منه، مثل clv_agent_…k7Qe، ويقوم كل استخدام بتحديث آخر استخدام.
  • بعد إنشائه، لا يمكن تغيير أذوناته وحدوده. لتغييرها، أنشئ رمزاً جديداً وألغِ الرمز القديم. راجع إدارة رموز API.

استكشاف الأخطاء وإصلاحها

الرسالة السبب الإصلاح
"امنح الرمز اسماً." الاسم فارغ. اكتب اسماً.
"اختر قدرة واحدة على الأقل." لم يتم تحديد أي إذن. حدد واحداً على الأقل.
"اختر موقعاً واحداً على الأقل." تم اختيار المواقع المختارة دون تحديد أي منها. اختر موقعاً، أو اختر كل المواقع.
"أدخل عدداً صحيحاً من الأرصدة." يحتوي حقل الإنفاق على رقم عشري أو نص، أو 0 في حد أقصى. أدخل عدداً صحيحاً، أو اترك الحد فارغاً.
"تسمح خطتك بالموافقة على عمل الوكيل تلقائياً بأقل من 500 رصيد كحد أقصى." الموافقة تلقائياً أدناه تتجاوز الحد الأقصى لخطة عملك. قلل القيمة.
"القيمة ليست عنوان IP أو نطاقاً." سطر قائمة السماح لعناوين IP غير صالح. أصلح ذلك السطر أو احذفه.
"لا يمكن لدورك منح بعض هذه القدرات." الإذن يتجاوز صلاحيات دورك. ألغِ تحديده، أو اطلب من المالك أو المسؤول إنشاء الرمز.
"وصلت مساحة العمل الخاصة بك إلى حد 50 رمزاً نشطاً. قم بإلغاء أحدها أولاً." 50 رمزاً نشطاً. ألغِ رمزاً لا تستخدمه.
"الوصول إلى API والوكيل غير متاح في خطتك." مساحة العمل ليست في خطة Pro أو Business أو Custom. قم بالترقية إلى Pro.
"تعذر إنشاء الرمز. حاول مرة أخرى." حدث خطأ ما. حاول مرة أخرى؛ اتصل بالدعم إذا استمرت المشكلة.
ربط تطبيقات ووكلاء AIإعداد الرمز في Claude Code أو Codex أو Cursor.أذونات الوكيلما يسمح به كل إذن.إدارة رموز APIإعادة الإنشاء، الإلغاء، وانتهاء الصلاحية.التحكم في إنفاق الوكيل والموافقاتحدود الإنفاق والموافقات.