跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.kontext.so/llms.txt

Use this file to discover all available pages before exploring further.

节奏控制 决定广告在对话中出现的频率。在每一条助手消息下都展示广告通常太密——会让聊天显得喧闹，读者也容易麻木。Kontext 提供两种节奏控制方式，二者可以叠加使用。

​
方式 1：由我们来控节奏

节奏配置位于你账号的服务端配置中。告诉我们你想要的节奏——例如”每 5 条助手消息出一次广告”或者”新对话的前 3 轮不出广告”——我们会在我们这边设置好。之后 SDK 会自动决定哪些助手消息会展示广告，你的应用里无需写任何节奏逻辑。 如果你不确定从什么节奏开始合适，我们会基于同类发布方的实践给出建议。

​
方式 2：用 trackOnly 在单条消息上覆盖

如果你想抑制某个具体广告位的广告，只需在你想跳过的助手消息的前一条用户消息上把 trackOnly: true 设置好： 
session.addMessage(
  { id: 'u-99', role: 'user', content: '…', createdAt: new Date() },
  { trackOnly: true }
)
紧随其后的助手消息不会显示广告。这一轮的广告被静音了，但 SDK 仍在后台持续工作：
  • 你仍然必须为每一条消息调用 addMessage。 跳过它会破坏服务端用于后续定向的对话上下文。请始终传入每一条消息——只对想要抑制的消息加上标志即可。
  • SDK 仍会发起 /preload 请求。 服务端的分析数据照常准确。
  • 服务端会提前为下一轮不带 trackOnly 的回合准备好广告。 这是服务端层面的预先准备，并不是把广告下载到客户端缓存：当下一个可投放广告的回合到来时，填充率更高（服务端有更多时间寻找契合上下文的素材），并且广告投放更快（素材在我们这边已就绪）。
简而言之：trackOnly 仅在这一轮里隐藏广告，与此同时上下文在我们这边保持活跃，让下一个可投放广告的回合填充更及时、命中率更高。

​
下一步

消息

addMessage 调用，也就是 trackOnly 的设置位置。

广告生命周期事件

广告被抑制时，哪些事件仍会触发。