搜索历史会话
zhini_search_sessions搜索历史会话,用于按客户名、消息关键词、消息发送时间范围、客服、渠道、明确标签、联系人类型召回包括已结束、已关闭会话在内的历史会话候选。用户只要求查询当天或某个时间范围内的对话、咨询记录时,默认查询当前授权账号关联的所有渠道范围,不代表当前调用客服本人接待或回复过;除非用户明确说“我处理过、我接待过、我回复过、归属于我”或指定某客服/渠道,否则不要自动传 kfid 或 channel_id。用户要求查询某天或某段时间内的全部接待、完整会话或已结束会话时,应使用本工具分页查询,不能只调用 zhini_list_active_sessions。自然语言中的“XXX 用户/客户”默认是业务语义;当 XXX 必须根据聊天判断时,使用 msg 按相关表达召回候选,再用 msg_stime 限定消息发送时间范围,最后用 zhini_fetch_messages 读取完整上下文并由模型分类,不要先把 XXX 当成标签名。只有用户明确提到标签或已有 tag_id 时,标签才作为筛选条件或补充信号。关键词命中只是召回信号,不等于最终分类。条件性限制:仅当 msg 非空时,关键词历史检索只支持最近半年内的记录;msg 未传或为空、仅使用其他筛选条件(包括 msg_stime)时不受这条关键词专属限制。重要时间语义:msg_stime 表示消息发送时间范围,用于筛选时间段内包含消息的会话,不表示对话开启时间;旧字段 stime 已移除,不要传入。禁止空条件拉全量;page 从 0 开始;本工具不接收数量参数,底层查询默认每次返回 30 条,MCP 可全部展示给模型。
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| msg | No | 消息内容关键词。适合搜索订单号、手机号片段、产品名、错误提示、投诉词、活动词等。仅当本字段非空时触发关键词历史检索限制:只支持最近半年内的记录。 | |
| kfid | No | 客服 ID 列表。仅在用户明确指定某客服,或明确说查询当前调用者本人处理过/接待过/回复过/归属于本人的会话时传;第一人称场景可先用 zhini_get_current_kefu 获取 kfid。通用时间范围查询不要自动传当前 kfid。 | |
| name | No | 客户名称关键词。 | |
| page | No | 页码,从 0 开始。 | |
| tag_id | No | 标签 ID 列表。用户给标签名时应先调用 zhini_search_tags 解析 tag_id。 | |
| msg_stime | No | 消息发送时间范围,秒级时间戳;按该范围内包含消息的会话筛选,不表示对话开启时间。与非空 msg 组合时,关键词检索只支持最近半年。 | |
| channel_id | No | 渠道 ID 列表。仅在用户明确指定渠道时传;用户未指定渠道时默认覆盖当前授权账号关联的所有渠道。用户给渠道名时应先调用 zhini_list_channels 解析 channel_id。 | |
| wx_contact_type | No | 联系人类型数组:0 联系人,1 群组。 |