本文档介绍智能体埋点上报API接口的输入输出参数。调用该接口可上报用户的喜欢、复制、分享、查看引用资料等行为事件，提升智能体回复效果。 # 认证方式见[智能体API认证方式--联网问答Agent-火山引擎](https://docs.volcengine.com/docs/85508/2628937?lang=zh) # 接口详情 ## URL |URL

|* **API Key接入：** https://open.feedcoopapi.com/agent_api/agent/event/log

* **Access Key接入：** https://mercury.volcengineapi.com?Action=AgentEventLog&Version=2026\-01\-01 | |---|---| |Method |POST | |Header |* **API Key接入：**

* Authorization: Bearer

* Content\-Type：application/json

* ServiceName: ask_echo

* **Access Key接入：**

* Content\-Type：application/json

* 此接入方式基于火山引擎访问控制的AK/SK鉴权，统一使用 ServiceName=ask_echo，接口验签及请求公共参数逻辑遵循火山引擎官网的统一规范，详情请参见：[签名方法--API签名调用指南-火山引擎](https://www.volcengine.com/docs/6369/67269)； | ## 请求体 **AgentEventLogRequest** |**参数** |**类型** |**必需** |**描述** | |---|---|---|---| |RequestId |String |是 |智能体会话API接口返回的RequestId，[获取方式](https://docs.volcengine.com/docs/85508/1510834?lang=zh) | |UserId |String |否 |反馈的用户Id | |EventList |Array |是 |事件列表，最多不超过20个，超过丢弃 | **Event** |EventName |String |是 |用户事件枚举，枚举值见下方 | |---|---|---|---| |Params |String |否 |事件属性信息，json字符串，不同的事件对应不同结构，详细描述见下方 | **EventName** |

事件

分类

上报时机

上报event

上报参数params

| |---|---|---|---|---| |喜欢 |回复效果反馈 |点击喜欢按钮 |agent_like |\- | |不喜欢 |回复效果反馈 |点击不喜欢按钮，直接返回

点击不喜欢按钮，完成反馈返回 |agent_dislike |{

"reason": string // 长度上限500

} | |举报 |回复效果反馈 |点击举报按钮

|agent_report |{

"reason": string // 长度上限500

} | |追问 |用户行为反馈

|点击了可能想问的问题 |agent_follow_up |{

"follow_up_question":string // 点击的问题

} | |复制 |用户行为反馈 |点击复制按钮 |agent_copy |\- | |分享 |用户行为反馈 |点击分享按钮,并完成分享 |agent_share |\- | |收藏 |用户行为反馈 |点击了收藏，将结果加入了收藏夹 |agent_save |\- | |查看引用 |用户行为反馈 |点击引用角标，查看引用资料 |agent_reference

|{

"reference_id": string // 点击的引用角标对应reference id

} | ||用户行为反馈 |点击参考资料url跳转 |agent_reference_url |{

"reference_id": string // 点击的引用资料对应reference id

} | |热点开场问题展现 |热点开场问题

|请求开场问题后展示 |agent_opening_question_show |{

"opening_questions": string // 展示的开场问题json字符串

} | |热点开场问题点击 |热点开场问题 |用户点击开场问题 |agent_opening_question_click |{

"opening_question": string // 点击的开场问题

} | ## 请求示例 ```JSON { "RequestId": "202210271151020102121450321B8D2A21", "UserId": "user_xxx", "EventList":[{ "EventName": "agent_dislike", "Params": "{\"reason\": \"content_too_long\"}" }] } ``` ## 响应示例 ```JSON { "ResponseMetadata": { "RequestId": "你的logid", "Action": "AgentEventLog", "Version": "2026-01-01", "Service": "ask_echo", "Region": "cn-north-1" } } ``` # 错误处理 ## 错误响应响应格式如下： ```JSON { "ResponseMetadata": { "RequestId": "202210271151020102121450321B8D2A21", "Action": "AgentEventLog", "Version": "2023-01-01", "Service": "volc_torchlight_api", "Region": "cn-north-1", "Error": { "CodeN": 100010, "Code": "SignatureDoesNotMatch", "Message": "The request signature we calculated does not match the signature you provided. Check your Secret Access Key and signing method. Consult the service documentation for details." } } } ```