你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Azure 门户中 Azure AI 搜索服务管理

在 Azure AI 搜索中,Azure 门户支持广泛的管理和内容管理操作,除非你想实现自动化,否则无需编写代码。

每项搜索服务都作为独立资源进行管理。 你的角色分配决定了门户中公开的操作。

门户和管理员权限

门户访问是通过角色分配实现的。 默认情况下,所有搜索服务在开始时都至少有一个服务管理员或所有者。 服务管理员、共同管理员和所有者有权创建其他管理员和其他角色分配。 他们对默认搜索服务的所有门户页面和操作都具有完全访问权限。

如果你在搜索服务上禁用了 API 密钥并仅使用角色,则管理员必须授予自己数据平面角色分配,才能完全访问对象和数据。 这些角色分配包括搜索服务参与者、搜索索引数据参与者和搜索索引数据读取者。

提示

默认情况下,任何所有者或管理员都可以创建或删除服务。 若要防止意外删除,可以锁定资源

Azure 门户概览

概述页面是每个服务的主页。 在以下屏幕截图中,红色框表示你可能经常(尤其是在不熟悉该服务时)使用的任务、工具和磁贴。

搜索服务的门户页面

区域 说明
1 页面顶部的命令栏包括导入数据向导搜索资源管理器,用于原型制作和浏览。
2 “基本信息”部分列出了服务属性,例如,服务终结点、服务层和副本以及分区计数。
3 中心的选项卡式页面可快速访问使用情况数据和服务运行状况指标。
4 指向现有索引、索引器、数据源和技能集的导航链接。

无法更改搜索服务名称、订阅、资源组、区域(位置)或层。 切换层需要创建新的服务或提交支持工单来请求层升级,而这仅支持基本和更高级别。

第一天管理清单

对于新的搜索服务,我们建议执行这些配置任务。

启用基于角色的访问

搜索服务始终使用 API 密钥进行创建,并默认使用基于密钥的身份验证。 但是,使用 Microsoft Entra ID 和角色分配是一种更安全的选择,因为它消除了以纯文本形式存储和传递密钥的情况。

  1. 在搜索服务上启用角色。 建议使用“仅角色”选项。

  2. 对于管理,请分配数据平面角色以替换禁用 API 密钥时丢失的功能。 角色分配包括搜索服务参与者、搜索索引数据参与者和搜索索引数据读取者。 需要这三种角色分配。

    有时,角色分配可能需要五到十分钟才能生效。 在此之前,用于数据平面操作的门户页面中会出现以下消息。

    指出权限不足的门户消息的屏幕截图。

  3. 继续为解决方案开发人员和应用添加更多角色分配

配置托管标识

如果计划在自动索引、应用 AI 或集成矢量化中使用索引器,则应将搜索服务配置为使用托管标识。 然后,可以在授权搜索服务访问数据和操作的其他 Azure 服务上添加角色分配。

对于集成矢量化,搜索服务标识需要:

  • Azure 存储上的存储 Blob 数据读取者
  • Azure AI 多服务帐户上的认知服务数据用户

可能需要几分钟角色分配才会生效。

在进入网络安全之前,请考虑测试所有连接点以验证角色分配。 运行导入数据向导导入和向量化数据向导以测试权限。

配置网络安全

默认情况下,搜索服务通过公共 Internet 连接接受经过身份验证和授权的请求。 网络安全通过防火墙规则或禁用公共连接并仅允许来自 Azure 虚拟网络的请求来限制访问。

Azure AI 搜索中的安全性解释了 Azure AI 搜索中的入站和出站调用。

查看容量并了解账单

默认情况下,一个搜索服务在一个副本和分区的最小配置中创建。 可以通过添加副本和分区来添加容量,但我们建议等到卷需要添加容量时再这样做。 许多客户在最低配置上运行生产工作负荷。

某些功能会增加运行服务的成本:

启用诊断日志记录

启用诊断日志记录以跟踪用户活动。 如果跳过此步骤,仍会自动获取活动日志平台指标,但如果需要索引和查询使用情况信息,则应启用诊断日志记录并选择用于已记录操作的目标。

建议将 Log Analytics 工作区用于持久存储,以便在门户中运行系统查询。

在内部,Microsoft 会收集有关你的服务和平台的遥测数据。 若要详细了解数据保留,请参阅指标的保留期

注意

有关数据位置和隐私的详细信息,请参阅安全概述文章的“数据驻留”部分。

启用语义排序器

使用语义排序器时,每月前 1,000 个请求是免费的,但你必须选择加入才能获取免费配额。

在 Azure 门户中,在最左侧窗格上的“设置”下,选择“语义排名器”,然后选择免费计划。 有关详细信息,请参阅启用语义排序器

向开发人员提供连接信息

开发人员需要使用以下信息才能连接到 Azure AI 搜索:

  • “概述”页上提供的终结点或 URL
  • “密钥”页中的 API 密钥或角色分配(建议使用参与者角色)

建议使用以下向导和工具的门户访问权限:导入数据向导导入和向量化数据搜索资源管理器。 请记住,用户必须是参与者或更高级别的角色才能运行导入向导。

后续步骤

在以下 API 和模块中找可以到对服务管理的编程支持:

还可以使用适用于 .NET、Python、Java 和 JavaScript 的 Azure SDK 中的管理客户端库。

除预览版管理功能外,所有模态和语言都有功能奇偶一致性。 一般情况下,预览版管理功能首先通过管理 REST API 发布。