使用说明
Next.js学生数据与Thesys AI集成
该项目演示了学生数据API和Thesys AI之间的集成,提供了一个使用自然语言查询学生信息的智能界面。
特性
- 使用MockAPI实时集成学生数据
- 基于Thesys AI的自然语言处理
- 流式响应,提供更好的用户体验
- 使用CrayonAI的漂亮UI组件
- TypeScript用于类型安全
- 带有应用路由器的新式Next.js 15.2
先决条件
- Node.js 18+
- npm或纱线
- Thesys API密钥
环境变量
创建一个 .env.local 根目录中的文件,其中包含:
THESYS_API_KEY=your_thesys_api_key_here
安装
- 克隆存储库:
git clone <repository-url>
cd template-c1-component-next
- 安装依赖项:
npm install
- 运行开发服务器:
npm run dev
该应用程序将在 http://localhost:3000
项目结构
template-c1-component-next/
├── src/
│ ├── app/
│ │ ├── api/
│ │ │ ├── ask/ # Thesys AI integration
│ │ │ └── mcp/ # Student data integration
│ │ ├── components/ # React components
│ │ ├── helpers/ # Utility functions
│ │ └── hooks/ # Custom React hooks
├── public/ # Static assets
└── package.json # Project dependencies
API集成
该项目集成了两个主要的API:
-
学生数据API
- 端点:
https://68651dad5b5d8d03397fc50c.mockapi.io/details - 提供学生信息,包括:
- 名字
- 电子邮件
- 地址
- 国家
- 累计平均绩点
- 端点:
-
Thesys人工智能API
- 用于自然语言处理
- 提供对查询的智能响应
- 支持流式响应
使用示例
您可以使用自然语言查询学生数据。示例:
- 获取具体的学生详细信息:
What is Jeff Wolf's CGPA?
- 查找表现最佳的员工:
Show me all students with CGPA above 90
- 获取特定国家的数据:
List all students from Taiwan
组件
-
MCP服务器(
/api/mcp)- 处理数据集成
- 用上下文丰富提示
- 管理API通信
-
询问API(
/api/ask)- 处理自然语言查询
- 与Thesys AI集成
- 处理流媒体响应
-
UI组件
- 使用CrayonAI组件
- 响应式设计
- 实时更新
发展
运行测试
npx tsx src/app/test.ts
生产大楼
npm run build
贡献
- 分叉存储库
- 创建功能分支
- 提交您的更改
- 推到分支
- 创建拉取请求
许可证
此项目根据MIT许可证获得许可-有关详细信息,请参阅许可证文件。