Voice Iterate Widget (eelvaade)

Hoidlas on mandatav Web Component, mis salvestab sisestatud või brauseris transkribeeritud juhise, saadab selle teile kuuluvale OpenFactory rakendusele ja küsib seotud repair ticket olekut. Integratsioon on ainult eelvaates.

Paketi source kood on OpenFactory monorepo kaustas tools/voice-iterate. Ärge eeldage, et @openfactory/voice-iterate või selle CDN bundle on avalikult avaldatud; ehitage ja kinnitage hoidlast üle vaadatud artefakt, kuni release pole package registrys selgelt kirjas.

Praegune piir

Endpoint võtab vastu juhise rakendusele Git source’iga ja käivitab ühise repair workflow. Stage 0 muudab juurutatud sandbox koopiat ja võib seda preview uuesti juurutada. See ei garanteeri, et muudatus commit’takse upstream hoidlasse. Ticket märgitud done tõestab ainult salvestatud agent task tulemust; vaadake tulemus üle ja kontrollige rakendust ise.

Teenus lubab ühe rakenduse kohta korraga kõige rohkem kaks pooleliolevat iteratsiooni. Täiendavad päringud tagastavad 429, kuni ticket jõuab lõpliku olekuseni.

Eeltingimused

• Teile kuuluv OpenFactory rakendus koos source.git_url.
• Päris konto; külaliste sessioonid ei saa autonoomseid code edit käivitada.
• of_mcp_ account key serveris, mitte brauseri JavaScriptis.
• HTTPS või localhost development origin, kui kasutatakse mikrofoni sisendit.

Ehitada widget allikast

Monorepo:

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

Kaasake saadud versioonitud bundle või installige oma kontrollitud registryst. Salvestage source commit ja checksum, mida teie rakendus kasutab.

Kasutada same-origin proxy

Brauserile suunatud widget kutsub:

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

Teie server peaks kinnitama sihtrakenduse ID ja edastama need päringud:

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

Lisage Authorization: Bearer <of_mcp_key> ainult serveris. Autentige ja piirake oma proxy kasutajaid; muidu võib iga marsruudini jõudnud külastaja kulutada teie konto volitusi kinnitatud rakenduse muudatustele. Lubage ainult need kolm teed ja kaks ülaltoodud meetodit, rakendage request suuruse piire ja ärge edastage suvalisi header’eid ega app ID-sid.

Ühendage kohalikult ehitatud moodul proxy endpointiga:

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 selle stiilid töötavad Shadow DOM-is. Vaikimisi text fallback jääb kasutatavaks, kui brauseri speech recognition pole saadaval. Brauseri speech teenused ja privaatsuskäitumine erinevad brauseri ja juurutuse järgi; küsige nõusolekut ja testige täpset toetatud brauserite hulka. OpenFactory saab sellel teel teksti, samas võib brauser või seadistatud speech teenus töödelda heli eraldi.

Vastuvõtutest

1. Esitage kahjutu, tagasipööratav muudatus mitte tootmisrakenduse vastu.
2. Kinnitage, et proxy ei saa sihtida teist rakendust ja lükkab tagasi autentimata kutseid.
3. Jälgige queued/working kuni lõpliku done, failed, lost või stale olekuni.
4. Kontrollige task result ja preview käsitsi.
5. Kinnitage, et upstream Git hoidla on muutmata, välja arvatud juhul, kui eraldi üle vaadatud source-persistence workflow teatab commit’ist või pull request’ist.
6. Taastage või ehitage sandbox uuesti kanonilisest source’ist.

Vt Promptiga abistatud rakenduse juurutamine ja Rakenduse juurutamine samade persistence ja promotion piiride kohta.