1. 准备工作
在开始之前,确保已经完成了以下准备工作:
- 创建并发布了 Coze 智能体。
- 获取了个人访问令牌(Personal Access Token),这是用于授权的关键凭证。
- 确认目标智能体的 Bot ID 和其他必要参数已准备就绪。
2. 请求方法与 URL
微信小程序可以通过 wx.request
方法发起网络请求。针对 Coze API,使用的 URL 如下:
POST https://api.coze.cn/open_api/v2/chat(该url对应下列字段)
此接口允许发送消息并与指定的 Bot 进行交互。
3. 请求头 (Header)
在微信小程序中,请求头需要包含以下关键字段:
Header 名称 | 描述 |
---|---|
Authorization |
认证令牌,格式为 Bearer {{Personal_Access_Token}} |
Content-Type |
数据格式,通常为 application/json |
4. 请求体 (Body)
请求体是一个 JSON 对象,包含以下字段及其含义:
字段名称 | 类型 | 必填 | 描述 |
---|---|---|---|
conversation_id |
string | 否 | 对话 ID |
bot_id |
string | 是 | 使用的目标 Bot ID |
user |
string | 是 | 用户唯一标识 |
query |
string | 是 | 发送的消息内容 |
stream |
boolean | 否 | 是否启用流式响应,默认为 false |
5. 微信小程序代码示例
以下是在微信小程序中调用 Coze API 的完整代码示例:
Page({
data: {
conversationId: "unique_conversation_id", // 替换为实际对话ID
botId: "your_bot_id", // 替换为目标Bot ID
userId: "user_unique_identifier", // 替换为用户的唯一标识
query: "" // 用户输入的消息
},
sendMessage() {
const that = this;
wx.request({
url: 'https://api.coze.cn/open_api/v2/chat', // Coze API 地址
method: 'POST',
header: {
'Authorization': 'Bearer your_personal_access_token', // 替换为您的Access Token
'Content-Type': 'application/json'
},
data: {
conversation_id: that.data.conversationId,
bot_id: that.data.botId,
user: that.data.userId,
stream: false // 不开启流式响应
},
success(res) {
console.log('Response:', res);
if (res.statusCode === 200 && res.data.success) {
wx.showToast({
title: '成功收到回复!',
icon: 'success'
});
console.log('AI Response:', res.data.result); // 输出AI的回答
} else {
wx.showToast({
title: '请求失败',
icon: 'none'
});
}
},
fail(err) {
console.error('Request failed:', err);
wx.showToast({
title: '网络请求异常',
icon: 'none'
});
}
});
}
});
6. 注意事项
- Token 安全性: 不要在前端硬编码敏感信息,如 Personal Access Token。推荐通过后端传递动态生成的临时 Token。
- 跨域问题: 确保 Coze API 的域名已在微信公众平台的安全域名列表中添加。
- 调试工具: 可以借助微信开发者工具中的 Network 面板查看请求细节以便于调试。
参考C知道