openLesson 是一个以音频对话进行苏格拉底式提问的辅导系统,本技能让 AI 智能体通过 API 与之交互。核心用途是生成个性化学习计划(以有向图表示,每个节点为一次会话)、启动会话、分析音频中的推理缺口,并获取会话总结。
主要能力与端点:POST /api/agent/plan 传入 topic 和 days 生成学习计划;days 与会话数对应关系为 7 天 3-5 次、14 天 4-7 次、30 天(默认)5-10 次、60 天 8-14 次、90 天 10-18 次、180 天 15-25 次。POST /api/agent/session/start 传入 problem 与 plan_node_id 启动会话。POST /api/agent/session/analyze 传入 session_id、audio_base64、audio_format 分析音频,返回 gapScore、signals、transcript、followUpQuestion、requiresFollowUp。POST /api/agent/session/end 结束会话并生成总结。GET /api/agent/session/summary?session_id=xxx 获取已完成会话的总结报告。
使用方式:无需浏览器工具,只需 shell 工具(如 curl)。认证使用 Authorization: Bearer YOUR_API_KEY 头,API 密钥通过环境变量 OPENLESSON_API_KEY 提供,可在用户面板 /dashboard 生成。务必使用 https://www.openlesson.academy 进行 API 调用,openlesson.academy 域名的重定向会丢失 Authorization 头。
限制:平台仅支持音频,analyze 端点只接受音频、不接受文本,需先将语音转为 base64 编码音频,支持 webm、mp4、ogg 格式,发送文本会被拒绝。建议以 webm(优先 Opus 编解码器)录制,按 30-60 秒分块发送。若 requiresFollowUp 为 true 应追问后续问题,可用 gap 分数判断掌握程度。错误码含义:401 密钥无效或未激活,403 会话不属于该密钥,404 会话未找到,500 内部服务器错误。工作流为生成计划、启动首节点会话、录制并分析音频、直至掌握概念、结束会话获取总结、再进入下一节点。其他细节如收费、价格、平台支持范围资料未提供。