文档中心

联网问答Agent

API参考

埋点上报API

埋点上报API

本文档介绍智能体埋点上报API接口的输入输出参数。调用该接口可上报用户的喜欢、复制、分享、查看引用资料等行为事件，提升智能体回复效果。

认证方式

见智能体API认证方式--联网问答Agent-火山引擎

接口详情

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 <API_KEY> Content-Type：application/json ServiceName: ask_echo Access Key接入： Content-Type：application/json 此接入方式基于火山引擎访问控制的AK/SK鉴权，统一使用 ServiceName=ask_echo，接口验签及请求公共参数逻辑遵循火山引擎官网的统一规范，详情请参见：签名方法--API签名调用指南-火山引擎；

请求体

AgentEventLogRequest

参数	类型	必需	描述
RequestId	String	是	智能体会话API接口返回的RequestId，获取方式
UserId	String	否	反馈的用户Id
EventList	Array<Event>	是	事件列表，最多不超过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 // 点击的开场问题 }

请求示例

响应示例

错误处理

错误响应

响应格式如下：

最近更新时间：2026.08.18 19:51:35

这个页面对您有帮助吗？

有用

有用

无用

无用