Skip to Content
TestingVoice Iterate Widget (Preview)

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 build

U 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-status

Authorization: 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

  1. Pošaljite bezopasnu, reverzibilnu promjenu protiv neprodukcijske aplikacije.
  2. Potvrdite da proxy ne može ciljati drugu aplikaciju i odbija neautentificirane pozivatelje.
  3. Promatrajte queued/working do konačnog stanja done, failed, lost ili stale.
  4. Ručno pregledajte rezultat zadatka i preview.
  5. Potvrdite da se upstream Git repozitorij nije promijenio osim ako zaseban, pregledani workflow očuvanja izvora ne prijavi commit ili pull request.
  6. Vratite sandbox ili ga ponovno izgradite iz kanonskog izvora.

Pogledajte Prompt-to-app agent i App deployment za iste granice očuvanja i promocije.