laybot/ai-sdk

LayBot LingTeach AI PHP SDK

v1.0.2 2025-07-07 04:21 UTC

This package is auto-updated.

Last update: 2025-07-07 05:31:55 UTC


README

教育智能中枢引擎 · 为教学场景深度优化
Powered by LayBot LingTeach AI | 官网 https://ai.laybot.cn

LayBot® Certified Packagist License PHP GDPR K12

LayBot 灵语智教 是一套专为 分层教学支持、课堂教学、作业批改、教研创作、动态Q&A 打磨的 AI 引擎。
本 SDK 以 OpenAI 完全兼容的调用方式,一键接入 灵语智教 教育核心模型矩阵,自动完成计费与合规审计,让开发者专注教学业务本身。

⚡ Webman 专享 · 真·思维链流式

  • 本 SDK 内置 自动流式驱动检测
    Webman / Workerman 进程 → AsyncTcpConnection,毫秒级逐 token 推流,对于Webman框架在AI流式输出提速更友好;
    在 Laravel / ThinkPHP / 其他 FPM 环境 → Guzzle Stream,零依赖零配置。
  • 告别“整段再返”,实时展示思维链。
  • 本 SDK 默认为LayBot专属模型调用,同时也支持使用本SDK的能力直接面向DeepSeek,OpenAI这些大模型api调用场景

✨ 为什么选择 LayBot 灵语智教?

功能 价值
🛰️ 流式 SSE stream:true 即获毫秒级增量反馈
🛡️ 企业级安全 API-Key / IP 白名单、余额预扣、敏感词脱敏
💰 成本透明 按教育任务颗粒度计费,Credit 明细实时可查
🧠 教学深度适配 预置 K12/高教/国际课程专用推理参数
🚀 智能分层教学 动态生成梯度化习题(基础→拓展→竞赛)
✍️ 作业批改引擎 支持数学公式/图文混排版面解析(LB-Aethel)
🌐 国际课程适配 A-Level/AP/IB成绩单智能分析+选课推荐
📝 教研创作加速 3秒生成考点明确的试卷(支持LaTeX输出)
🛡️ 教育合规保障 内置K12内容过滤+GDPR合规审计

📚 旗舰教育智能模型(节选)

教育场景 解决方案 模型推荐 模型代号 核心优势
口语评测 实时发音打分+口语表达能力分析 灵语·语韵 LB-Phona 毫秒级语音识别+精准发音纠错,定制化口语评测方案,适配K12与成人口语训练场景
能力素养测评 综合素养分析+成长路径建议 灵语·慧学 LB-Skillwise 多维度素质能力测评,自动生成个性化成长建议,覆盖学科+创新+综合素质等模块
K12分层教学 动态梯度习题生成 明心·洞玄 LB-Insight 中英双语分层训练 → 5分钟生成千人千面习题,智能匹配学力水平
智能组卷批改 图文混排试卷生成+批改 灵语·玄穹 LB-Aethel 数学公式/图文解析 → 精准识别手写解题步骤,自动生成错题本
学业诊断 成绩单分析+薄弱点定位 灵语·太初 LB-Primordius 多步链式解题 → 深度追踪思维漏洞,提供针对性补强方案
跨学科教学 学科知识串联教学 灵语·寰宇 LB-Cosmos 高中/大学跨学科推理 → 打破学科壁垒,构建知识网络图谱

完整模型列表与价格,请参考控制台「模型与价格」页。所有模型均针对教学场景深度优化,支持 K12/高教/国际课程等全学段教育需求。

📦 安装

composer require laybot/ai-sdk

🏃‍♂️ 快速上手

🧩 与 LayBot 前端框架深度集成

若您使用 LayBot MPA/SPA 前端框架(发明专利申请号:2025108367676),可无缝嵌入 AI 组件:

<laybot-ai-chat
        model="LB-Cosmos"
        api-key="sk-live-xxxxxxxx"
        prompt="用高中难度讲解牛顿第二定律"
>
    <!-- 组件自动处理流式输出 -->
</laybot-ai-chat>
<?php
// 课堂教学场景:动态分层讲解
$chat->completions([
    'model' => 'LB-Cosmos',
    'messages' => [
        ['role' => 'user', 'content' => '为初二学生讲解浮力定律']
    ],
    'edu_features' => [
        'difficulty' => 'middle_school', // K12学段适配
        'tiered' => true  // 启用分层教学(自动生成基础+拓展内容)
    ]
]);
// 作业批改场景:数学图文解析
$chat->completions([
    'model' => 'LB-Aethel',
    'messages' => [
        ['role' => 'user', 'content' => file_get_contents('math_homework.jpg')]
    ],
    'task_type' => 'grading' // 激活批改模式
]);
<?php
require 'vendor/autoload.php';

use Laybot\Chat;

/** 初始化(支持 PSR-18 容器内全局共享) */
$chat = new Chat('sk-live-xxxxxxxx');

/** 流式课堂问答 */
$chat->completions([
    'model'    => 'LB-Cosmos',
    'stream'   => true,
    'messages' => [
        ['role'=>'user','content'=>'请用高中难度讲解牛顿第二定律']
    ]
],[
    'stream'   => fn($chunk,$done) => print $done
                                   ? PHP_EOL
                                   : ($chunk['choices'][0]['delta']['content'] ?? ''),
    'complete' => fn($json)        => print_r($json)
]);

✨ 教育专属能力一览

能力 典型场景 对应端点
Smart Chat 课堂 Q&A / 知识点讲解 /v1/chat
Doc Parser 课件|试卷 → 结构化文本 /v1/doc
Essay Grader 作文评分、润色 /v1/chat + rubric 模板
Item Generator 习题 / 试卷批量生成 /v1/chat batch 模式
Vision QA 图片实验报告解析 /v1/chat + image-in

⛑️ 常见错误码

code http 描述
40101 401 API_KEY_INVALID — Key 不存在或禁用
40200 402 INSUFFICIENT_CREDIT — 余额不足
42900 429 RATE_LIMITED — 触发限流
50000 500 INTERNAL_ERROR — 平台内部异常

完整列表见文档 https://ai.laybot.cn/docs/errors

🔧 高级用法

// 自定义超时 / 代理
$chat = new Laybot\Chat([
    'apikey' => 'sk-xxx',
    'base'   => 'https://api.laybot.cn',
    'guzzle' => ['timeout'=>30,'proxy'=>'http://127.0.0.1:7890']
]);

🚀 路线图

  • Embed / Audio / Vision 端点
  • WebSocket 多轮上下文通道
  • SDK 自动指数退避重试
  • Webman & Thinkphp & Laravel & Yii ServiceProvider

🤝 参与贡献

PR / Issue 欢迎提交!
代码规范:PSR-12 + PHPStan 8 + PHPUnit。

composer run test   # 运行完整单测

📜 知识产权与专利保护

1. SDK 许可证

本项目采用 Apache License 2.0,核心保障:

  • ✅ 允许商业闭源使用
  • ✅ 明确专利授权
  • ✅ 防御性专利终止条款

📄 License

Apache-2.0 © 2025 LayBot Inc. – LayBot LingTeach AI