> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# 用户

## 概述

“用户”页面列出此工作区中与智能体交谈过的所有人，包括他们是谁、上次联系时间以及与哪个智能体交谈。

每位用户都通过启动对话时传入的 `user_id` 识别。了解如何设置此项，请参阅[对话启动客户端数据](/docs/zh/eleven-agents/customization/personalization#conversation-initiation-client-data-structure)，或查看[集成](/docs/zh/eleven-agents/integrate/overview)下对应平台的指南。

![显示用户列表和所选用户对话的用户页面](/docs/_fern-img/353b30276a034eed7007aa17008b84bab1ae50fe903b0890fd0d87d7bbc51fcd.webp)

## 表格列

* **用户 ID** — 会话开始时传入的外部 ID。
* **上次联系** — 用户上次互动时间（可排序）。
* **智能体** — 该次互动涉及的智能体。
* **对话** — 对话总数（可排序）。

## 搜索和筛选

搜索会精确匹配用户 ID，请输入完整 ID，而不是部分字符串。

还可按日期范围、智能体和分支筛选（需在所选智能体上启用[版本控制](/docs/zh/eleven-agents/operate/versioning)）。

## 详情

点击一行可按时间顺序打开该用户的对话。之后可像在对话历史中一样打开任意单个对话。

## API 参考文档

[列出用户](/docs/zh/api-reference/users/list) — 请求参数、响应结构和分页。