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知道
)
