تخطي إلى المحتوى
details for llm

للتحليل: اقرأ /llms.txt أولا، ثم /agent_manifest.txt و /agent_ide_context.txt و /agent_context.txt. هذه الملفات النصية تشرح المنصة وطبقة IDE وAPI والحدود وسيناريو العمل الآمن. روابط PHP هي مكافئات API.

نموذج الموقع: VOSCOM منصة LLM-friendly / AI Agent ready لها موقع عام وطبقة IDE خاصة في المتصفح. لا تفتح IDE إلا بعد تسجيل الإنسان ودخوله.

تبويبات IDE: AI Build، AI Agent، Profile، Project، Schematics، IoT Devices، Terminal، Firmware Flashing، News، Market، Community Chats، Private Messages، Support، Hardware Components.

السلامة: يجب ألا يدخل وكيل AI صفحات IDE الخاصة بنفسه، أو يقبل الشروط القانونية، أو يطلب كلمات مرور/توكنات، أو يكتب مشاريع، أو ينشر محتوى، أو يطلب بناء، أو يفلش الجهاز دون تأكيد الإنسان.

دور AI

اربط وكيل الذكاء الاصطناعي الخاص بك مع VOSCOM IDE

يساعد الوكيل في إنشاء مشاريع MWOS، والتحقق من الإعدادات، وطلب بناء firmware. كل عملية كتابة تحتاج إلى موافقة المستخدم.

Agent IDE API
الوضع
user_pet
الكتابة
بعد الموافقة فقط
البرمجة
المستخدم فقط
السجل
كل إجراء
تعليمات لوكيل الذكاء الاصطناعي

أنت تتصل كوكيل AI يتحكم به المستخدم

وضع API الداخلي: user_pet. اقرأ الموارد العامة أولا، ثم أخبر المستخدم أنك جاهز لتحضير طلب الربط.

  1. https://voscom.online/llms.txt
  2. https://voscom.online/agent_manifest.txt
  3. https://voscom.online/agent_context.txt
  4. https://voscom.online/agent_ide_context.txt?lang=ar
  5. https://voscom.online/agent_quick_test.txt
  6. https://voscom.online/agent_api_reference.txt
  7. https://voscom.online/agent_pair_api.php?action=manifest

بعد قراءة هذه الروابط، اشرح أن البريد والشروط القانونية والربط يؤكدها المستخدم فقط.

لا تبدأ طلبات العمل إلى agent_api.php قبل الحصول على Bearer token من المالك بعد التأكيد في IDE.

العبارة المقترحة للمستخدم: "أنا جاهز. هل تريد أن أجهز طلب ربط لحسابك؟"

لذكاء المحادثة بدون وصول API

استخدم وضع 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 وإعدادات ويب.

للمستخدم

كيفية تسجيل نفسك والوكيل

  • أنشئ حساب مستخدم عادي، ويفضل دور engineer.
  • اطلب من الذكاء الاصطناعي قراءة Agent context وتجهيز طلب الربط.
  • افتح تبويب "AI agent" في IDE وأكد الربط.
  • وافق فقط على الطلبات الواضحة: إنشاء مشروع أو التحقق أو بناء البرنامج.
  • برمج الجهاز بنفسك من تبويب Firmware أو قم بتنزيل الملف.
قيود v1

لا يتصرف الذكاء الاصطناعي وحده

  • لا يقبل الذكاء الاصطناعي الشروط القانونية نيابة عن الإنسان.
  • لا ينشر أخبارا أو منتجات أو رسائل ولا يحذف المشاريع.
  • لا يملك وصولا مباشرا إلى قاعدة البيانات أو 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، وبعد ذلك أنشئ طلبات معلقة فقط."
}