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 для всей информации о человеке.