mirror of
https://github.com/silenceper/wechat.git
synced 2026-11-16 05:12:03 +08:00
feat: add aispeech dialog APIs (#887)
* feat: add aispeech dialog APIs * test: fix aispeech lint failures * test: satisfy aispeech interfacer lint
This commit is contained in:
1 parent
0e34286d78
commit
2bc22dc4ae
18 files changed
+1562
-3
No files matched your search
+100
-2
@@ -1,5 +1,103 @@
|
||||
# 智能对话
|
||||
|
||||
[官方文档](https://developers.weixin.qq.com/doc/aispeech/platform/INTERFACEDOCUMENT.html)
|
||||
[官方文档](https://developers.weixin.qq.com/doc/aispeech/confapi/dialog/token.html)
|
||||
|
||||
## 快速入门
|
||||
## 快速入门
|
||||
|
||||
```go
|
||||
import (
|
||||
"github.com/silenceper/wechat/v2"
|
||||
"github.com/silenceper/wechat/v2/aispeech/config"
|
||||
"github.com/silenceper/wechat/v2/aispeech/dialog"
|
||||
"github.com/silenceper/wechat/v2/cache"
|
||||
)
|
||||
|
||||
wc := wechat.NewWechat()
|
||||
memory := cache.NewMemory()
|
||||
|
||||
ai := wc.GetAISpeech(&config.Config{
|
||||
AppID: "xxx",
|
||||
Token: "xxx",
|
||||
AESKey: "xxx",
|
||||
Account: "admin",
|
||||
Cache: memory,
|
||||
})
|
||||
|
||||
dialogClient := ai.GetDialog()
|
||||
|
||||
accessToken, err := dialogClient.GetAccessToken()
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
|
||||
res, err := dialogClient.Query(&dialog.QueryRequest{
|
||||
Query: "你好",
|
||||
Env: "online",
|
||||
UserID: "user-1",
|
||||
})
|
||||
```
|
||||
|
||||
## 简单问答导入与发布
|
||||
|
||||
```go
|
||||
task, err := dialogClient.ImportJSON(&dialog.ImportJSONRequest{
|
||||
Mode: 0,
|
||||
Data: []dialog.BotIntent{{
|
||||
Skill: "售前咨询",
|
||||
Intent: "查询营业时间",
|
||||
Disable: false,
|
||||
Questions: []string{"你们几点开门", "营业时间是什么时候"},
|
||||
Answers: []string{"我们的营业时间是周一至周五 9:00-18:00"},
|
||||
}},
|
||||
})
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
|
||||
asyncResult, err := dialogClient.FetchAsync(&dialog.FetchAsyncRequest{
|
||||
TaskID: task.TaskID,
|
||||
})
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
|
||||
publish, err := dialogClient.Publish()
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
|
||||
progress, err := dialogClient.GetEffectiveProgress(&dialog.EffectiveProgressRequest{
|
||||
Env: "online",
|
||||
})
|
||||
```
|
||||
|
||||
当前封装微信智能对话开放接口中“接入智能对话”的 6 个接口:
|
||||
|
||||
- `POST /v2/token`
|
||||
- `POST /v2/bot/import/json`
|
||||
- `POST /v2/async/fetch`
|
||||
- `POST /v2/bot/publish`
|
||||
- `POST /v2/bot/effective_progress`
|
||||
- `POST /v2/bot/query`
|
||||
|
||||
## 真实接口验证
|
||||
|
||||
默认单元测试不会访问真实微信接口。如需验证 token 和 query 只读链路,可设置以下环境变量后运行:
|
||||
|
||||
```bash
|
||||
AISPEECH_INTEGRATION=1
|
||||
AISPEECH_APPID=xxx
|
||||
AISPEECH_TOKEN=xxx
|
||||
AISPEECH_AES_KEY=xxx
|
||||
go test ./aispeech/dialog -run TestIntegrationAccessTokenAndQuery
|
||||
```
|
||||
|
||||
如需验证导入、异步任务查询、发布、发布进度查询和命中回答的完整链路,可显式开启变更型测试。该测试会导入一个 `CodexSmokeTest` 临时问答并发布到线上机器人:
|
||||
|
||||
```bash
|
||||
AISPEECH_INTEGRATION_MUTATION=1
|
||||
AISPEECH_APPID=xxx
|
||||
AISPEECH_TOKEN=xxx
|
||||
AISPEECH_AES_KEY=xxx
|
||||
go test ./aispeech/dialog -run TestIntegrationFullDialogFlow -v
|
||||
```
|
||||
Reference in new issue
Block a user