当开发者订阅了智能体下架回调事件后,开发者下架低代码智能体时,扣子编程会向指定的回调地址推送回调消息,消息中包含智能体的基本信息。订阅回调的具体操作请参见订阅回调。
智能体下架回调事件的触发条件如下:
|
回调类型 |
个人版 |
企业版(企业标准版、企业旗舰版) |
|---|---|---|
|
普通回调 |
仅空间所有者可订阅,当工作空间中任意低代码智能体被下架时,对应的回调地址会收到智能体下架回调事件。 |
仅超级管理员和管理员可订阅,当企业内任意低代码智能体被下架时,对应的回调地址会收到智能体下架回调事件。 |
|
渠道回调 |
仅自定义渠道创建者可订阅,当该渠道中的低代码智能体被下架时,对应的回调地址会收到智能体下架回调事件。 |
仅超级管理员和管理员可订阅,当自定义渠道中的低代码智能体被下架时,对应的回调地址会收到智能体下架回调事件。 |
回调消息的结构体 Body 中包含两个主要字段:header 和 event。
header参数的参数说明请参见回调事件。event 参数中包括以下参数:
|
字段 |
类型 |
说明 |
|---|---|---|
|
bot_id |
String |
智能体 ID。 |
|
space_id |
String |
智能体所属的空间 ID。 |
|
connector_id |
String |
智能体下架的渠道 ID。扣子编程官方渠道对应的渠道 ID 如下:
|
|
bot_name |
String |
智能体名称。 |
|
description |
String |
智能体的描述信息。 |
回调结构体示例:
{
"header": {
"event_type": "bot.unpublished", //智能体下架回调事件
"event_id": "76464a1a-eda7-48e9-b207-2db50392e60a-7509745929591717899", // 此次触发的唯一 id,用户应该用这个 id 做去重
"created_at": 1749038258245,
"coze_account_id": "4189602994****", // 被下架的智能体所属的空间的 owner id
"api_app_id": "75097459295917****", // 回调应用的 id
"connector_id": "74239893676742***" // 如果为渠道回调,这个字段会填充自定义渠道 id
},
"event": {
"bot_id": "7512041635401****", // 智能体 id
"space_id": "7309693825197****", // 智能体所属的 space_id, 仅普通回调有这个字段,渠道回调没有
"connector_id": "10000122", //渠道 ID
"bot_name": "智能体名称",
"description": "智能体简介"
}
}
开发者服务器收到智能体下架回调后,应在 3 秒内响应,并返回 HTTP 状态码 200。