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", // 替换为实际对话IDbotId: "your_bot_id", // 替换为目标Bot IDuserId: "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知道
