查詢使用者及其工作階段
列出您的終端使用者及他們在 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查看整個人員的資料。