ودجة التكرار الصوتي (معاينة)

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

لا تفترض أن @openfactory/voice-iterate أو حزمة CDN الخاصة به منشورة للعامة؛ ابنِ وثبّت مخرجا مراجعا حتى يُدرج إصدار صراحة في سجل الحزم.

الحد الحالي

تقبل نقطة النهاية تعليما لتطبيق بمصدر Git وتوزّع سير الإصلاح المشترك. المرحلة 0 تغيّر نسخة الصندوق الرملي المنشورة ويمكنها إعادة نشر تلك المعاينة. لا تضمن أن التغيير مُلتزم به في المستودع العلوي. تذكرة موسومة done تثبت فقط نتيجة مهمة الوكيل المسجلة؛ راجع نتيجتها وتحقق من التطبيق بنفسك.

تسمح الخدمة بتكرارين قيد التنفيذ على الأكثر لكل تطبيق. الطلبات الإضافية تعيد 429 حتى تصل تذكرة إلى حالة نهائية.

المتطلبات السابقة

تطبيق OpenFactory مملوك مع source.git_url.
حساب حقيقي؛ جلسات الضيف لا يمكنها توزيع تعديلات شفرة مستقلة.
مفتاح حساب of_mcp_ يُحفظ على خادم، لا في JavaScript المتصفح.
HTTPS أو أصل تطوير localhost إذا استُخدم إدخال الميكروفون.

ابنِ الودجة من المصدر

من مصدر الودجة المراجع:


cd tools/voice-iterate
npm ci
npm test
npm run lint
npm run build

ضمّن الحزمة الناتجة ذات الإصدار أو ثبّتها من سجلك المحكوم. سجّل التزام المصدر والمجموع الاختباري الذي يستخدمه تطبيقك.

استخدم وكيلا من نفس الأصل

تستدعي الودجة المواجهة للمتصفح:


POST {endpoint}/iterate
GET  {endpoint}/agent-status
GET  {endpoint}/agent-status?thread_id={thread_id}

يجب أن يثبّت خادمك معرف التطبيق المستهدف ويعيد توجيه تلك الطلبات إلى:


POST https://console.openfactory.tech/api/apps/{APP_ID}/iterate
GET  https://console.openfactory.tech/api/apps/{APP_ID}/agent-status

أرفق Authorization: Bearer <of_mcp_key> على الخادم فقط. صادق وحدّ معدل مستخدمي وكيلك؛ وإلا يمكن لكل زائر يصل إلى المسار إنفاق سلطة حسابك على تغييرات التطبيق المثبت. اسمح فقط بالمسارات الثلاثة والطرقتين أعلاه، وافرض حدود حجم الطلب، ولا تمرّر ترويسات أو معرفات تطبيق اعتباطية.

ركّب الوحدة المبنية محليا بنقطة نهاية الوكيل:


import { createVoiceIterate } from './vendor/openfactory-voice-iterate/index.mjs';
 
const widget = createVoiceIterate({
  appId: '550e8400-e29b-41d4-a716-446655440000',
  endpoint: '/api/voice-iterate',
  fallback: 'text',
  onStatusChange: ({ status, thread }) => {
    console.log(status, thread.taskResult);
  },
});

يعمل العنصر المخصص وأنماطه في Shadow DOM. يبقى احتياط النص الافتراضي قابلا للاستخدام عندما يتعذر التعرف على الكلام في المتصفح. تختلف خدمات كلام المتصفح وسلوك الخصوصية حسب المتصفح والنشر؛ احصل على الموافقة واختبر مجموعة المتصفحات المدعومة بالضبط. يتلقى OpenFactory النص الناتج على هذا المسار، بينما قد يعالج المتصفح أو خدمة كلام مضبوطة الصوت بشكل منفصل.

اختبار القبول

أرسل تغييرا غير ضار وقابلا للعكس ضد تطبيق غير إنتاجي.
أكد أن الوكيل لا يمكنه استهداف أي تطبيق آخر ويرفض المتصلين غير المصادقين.
راقب queued/working حتى حالة نهائية done أو failed أو lost أو stale.
افحص نتيجة المهمة والمعاينة يدويا.
أكد أن مستودع Git العلوي دون تغيير ما لم يبلّغ سير استمرار مصدر منفصل ومراجع عن التزام أو طلب سحب.
أرجع الصندوق الرملي أو أعد بناءه من المصدر القانوني.

انظر وكيل الموجه إلى التطبيق ونشر التطبيق لنفس حدود الاستمرار والترقية.