ווידג’ט של חזרת קול (תצוגה מקדימה)
המאגר מכיל רכיב אינטרנט ניתן להטמעה הלוכד או הוראה מתומללת דפדפן, שולחת אותה לאפליקציית OpenFactory בבעלות, וכן סוקר את כרטיס התיקון שנוצר. השילוב הוא תצוגה מקדימה בלבד.
מקור החבילה נמצא ב-tools/voice-iterate ב-OpenFactory monorepo. תעשה
לא להניח ש-@openfactory/voice-iterate או חבילת ה-CDN שלו מתפרסמת בפומבי;
לבנות ולהצמיד חפץ שנבדק מהמאגר עד לשחרור
רשום במפורש ברישום החבילות.
גבול נוכחי
נקודת הקצה מקבלת הוראה לאפליקציה עם מקור Git ומשגרת
זרימת העבודה המשותפת לתיקון. שלב 0 משנה את עותק ארגז החול הפרוס ויכול
לפרוס מחדש את התצוגה המקדימה הזו. זה לא מבטיח שהשינוי מחויב
המאגר במעלה הזרם. כרטיס המסומן done מוכיח רק את הסוכן המוקלט
תוצאת המשימה; סקור את התוצאה שלו ואמת את האפליקציה בעצמך.
השירות מאפשר לכל היותר שתי איטרציות בטיסה לאפליקציה. נוסף
מבקש החזרה 429 עד שכרטיס מגיע למצב מסוף.
דרישות מוקדמות
- אפליקציית OpenFactory בבעלות עם
source.git_url. - חשבון אמיתי; הפעלות אורח לא יכולות לשלוח עריכות קוד אוטונומיות.
- מפתח חשבון
of_mcp_שמור בשרת, אף פעם לא ב-JavaScript בדפדפן. - HTTPS או מקור פיתוח מקומי מארח אם נעשה שימוש בכניסת מיקרופון.
בנה את הווידג’ט מהמקור
מתוך המונורפו:
cd tools/voice-iterate
npm ci
npm test
npm run lint
npm run buildספק את החבילה המנוסחת שהתקבלה או התקן אותה מהשליטה שלך הרישום. רשום את התחייבות המקור ואת סכום הבדיקה המשמשים את היישום שלך.
השתמש ב-proxy מאותו מקור
הווידג’ט הפונה לדפדפן קורא:
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> רק בשרת. אימות
והגבלת שיעורי משתמשי ה-proxy שלך; אחרת כל מבקר יכול להגיע
מסלול יכול לבזבז את סמכות החשבון שלך על שינויים באפליקציה המוצמדת. אפשר
רק שלושת הנתיבים ושתי השיטות שלמעלה, אוכפים מגבלות של גודל בקשה, ועושים
לא להעביר כותרות שרירותיות או מזהי אפליקציה.
הרכב את המודול שנבנה באופן מקומי עם נקודת הקצה של ה-proxy:
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 מקבל הטקסט המתקבל בנתיב זה, בעוד הדפדפן או דיבור מוגדר השירות עשוי לעבד אודיו בנפרד.
מבחן קבלה
- שלח שינוי בלתי מזיק, הפיך כנגד אפליקציה שאינה ייצור.
- אשר שה-proxy אינו יכול למקד לאף אפליקציה אחרת ודוחה ללא אימות מתקשרים.
- התבוננו ב-
queued/workingדרך מסוףdone,failed,lost, אוstaleמצב. - בדוק את תוצאת המשימה ותצוגה מקדימה באופן ידני.
- ודא שמאגר Git במעלה הזרם אינו משתנה, אלא אם כן, זרימת עבודה של התמדה במקור שנבדקה מדווחת על בקשת התחייבות או משיכה.
- החזר או בנה מחדש את ארגז החול מהמקור הקנוני.
ראה סוכן בקשת ליישום ו פריסת אפליקציה לאותה התמדה ו גבולות קידום.