音声反復ウィジェット (プレビュー)
リポジトリには、入力された、または ブラウザで転写された指示を所有する OpenFactory アプリに送信し、 結果として得られる修復チケットをポーリングします。統合はプレビューのみです。
パッケージのソースは OpenFactory モノリポジトリの tools/voice-iterate にあります。する
@openfactory/voice-iterate またはその CDN バンドルが公的に公開されているとは想定しません。
リリースが完了するまで、レビュー済みのアーティファクトをリポジトリからビルドして固定します。
パッケージレジストリに明示的にリストされています。
現在の境界
エンドポイントは、Git ソースを持つアプリの命令を受け入れ、ディスパッチします
共有修復ワークフロー。 Stage 0 は、デプロイされたサンドボックスのコピーを変更し、
そのプレビューを再展開します。変更がコミットされることを保証するものではありません
上流のリポジトリ。 done とマークされたチケットは、記録された代理人のみを証明します
タスクの結果。その結果を確認し、アプリを自分で検証してください。
このサービスでは、アプリごとに最大 2 回の実行中の反復が許可されます。追加
チケットが終了状態に達するまで、リクエストは 429 を返します。
前提条件
source.git_urlを備えた所有の OpenFactory アプリ。- 本物のアカウント;ゲスト セッションは自律的なコード編集をディスパッチできません。
of_mcp_アカウント キーはサーバー上に保持され、ブラウザ JavaScript には決して保存されません。- マイク入力が使用されている場合は、HTTPS またはローカルホスト開発オリジン。
ソースからウィジェットを構築する
モノレポから:
cd tools/voice-iterate
npm ci
npm test
npm run lint
npm run build結果として得られるバージョン管理されたバンドルをベンダーに提供するか、独自に管理するバンドルからインストールします。 レジストリ。アプリケーションで使用されるソース コミットとチェックサムを記録します。
同一オリジンプロキシを使用する
ブラウザ向けウィジェットは以下を呼び出します。
POST {endpoint}/iterate
GET {endpoint}/agent-status
GET {endpoint}/agent-status?thread_id={thread_id}サーバーはターゲット アプリ ID を固定し、それらのリクエストを以下に転送する必要があります。
POST https://console.openfactory.tech/api/apps/{APP_ID}/iterate
GET https://console.openfactory.tech/api/apps/{APP_ID}/agent-statusAuthorization: Bearer <of_mcp_key> をサーバー上にのみ接続します。認証する
独自のプロキシ ユーザーのレート制限を行います。それ以外の場合は、すべての訪問者が
ルートは、固定されたアプリへの変更にアカウントの権限を費やすことができます。許可する
上記の 3 つのパスと 2 つのメソッドのみがリクエスト サイズ制限を強制し、
任意のヘッダーやアプリ ID を転送しないでください。
プロキシ エンドポイントを使用して、ローカルに構築されたモジュールをマウントします。
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);
},
});カスタム要素とそのスタイルは Shadow DOM で実行されます。デフォルトのテキスト ブラウザの音声認識が利用できない場合でも、フォールバックは引き続き使用できます。 ブラウザの音声サービスとプライバシーの動作は、ブラウザと展開によって異なります。 同意を得て、サポートされている正確なブラウザ セットをテストします。 OpenFactoryが受け取ります このパス上の結果のテキスト、ブラウザまたは設定された音声 サービスは音声を個別に処理する場合があります。
受け入れテスト
- 非運用アプリに対して無害で元に戻せる変更を送信します。
- プロキシが他のアプリをターゲットにできず、未認証の呼び出し元を拒否することを確認します。
queued/workingから、終端状態のdone、failed、lost、またはstaleまでを観測します。- タスクの結果を検査し、手動でプレビューします。
- 別個の場合を除き、上流の Git リポジトリが変更されていないことを確認します。 レビューされたソース永続化ワークフローは、コミットまたはプル リクエストを報告します。
- 正規ソースからサンドボックスを元に戻すか再構築します。
Prompt-to-app agent および App deployment で、同じ永続性とプロモーションの境界を確認してください。