Agents & skills · for AI agents

사용자 및 세션 조회

MCP를 통해 최종 사용자와 채팅 세션을 나열합니다 — 디렉터리 및 메타데이터만 제공되며, 트랜스크립트는 도구가 반환하는 링크를 통해 콘솔에서 접근할 수 있습니다.

MCP tools: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시간 토큰 사용량 및 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 키가 존재합니다. 따라서 플랫폼은 메타데이터 + 콘솔 링크를 반환하며, 원본 대화는 통합 에이전트로 스트리밍되지 않고 콘솔에서 사람이 직접 읽습니다.

보고하세요. 답변으로 시작하세요("알렉스는 3개의 세션이 있으며, 모두 리파이낸싱 관련이며, 가장 최근은 어제였습니다"), 그 후 관련 세션의 console_url을 붙여넣어 사용자가 해당 정확한 스레드로 바로 이동하도록 하세요. 또는 전체 사용자 정보를 원한다면 user_console_url을 사용하세요.