Voice Iterate Widget (priekšskatījums)

Repozitorijā ir iegulstams Web Component, kas fiksē ierakstītu vai pārlūkā transkribētu norādījumu, iesniedz to jums piederošai OpenFactory lietotnei un aptaujā saistīto repair ticket. Integrācija ir tikai priekšskatījumam.

Pakotnes source kods atrodas OpenFactory monorepo mapē tools/voice-iterate. Neuzskatiet, ka @openfactory/voice-iterate vai tā CDN bundle ir publiski publicēts; uzbūvējiet un piesaistiet pārskatītu artefaktu no repozitorija, kamēr release nav skaidri ierakstīts package registry.

Pašreizējā robeža

Endpoint pieņem norādījumu lietotnei ar Git source un palaiž kopīgo repair workflow. Stage 0 maina izvietoto sandbox kopiju un var atkārtoti izvietot šo preview. Tas negarantē, ka izmaiņa tiks commit’ta upstream repozitorijā. Ticket atzīmēts ar done pierāda tikai ierakstīto agent task rezultātu; pārskatiet rezultātu un pārbaudiet lietotni paši.

Pakalpojums atļauj ne vairāk kā divas notiekošas iterācijas katrai lietotnei. Papildu pieprasījumi atgriež 429, kamēr ticket nesasniedz galīgo stāvokli.

Priekšnosacījumi

• Jums piederoša OpenFactory lietotne ar source.git_url.
• Īsta konts; viesu sesijas nevar palaist autonomus code edit.
• of_mcp_ account key glabāts serverī, ne pārlūka JavaScript.
• HTTPS vai localhost development origin, ja izmanto mikrofona ievadi.

Uzbūvēt widget no source

Monorepo:

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

Iekļaujiet iegūto versijuoto bundle vai instalējiet no sava kontrolētā registry. Fiksējiet source commit un checksum, ko izmanto jūsu lietotne.

Izmantot same-origin proxy

Pārlūkam paredzētais widget izsauc:

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

Jūsu serverim jāpiesaista mērķa lietotnes ID un jāpārsūta šie pieprasījumi uz:

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

Pievienojiet Authorization: Bearer <of_mcp_key> tikai serverī. Autentificējiet un ierobežojiet savus proxy lietotājus; pretējā gadījumā katrs apmeklētājs, kas var sasniegt maršrutu, var iztērēt jūsu konta pilnvaras izmaiņām piesaistītajā lietotnē. Atļaujiet tikai trīs ceļus un divas metodes augstāk, piemērojiet request izmēra limitus un nepārsūtiet patvaļīgus header vai app ID.

Pievienojiet lokāli uzbūvētu moduli ar 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 un tā stili darbojas Shadow DOM. Noklusējuma text fallback paliek lietojams, ja pārlūka speech recognition nav pieejama. Pārlūka speech pakalpojumi un privātuma uzvedība atšķiras pēc pārlūka un izvietojuma; iegūstiet piekrišanu un pārbaudiet precīzu atbalstīto pārlūku kopu. OpenFactory šajā ceļā saņem iegūto tekstu, kamēr pārlūks vai konfigurēts speech pakalpojums var apstrādāt audio atsevišķi.

Pieņemšanas tests

1. Iesniedziet nekaitīgu, atgriezenisku izmaiņu pret ne ražošanas lietotni.
2. Apstipriniet, ka proxy nevar mērķēt citu lietotni un noraida neautentificētus izsaucējus.
3. Vērojiet queued/working līdz galīgam done, failed, lost vai stale stāvoklim.
4. Pārbaudiet task result un preview manuāli.
5. Apstipriniet, ka upstream Git repozitorija nav mainījusies, ja vien atsevišķs, pārskatīts source-persistence workflow neziņo par commit vai pull request.
6. Atgrieziet vai pārbūvējiet sandbox no kanoniskā source.

Sk. Lietotnes izvietošana ar promptu un Lietotnes izvietošana par tām pašām persistence un promotion robežām.