Skip to Content
TestingVoice Iterate Widget (peržiūra)

Voice Iterate Widget (peržiūra)

Saugykloje yra įterpiamas Web Component, kuris fiksuoja įvestą arba naršyklėje transkribuotą nurodymą, perduoda jį jums priklausančiai OpenFactory programai ir tikrina susijusį repair ticket. Integracija skirta tik peržiūrai.

Paketo source kodas yra OpenFactory monorepo kataloge tools/voice-iterate. Nelaikykite, kad @openfactory/voice-iterate ar jo CDN bundle yra viešai publikuoti; surinkite ir užfiksuokite peržiūrėtą artefaktą iš saugyklos, kol release aiškiai nebus įrašytas package registry.

Dabartinė riba

Endpoint priima nurodymą programai su Git source ir paleidžia bendrą repair workflow. Stage 0 keičia įdiegtą sandbox kopiją ir gali iš naujo diegti tą preview. Jis negarantuoja, kad pakeitimas bus commit’intas į upstream saugyklą. Ticket pažymėtas done įrodo tik įrašytą agent task rezultatą; peržiūrėkite rezultatą ir patikrinkite programą patys.

Paslauga leidžia ne daugiau kaip dvi vykdomas iteracijas vienai programai. Papildomos užklausos grąžina 429, kol ticket pasiekia galutinę būseną.

Reikalavimai

  • Jums priklausanti OpenFactory programa su source.git_url.
  • Tikra paskyra; svečių sesijos negali paleisti autonominių code edit.
  • of_mcp_ account key saugomas serveryje, ne naršyklės JavaScript.
  • HTTPS arba localhost development origin, jei naudojama mikrofono įvestis.

Surinkti widget iš source

Monorepo:

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

Įtraukite gautą versijuotą bundle arba įdiekite iš savo kontroliuojamo registry. Užfiksuokite source commit ir checksum, kuriuos naudoja jūsų programa.

Naudoti same-origin proxy

Naršyklei skirtas widget kviečia:

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

Jūsų serveris turi užfiksuoti tikslinės programos ID ir perduoti tas užklausas į:

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

Pridėkite Authorization: Bearer <of_mcp_key> tik serveryje. Autentifikuokite ir limituokite savo proxy naudotojus; kitaip kiekvienas lankytojas, galintis pasiekti maršrutą, gali išleisti jūsų paskyros teises pakeitimams užfiksuotoje programoje. Leiskite tik tuos tris kelius ir dvi aukščiau nurodytas metodus, taikykite request dydžio limitus ir neperduokite savavališkų header ar app ID.

Prijunkite lokaliai surinktą modulį su proxy endpoint:

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 ir jo stiliai veikia Shadow DOM. Numatytoji text fallback lieka naudojama, kai naršyklės speech recognition nepasiekiama. Naršyklės speech paslaugos ir privatumo elgsena skiriasi pagal naršyklę ir diegimą; gaukite sutikimą ir išbandykite tikslų palaikomų naršyklių rinkinį. OpenFactory šiuo keliu gauna gautą tekstą, o naršyklė ar sukonfigūruota speech paslauga gali garso apdorojimą atlikti atskirai.

Priėmimo testas

  1. Pateikite nekenksmingą, atstatomą pakeitimą ne gamybinei programai.
  2. Patvirtinkite, kad proxy negali taikyti kitai programai ir atmeta neautentifikuotus kvietėjus.
  3. Stebėkite queued/working iki galutinės done, failed, lost ar stale būsenos.
  4. Patikrinkite task result ir preview rankiniu būdu.
  5. Patvirtinkite, kad upstream Git saugykla nepasikeitė, nebent atskiras, peržiūrėtas source-persistence workflow praneša apie commit ar pull request.
  6. Atstatykite arba perkurkite sandbox iš kanoninio source.

Žr. Programos diegimas pagal promptą ir Programos diegimas dėl tų pačių persistence ir promotion ribų.

Numatytieji testaiVM valdymas