Attu 3.0 Beta:多集群管理、AI 代理以及全新重构的 Milvus 控制台
Attu 3.0 Beta 现已发布。
Attu是Milvus 的开源管理控制台。如果您曾在本地或生产环境中使用过 Milvus,那么您很可能曾通过 Attu 查看 Collections、浏览数据、管理 Schemas,或检查集群内部的运行状况。
Attu 2.x 在基本的单集群管理方面表现良好。但随着 Milvus 部署规模的扩大,其局限性也日益凸显。它每次只能连接一个 Milvus 实例,且容器重启后会丢失连接状态。 数据浏览主要以 Collection 为中心。诊断、监控、API 调试、备份与恢复以及权限管理往往需要单独的工具或手动操作。
Attu 3.0 Beta 是对 Milvus 管理体验的全面重构。
此版本新增了多集群管理、持久化本地状态、内置 AI 代理(包含 50 多种 Milvus 工具)、专家级诊断能力、重新设计的数据浏览器、内置 Prometheus 指标、API 实验台、基于 GUI 的备份与恢复,以及简化的 RBAC 工作流。
简而言之,Attu 不再仅仅是用于单个 Milvus 实例的轻量级查看器。它正逐渐成为开发人员和团队在本地、预发布及生产环境中管理 Milvus 的实用运维控制台。
Attu 3.0 Beta 版本的变更
以下是 Attu 2.x 与 Attu 3.0 Beta 版本的高级对比。
| 功能 | Attu 2.x | Attu 3.0 Beta |
|---|---|---|
| 集群连接 | 仅支持单实例 | 支持多个集群,一键切换 |
| 状态持久化 | 无状态;容器重启后状态丢失 | 本地数据库;重启后数据仍保留 |
| AI 辅助 | 无 | 内置Agent,支持50多种Milvus工具 |
| 诊断 | 手动排查 | 4项内置专家级诊断技能 |
| 基于角色的访问控制(RBAC)管理 | 独立页面,多步骤流程 | 基于上下文、一键创建用户 |
| 数据导航 | 扁平化Collection列表 | 分层树:数据库 → Collection → 分区 |
| 监控 | 需要外部 Grafana 支持 | 内置的 Prometheus 指标仪表盘 |
| API 调试 | 外部工具(如 curl 或 Postman) | 内置 REST API 测试平台 |
| 备份与恢复 | 仅限 CLI | 支持 S3、MinIO、GCS 和 Azure 的图形界面 |
| 大语言模型(LLM)集成 | 无 | 自带模型(BYOL):OpenAI、Anthropic、DeepSeek、Gemini 等 |
通过一个侧边栏管理多个 Milvus 集群
日常使用中最显著的变化是多集群管理功能。Attu 3.0 可连接您运行的每个 Milvus 实例,并在单个侧边栏中列出它们。
图片:Attu 3.0 侧边栏显示了多个 Milvus 连接及其健康状态指标
在 Attu 2.x 中,从一个 Milvus 集群切换到另一个集群意味着需要断开连接、重新连接并等待。如果您为开发、预发布、生产环境或不同业务线分别设置了独立的集群,往往会导致每个集群都需要占用一个浏览器标签页。
Attu 3.0 通过一个持久的左侧边栏取代了这种操作流程。每个 Milvus 连接都集中列在同一位置,旁边配有实时健康状态指示器。绿色圆点表示该集群可访问;红色圆点表示该集群已下线或不可用。
切换集群只需一次点击。Attu 会保留每个连接的上下文信息,因此您在不同环境之间切换时无需每次重新连接。
连接设置更稳定
新连接支持 TLS/SSL 加密、令牌认证以及用户名/密码认证。您可以在保存连接前进行测试,将连接详细信息保存在本地,并在旧环境不再需要时批量清除已断开的连接。
每个集群都有独立的工作区。概览、数据浏览器、用户管理、指标和操作均限定在当前选定的集群范围内。这大大降低了将预发布环境与生产环境混淆,或在错误位置执行操作的风险。
对于管理多个 Milvus 实例的用户而言,这是 Attu 3.0 中最重要的变更之一。虽然听起来很基础,但它大大减少了日常 Milvus 工作中频繁切换标签页和重新连接带来的麻烦。
本地状态现可在重启后保留
Attu 2.x 是一个无状态系统。如果容器重启,您保存的连接信息将会消失,您必须重新构建工作区。
Attu 3.0 新增了一个本地数据库,用于持久化集群配置、代理对话历史记录、自定义技能、LLM 配置以及用户偏好设置。
使用 Docker 运行 Attu 时,请挂载一个卷以保留这些状态:
docker run -d --name attu -p 3000:3000 -v attu-data:/data zilliz/attu:v3.0.0-beta.6
挂载卷后,重启容器就不再意味着要从零开始。
这对新的 AI 代理同样至关重要。对话历史记录、自定义技能和 LLM 配置均可本地持久化,因此 Attu 成为了一个可长期使用的控制台,而非每次重启后都会重置的临时界面。
使用内置 AI 代理以自然语言操作 Milvus
Attu 3.0 包含一个用于管理 Milvus 的内置 AI 代理。这并非文档聊天机器人。该代理连接了 50 多种 Milvus 工具,因此能够检查集群状态,并通过 Attu 执行实际操作。
图片:Attu 3.0 AI 代理可通过自然语言请求调用 Milvus 工具
覆盖常见 Milvus 工作流的 50 多种内置工具
该Agent涵盖日常运维、故障诊断、权限管理及集群管理。您可以提出问题或下达指令,例如:
| 场景 | 示例提示 |
|---|---|
| 日常操作 | “列出我所有的 Collections。” “创建一个包含 id、title 和 embedding 字段的 Collection。embedding 字段的维度设为 768。” “向 my_collection 中插入一些测试数据。” “在 my_collection 中搜索与‘人工智能’最相似的 10 条记录。” |
| 运维与诊断 | “我的集群运行状况如何?” “为什么搜索这么慢?” “哪些 Collections 占用的内存最多?” “最近有查询速度慢的情况吗?” |
| 权限 | “创建一个名为 analyst 的只读用户。” “向 admin 角色授予所有权限。” “检查用户 zhangsan 拥有哪些权限。” |
| 集群管理 | “显示当前的 Milvus 版本和配置。” “列出资源组的使用情况。” “帮我压缩 my_collection。” |
破坏性操作需要批准
图片:破坏性或敏感操作在执行前会显示确认对话框
该代理的设计旨在实现透明且可控。非破坏性操作(例如列出 Collections 或读取指标)会直接返回结果。
破坏性或敏感操作(例如删除Collection、清除数据或更改权限)会触发确认对话框。该对话框会列出确切的参数,并在操作执行前等待批准。
您还可以查看代理调用了哪些工具、使用了多少令牌,以及是否有任何工具调用失败。这对数据库管理代理而言至关重要。用户应能够理解代理执行了哪些操作,而不仅仅是看到最终结果。
从控制台运行专家诊断技能
AI Agents 自带四个内置诊断技能。这些是针对 Milvus 常见故障排除场景的引导式工作流,而非通用提示。
| 诊断技能 | 检查内容 |
|---|---|
| 集群健康状况诊断 | 版本、节点状态、各组件健康状况及关键指标。 |
| 搜索性能诊断 | 索引完整性、分段碎片、副本平衡以及相关的搜索性能指标。 |
| 数据写入诊断 | 插入速度慢、数据检查丢失、刷新异常以及写入路径症状。 |
| 配置审核 | 可能影响稳定性、性能或预期行为的高风险或错误设置。 |
图片:Attu 3.0 包含内置诊断技能,并支持自定义技能
您还可以使用自然语言创建自定义技能。一个技能可以编码为发布前的检查清单、针对特定Collection的数据质量检查,或是您的团队针对已知工作负载运行的诊断流程。
自定义技能本质上是领域知识与操作流程的结合。保存后,Agents即可重复使用该技能,而无需每次都依赖一次性提示。
自带 LLM 提供商
Attu 不捆绑或代理任何 LLM 服务。您可以自行配置提供商,并完全掌控模型路径。
支持的提供商选项包括 OpenAI、Anthropic、DeepSeek、Google Gemini、OpenRouter 以及自定义的 OpenAI 兼容端点。
| 提供商 | 示例模型 |
|---|---|
| OpenAI | GPT-5.5 |
| Anthropic | Claude Opus 4.8 |
| DeepSeek | DeepSeek-V4 |
| Google Gemini | Gemini 3.5 |
| OpenRouter | 任何路由模型 |
| 自定义端点 | 任何与 OpenAI 兼容的 API |
您的 API 密钥在本地加密存储,不会上传至 Attu 管理的服务。对于希望获得 AI 协助,但仍需控制凭据、数据流及服务商选择的团队而言,这种设计至关重要。
实际上,BYOL(自带模型)使该代理可在不同环境中使用。一个团队可能使用 OpenAI;另一个团队可能使用 Anthropic 模型;还有团队可能通过兼容 OpenAI 的端点进行路由。Attu 不会强制要求使用单一模型提供商。
通过“数据库 → Collection → 分区”树浏览 Milvus 数据
Attu 3.0 还重新设计了数据浏览器。Attu 2.x 主要呈现的是扁平化的 Collection 列表。一旦集群拥有多个数据库、数十个 Collection 以及分区数据,这种列表就难以使用。
新版浏览器采用与 Milvus 数据组织方式相匹配的层次结构:数据库 → Collection → 分区。
图片:重新设计的数据浏览器采用分层导航方式,用于浏览数据库、Collections和分区
数据操作更贴近浏览位置
数据浏览器保留了用户已习惯的操作,并在 UI 中直接增加了更多操作:
- 将Collection拖放至另一个数据库中。
- 当配置了Embeddings模型时,可通过直接输入文本执行向量搜索。
- 查看相似度评分,并通过筛选条件缩小结果范围。
- 以 CSV、JSON 和 Parquet 格式导入和导出数据。
- 以可视化方式查看和编辑Collection Schema,包括对Dynamic Field的支持。
- 创建、删除和查看分区及分区统计信息。
- 管理 Collection 的完整生命周期:创建、加载、发布、复制、重命名、跨数据库移动以及删除。
图片:支持向量搜索和结果查看的 Attu 3.0 数据浏览器
这些操作大多可通过右键菜单或操作面板完成。对于常见的 Collection 操作,您不再需要在 UI 浏览和命令行操作之间来回切换。
Attu 3.0 也是随着Milvus 3.0新功能(如快照和可为空向量)日趋成熟,其 UI 支持将持续更新的产品线。
在同一界面查看操作、指标、慢查询、拓扑和备份
Attu 3.0 在控制台中整合了更多操作信息。“运维与监控”区域包含集群概览、实时指标、慢查询分析、拓扑以及备份与恢复功能。
图片:Attu 3.0“运维与监控”页面
我们的目标并非取代生产团队现有的所有可观测性系统。团队仍可继续使用 Prometheus、Grafana、日志、警报以及现有的监控栈。我们的目标是让用户能够直接在 Attu 内部解答关于 Milvus 的常见问题。
| 区域 | 您可以执行的操作 |
|---|---|
| 可视化集群概览 | 一目了然地查看 Milvus 版本、部署模式、节点数量、数据库数量、Collection 数量、负载状态以及配额实体。 |
| 实时指标 | 查看 QPS、插入/删除速率、查询延迟、缓存命中率以及相关基于 Prometheus 的指标。 |
| 慢查询分析 | 按类型、持续时间、Collection、时间戳、来源及相关故障排除上下文分析慢查询。 |
| 拓扑视图 | 了解节点拓扑结构,以及 RootCoord、DataCoord、IndexCoord、QueryCoord 和 Proxy 等组件之间的连接关系。 |
| 备份与恢复 | 可将全量或增量备份保存至 S3、MinIO、GCS 或 Azure,并以 ZIP 格式下载备份元数据,或上传 ZIP 文件进行恢复。 |
备份和还原尤为重要,因为它们将此前依赖 CLI 操作的工作流转移到了 GUI 界面。这对于本地测试、预发布环境验证以及希望拥有更清晰恢复路径的团队而言非常有用。
使用内置 API Playground 调试 Milvus REST API
Attu 3.0 新增了 REST API 调试环境,用于 Milvus API 的开发和调试。
图片:Attu 3.0 API 实验台
该 API 沙箱按类别对 Milvus REST 端点进行了分类。选择数据库和 Collection 后,Attu 会自动填充运行上下文。随后,您只需单击一下即可发送请求,并实时查看响应。
当您希望测试 API 调用,却无需配置 curl 命令或 Postman Collection 时,此功能非常实用。此外,它还有助于了解 Milvus 功能与 REST API 之间的映射关系,因为您可以直接在 UI 上下文和请求正文之间切换。
对于应用程序开发人员而言,API Playground 是一个调试平台;对于 Milvus 新用户而言,它是一个学习平台;对于平台团队而言,这是在将操作转化为脚本或应用程序代码之前快速验证操作的一种方式。
在数据库或 Collection 旁管理 RBAC
Attu 3.0 改变了 UI 中权限工作流的操作体验。它不再将RBAC视为一项独立的管理任务,而是将访问控制更紧密地整合到用户日常操作的数据库和 Collection 标签页中。
其底层模型仍是 Milvus RBAC:用户、角色、权限、授予和撤销。Attu 3.0 简化了围绕该模型的操作路径。
图片:Attu 3.0 中的上下文用户和权限管理
常见权限范围的一键用户创建
在 Attu 2.x 中,为 Collection 开放只读访问权限通常需要多个步骤:创建用户、创建角色、配置权限、将角色分配给用户,并确保作用域正确。
在 Attu 3.0 中,您可以打开一个 Collection,转到“用户”选项卡,点击“创建用户”,选择“只读”或“读写”,然后让 Attu 完成整个工作流。它会创建用户、生成安全密码、创建匹配的范围角色,并应用授权。
在数据库层级,同样的操作模式同样适用。您还可以一键授权现有用户访问当前Collection,或撤销其访问权限。
这使得权限管理更贴近受保护的资源。您无需在多个管理页面间来回切换,也无需记住角色命名规范,仅需简单操作即可为团队成员授予范围限定访问权限。
此测试版对 Attu 用户意味着什么
Attu 3.0 Beta 是自 Attu 首次发布以来,Milvus 管理控制台的一次重大更新。这不仅仅是一次界面焕新,更拓展了 Attu 的功能范围。
此次升级的核心在于,Attu 现已更好地契合了许多 Milvus 用户的实际工作方式:管理多个集群、持久化本地设置、更频繁的数据迁移、更严格的访问控制、更复杂的故障排除,以及在无需在不同工具之间切换的情况下更深入地理解集群行为的需求。
主要亮点包括:
- 支持健康指标和一键切换的多集群管理。
- 集群配置、偏好设置、LLM 配置、代理历史记录及自定义技能的持久化本地状态。
- 内置 AI Agent,支持 50 多种 Milvus 工具,并对破坏性操作设置确认门槛。
- 四项内置专家诊断技能,分别针对集群健康状况、搜索性能、数据写入及配置审查。
- 重新设计的数据浏览器,支持数据库 → Collection → 分区导航,并提供更丰富的 Collection 操作。
- 内置 Prometheus 指标、慢查询分析、拓扑图以及备份与恢复功能。
- 用于调试和学习 Milvus API 的 REST API 实验平台。
- RBAC 工作流不仅可在独立的管理流程中运行,还可直接在数据库或 Collection 旁执行。
如果您仅将 Attu 用于本地 Milvus 开发,3.0 版本将为您提供功能更强大的控制台。如果您管理多个 Milvus 环境,仅多集群和持久状态这些新功能就值得一试。 如果您经常调试性能或权限问题,Agents、诊断、指标以及上下文相关的 RBAC 工作流将立即为您节省时间。
立即开始
使用 Docker 试用 Attu 3.0 Beta 版:
docker run -d --name attu -p 3000:3000 -v attu-data:/data zilliz/attu:v3.0.0-beta.6
然后打开:
http://localhost:3000
在侧边栏中添加您的 Milvus 连接,并开始探索新的控制台。
更喜欢桌面应用?请从GitHub Releases 下载适用于您平台的版本。Attu 3.0 Beta 提供了适用于 macOS、Linux 和 Windows 的桌面安装包。最新版本还包含一个独立的 Linux 服务器安装包,可用于在不使用 Docker 或 Electron 的情况下运行 Attu。
有疑问吗?欢迎在Milvus Discord 频道分享您的多集群配置、自定义代理技能或诊断场景,或预约Milvus 办公时间,与社区成员共同解决问题。
不想自己运维 Milvus 基础设施? Zilliz Cloud是 Milvus 创建者推出的全托管平台。它保留了 Milvus API,并增加了用于实时向量搜索、大规模发现和 AI 数据操作的托管基础设施。 对于有数据主权要求的团队,Zilliz CloudBYOC可在您自己的云账户内运行,这样数据将保留在您的 VPC 中,而 Zilliz 负责处理运维工作。
Try Managed Milvus for Free
Zilliz Cloud is hassle-free, powered by Milvus and 10x faster.
Get StartedLike the article? Spread the word



