使用文本摘要

项目
10/09/2024

本文介绍如何将文本摘要与 Azure AI 视频索引器配合使用。此示例使用 Azure OpenAI 部署。

注意

此功能仅适用于标准帐户。创建标准帐户。

先决条件

查看纹素摘要概述。
Azure OpenAI gpt-35-turbo 或 gpt-4 部署。
部署上设置的中型或更高版本的内容筛选器。有关使用内容筛选器的详细信息，请参阅内容筛选。

重要

对于摘要（包括基于文本的摘要和关键帧），内容筛选器必须将“暴力”、“仇恨”、“性”和“自我伤害”设置为至少中等级别（这意味着至少中等级别的有害内容将被阻止。如果需要，可以将其设置为更严格，并保存内容筛选器。

对于基于关键帧的摘要，还必须创建越狱筛选器。

若要从基于关键帧的摘要中受益，必须选择接受视觉输入的 Azure Open AI 模型。
连接到 Azure OpenAI 帐户的 Azure AI 视频索引器帐户。
已在所需的 Azure 订阅中授予对 Azure OpenAI 的访问权限。目前，仅应用程序授予对此服务的访问权限。你可以通过填写表格申请访问 Azure OpenAI。
上传到 Azure AI 视频索引器库的视频。

注意

Azure AI 视频索引器无法连接到微调的模型。

在浏览器中打开网页

如果已打开所需的网页，则更容易遵循这些说明。将以下参数复制并粘贴到你喜欢的文本编辑器中。下面是一个入门列表：

VI 帐户 ID：
视频文件 ID：
部署名称：
访问令牌：

在一个选项卡或窗口中打开Azure 门户，然后登录。
1. 导航到帐户 ID 的 Azure AI 视频索引器帐户页。
2. 导航到 Azure OpenAI 帐户页
  1. 从菜单中选择“模型部署”，然后选择“管理部署”。此时会打开 Azure OpenAI Studio。复制要使用的部署名称。
在另一个选项卡或窗口中打开 Azure AI 视频索引器 Web 门户并登录。
1. 导航到库页面，选择视频，然后右键单击该视频文件 ID。
在另一个选项卡或窗口中打开 Azure AI 视频索引器 API 并登录。

生成文本摘要

可以使用 Azure AI 视频索引器 Web 门户汇总文本。

如果尚未打开 Web 门户，请打开 Azure AI 视频索引器 Web 门户。
上传文件并等待该文件编制索引。
选择要导航到媒体页面的视频。
选择“ 生成摘要”。将生成文本摘要。

注意

如果未看到“生成摘要”按钮，则可能使用的是试用帐户。创建标准帐户以使用此功能。

摘要自定义项

生成摘要后，可以通过自定义摘要样式或更改模型部署来调整摘要样式。

自定义摘要样式

还可以通过选择“ 自定义摘要”图标来自定义摘要 。可以从短、**中或长摘要长度中进行选择 ，可以选择“中性”、“ 随意”或 “正式 ”作为摘要样式。做出选择后，再次选择“生成”。

更改模型部署

选择“自定义摘要”图标。
从 “模型部署”下拉列表中选择要使用的模型部署 。
再次选择“生成”。

注意

请记住，模型部署是模型和筛选器的组合。此外，每次自定义文本摘要时，它都表示 API PUT 请求。

创建视频摘要

生成访问令牌

在Azure 门户中生成访问令牌：

导航到 Azure AI 视频索引器帐户。
从菜单中选择“管理”，然后选择“管理 API”。
在“权限类型”下拉列表中，选择“参与者”。
在“范围”下拉列表中，选择“帐户”。
然后选择“生成” 。生成访问令牌。
将访问令牌复制到剪贴板。

创建可供文本编辑器使用的视频摘要所需的所有参数。

在 Azure AI 视频索引器 API 页上，搜索摘要。
选择“创建视频摘要”旁边的“试用”按钮。此时会打开 API 参数窗格。
将剪贴板上的访问令牌粘贴到 accessToken 字段中。
从位置下拉列表中选择位置。
在 accountId 字段中复制并粘贴 VI 帐户 ID。
复制视频文件 ID 并将其粘贴到 videoId 字段中。
从 长度下拉列表中选择摘要、中、短或长长度的长度 。
从样式下拉列表中选择 样式、中性、休闲或正式样式 。
选择Send。

在响应中，有一个摘要 ID。将该 ID 复制到剪贴板。

获取视频摘要

首先，检查摘要状态。在摘要作业完成之前，状态值会显示“正在处理”，但响应中没有摘要。完成摘要作业后，摘要将显示在响应中。

选择“ GET 视频摘要”。
在相应的字段中输入帐户 ID、视频 ID、摘要 ID 和访问令牌。
选择Send。

注意

响应中始终提供有关摘要的免责声明。此外，“位置”标头中还有一个指向作业状态 API 的链接。

可以按页面列出视频摘要。选择 “GET 列表视频摘要 ”，并使用已描述的相同参数。如果有大量摘要列表，请使用页面参数返回页面中的响应。使用 GET 视频摘要请求的摘要 ID。

删除视频摘要

删除视频摘要与使用相同参数选择 DEL Delete 视频摘要和选择“ 发送”一样简单。

错误代码

请求	状态代码	错误消息	错误类型	原因	缓解措施

Create-Video-Summary	400	帐户未连接到 Azure OpenAI	INVALID_INPUT		转到Azure 门户并连接帐户。
Create-Video-Summary	400	找不到具有此名称的部署：{deploymentName}	INVALID_INPUT		检查部署名称字符串。
Create-Video-Summary	400	此模型不支持生成摘要。	INVALID_INPUT		选择其他模型
Create-Video-Summary	400	无法生成摘要，因为 AI 模型必须添加内容筛选器以避免显示有害内容。 “+ $”添加以下策略： {string。Join（“，”，Enum.GetValues<FilterType>（）。Where（type => type ！= FilterType.JailBreak）}.“ + $”将 AllowedContentLevel 设置为至少 {AllowedContentLevel.Medium} 作为源 {FilterSource.Prompt} 和 {FilterSource.Completion}	SUMMARY_FILTERS_NOT_FOUND		请参阅错误消息。
Create-Video-Summary	400	找不到视频	VIDEO_NOT_FOUND
Create-Video-Summary	400	视频索引尚未成功完成	VIDEO_ALREADY_IN_PROGRESS
Create-Video-Summary	400	无效的摘要长度值“{length}”	INVALID_INPUT
Create-Video-Summary	400	摘要样式值“{style} 无效	INVALID_INPUT
Get-Video-Summary	200	NA	NA
Get-Video-Summary	404	视频“{videoId}”找不到摘要“{summaryId}”	NOT_FOUND
Get-Video-Summary	200	无法生成摘要，因为视频内容被标记为有害。有关详细信息，请参阅内容筛选器	NA	视频中的所有部分都触发了内容筛选器。	特定视频没有解决方案。
Get-Video-Summary	200	没有足够的信息来生成摘要。	NA	视频见解不包含足够的信息，无法为 Azure OpenAI 创建提示	如果视频的预设不包含所有模型，则使用包含音频的更高级预设重新编制索引可能会有所帮助。
Get-Video-Summary	200	无法获取资源 {_resourceName} 的 Azure OpenAI 部署
Get-Video-Summary	200	部署 {DeploymentName} 不存在
Get-Video-Summary	200	无法访问 Azure OpenAI。请稍后再次尝试运行摘要。			稍后再次尝试摘要作业。
Create-Video-Summary				无角色分配
Get-Video-Summary				无角色分配

故障排除

在查找特定解决方案之前，请确保在文档的“先决条件”部分中创建了资源。

不会显示生成摘要

你可能尚未将 Azure OpenAI 帐户正确连接到 Azure AI 视频索引器帐户。

无法生成摘要

需要向部署添加内容筛选器，以避免显示有害内容。返回到 Azure OpenAI 工作室，将筛选器添加到部署。
你可能已经为包含敏感或有害内容的内容创建了一个宽松的内容筛选器。内容筛选器至少需要中等。如果将内容筛选器设置为“中等和有害内容”仍保留在视频中，则会触发该筛选器。在这种情况下，没有解决方案。
你可能没有要求听录，或者索引过程中可能没有足够的信息生成。
你可能使用的是高级预设。
视频中可能没有足够的音频来创建转换。

无法使用缺少模型部署或部署

可能尚未创建部署。
有人可能已更改或删除已部署的模型。

限制

可能会有太多请求发送到 VI。请在等待几分钟后重试。

收到错误“找不到筛选器”

如果收到未找到筛选器错误，则会收到描述缺少内容的详细错误。此错误如下所示，但可能具有有关其他缺失事项的详细信息：

ErrorType":"SUMMARY_FILTERS_NOT_FOUND","Message":"Couldn't generate a summary because the model needs to be set with the right content filters to avoid showing harmful content. Input filter 'Jailbreak' must be enabled with action set to 'Annotate and block'. Trace id: '00000000-0000-0000-0000-000000000000'.

注意

仅当使用基于关键帧的摘要或常规摘要（从 2024 年 11 月 1 日开始）时，才需要越狱筛选器。

若要解决越狱问题，请执行以下操作：

选择“ 转到 Azure Open AI Studio”。
选择“部署”。
选择正在使用的部署。
选择“编辑” 。
将筛选器配置为每个类别至少具有中等级别。
对越狱攻击应用提示盾牌。
选择“创建筛选器”。

其他注意事项

建议在同一区域中创建 Azure AI 视频索引器和 Azure OpenAI 帐户，或者可能会遇到性能问题。

通过