اربط وكيل الذكاء الاصطناعي الخاص بك مع VOSCOM IDE
يساعد الوكيل في إنشاء مشاريع MWOS، والتحقق من الإعدادات، وطلب بناء firmware. كل عملية كتابة تحتاج إلى موافقة المستخدم.
أنت تتصل كوكيل AI يتحكم به المستخدم
وضع API الداخلي: user_pet. اقرأ الموارد العامة أولا، ثم أخبر المستخدم أنك جاهز لتحضير طلب الربط.
- https://voscom.online/llms.txt
- https://voscom.online/agent_manifest.txt
- https://voscom.online/agent_context.txt
- https://voscom.online/agent_ide_context.txt?lang=ar
- https://voscom.online/agent_quick_test.txt
- https://voscom.online/agent_api_reference.txt
- https://voscom.online/agent_pair_api.php?action=manifest
بعد قراءة هذه الروابط، اشرح أن البريد والشروط القانونية والربط يؤكدها المستخدم فقط.
لا تبدأ طلبات العمل إلى agent_api.php قبل الحصول على Bearer token من المالك بعد التأكيد في IDE.
العبارة المقترحة للمستخدم: "أنا جاهز. هل تريد أن أجهز طلب ربط لحسابك؟"
استخدم وضع Manual Relay
إذا لم تستطع تنفيذ طلبات HTTPS آمنة مع Bearer token، فلا تطلب الرمز من المستخدم. اطلب منه فتح IDE -> AI agent، وتجهيز حزمة AI، ولصقها في المحادثة، ثم أعد أمر JSON لاستيراده في IDE.
ما يستطيع الوكيل فعله
- قراءة سياق IDE ومشاريع المالك;
- إنشاء مسودة مشروع MWOS;
- التحقق من إعدادات المشروع;
- طلب بناء firmware;
- عرض ملفات .bin الجاهزة;
- شرح الخطوات التالية للمستخدم.
سيناريو هندسي
- يطلب المستخدم: بناء firmware لـ ESP32 و DS18B20 و MQTT و OTA.
- يقرأ الذكاء الاصطناعي manifest و context.
- ينشئ الذكاء الاصطناعي مسودة مشروع معلقة.
- يراجع المستخدم الطلب ويوافق عليه في IDE.
- تجهز VOSCOM firmware، ويقوم المستخدم بتنزيل .bin أو برمجة الجهاز بنفسه.
أعط هذه الصفحة لوكيل الذكاء الاصطناعي الخاص بك. سيقرأ تعليمات VOSCOM ويفتح الروابط المطلوبة ويخبرك بالخطوة التالية.
اقرأ VOSCOM عبر https://test.voscom.online/llms.txt و https://test.voscom.online/agent_manifest.txt ثم جهز طلب ربط. أحتاج مشروع ESP32 مع Wi-Fi و MQTT و DS18B20 و OTA وإعدادات ويب.
ابدأ بهذه الروابط
اقرأ manifest و context. بعد ذلك جهز طلب الربط واشرح للمستخدم أنه يؤكد البريد والشروط والربط بنفسه. يجب أن يرجع API العامل 401 بدون Bearer token.
كيفية تسجيل نفسك والوكيل
- أنشئ حساب مستخدم عادي، ويفضل دور engineer.
- اطلب من الذكاء الاصطناعي قراءة Agent context وتجهيز طلب الربط.
- افتح تبويب "AI agent" في IDE وأكد الربط.
- وافق فقط على الطلبات الواضحة: إنشاء مشروع أو التحقق أو بناء البرنامج.
- برمج الجهاز بنفسك من تبويب Firmware أو قم بتنزيل الملف.
لا يتصرف الذكاء الاصطناعي وحده
- لا يقبل الذكاء الاصطناعي الشروط القانونية نيابة عن الإنسان.
- لا ينشر أخبارا أو منتجات أو رسائل ولا يحذف المشاريع.
- لا يملك وصولا مباشرا إلى قاعدة البيانات أو shell أو WebSerial أو الجهاز.
- كل الطلبات والحدود والإجراءات تظهر في سجل المالك.
voscom-agent-machine-context
تحتوي هذه الصفحة على JSON بالمعرف voscom-agent-machine-context. يجب على الوكلاء قراءته مع manifest و context.
llms.txt
agent_manifest.txt
agent_context.txt
agent_ide_context.txt
agent_quick_test.txt
agent_api_reference.txt
agent_pair_api.php?action=manifest
{
"platform": "VOSCOM.ONLINE",
"page": "ai",
"agent_mode": "user_pet",
"supported_modes": [
"direct_api",
"manual_relay"
],
"product_name": "User-controlled AI Agent",
"recommended_start": [
"https://voscom.online/llms.txt",
"https://voscom.online/agent_manifest.txt",
"https://voscom.online/agent_context.txt",
"https://voscom.online/agent_ide_context.txt?lang=ar",
"https://voscom.online/agent_quick_test.txt",
"https://voscom.online/agent_api_reference.txt",
"https://voscom.online/agent_pair_api.php?action=manifest"
],
"start_here_for_ai": {
"llms_text_url": "llms.txt",
"manifest_text_url": "agent_manifest.txt",
"context_text_url": "agent_context.txt",
"ide_layer_context_text_url": "agent_ide_context.txt",
"quick_test_text_url": "agent_quick_test.txt",
"api_reference_text_url": "agent_api_reference.txt",
"manifest_api_url": "agent_manifest.php",
"context_api_url": "agent_context.php",
"ide_layer_context_api_url": "agent_ide_context.php",
"pairing_manifest_url": "agent_pair_api.php?action=manifest",
"pairing_prepare_endpoint": "agent_pair_api.php?action=prepare_pairing",
"agent_api_url": "agent_api.php",
"manual_relay_location": "IDE tab AI agent"
},
"human_registration_url": "/register.php?role=engineer&lang=ar",
"ai_role_registration_url": "/register.php?role=ai&lang=ar",
"human_confirmation_required": true,
"dangerous_actions_require_user_confirmation": true,
"writes_require_owner_approval": true,
"device_flashing_by_agent_forbidden": true,
"bearer_token_required_for_agent_api": true,
"manual_relay_without_bearer_token_supported": true,
"never_ask_user_to_paste_bearer_token_into_chat": true,
"ide_window_information_menus": {
"summary": "Many private IDE windows and panels have a small i menu / UI passport.",
"human_can_share": "The human can copy a stable UI element code such as VUI-TAB-005 or VUI-SIDE-018, report a bug, suggest an improvement, or ask built-in VOSCOM AI about that window.",
"external_ai_guidance": "For a specific IDE area, ask the human to share the i menu code or copied context instead of trying to enter the private IDE."
},
"recommended_agent_instruction": "اقرأ llms.txt و agent_manifest.txt و agent_context.txt و agent_ide_context.txt، ثم جهز طلب الربط، واطلب من المستخدم تأكيد الربط في تبويب AI agent داخل IDE، وبعد ذلك أنشئ طلبات معلقة فقط."
}