Voice Iterate-widget (preview)

Repositorio sisältää upotettavan Web Componentin, joka tallentaa kirjoitetun tai selaimessa litteroidun ohjeen, lähettää sen omistamallesi OpenFactory-sovellukselle ja pollaa syntyvää repair ticketiä. Integraatio on vain preview-tilassa.

Paketin lähdekoodi on polussa tools/voice-iterate OpenFactory-monorepossa. Älä oleta, että @openfactory/voice-iterate tai sen CDN bundle on julkaistu julkisesti; rakenna ja kiinnitä tarkistettu artifact reposta, kunnes julkaisu on eksplisiittisesti package registryssä.

Nykyinen raja

Päätepiste hyväksyy ohjeen Git-lähteellä varustetulle sovellukselle ja käynnistää jaetun repair workflowin. Stage 0 muuttaa deployattua sandbox-kopiota ja voi deployata previewn uudelleen. Se ei takaa, että muutos commitoidaan upstream repositoryyn. done-merkitty ticket todistaa vain tallennetun agent task outcomen; tarkista tulos ja varmista sovellus itse.

Palvelu sallii enintään kaksi käynnissä olevaa iterointia per sovellus. Lisäpyynnöt palauttavat 429, kunnes ticket saavuttaa terminal staten.

Edellytykset

• Omistamasi OpenFactory-sovellus, jossa on source.git_url.
• Oikea tili; guest sessions eivät voi käynnistää autonomisia koodimuutoksia.
• of_mcp_ account key palvelimella, ei koskaan browser JavaScriptissä.
• HTTPS tai localhost development origin, jos mikrofonia käytetään.

Rakenna widget lähdekoodista

Monorepossa:

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

Ota käyttöön syntynyt versioned bundle tai asenna se omasta hallitusta registrystä. Kirjaa source commit ja checksum, joita sovelluksesi käyttää.

Same-origin-välityspalvelin

Selaimessa oleva widget kutsuu:

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

Palvelimesi kiinnittää kohdesovelluksen app ID:n ja välittää nämä pyynnöt osoitteisiin:

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

Liitä Authorization: Bearer <of_mcp_key> vain palvelimella. Todenna ja rate-limit omat välityspalvelimen käyttäjät; muuten jokainen reittiin pääsevä vierailija voi käyttää tilisi authoritya kiinnitetyn sovelluksen muutoksiin. Salli vain kolme polkua ja kaksi metodia yllä, rajoita pyynnön kokoa äläkä välitä satunnaisia headereita tai app ID:itä.

Mountaa paikallisesti rakennettu moduuli proxy-endpointilla:

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

Custom element ja sen tyylit ajetaan Shadow DOMissa. Oletus text fallback toimii edelleen, kun browser speech recognition ei ole käytettävissä. Browser speech services ja yksityisyyskäyttäytyminen vaihtelevat selaimen ja deploymentin mukaan; hanki suostumus ja testaa tarkalleen tuetut selaimet. OpenFactory saa tulostekstin tällä polulla, kun selain tai konfiguroitu speech service voi käsitellä äänen erikseen.

Hyväksyntätesti

1. Lähetä harmiton, peruutettavissa oleva muutos non-production-sovellusta vastaan.
2. Varmista, ettei välityspalvelin voi kohdistaa muita sovelluksia ja hylkää autentisoimattomat callers.
3. Seuraa queued/working terminal tilaan done, failed, lost tai stale state.
4. Tarkista task result ja preview käsin.
5. Varmista, että upstream Git repository on ennallaan, ellei erillinen, tarkistettu source-persistence workflow raportoi committia tai pull requestia.
6. Palauta sandbox tai rakenna se uudelleen kanonisesta lähteestä.

Katso Prompt-avusteinen sovelluksen käyttöönotto ja Sovelluksen käyttöönotto samoista persistence- ja promotion-rajoista.