Voice Iterate Widget (Preview)
Repozitorij sadrži ugradivu Web Component koja hvata upisanu ili u pregledniku transkribiranu uputu, šalje je u aplikaciju OpenFactory koju posjedujete i periodički provjerava nastali repair ticket. Integracija je zasad samo u previewu.
Izvorni kod paketa je u tools/voice-iterate u monorepu OpenFactory. Ne
pretpostavljajte da su @openfactory/voice-iterate ili njegov CDN bundle javno
objavljeni; izgradite i pričvrstite pregledani artefakt iz repozitorija dok u
registru paketa nije izričito navedeno izdanje.
Trenutačna granica
Krajnja točka prima uputu za aplikaciju s Git izvorom i pokreće zajednički repair workflow.
Stage 0 mijenja implementiranu kopiju sandboxa i može taj preview ponovno implementirati. Ne
jamči da je promjena commitana u upstream repozitorij. Ticket označen done dokazuje samo
zabilježeni ishod zadatka agenta; pregledajte rezultat i aplikaciju provjerite sami.
Usluga dopušta najviše dvije aktivne iteracije po aplikaciji. Dodatni
zahtjevi vraćaju 429 dok ticket ne dosegne konačno stanje.
Preduvjeti
- Aplikacija OpenFactory koju posjedujete s
source.git_url. - Stvarni račun; gostujuće sesije ne mogu pokrenuti autonomne izmjene koda.
- Ključ računa
of_mcp_pohranjen na poslužitelju, nikad u JavaScriptu preglednika. - HTTPS ili localhost razvojni origin ako koristite ulaz s mikrofona.
Izgradnja widgeta iz izvora
Iz monorepa:
cd tools/voice-iterate
npm ci
npm test
npm run lint
npm run buildU projekt uključite verzionirani bundle ili ga instalirajte iz vlastitog kontroliranog registra. Zabilježite source commit i checksum koje vaša aplikacija koristi.
Proxy istog podrijetla
Widget koji preglednik zove poziva:
POST {endpoint}/iterate
GET {endpoint}/agent-status
GET {endpoint}/agent-status?thread_id={thread_id}Vaš poslužitelj treba pričvrstiti ciljani app ID i te zahtjeve proslijediti na:
POST https://console.openfactory.tech/api/apps/{APP_ID}/iterate
GET https://console.openfactory.tech/api/apps/{APP_ID}/agent-statusAuthorization: Bearer <of_mcp_key> dodajte samo na poslužitelju. Provjerite
identitet i ograničite brzinu korisnika vlastitog proxyja; inače svaki posjetitelj koji
dosegne route može potrošiti ovlasti vašeg računa na promjene pričvršene aplikacije. Dopustite
samo tri putanje i dvije metode gore, primijenite ograničenja veličine zahtjeva i
ne prosljeđujte proizvoljna zaglavlja ili app ID.
Postavite lokalno izgrađeni modul s krajnjom točkom proxyja:
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);
},
});Prilagođeni element i njegovi stilovi rade u Shadow DOM-u. Zadani tekstualni fallback ostaje upotrebljiv kad prepoznavanje govora u pregledniku nije dostupno. Usluge govora u pregledniku i ponašanje privatnosti razlikuju se po pregledniku i implementaciji; pribavite privolu i testirajte točno podržani skup preglednika. OpenFactory na ovom putu prima nastali tekst, dok preglednik ili konfigurirana usluga govora može zvuk obrađivati odvojeno.
Prihvatni test
- Pošaljite bezopasnu, reverzibilnu promjenu protiv neprodukcijske aplikacije.
- Potvrdite da proxy ne može ciljati drugu aplikaciju i odbija neautentificirane pozivatelje.
- Promatrajte
queued/workingdo konačnog stanjadone,failed,lostilistale. - Ručno pregledajte rezultat zadatka i preview.
- Potvrdite da se upstream Git repozitorij nije promijenio osim ako zaseban, pregledani workflow očuvanja izvora ne prijavi commit ili pull request.
- Vratite sandbox ili ga ponovno izgradite iz kanonskog izvora.
Pogledajte Prompt-to-app agent i App deployment za iste granice očuvanja i promocije.