speak-sdk-patterns

Skill zawiera production-ready wzorce dla API Speak do nauki języków obcych. Znajdziesz tu implementacje sesji konwersacyjnych, oceny wymowy, przetwarzania audio i operacji wsadowych. Użyj go podczas wdrażania integracji Speak, refaktoryzacji kodu SDK lub ustalania standardów kodowania dla zespołu pracującego nad funkcjami nauczania języków. Wymaga ukończonego setup'u z speak-install-auth i zainstalowanego ffmpeg.

1. Upewnij się, że masz ukończony setup autentykacji z skill'u speak-install-auth oraz ważne poświadczenia API skonfigurowane w swoim środowisku.

2. Zainstaluj ffmpeg na swoim systemie — jest wymagany do przetwarzania plików audio przed wysłaniem do API Speak.

3. Zaimportuj wzorzec ConversationManager do swojego projektu TypeScript lub Python. Klasa zarządza sesją konwersacyjną, przechowując informacje o turach, czasie rozpoczęcia i języku nauki.

4. Aby rozpocząć lekcję, wywołaj metodę startLesson() z parametrami: język docelowy, scenariusz konwersacji i poziom zaawansowania. Metoda zwróci identyfikator sesji, który będziesz używać w kolejnych krokach.

5. Dla każdej odpowiedzi użytkownika wywołaj submitResponse() z identyfikatorem sesji i ścieżką do pliku audio. Skill automatycznie prześle audio do API, otrzyma ocenę wymowy i zwróci wynik turny.

6. Po zakończeniu lekcji użyj endAndReport() aby zamknąć sesję i otrzymać podsumowanie z czasem trwania, liczbą tur i średnią oceną wymowy.