查询用户及其会话
列出您的终端用户及其在 MCP 上的聊天会话——仅限目录和元数据;转录内容保留在控制台中,通过工具返回的链接访问。
list_end_usersget_end_userlist_user_sessions原则——返回链接,而非转录内容。 这些工具返回的是您的用户是谁以及他们聊了多少——绝不会返回对话文本。每条结果都包含一个
console_url;请将该链接交给用户,以便他们在控制台中打开并阅读转录内容,因为只有在控制台中才能正确渲染。
三个只读工具涵盖了“谁在使用我的智能体,以及用量多少”:
1. 用户目录
list_end_users(sort="tokens24h") # busiest first; sort="recent" for newest
list_end_users(q="alex") # filter by name or external id每个用户返回的信息包括登录方式、电子邮件(如有)、空间/会话/文档数量、24 小时 token 用量以及一个 console_url。使用场景——“本周谁是我的最活跃用户?” → 使用 sort="tokens24h",然后返回最活跃用户的 console_url。
2. 单个用户的详细信息
get_end_user(uid="…") # profile: name, contact email/phone, city, timezone, spaces仅包含个人资料字段——无对话内容。包含指向其详细页面的 console_url。
3. 他们的会话——元数据,然后是链接
list_user_sessions(uid="…") # per session: agent, AI-summarised title, message_count, tokens, time不会返回消息本身——这是出于设计考虑。您获得的是会话的结构(哪个智能体、持续时间、时间、AI 标题)以及两个链接:console_url 打开该特定对话(控制台会直接跳转到该对话并弹出转录内容——无需在长列表中查找),而 user_console_url 打开用户的详细页面。使用场景——“该客户之前是否与我们交谈过,谈了什么?” → 列出他们的会话,摘要标题,并返回相关会话的 console_url,以便用户直接定位到该对话线程。
为什么通过 MCP 不提供转录内容:聊天内容是您的终端用户的数据,而租户 API 密钥由您连接的任何智能体持有。因此,平台返回元数据 + 控制台链接,原始对话由人在控制台中阅读——而不是流式传输给集成智能体。
汇报结果。 先给出答案(“Alex 有 3 个会话,都是关于再融资的,最近一次在昨天”),然后粘贴相关会话的
console_url,以便用户直接点击进入该特定对话线程——或者使用user_console_url查看整个人的信息。