This commit is contained in:
V-LiuShuang committed 2026-09-24 11:46:48 +08:00
1 parent 359991da19
commit fef74af253
12 files changed
+506 -509

No files matched your search

@@ -0,0 +1,40 @@
# 下发任务的工具使用说明
调用`creatOrSendTask`工具下发任务,请求参数取值规则:
- `requestBodyJson`:由调用侧提供。
- `creatorCode`:从上下文中获取。
- `fs`:没有特殊要求使用默认值false即可。
工具调用结果的处理:
- 调用成功,把响应结果展示给用户,用户需要记住`testTaskUuid`和`testTaskCode`。
- 调用失败,把响应结果展示给用户,友好的告知用户,下发任务工具调用失败,请您稍后再试。
**特别重要的事项:调用失败了,请不要重试,主动重试可能会带来糟糕的结果,除非用户主动要求。**
## 成功示例
```json
{
"code": "0",
"msg": "任务下发已提交,正在生成中",
"data": {
"testTaskUuid": "1234567890",
"offLineTestUnit": "",
"unWorkingTestUnit": "",
"testTaskCode": "TT20260923000001"
},
"ok": true
}
```
## 失败示例
```json
{
"code": "500",
"msg": "系统异常",
"ok": false
}
```
@@ -0,0 +1 @@
# 执行Preload测试文档
@@ -0,0 +1,23 @@
# 执行Stress任务文档
1. 如果用户提供了项目信息,先阅读[查项目信息文档](./query_project_info_doc.md),一步一步地获取`projectName`和`projectUuid`,如果没有的话就跳过。
2. 阅读[查测试机的文档](./query_test_device_doc.md)获取`deviceKey`和`deviceValue`。
3. 根据相应的[请求模板文件](#请求模板文件),**一字不改地生成**1个JSON字符串,再根据[变量表](#变量表)执行变量替换。
4. 阅读[下发任务文档](./create_task_doc.md),上一步生成的JSON字符串就是`requestBodyJson`参数。
## 请求模板文件
- [无项目下发](../example/stress_task_non_project_request.json)
- [根据项目下发](../example/stress_task_use_project_request.json)
## 变量表
JSON字符串中变量的格式示例:{id},根据取值规则查找并替换。
|变量名称|取值规则|
|---|---|
|id|随机生成1个由小写字母、数字组成的7位长度字符串(示例:2b43cb39)|
|projectName|调用工具获得的项目名称|
|projectUuid|调用工具获得的项目ID|
|deviceKey|调用工具获得的测试机ID|
|deviceValue|调用工具获得的测试机名称|
@@ -0,0 +1 @@
# 更新驱动文档
@@ -0,0 +1,47 @@
# 查项目信息文档
请先思考**上下文中是否包含项目信息?如果没有的话,请向用户询问项目名称/五码/项目别名**。
## 口语和变量的映射关系
|口语|变量名称|
|---|---|
|项目名称|projectName|
|五码|modelCode|
|项目别名|projectAlias|
|项目ID|projectUuid|
## 工作流程
1. 先[查项目基础信息](#查项目基础信息),收集**项目名称**。
2. 再用项目名称[查项目名称和项目ID](#查项目名称和项目ID)。
## 查项目基础信息
调用`debuggingProjectQuery`根据**项目名称**检索,查不到根据**五码**检索,仍然查不到根据**项目别名**检索。根据返回结果中的`rows`判定查询结果,有3种情况:
- 返回1条,查询成功。
- 返回0条或多条,**向用户询问更具体的项目信息,重新查询。**
- 返回错误信息,参考[错误信息处理](#错误信息处理)。
## 查项目名称和项目ID
调用`queryProjectNameList`工具,使用**项目名称**检索,响应结果是一个JSON数组,有4种情况:
- 返回1条结果,查询成功。
- 返回多条,把查询结果展示给用户,让用户选1条。
- 返回0条结果,视为查询失败,告知用户查不到项目名称和项目ID。
- 返回错误信息,参考[错误信息处理](#错误信息处理)。
## 错误信息处理
调用`debuggingProjectQuery`或`queryProjectNameList`工具遇到错误的响应示例:
```json
{
"code": 500,
"msg": "系统异常"
}
```
应对策略:友好的告知用户,因工具调用失败,请您稍后再试。**不要自行主动重试,除非用户主动要求。**
@@ -0,0 +1,2 @@
# 查测试机的文档