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

Microsoft Foundry 模型目录向量器（预览版）

注释

Azure AI 搜索可通过Azure门户、REST API 和Azure SDK获取。 它也是 Foundry IQ 的基础；Foundry IQ 是一个托管式知识层，可将企业内容转化为供 Microsoft Foundry 门户中的智能体使用的、可复用且具备权限感知能力的知识库。

重要

标记为“预览”的特性、功能或属性不受服务级别协议 (SLA) 保障，不建议用于生产工作负载，并且在正式发布之前可能会更改或受到限制。 Azure AI 搜索预览条款适用于所有预览功能，无论是独立功能还是正式版功能的一部分。

Microsoft Foundry 模型目录向量器（预览版）连接到从 Foundry 模型目录或 Azure 机器学习 （AML） 终结点部署的嵌入模型。 你的数据会在模型部署的 地理环境中 处理。

如果使用集成向量化来创建向量数组，技能集应包含一个 AML 技能 ，该技能指向向量器中指定的同一模型。

先决条件

向量化器参数

参数区分大小写。 所使用的参数取决于 模型提供程序所需的身份验证（如果有）。

参数名称 描述
uri （密钥身份验证必填）来自 Microsoft Foundry 模型目录的无服务器部署的目标 URI 或 AML 联机终结点的评分 URI。 仅允许 HTTPS URI 方案。
key （ 密钥身份验证必需）模型提供程序的 API 密钥。
resourceId （令牌身份验证的必需项）模型提供程序的 Azure 资源管理器资源 ID。 对于 AML 联机终结点，请使用 subscriptions/{guid}/resourceGroups/{resource-group-name}/Microsoft.MachineLearningServices/workspaces/{workspace-name}/onlineendpoints/{endpoint_name} 格式。
modelName 在指定的 uri中部署的 Microsoft Foundry 模型目录中嵌入模型的名称。 支持的模型（仅限无服务器部署）包括：

  • Cohere-embed-v3-english
  • Cohere-embed-v3-多语言
  • Cohere-embed-v4
region （可选的令牌身份验证）模型提供程序部署所在的区域。 如果区域与搜索服务的区域不同，则为必需。
timeout （可选）HTTP 客户端在进行 API 调用时的超时时间。 它必须格式化为 XSD“dayTimeDuration”值（ ISO 8601 持续时间 值的受限子集）。 例如，PT60S 表示 60 秒。 如果未设置，则选择默认值 30 秒。 超时可以设置为最多 230 秒，最小为 1 秒。

要使用的身份验证参数

Microsoft Foundry 模型目录向量器提供两种身份验证选项：

  • 基于密钥的身份验证。 提供静态密钥以对来自向量器的评分请求进行身份验证。 设置此连接的uri参数和key参数。

  • 基于令牌的身份验证。 基于 Foundry 中心的项目或 AML 联机终结点是使用基于令牌的身份验证部署的。 Azure AI 搜索服务必须具有托管标识和模型提供程序上的角色分配。 然后，vectorizer 使用搜索服务标识对模型提供程序进行身份验证，无需静态密钥。 搜索服务标识必须具有 “所有者 ”或 “参与者 ”角色。 resourceId设置参数，如果搜索服务位于与模型提供程序不同的区域，请设置region参数。

支持的向量查询类型

Microsoft Foundry 模型目录向量器支持哪些矢量查询类型取决于配置的 modelName。

嵌入模型 支持 text 查询 支持 imageUrl 查询 支持 imageBinary 查询
Cohere-embed-v3-english X X
Cohere-embed-v3-多语言 X X
Cohere-embed-v4 X X

预期的字段维度

使用 Microsoft Foundry 模型目录向量器配置的向量字段的预期字段维度取决于所配置的 modelName。

modelName 预期尺寸
Cohere-embed-v3-english 1024
Cohere-embed-v3-多语言 1024
Cohere-embed-v4 256–1536

示例定义

Foundry 模型目录中的建议模型名称由基础模型加上随机三字母后缀组成。 模型的名称将与本示例中所示的名称不同。

"vectorizers": [
    {
        "name": "my-model-catalog-vectorizer",
        "kind": "aml",
        "amlParameters": {
            "uri": "https://Cohere-embed-v3-multilingual-hin.eastus.models.ai.azure.com",
            "key": "aaaaaaaa-0b0b-1c1c-2d2d-333333333333",
            "timeout": "PT60S",
            "modelName": "Cohere-embed-v3-multilingual-hin",
            "resourceId": null,
            "region": null,
        },
    }
]

另请参阅

  • Last updated on