ユーザーとセッションを検索する
MCP経由でエンドユーザーとそのチャットセッションを一覧表示 — ディレクトリとメタデータのみ。トランスクリプトはコンソール内に保持され、ツールが返すリンクからアクセスできます。
list_end_usersget_end_userlist_user_sessions原則 — 転記ではなくリンクを返す。 これらのツールは、ユーザーが誰であり、どれくらいチャットしているかを返しますが、会話のテキストは決して返しません。各結果には
console_urlが含まれています。ユーザーにその URL を渡し、コンソールで開いて転記を読むようにしてください。コンソールでは適切にレンダリングされます。
「誰が私のエージェントを使用しており、どれくらい使用しているか」をカバーする読み取り専用のツールが3つあります。
1. ユーザーディレクトリ
list_end_users(sort="tokens24h") # busiest first; sort="recent" for newest
list_end_users(q="alex") # filter by name or external id各ユーザーには、サインイン方法、メールアドレス（ある場合）、スペース/セッション/ドキュメントの数、24時間あたりのトークン使用量、および console_url が返されます。ユースケース — 「今週最もアクティブなユーザーは誰か？」 → sort="tokens24h" を使用し、上位ユーザーの console_url を渡します。
2. 1人のユーザーの詳細
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タイトル）と2つのリンクが得られます。console_url はその正確な会話を開きます（コンソールは直接そこにジャンプし、転記をポップアップ表示します — 長いリストの中から探す必要はありません）。user_console_url はユーザーの詳細ページを開きます。ユースケース — 「この顧客は以前に私たちと話したことがあるか、そして何について話したか？」 → 会話セッションをリストし、タイトルを要約し、関連するものの console_url を渡して、スレッドに直接アクセスできるようにします。
MCP経由で転記を返さない理由: チャットコンテンツはエンドユーザーのデータであり、テナントAPIキーは接続したエージェントが保持しています。したがって、プラットフォームはメタデータとコンソールリンクを返し、生じた会話は統合エージェントにストリーミングされるのではなく、コンソールで人間が読みます。
報告する。 答えを先頭に持ってきて（「アレックスは3つのセッションがあり、すべてリファイナンスについて、最新は昨日」）、関連するセッションの
console_urlを貼り付けて、ユーザーがその正確なスレッドに直接クリックしてアクセスできるようにします — または、人物全体についてはuser_console_urlを使用します。