从门户调用必应自定义搜索实例

警告

2020 年 10 月 30 日，必应搜索 API 从 Azure AI 服务迁移到必应搜索服务。本文档仅供参考。有关更新的文档，请参阅必应搜索 API 文档。关于为必应搜索创建新的 Azure 资源的说明，请参阅通过 Azure 市场创建必应搜索资源。

配置完自定义搜索体验后，可以在必应自定义搜索门户中对其进行测试。

创建搜索查询

登录到必应自定义搜索门户后，选择你的搜索实例并单击“生产”选项卡。在“终结点”下，选择一个 API 终结点（例如，Web API）。你的订阅决定了显示哪些终结点。

若要创建搜索查询，请为终结点输入参数值。请注意，门户中显示的参数可能会根据你选择的终结点而更改。有关详细信息，请参阅自定义搜索 API 参考。若要更改搜索实例使用的订阅，添加相应的订阅密钥，并更新相应的市场和/或语言参数。

一些重要参数如下所述：

参数	说明
查询	要搜索的搜索词。仅适用于 Web 终结点、图像终结点、视频终结点和自动建议终结点
自定义配置 ID	所选自定义搜索实例的配置 ID。该字段是只读字段。
市场	结果将来自的市场。仅适用于 Web 终结点、图像终结点、视频终结点和托管 UI 终结点。
订阅密钥	测试时要使用的订阅密钥。可以从下拉列表中选择一个密钥，也可以手动输入一个。

单击“其他参数”可显示以下参数：

参数	说明
安全搜索	用于筛选成人内容网页的筛选器。仅适用于 Web 终结点、图像终结点、视频终结点和托管 UI 终结点。请注意，必应自定义视频搜索仅支持两个值：`moderate` 和 `strict`。
用户界面语言	用于用户界面字符串的语言。例如，如果你在托管 UI 中启用图像和视频，“图像”和“视频”选项卡使用指定的语言。
计数	要在响应中返回的搜索结果数。仅适用于 Web 终结点、图像终结点和视频终结点。
Offset	返回结果前要跳过的搜索结果数。仅适用于 Web 终结点、图像终结点和视频终结点。

指定所有必需选项后，单击“调用”即可在右侧窗格中查看 JSON 响应。如果选择“托管 UI”终结点，可以在底部窗格中测试搜索体验。

可更改与必应自定义搜索实例关联的订阅，而无需创建新的实例。若要针对新订阅发送 API 调用并收取调用费用，在 Azure 门户中创建一个新的必应自定义搜索资源。使用 API 请求中的新订阅密钥，以及实例的自定义配置 ID。