155 lines
2.9 KiB
Markdown
155 lines
2.9 KiB
Markdown
# 🚀 5分钟快速开始 - 使用免费API
|
||
|
||
## 步骤1: 获取免费API Key (2分钟)
|
||
|
||
### 方式1: 硅基流动 (推荐) ⭐
|
||
|
||
1. 访问: https://cloud.siliconflow.cn
|
||
2. 点击"免费注册"
|
||
3. 使用微信或手机号注册
|
||
4. 进入控制台 → API密钥
|
||
5. 点击"创建新密钥"
|
||
6. 复制密钥（格式: `sk-xxxxxx`）
|
||
|
||
**免费额度**: 每月免费Token，足够测试使用！
|
||
|
||
### 方式2: DeepSeek (备选)
|
||
|
||
1. 访问: https://platform.deepseek.com
|
||
2. 注册账号
|
||
3. 充值10元（可用很久）
|
||
4. 获取API Key
|
||
|
||
## 步骤2: 配置API Key (1分钟)
|
||
|
||
打开文件: `ry-xinli-admin/src/main/resources/application.yml`
|
||
|
||
找到这一行：
|
||
```yaml
|
||
api-key: sk-your-api-key-here
|
||
```
|
||
|
||
替换为你的API Key：
|
||
```yaml
|
||
api-key: sk-abcdefghijklmnopqrstuvwxyz123456
|
||
```
|
||
|
||
**完整配置示例**:
|
||
```yaml
|
||
rag:
|
||
mode: openai
|
||
openai:
|
||
base-url: https://api.siliconflow.cn/v1
|
||
api-key: sk-你的密钥 # ⚠️ 修改这里
|
||
embed-model: BAAI/bge-large-zh-v1.5
|
||
generate-model: deepseek-ai/DeepSeek-V3
|
||
```
|
||
|
||
## 步骤3: 启动应用 (2分钟)
|
||
|
||
```bash
|
||
cd ry-xinli-admin
|
||
mvn spring-boot:run
|
||
```
|
||
|
||
等待启动完成，看到：
|
||
```
|
||
Started XinliAdminApplication in X seconds
|
||
```
|
||
|
||
## 步骤4: 测试功能 (1分钟)
|
||
|
||
### 测试1: 健康检查
|
||
|
||
浏览器访问:
|
||
```
|
||
http://localhost:8080/psychology/rag-test/health
|
||
```
|
||
|
||
应该看到：
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"data": {
|
||
"overall_status": "HEALTHY"
|
||
}
|
||
}
|
||
```
|
||
|
||
### 测试2: 向量化测试
|
||
|
||
```bash
|
||
curl -X POST "http://localhost:8080/psychology/rag-test/test-embedding" \
|
||
-d "text=测试文本"
|
||
```
|
||
|
||
### 测试3: 文本生成测试
|
||
|
||
```bash
|
||
curl -X POST "http://localhost:8080/psychology/rag-test/test-generation" \
|
||
-d "prompt=什么是心理学？"
|
||
```
|
||
|
||
## ✅ 完成！
|
||
|
||
现在你可以：
|
||
|
||
1. **上传文档**: 通过API上传心理学文档
|
||
2. **智能问答**: 基于知识库回答问题
|
||
3. **生成报告**: 生成AI增强的心理评估报告
|
||
|
||
## 📚 下一步
|
||
|
||
- 查看完整API文档: `RAG-API-EXAMPLES.md`
|
||
- 了解更多免费服务: `RAG-FREE-SERVICES-GUIDE.md`
|
||
- 开发前端页面: 参考API示例
|
||
|
||
## ❓ 遇到问题？
|
||
|
||
### 问题1: API Key无效
|
||
|
||
**错误**: `401 Unauthorized`
|
||
|
||
**解决**:
|
||
1. 检查API Key是否正确复制
|
||
2. 确认没有多余的空格
|
||
3. 确认API Key以`sk-`开头
|
||
|
||
### 问题2: 连接超时
|
||
|
||
**错误**: `Connection timeout`
|
||
|
||
**解决**:
|
||
1. 检查网络连接
|
||
2. 确认可以访问 https://api.siliconflow.cn
|
||
3. 尝试使用VPN（如果在特殊网络环境）
|
||
|
||
### 问题3: 免费额度用完
|
||
|
||
**解决**:
|
||
1. 等待下月刷新
|
||
2. 充值少量金额（通常几元即可）
|
||
3. 切换到其他免费服务
|
||
|
||
## 💡 省钱小技巧
|
||
|
||
1. **减少检索数量**:
|
||
```yaml
|
||
retrieval:
|
||
top-k: 3 # 默认5，改为3
|
||
```
|
||
|
||
2. **使用更小的模型**:
|
||
```yaml
|
||
generate-model: Qwen/Qwen2.5-7B-Instruct # 更快更便宜
|
||
```
|
||
|
||
3. **提高相似度阈值**:
|
||
```yaml
|
||
similarity-threshold: 0.75 # 默认0.7，提高到0.75
|
||
```
|
||
|
||
---
|
||
|
||
**需要帮助？** 查看详细文档: `RAG-FREE-SERVICES-GUIDE.md`
|