【扣子coze+微信开发者工具】实现ai自定义对话03：微信小程序js逻辑和接口实现

目录

摘要

一、前言

二、扣子API

1.  扣子的API文档理解

2. 对话API深度理解

2.1 bot_id

2.2 additional_messages

2.2.1 role

2.2.2 type

2.2.3 content_type

2.2.4 content

2.3 stream

三、.js文件——发起对话（逻辑代码）

1. 纯文本text对话

1.1 content传入内容包装

2. 图片多模态object_string对话

2.1 上传文件获取文件id

2.2 wx.request访问扣子API（文件和图片）

四、总结 

---

摘要

本系列文章实现了运用国内扣子Coze与微信开发者工具实现一个简单的微信小程序页面，一个与自定义AI语言交互问答的功能。本系列文章详细讲解的从创建bot到微信小程序页面还有接口的编写。后续可能会加入后端Java+SpringBoot的逻辑功能来丰富项目。

---

成果预览：

专栏相关操作    传送==>（^_^）

01、创建自定义Bot

02、微信小程序对话页面简单设计

03、微信小程序js逻辑和接口实现

一、前言

本文主要讲的是运用开发者工具调用微信的API接口并且连接Coze的API接口，实现可以通过微信小程序与自定义的Bot进行AI对话。

一个星期前扣子提供的API只有一个，当时为了处理逻辑我采用的是微信开发者+SpringBoot后端框架来编写，但是上周突然发现扣子更新了API文档，添加了巨巨巨巨巨巨巨多的API接口，开心之后又开始悲催的改改改（呜呜呜~~~）

因为是这种情况，感觉简单的对话再采用前后端的方式就比较繁琐，扣子的新的API可以实现大部分的功能，因此简单的对话我暂时去掉的后端的部分，让微信小程序直接与扣子通信，后期增加其他功能再添加后端部分。

二、扣子API

1.  扣子的API文档理解

在扣子的主页的左下角有一个扣子API，点击之后就有了快速开始的教程，其中先获取个人访问令牌的部分已经在【扣子coze+微信开发者工具】实现ai自定义对话01中讲过，可以参考传送门（上面上面）。

​

 ​

先看目录，API接口之前的部分基本都讲过。 接口分为Bot、会话、消息、对话、文件、知识库、错误码7个部分。

其中，会话、消息、对话我刚开始很难区分，就不断反复看文档，我的理解是这样的：

• 会话就是一个全新的对话页面，一个用户可以与一个Bot有多个会话；
• 消息每条发送的消息，包括用户发的和Bot发的，单位为（条），一条消息；消息的API接口可以直接更改对话过程中的消息内容，包括已经发送过得消息；
• 对话一般就是一问一答，用户向Bot发起一个提问，Bot回答，这样一个过程为对话；

会话中可以有多个对话，多个消息；对话一般为两条消息。

 我目前的功能主要是一个简单的对话，因此并没有采用会话，而只有对话，后期会逐渐增加关于会话、消息的功能。

2. 对话API深度理解

对话的又分为发起对话、查看对话详情、查看对话消息详情、提交工具执行结果。

这里我们主要来分析“发起对话”这一部分。

官方给出的解释是：调用此接口发起一次对话，支持添加上下文和流式响应。

通俗来说就是可以带着已经和Bot说过的话再向它提问，他给出的方式呢可以是非流式响应也可以是流式响应，官方的文档给出的内容非常的多，也给了很多例子，但是没有给出用Java和JS方式怎么去调用。

我用postman测了很多，然后再用Java语言和JS去编写测试。因为后端被我去掉，所以这里也不再展示，只展示用微信开发者工具调用的方式。

基础信息官方写的简介明了，重点在于Body部分。

2.1 bot_id

要进行会话聊天的 Bot ID。

进入 Bot 的 开发页面，开发页面 URL 中 bot 参数后的数字就是 Bot ID。例如https://www.coze.cn/space/341****/bot/73428668*****，bot