重要
实体链接将从 2028 年 9 月 1 日起从 Azure AI 语言停用。 在此日期之后,不再支持实体链接功能。 在支持时段内,我们建议用户迁移现有工作负载并将所有新项目定向到 Azure AI 语言 命名实体识别 ,或者考虑其他替代解决方案。
实体链接功能允许检测和澄清文本中提到的实体的特定标识。 例如,它可以确定“火星”一词是指地球还是罗马战争之神。 此功能通过将每个实体与正确的上下文相关联来帮助消除歧义。
开发选项
若要使用实体链接,需在应用程序中提交原始非结构化文本进行分析并处理 API 输出。 分析按原样执行,不会对数据所用的模型进行其他自定义。 可通过两种方式使用实体链接:
发展选项 | Description |
---|---|
语言工作室 | Language Studio 是一个基于 Web 的平台,让你可以在没有 Azure 帐户的情况下尝试使用文本示例进行实体链接,并在注册时使用自己的数据。 有关详细信息,请参阅 Language Studio 网站。 |
REST API 或客户端库 (Azure SDK) | 使用 REST API 或以各种语言提供的客户端库将实体链接集成到应用程序中。 有关详细信息,请参阅实体链接快速入门。 |
确定如何处理数据(可选)
指定实体链接模型
默认情况下,实体链接对文本使用最新的可用 AI 模型。 你还可以将 API 请求配置为使用特定模型版本。
输入语言
将文档提交到实体链接处理时,可以指定它们所用的支持语言之一。 如果未指定语言,则实体链接默认为英语。 由于多语言和表情符号支持,响应可能包含文本偏移。
提交数据
当为实体链接提供较少的文本时,会得到更高质量的结果。 这一特征与某些特征相反,例如对较大文本块执行更好的关键短语提取。 要从两个操作获取最佳结果,请考虑相应地重建输入。
若要发送 API 请求,需要语言资源终结点和 API 密钥。
注释
可以在 Azure 门户上找到语言资源的密钥和终结点。 它们位于资源管理的“密钥和终结点”页上。
在收到请求时执行分析。 同步使用实体链接是无状态的。 不会在帐户中存储数据,结果会立即在响应中返回。
在以异步方式使用此功能时,API 结果在引入请求时的 24 小时内可用,并在响应中指示。 在此时间段后,结果将被清除,并且不再可用于检索。
获取实体链接结果
可将结果流式传输到应用程序,或者将输出保存到本地系统上的文件中。
服务和数据限制
有关每分钟和每秒可以发送的请求大小和数量信息,请参阅服务限制一文。