وثائق المطورين

نمطان أصيلان: عقل صُرَد أو عقلك الخاص

تخدم صُرَد من يريد بناء وكيله وتشغيله بالكامل داخلها، كما تخدم الأنظمة التي تملك عقولها الخاصة. النمطان مدعومان بالقدر نفسه، ويختار المالك النمط لكل وكيل.

الحصول على الوصول

1. يفتح فريق صُرَد حساب مؤسستك ومساحة عملها، ويسلّمك بريد المسؤول وكلمة مرور مؤقتة (لا تسجيل ذاتي حالياً).
2. تدخل إلى Studio وتغيّر كلمة المرور من الإعدادات.
3. تنشئ وكيلك وتضبطه وتنشره (انظر «الوكيل: الإعداد والنشر»).
4. من Studio ← الدمج: تنشئ مفتاح API لخادمك، وتسجّل نطاقات موقعك أو تطبيقك.

أساسيات مشتركة

كل الطلبات إلى https://app.surad-ai.com عبر HTTPS، والأجسام بصيغة JSON، والأخطاء بشكل واحد موحد (انظر المرجع).

للأمان طبقتان لا تختلطان:

• مفتاح API (يبدأ بـsk_): يبقى في خادمك فقط، وتنشئه من Studio ← الدمج. يظهر مرة واحدة عند إنشائه.
• رمز الجلسة: قصير العمر ومربوط بنطاق موقعك، وهو وحده ما يصل إلى المتصفح أو التطبيق.

ما الذي تتحكم فيه من Studio

• العقل: النموذج، والتعليمات، والمعرفة التي يستند إليها الوكيل ولا يتجاوزها.
• الصوت: الصوت من الكتالوج، والسرعة، وقواعد النطق للأسماء والمصطلحات.
• شكل الرد: نص، أو صوت، أو كلاهما. وطوله: قصير (الأنسب للصوت)، أو متوازن، أو مفصّل.
• النشر: كل تعديل يدخل مراجعة جديدة، ولا يصل إلى عملائك إلا بعد نشرها، ويمكنك التراجع بنقرة.
• السجل: محادثات وكلائك كما حُفظت، في Studio ← المحادثات.

ما تختاره في Studio هو ما يسمعه عملاؤك: الصوت نفسه، وقواعد النطق نفسها، في الويدجت والـAPI على السواء.

لوكلاء البرمجة بالذكاء الاصطناعي

إن كان مساعد برمجي (مثل Claude Code أو Cursor) سيكتب الدمج نيابة عنك، فوجّهه إلى /llms.txt و/llms-full.txt: نسخة نصية مكثفة من هذه الوثائق بالإنجليزية، فيها كل المسارات والحقول والأخطاء.