@optima-chat/optima-agent 0.8.8 → 0.8.10
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: review
|
|
3
|
-
description: Review management and
|
|
3
|
+
description: Review management, moderation, and AI review generation. View, approve, reject, and respond to customer reviews. Handle featured reviews, reports, and settings. Generate AI reviews for products. Use when user needs to moderate reviews, respond to feedback, manage review reports, configure auto-approval, view review statistics, or generate AI reviews.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Commerce CLI - Review Management
|
|
@@ -18,6 +18,10 @@ description: Review management and moderation. View, approve, reject, and respon
|
|
|
18
18
|
- "查看举报" → `commerce review reports --status pending`
|
|
19
19
|
- "查看评价设置" → `commerce review get-settings`
|
|
20
20
|
- "开启自动审核" → `commerce review update-settings --auto-approve`
|
|
21
|
+
- "生成评价" / "给商品刷评价" → `commerce review generate`
|
|
22
|
+
- "创建一条评价" → `commerce review create`
|
|
23
|
+
- "给产品生成5条评价" → 先 `commerce product get` 了解产品 → 再 `commerce review generate`
|
|
24
|
+
- "查看AI评价" → `commerce review list --ai-generated`
|
|
21
25
|
|
|
22
26
|
### 场景决策表
|
|
23
27
|
|
|
@@ -31,6 +35,7 @@ description: Review management and moderation. View, approve, reject, and respon
|
|
|
31
35
|
| 查看统计 | `review stats` | 监控平均分和评分分布趋势 |
|
|
32
36
|
| 查看设置 | `review get-settings` | 了解当前自动审核等配置 |
|
|
33
37
|
| 开启自动审核 | `review update-settings --auto-approve` | 所有评价自动通过 |
|
|
38
|
+
| AI 生成评价 | `review generate --product-id xxx --reviews '[...]' --spread-days 30` | 先查产品信息，自然评分分布，混合风格 |
|
|
34
39
|
|
|
35
40
|
### 标准评价管理流程
|
|
36
41
|
1. **每日审核** - `commerce review list --status pending` 查看待审核
|
|
@@ -47,6 +52,66 @@ description: Review management and moderation. View, approve, reject, and respon
|
|
|
47
52
|
4. **回复评价** - `commerce review respond` 真诚道歉并提出解决方案
|
|
48
53
|
5. **跟进改进** - 记录问题，优化产品或服务
|
|
49
54
|
|
|
55
|
+
### AI 评价生成流程
|
|
56
|
+
1. **了解产品** - `commerce product get --id prod_xxx` 获取产品名称、描述、卖点
|
|
57
|
+
2. **构思评价** - 根据产品特点构思多样化评价（不同评分、角度、风格、买家名字）
|
|
58
|
+
3. **批量提交** - `commerce review generate` 一次提交所有评价，自动分散时间
|
|
59
|
+
|
|
60
|
+
**单条创建示例：**
|
|
61
|
+
```bash
|
|
62
|
+
commerce review create \
|
|
63
|
+
--product-id prod_123 \
|
|
64
|
+
--rating 5 \
|
|
65
|
+
--title "品质出色" \
|
|
66
|
+
--content "收到后非常满意，做工精细，材质很好，值得推荐！" \
|
|
67
|
+
--customer-name "张明" \
|
|
68
|
+
--ai-generated --verified
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
**批量生成示例（推荐）：**
|
|
72
|
+
```bash
|
|
73
|
+
# 全部标记为已验证购买
|
|
74
|
+
commerce review generate \
|
|
75
|
+
--product-id prod_123 \
|
|
76
|
+
--spread-days 30 \
|
|
77
|
+
--verified \
|
|
78
|
+
--reviews '[
|
|
79
|
+
{"rating":5,"title":"品质出色","content":"收到后非常满意，做工精细，材质很好，值得推荐给朋友！","customer_name":"张明"},
|
|
80
|
+
{"rating":4,"title":"性价比高","content":"整体不错，这个价位能买到这样的质量很满意。包装也很用心。","customer_name":"李华"},
|
|
81
|
+
{"rating":5,"title":"超出预期","content":"比想象中好很多！细节处理得很到位，能看出品牌的用心。已经推荐给同事了。","customer_name":"王芳"},
|
|
82
|
+
{"rating":4,"title":"物流很快","content":"下单第二天就到了，包装完好无损。产品本身也挺好用的，会回购。","customer_name":"陈磊"},
|
|
83
|
+
{"rating":3,"title":"还行吧","content":"一般般，没有特别惊艳但也没什么问题，中规中矩的产品。","customer_name":"赵静"}
|
|
84
|
+
]'
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
## AI 评价质量指标
|
|
88
|
+
|
|
89
|
+
生成 AI 评价时，必须遵循以下质量标准：
|
|
90
|
+
|
|
91
|
+
| 维度 | 标准 |
|
|
92
|
+
|------|------|
|
|
93
|
+
| 评分分布 | 自然分布：5星 60%、4星 30%、3星 10%，避免全5星 |
|
|
94
|
+
| 内容多样性 | 每条评价角度不同（材质、外观、使用体验、性价比、物流、包装等） |
|
|
95
|
+
| 风格多样性 | 混合专业型、口语型、简短型、详细型 |
|
|
96
|
+
| 名字真实性 | 使用目标市场常见姓名，避免重复 |
|
|
97
|
+
| 长度适中 | 50-200 字，避免过短或过长 |
|
|
98
|
+
| 语言一致 | 评价语言与店铺目标市场一致 |
|
|
99
|
+
| 已购买比例 | 建议 60-80% 标记为已验证购买（`--verified`），提升可信度 |
|
|
100
|
+
| 时间分散 | 使用 `--spread-days` 分散评价时间，默认 30 天 |
|
|
101
|
+
|
|
102
|
+
## AI 评价风格模板
|
|
103
|
+
|
|
104
|
+
每次批量生成时混合使用不同风格，使评价看起来来自不同用户：
|
|
105
|
+
|
|
106
|
+
- **专业型**: 客观描述产品特点和功能，用词准确，适合电子产品、工具类
|
|
107
|
+
> 例："这款蓝牙耳机的降噪效果令人印象深刻，续航实测达到标称的8小时，佩戴舒适度也很好。"
|
|
108
|
+
- **口语型**: 像真实买家的日常用语，带有个人情感，适合服饰、日用品
|
|
109
|
+
> 例："哇真的好好看！颜色跟图片一模一样，穿上特别显瘦，闺蜜都问我在哪买的～"
|
|
110
|
+
- **简短型**: 1-2 句话 + 评分，模拟快速评价
|
|
111
|
+
> 例："质量不错，好评。"
|
|
112
|
+
- **详细型**: 多角度描述使用体验，150-200 字，提供丰富参考
|
|
113
|
+
> 例："用了一周来评价。首先包装很精致，打开就能感觉到品质。实际使用中，XX功能非常实用，解决了我之前YY的困扰。唯一小遗憾是ZZ方面还有提升空间，但整体性价比很高，推荐购买。"
|
|
114
|
+
|
|
50
115
|
## 卓越标准
|
|
51
116
|
|
|
52
117
|
### 评价管理质量指标
|
|
@@ -98,6 +163,25 @@ commerce review respond --id review_123 --content "非常抱歉给您带来了
|
|
|
98
163
|
- **恶意竞争** → 多个可疑评价来自同一IP则删除
|
|
99
164
|
- **真实差评** → 即使被举报也不应删除，驳回举报
|
|
100
165
|
|
|
166
|
+
### AI 评价生成错误
|
|
167
|
+
|
|
168
|
+
❌ **错误做法 - 全部5星、内容雷同**：
|
|
169
|
+
```bash
|
|
170
|
+
# 所有评价都是5星，内容模板化，一看就是假的
|
|
171
|
+
commerce review generate --product-id prod_123 --reviews '[
|
|
172
|
+
{"rating":5,"title":"很好","content":"很好很满意","customer_name":"用户A"},
|
|
173
|
+
{"rating":5,"title":"不错","content":"很好很满意","customer_name":"用户B"},
|
|
174
|
+
{"rating":5,"title":"好评","content":"很好很满意","customer_name":"用户C"}
|
|
175
|
+
]'
|
|
176
|
+
```
|
|
177
|
+
|
|
178
|
+
✅ **正确做法 - 多样化评分、内容、风格**：
|
|
179
|
+
- 评分分布自然（5星60%、4星30%、3星10%）
|
|
180
|
+
- 每条评价从不同角度评价（材质、外观、使用感受、物流等）
|
|
181
|
+
- 混合不同风格（专业、口语、简短、详细）
|
|
182
|
+
- 使用真实感的姓名，不重复
|
|
183
|
+
- 先 `product get` 了解产品卖点再构思
|
|
184
|
+
|
|
101
185
|
## 命令参考
|
|
102
186
|
|
|
103
187
|
### 评价查看
|
|
@@ -120,6 +204,10 @@ commerce review respond --id review_123 --content "非常抱歉给您带来了
|
|
|
120
204
|
- `commerce review reports` - 查看举报
|
|
121
205
|
- `commerce review handle-report` - 处理举报
|
|
122
206
|
|
|
207
|
+
### AI 评价生成
|
|
208
|
+
- `commerce review create` - 创建单条评价（商家/AI）
|
|
209
|
+
- `commerce review generate` - 批量生成评价（推荐，支持时间分散）
|
|
210
|
+
|
|
123
211
|
### 评价设置
|
|
124
212
|
- `commerce review get-settings` - 查看评价设置
|
|
125
213
|
- `commerce review update-settings` - 更新评价设置
|