用途:实现 AI 对话练习功能,构建 AI 语言导师,围绕场景进行口语与文本练习并获取实时反馈。
主要能力:通过 @speak/language-sdk 的 SpeakClient 启动会话(startConversation),可指定 scenario、language、level、nativeLanguage、maxTurns 与 feedbackDetail(word 或 phoneme);用 sendTurn 提交音频或文本,返回导师回复、0-100 发音评分、语法纠正与词汇注释;用 endSession 获取会话摘要(平均发音分、语法准确率、新词、时长)。支持多主题连续练习与进度报告。场景涵盖日常、旅行、餐饮、商务、社交等类别。
使用方式:需先完成 speak-install-auth 配置并具备有效 API 凭据与音频处理能力。示例:const client = new SpeakClient({ apiKey: process.env.SPEAK_API_KEY!, appId: process.env.SPEAK_APP_ID!, language: 'es' }); 再调用 client.startConversation({ scenario: 'ordering-food', language: 'es', level: 'intermediate', nativeLanguage: 'en', maxTurns: 10, feedbackDetail: 'phoneme' })。提交文本会跳过发音评分。
限制与错误处理:会话超 30 分钟自动结束;音频需为 WAV 16kHz 单声道;API 延迟可设 10 秒超时重试;音频质量差需重录。发音训练可参考 speak-core-workflow-b。具体收费与平台支持暂未提供。