Coze接口对接指南

前言

这篇文章从coze api的角度来介绍如何对接coze平台发布的智能体。

背景介绍

大家知道在coze平台上发布一个bot非常简单,你可以根据使用场景来构建属于自己的专属机器人。关于搭建AI机器人的工作流程这里不再赘述,大家可以查看前几篇文章。主要流程如下:

信息资源整合→创建知识库or接入平台插件→创建工作流→编写Bot提示词→调试、优化→发布

如何在自己的系统中集成已发布的bot呢?使用coze平台的Bot as api就起到了关键作用,下面开始介绍操作步骤

Coze API介绍

Coze API 作为 Coze 平台与外界沟通的枢纽,为开发者提供了一个灵活的接口,以便充分利用 Coze 的功能和服务,推动业务流程的自动化和系统间的无缝集成。它提供了一系列全面的功能,从数据检索到智能交互,致力于提高工作效率并开拓新的应用场景。

Coze API申请接入流程

一、登录账号

访问Coze官方网站,注册开发者账号,填写必要的个人信息和公司信息。

二、创建应用与密钥

登录到首页后创建Bot

打开API令牌管理页面添加新令牌

三、发布授权Bot as api

四、API配置

在个人访问令牌界面,配置所需API接口权限

五、Coze API的使用限制

当前扣子 API 免费供开发者使用,每个空间的 API 请求限额如下:

请求类型请求数
QPS (每秒发送的请求数)2
QPM (每分钟发送的请求数)60
QPD (每天发送的请求数)3000

六、Coze API调用过程

Coze API的协议和格式: Coze的API使用HTTPS协议,返回值为JSON格式。支持流式和非流式数据返回

curl --location --request 
POST 'https://api.coze.cn/open_api/v2/chat' 
--header 'Authorization: Bearer pat_zmSmk3cvswCNvGdG8TWLEoLZa2zNYxaMZcLhx7vVGWJvJgeATPg6AO08qqPsQoPd' --header 'Content-Type: application/json' 
--header 'Accept: */*' 
--header 'Host: api.coze.cn' 
--header 'Connection: keep-alive' 
--data-raw '{ 
"conversation_id": "122222223", 
"bot_id": "7383502169561366564", 
"user": "6ctrs26q8701k", 
"query": "有哪些值得推荐的冰茶品牌", 
"stream": false }'

七、Coze API的响应

{"messages":[{"role":"assistant","type":"answer",
"content":"😜亲,像康师傅冰红茶、统一冰红茶都挺不错的😃,口感清爽,很适合夏天消暑🧊,不过每个人口味不同,你可以都尝尝看哟😜 ","content_type":"text"},
{"role":"assistant","type":"verbose",
"content":"{\"msg_type\":\"generate_answer_finish\",\"data\":\"\",\"from_module\":null,\"from_unit\":null}","content_type":"text"},
{"role":"assistant","type":"follow_up",
"content":"康师傅冰红茶和统一冰红茶哪个更好喝?","content_type":"text"},
{"role":"assistant","type":"follow_up",
"content":"冰茶品牌中还有哪些值得推荐的品牌?","content_type":"text"},{"role":"assistant","type":"follow_up","content":"推荐一些冰茶的制作方法","content_type":"text"}],
"conversation_id":"122222223","code":0,"msg":"success"}%

总结

本篇文章主要和大家分享的是如何使用coze平台开放的API功能,它的好处不仅可以避免每次都需要登录网页才能使用Coze的情况,而且还可以把bot功能集成到你的应用场景中去,比如最近比较火的微信群聊机器人。希望今天的分享能给帮助到大家,为大家在AI的路上继续赋能。