Ses Yineleme Widget’ı (Önizleme)

Depo, yazılan veya yazılan bir metni yakalayan gömülebilir bir Web Bileşeni içerir. tarayıcı tarafından yazılan talimat, bunu sahip olunan bir OpenFactory uygulamasına gönderir ve ortaya çıkan onarım biletini yoklar. Entegrasyon yalnızca önizleme amaçlıdır.

Paket kaynağı OpenFactory monorepo’sunda tools/voice-iterate konumundadır. Yap @openfactory/voice-iterate’in veya CDN paketinin herkese açık olarak yayınlandığını varsaymayın; bir sürüm çıkana kadar depodan incelenen bir yapıyı oluşturun ve sabitleyin Paket kayıt defterinde açıkça listelenmiştir.

Mevcut sınır

Uç nokta, Git kaynağına sahip bir uygulamaya yönelik talimatı kabul eder ve gönderir paylaşılan onarım iş akışı. Aşama 0, dağıtılan sanal alan kopyasını değiştirir ve bu önizlemeyi yeniden dağıtın. Değişikliğin taahhüt edildiğini garanti etmez. yukarı akış deposu. done işaretli bir bilet yalnızca kayıtlı acenteyi kanıtlar görev sonucu; sonucunu inceleyin ve uygulamayı kendiniz doğrulayın.

Hizmet, uygulama başına en fazla iki uçuş sırasında yinelemeye izin verir. Ek bir bilet terminal durumuna ulaşana kadar istekler 429 değerini döndürür.

Önkoşullar

• source.git_url ile sahip olunan bir OpenFactory uygulaması.
• Gerçek bir hesap; Konuk oturumları bağımsız kod düzenlemeleri gönderemez.
• of_mcp_ hesap anahtarı hiçbir zaman tarayıcı JavaScript’inde değil, sunucuda tutulur.
• Mikrofon girişi kullanılıyorsa HTTPS veya localhost geliştirme kaynağı.

Widget’ı kaynaktan oluşturun

Monorepo’dan:

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

Ortaya çıkan sürüm paketini satın alın veya kendi kontrollü sisteminizden yükleyin kayıt defteri. Uygulamanız tarafından kullanılan kaynak taahhüdünü ve sağlama toplamını kaydedin.

Aynı kaynaktan bir proxy kullanın

Tarayıcıya bakan widget şunları çağırır:

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

Sunucunuz hedef uygulama kimliğini sabitlemeli ve bu istekleri şu adrese iletmelidir:

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

Authorization: Bearer <of_mcp_key>’u yalnızca sunucuya ekleyin. Kimlik doğrulama ve kendi proxy kullanıcılarınızın oranını sınırlayın; aksi halde ulaşabilen her ziyaretçi rota, sabitlenmiş uygulamadaki değişiklikler için hesabınızın yetkisini harcayabilir. İzin ver yalnızca yukarıdaki üç yol ve iki yöntem, istek boyutu sınırlarını uygular ve rastgele başlıkları veya uygulama kimliklerini iletmeyin.

Yerel olarak oluşturulmuş modülü proxy uç noktasına bağlayın:

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

Özel öğe ve stilleri bir Gölge DOM’da çalışır. Varsayılan metin Tarayıcı konuşma tanıma kullanılamadığında geri dönüş kullanılabilir durumda kalır. Tarayıcı konuşma hizmetleri ve gizlilik davranışı, tarayıcıya ve dağıtıma göre değişiklik gösterir; Onay alın ve desteklenen tarayıcı setini tam olarak test edin. OpenFactory’nin aldığı tarayıcı veya yapılandırılmış bir konuşma sırasında ortaya çıkan metin bu yolda hizmet sesi ayrı olarak işleyebilir.

Kabul testi

1. Üretim dışı bir uygulamaya karşı zararsız, geri döndürülebilir bir değişiklik gönderin.
2. Proxy’nin başka bir uygulamayı hedefleyemediğini ve kimliği doğrulanmamış uygulamaları reddettiğini doğrulayın arayanlar.
3. queued/working’yi done, failed, lost veya lost terminalinden gözlemleyin stale durumu.
4. Görev sonucunu inceleyin ve manuel olarak önizleyin.
5. Ayrı bir durum olmadığı sürece yukarı akış Git deposunun değişmediğini doğrulayın, gözden geçirilen kaynak kalıcılığı iş akışı bir taahhüt veya çekme isteği bildirir.
6. Korumalı alanı standart kaynaktan geri alın veya yeniden oluşturun.

Uygulamaya yönlendirme aracısı’a bakın ve Aynı kalıcılık için Uygulama dağıtımı ve Promosyon sınırları.