Voice Iterate Widget (Preview)

A repó beágyazható Web Componentet tartalmaz, amely rögzít egy begépelt vagy böngészőben átírt utasítást, elküldi egy Ön által birtokolt OpenFactory alkalmazásnak, és pollolja a keletkező repair ticketet. Az integráció egyelőre csak preview.

A csomag forrása a tools/voice-iterate könyvtárban van az OpenFactory monorepóban. Ne tegye fel, hogy az @openfactory/voice-iterate vagy CDN bundle-je nyilvánosan megjelent; építse és rögzítse a repóból származó, átnézett artefaktumot, amíg a csomagregiszterben kifejezetten fel nem tüntetnek egy kiadást.

Jelenlegi határ

A végpont elfogad egy utasítást Git forrással rendelkező alkalmazáshoz, és elindítja a közös repair workflow-t. A Stage 0 módosítja a telepített sandbox másolatot, és újratelepítheti azt a previewt. Nem garantálja, hogy a változás commitolódik az upstream repóba. A done jelzésű ticket csak a rögzített agent-feladat kimenetét bizonyítja; nézze át az eredményt, és maga ellenőrizze az alkalmazást.

A szolgáltatás alkalmazásonként legfeljebb két folyamatban lévő iterációt enged. További kérések 429-et adnak vissza, amíg a ticket terminális állapotba nem ér.

Előfeltételek

• Ön által birtokolt OpenFactory alkalmazás source.git_url mezővel.
• Valódi fiók; vendég munkamenetek nem indíthatnak autonóm kódmódosításokat.
• of_mcp_ fiókkulcs a szerveren, soha a böngésző JavaScriptjében.
• HTTPS vagy localhost fejlesztői origin, ha mikrofonbevitelt használ.

Widget építése forrásból

A monorepóból:

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

Vegye be a kapott verziózott bundle-t, vagy telepítse saját ellenőrzött regiszterből. Jegyezze fel a forrás commitot és checksumot, amit az alkalmazása használ.

Azonos eredetű proxy

A böngésző felé szolgáló widget ezeket hívja:

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

A szerver rögzítse a cél app ID-t, és továbbítsa a kéréseket ide:

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

Az Authorization: Bearer <of_mcp_key> csak a szerveren legyen. Hitelesítse és korlátozza saját proxy felhasználóit; különben minden látogató, aki eléri a route-ot, elköltheti fiókja jogosultságát a rögzített alkalmazás módosításaira. Engedélyezze csak a fenti három útvonalat és két metódust, kényszerítsen kérelmi méretkorlátokat, és ne továbbítson tetszőleges fejlécet vagy app ID-t.

Illessze be a helyben épített modult a proxy végponttal:

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);
  },
});

Az egyedi elem és stílusai Shadow DOM-ban futnak. Az alapértelmezett szöveges fallback használható marad, ha a böngésző beszédfelismerése nem elérhető. A böngésző beszédszolgáltatásai és adatvédelmi viselkedése böngészőnként és telepítésenként eltér; kérjen hozzájárulást, és tesztelje a ténylegesen támogatott böngészőkészletet. Az OpenFactory ezen az úton kapja a keletkező szöveget, míg a böngésző vagy egy beállított beszédszolgáltatás a hangot külön dolgozhatja fel.

Elfogadási teszt

1. Küldjön ártalmatlan, visszafordítható módosítást egy nem produkciós alkalmazás ellen.
2. Erősítse meg, hogy a proxy nem célozhat más alkalmazást, és elutasítja a nem hitelesített hívókat.
3. Figyelje a queued/working állapotokat a terminális done, failed, lost vagy stale állapotig.
4. Nézze át kézzel a feladat eredményét és a previewt.
5. Erősítse meg, hogy az upstream Git repó változatlan, hacsak egy külön, átnézett forrásmegőrzési workflow nem jelez commitot vagy pull requestet.
6. Állítsa vissza a sandboxot, vagy építse újra a kanonikus forrásból.

Lásd még a Prompt-to-app agent és az App deployment oldalakat ugyanezekről a megőrzési és promóciós határokról.