إعدادات المطوّر

للصفحة تبويبان: «الوصول الشخصي» و«عملاء التطبيقات».

مفتاحك الشخصي

• أنشئ المفتاح. «مفتاح جديد»: أعطه اسمًا إن شئت، ومدة صلاحية (7 أيام أو 30 يومًا أو 90 يومًا أو سنة أو بلا انتهاء) وأذوناته. كلها محدّدة افتراضيًا؛ أبقِ فقط ما تحتاج إليه أداتك.
• انسخه فورًا. يُعرض مرة واحدة فقط، ولا تحتفظ Sofia إلا ببصمته.
• استخدمه. أرسله في الترويسة Authorization: Bearer مع كل استدعاء. يعمل المفتاح على كل منشآتك، بصلاحياتك.

ربط مساعد ذكاء اصطناعي

مع Claude أو ChatGPT أو Cursor أو Gemini CLI أو Claude Code، غالبًا ما يكون موصّل التطبيقات المرتبطة أبسط: فهو لا يطلب أي مفتاح. انظر موصّل الذكاء الاصطناعي.

CLI والوكلاء

«نسخ تعليمات الوكيل» يعطيك النص الذي تلصقه في وكيلك ليستخدم واجهة API. الأمر sofia، المنشور على npm باسم sofia-post، يغلّف واجهة API للنشر من طرفية أو سكربت أو مهمة مجدولة؛ وتثبيته في تبويب Agents.

يُستخدم عميل التطبيق لبناء شيء سيأذن به مستخدمو Sofia الآخرون، لا شيء يعمل باسمك.

• أنشئ العميل. «عميل جديد»: اسم، وشعار لا يقل عن 180 × 180 بكسل، وعنوان سياسة الخصوصية، ومن عنوان إلى خمسة عناوين URL لإعادة التوجيه عبر HTTPS، والأذونات التي يجوز للتطبيق طلبها. يظهر الاسم والشعار للأشخاص أثناء الإذن.
• انسخ المعرّفات. تحصل على Client ID وClient Secret. العميل العام، لتطبيق شيفرته عامة، ليس له سرّ ويصادق بـ PKCE؛ وهذا الاختيار نهائي.
• نفّذ المسار. انظر تبويب «أضف Sofia إلى تطبيقك».

إذا كنت تؤتمت نشرك الخاص، فاستخدم المفتاح. ولا تبنِ عميلًا إلا حين تكون حسابات أشخاص آخرين معنية.

• API: نقاط الوصول والحمولات والإعدادات لكل شبكة، في تبويب API.
• CLI: النشر من طرفية، في تبويب Agents.
• موصّل الذكاء الاصطناعي: ربط Claude أو Cursor أو ChatGPT، انظر موصّل الذكاء الاصطناعي.