rjb
90f3103de3
Some checks failed
Flask 提示词大师 - CI/CD 流水线 / 代码质量检查 (push) Has been cancelled
Flask 提示词大师 - CI/CD 流水线 / 单元测试 (push) Has been cancelled
Flask 提示词大师 - CI/CD 流水线 / 集成测试 (push) Has been cancelled
Flask 提示词大师 - CI/CD 流水线 / 构建Docker镜像 (push) Has been cancelled
Flask 提示词大师 - CI/CD 流水线 / 部署到测试环境 (push) Has been cancelled
Flask 提示词大师 - CI/CD 流水线 / 部署到生产环境 (push) Has been cancelled
Flask 提示词大师 - CI/CD 流水线 / 部署监控系统 (push) Has been cancelled
109 lines
2.2 KiB
Markdown
109 lines
2.2 KiB
Markdown
# 智能提示词优化3号专家 - 对外接口文档
|
||
|
||
供 Android 等外部应用调用的 REST API。
|
||
|
||
## 接口地址
|
||
|
||
```
|
||
POST http://101.43.95.130:5002/api/open/expert-generate-3
|
||
```
|
||
|
||
## 请求
|
||
|
||
- **Method**: POST
|
||
- **Content-Type**: application/json
|
||
|
||
### 请求体参数
|
||
|
||
| 参数 | 类型 | 必填 | 说明 |
|
||
|------|------|------|------|
|
||
| input_text | string | 是 | 用户需求描述 |
|
||
| temperature | number | 否 | 生成随机性，0-2，默认 0.7 |
|
||
| max_tokens | int | 否 | 最大生成 token 数，100-4000，默认 1000 |
|
||
| timeout | int | 否 | 超时时间（秒），10-300，默认 60 |
|
||
| uid | int | 否 | 用户ID，用于历史记录归属，不传则使用默认用户 |
|
||
|
||
### 示例
|
||
|
||
```json
|
||
{
|
||
"input_text": "android内存溢出分析",
|
||
"temperature": 0.7,
|
||
"max_tokens": 1000,
|
||
"timeout": 60,
|
||
"uid": 1
|
||
}
|
||
```
|
||
|
||
## 响应
|
||
|
||
### 成功 (code=200)
|
||
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"message": "success",
|
||
"data": {
|
||
"intent_analysis": {
|
||
"core_intent": "技术",
|
||
"domain": "xxx",
|
||
"key_requirements": ["..."],
|
||
"expected_output": "...",
|
||
"constraints": ["..."]
|
||
},
|
||
"generated_prompt": "生成的完整提示词文本"
|
||
}
|
||
}
|
||
```
|
||
|
||
### 失败
|
||
|
||
```json
|
||
{
|
||
"code": 400,
|
||
"message": "错误描述",
|
||
"data": null
|
||
}
|
||
```
|
||
|
||
常见 code：400 参数错误，429 重复提交，500 服务器错误。
|
||
|
||
## Android 调用示例 (Kotlin + Retrofit)
|
||
|
||
```kotlin
|
||
// 请求体
|
||
data class ExpertGenerate3Request(
|
||
val input_text: String,
|
||
val temperature: Float? = 0.7f,
|
||
val max_tokens: Int? = 1000,
|
||
val timeout: Int? = 60,
|
||
val uid: Int? = null
|
||
)
|
||
|
||
// 响应体
|
||
data class ExpertGenerate3Response(
|
||
val code: Int,
|
||
val message: String,
|
||
val data: Data?
|
||
)
|
||
data class Data(
|
||
val intent_analysis: IntentAnalysis,
|
||
val generated_prompt: String
|
||
)
|
||
|
||
// 使用
|
||
val api = Retrofit.Builder()
|
||
.baseUrl("http://101.43.95.130:5002/")
|
||
.addConverterFactory(GsonConverterFactory.create())
|
||
.build()
|
||
.create(YourApi::class.java)
|
||
|
||
api.expertGenerate3(ExpertGenerate3Request(input_text = "android内存溢出分析"))
|
||
```
|
||
|
||
## 注意事项
|
||
|
||
- 项目已启用 CORS，支持跨域调用
|
||
- 对外接口不做 8 秒内重复提交校验，由客户端自行控制
|
||
- 建议在客户端增加防重复点击、超时重试等逻辑
|