RPA与Coze API的完美融合,自动化流程指南
用 Coze 开发好一个智能体后,可以在 Coze 上直接调用,也可以发布到 Bot商店、飞书,微信等平台上使用,但是如果想在自己的代码或项目里面远程调用时,或者想做一个自动化的处理,比如现在的 RPA + 智能体自动化时,就要用到 API 调用,也就是通过 HTTP 方式与 Bot 进行交互。

网上找了些资料,但是发现好多都是用的 Coze 的历史接口,现在新的 V3 接口处理方式包括字段和处理方式都不一样了,所以现在这个教程是基于最新版 V3 接口的。配置好 API 后,在影刀 RPA 中使用。
一、API 介绍
开发文档 : https://www.coze.cn/docs/developer_guides/coze_api_overview
目前 API 的调用是免费供开发者使用的,但是有一定的限制,包括频率和次数:
发起对话 API 的请求频率限制
- QPS(每秒发送的请求数):2
- QPM(每分钟发送的请求数):60
- QPD(每天发送的请求数):3000
扣子基础版和专业版账号的 API 使用限额存在差异。
- 基础版:2024年8月15日之后,基础版为每个账号免费提供 100 次 API 调用,累计用量超出额度后无法使用扣子 API。
- 专业版:不限制调用 API 的频率和次数。调用**发起对话** API, 按Token 消耗收取费用,其他接口免费。
二、准备工作
要使用 API 服务 ,在开始之前需要准备 3 个步骤:
1,将智能体发布为 API 服务。
2,添加访问令牌。
3,获取 bot_id
2.1) 发布 API 服务
在单个 Bot 的编排页面,点击「发布」按钮。

在发布页面,选择「Bot as API」

发布后,等平台审核通过,具体审核状态可以通过发布历史查看,具体为点击「发布记录」查看。

2.2 ) 添加访问令牌
登录 Coze 后,左侧菜单找到「扣子 API」

点击链接后,点击「授权」标签,个人访问信息,再添加新令牌。

勾选 Bot 管理的权限,注意添加时,令牌只会显示 1 次,所以一旦显示及时复制保存。

2.3 ) 获取 bot_id
从个人空间中,点击某个bot进去,在浏览器链接里面找到具体的id

经过上面几步准备工作,API 的准备工作就算完成了,如果想测试一下可以使用 CURL 命令,更改如下命令的
访问令牌、bot_id 和查询内容
curl --location --request POST 'https://api.coze.cn/v3/chat' \
--header 'Authorization: Bearer 自己的访问令牌' \
--header 'Content-Type: application/json' \
--data-raw '{
"bot_id": "自己的bot_id",
"user_id": "123456789",
"stream": false,
"auto_save_history": true,
"additional_messages": [
{
"role": "user",
"content": "自己的查询内容",
"content_type": "text"
}
]
}'
会返回如下的结构
{"data":{"id":"7409902541993197608","conversation_id":"7409902541993181224","bot_id":"7383716452492705842","created_at":1725252384,"last_error":{"code":0,"msg":""},"status":"in_progress"},"code":0,"msg":""}
三、影刀 RPA
如果只想将 API 调用集成到自己的代码中,那么不用影刀也是可以的,本质上还是 HTTP 的请求,如果用 Python 的话,用 requests 请求就行了。
用影刀 RPA 是因为目前做一些自动化的操作像发小红书、公众号或其它图文类的,都是建立相应的智能体通过 RPA 来调用的,所以可了解下在影刀中如何去调用 Coze。
3.1) 新建 Python 模块
模块中,可以通过自己写代码的方式扩展影刀的功能,那么就可以将 API 的操作比如调用和处理返回结果等信息在代码层来实现。

新建文件后,在文件中添加请求接口的代码,我这里只以对话接口做演示,需要其它接口的去开发文档查询即可。
如果是非流式的请求,整个对话接口的方式为发送请求,轮询查状态 ,获取消息。

发起对话请求,接口请求地址 : https://api.coze.cn/v3/chat , api_token 为访问令牌, bot_id 为智能体的ID。

轮询查状态,接口地址:https://api.coze.cn/v3/chat/retrieve, 请求发出去后,智能体还需要处理时间的,需要有一个轮询查状态,查询状态值为完成的时候,就可以查询消息了。

获取消息,接口地址为: https://api.coze.cn/v3/chat/message/list, 根据智能体不同的类型,从不同的结构中获取值。

通过日志查看返回结果信息,可以调试。如果要使用日志组件,直接用影刀里面的包就行,用下面的方式引入包
import xbot.app.logging

代码里面用到了 requests 第三方包,在影刀里面使用第三方的都需要安装,方法为从这三个点这里找到「Python包管理」

然后输入包的名称,再直接安装就行,安装好后就可以使用的包来操作了。

模块代码弄好之后,在影刀里面通过模块调用的方式来操作。

以上分享的就是如何使用 Coze 的 API,以及在影刀中调用智能体的操作,也就是现在RPA+智能体的常规操作方式,有需要这方面结合的,就可以试试这种方式了。
我是老梁,专注于分享AI工具和AI技术。