Knowledge Sources - Create Or Update

• SearchIndexKnowledgeSource
• AzureBlobKnowledgeSource

• SearchIndexKnowledgeSource
• AzureBlobKnowledgeSource

ErrorResponse

错误响应。

string

指定 AI 服务资源的 API 密钥。

• SearchIndexerDataNoneIdentity
• SearchIndexerDataUserAssignedIdentity

用于出站连接的用户分配的托管标识。 如果提供了 authResourceId 但未指定，则使用系统分配的托管标识。 在更新索引时，如果未指定标识，则该值保持不变。 如果设置为“none”，则清除此属性的值。

string

调用 AI 服务视觉服务时要使用的模型版本。 未指定时，它将默认为最新的可用。

string (uri)

AI 服务资源的资源 URI。

AIServicesVisionParameters

包含特定于 AI 服务视觉嵌入矢量化的参数。

aiServicesVision

配置为用于向量搜索的矢量化方法的名称。

string

要与此特定矢量化方法关联的名称。

string

（密钥认证所需）AML 服务的密钥。

AIFoundryModelCatalogName

部署在提供的终结点的 Azure AI Foundry 目录中的嵌入模型的名称。

string

（令牌身份验证的可选）。 部署 AML 服务的区域。

string

（令牌身份验证所必需的）。 AML 服务的 Azure 资源管理器资源 ID。 它的格式应为 subscriptions/{guid}/resourceGroups/{resource-group-name}/Microsoft.MachineLearningServices/workspaces/{workspace-name}/services/{service_name}。

string (duration)

（可选）指定后，指示进行 API 调用的 http 客户端的超时。

string (uri)

（无需身份验证或密钥身份验证时需要）将向其发送 JSON 有效负载的 AML 服务的评分 URI。 只允许使用 https URI 方案。

AMLParameters

指定 AML 矢量化器的属性。

aml

配置为用于向量搜索的矢量化方法的名称。

string

要与此特定矢量化方法关联的名称。

string

向 Azure Key Vault 授予所需的访问权限的 AAD 应用程序 ID，该权限将在加密静态数据时使用。 应用程序 ID 不应与 AAD 应用程序的对象 ID 混淆。

string

指定 AAD 应用程序的身份验证密钥。

string

代理的 ETag。

AzureBlobKnowledgeSourceParameters

知识源的类型。

string

可选的用户定义描述。

SearchResourceEncryptionKey

在 Azure Key Vault 中创建的加密密钥的说明。 当你希望完全保证没有人（甚至 Microsoft）无法解密它们时，此密钥用于为代理定义提供额外的静态加密级别。 加密代理定义后，它将始终保持加密状态。 搜索服务将忽略将此属性设置为 null 的尝试。 如果要轮换加密密钥，可以根据需要更改此属性;您的代理定义将不受影响。 使用客户管理的密钥进行加密不适用于免费搜索服务，仅适用于 2019 年 1 月 1 日或之后创建的付费服务。

azureBlob

知识源的类型。

string

知识源的名称。

KnowledgeAgentAzureOpenAIModel

用于图像语言化或上下文提取的可选聊天完成模型。

string

基于密钥的连接字符串或 ResourceId 格式（如果使用托管标识）。

string

Blob 存储容器的名称。

object

由知识源创建的资源。

boolean

指示是否应禁用图像语言化。

• AIServicesVisionVectorizer
• AMLVectorizer
• AzureOpenAIVectorizer
• WebApiVectorizer

用于矢量化内容的可选矢量化器配置。

string

容器内的可选文件夹路径。

• SearchIndexerDataNoneIdentity
• SearchIndexerDataUserAssignedIdentity

用于此知识源的显式标识。

IndexingSchedule

数据摄取的可选计划。

#Microsoft.Skills.Text.AzureOpenAIEmbeddingSkill

指定技能类型的 URI 片段。

string

指定 Azure OpenAI 资源的 API 密钥。

• SearchIndexerDataNoneIdentity
• SearchIndexerDataUserAssignedIdentity

用于出站连接的用户分配的托管标识。

string

表示执行作的级别，例如文档根目录或文档内容（例如，/document 或 /document/content）。 默认值为 /document。

string

指定资源上 Azure OpenAI 模型部署的 ID。

string

描述技能的描述，描述技能的输入、输出和用法。

integer (int32)

生成的输出嵌入应有的维度数。 仅在 text-embedding-3 及更高版本中受支持。

InputFieldMappingEntry[]

技能的输入可以是源数据集中的列，也可以是上游技能的输出。

AzureOpenAIModelName

部署在提供的 deploymentId 路径上的嵌入模型的名称。

string

在技能集中唯一标识它的技能的名称。 未定义名称的技能将在技能数组中为其从 1 开始的索引的默认名称，前缀为字符“#”。

OutputFieldMappingEntry[]

技能的输出要么是搜索索引中的字段，要么是可作为其他技能输入使用的值。

string (uri)

Azure OpenAI 资源的资源 URI。

string

指定 Azure OpenAI 资源的 API 密钥。

• SearchIndexerDataNoneIdentity
• SearchIndexerDataUserAssignedIdentity

用于出站连接的用户分配的托管标识。

string

指定资源上 Azure OpenAI 模型部署的 ID。

AzureOpenAIModelName

部署在提供的 deploymentId 路径上的嵌入模型的名称。

string (uri)

Azure OpenAI 资源的资源 URI。

AzureOpenAIEmbeddingSkill

包含特定于 Azure OpenAI 嵌入矢量化的参数。

azureOpenAI

配置为用于向量搜索的矢量化方法的名称。

string

要与此特定矢量化方法关联的名称。

object

其他信息。

string

其他信息类型。

ErrorAdditionalInfo[]

错误附加信息。

string

错误代码。

ErrorDetail[]

错误详细信息。

string

错误消息。

string

错误目标。

ErrorDetail

错误对象。

string (duration)

索引器执行之间的时间间隔。

string (date-time)

索引器应开始运行的时间。

InputFieldMappingEntry[]

创建复杂类型时使用的递归输入。

string

输入的名称。

string

输入的源。

string

用于选择递归输入的源上下文。

AzureOpenAIEmbeddingSkill

包含特定于 Azure OpenAI 模型终结点的参数。

azureOpenAI

AI 模型的类型。

string

技能定义的输出的名称。

string

输出的目标名称。 它是可选的，默认为 name。

#Microsoft.Azure.Search.DataNoneIdentity

指定身份类型的 URI 片段。

#Microsoft.Azure.Search.DataUserAssignedIdentity

指定身份类型的 URI 片段。

string

用户分配的托管标识的完全限定的 Azure 资源 ID，通常采用“/subscriptions/12345678-1234-1234-1234567890ab/resourceGroups/rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId”的形式，应分配给搜索服务。

string

代理的 ETag。

string

可选的用户定义描述。

SearchResourceEncryptionKey

在 Azure Key Vault 中创建的加密密钥的说明。 当你希望完全保证没有人（甚至 Microsoft）无法解密它们时，此密钥用于为代理定义提供额外的静态加密级别。 加密代理定义后，它将始终保持加密状态。 搜索服务将忽略将此属性设置为 null 的尝试。 如果要轮换加密密钥，可以根据需要更改此属性;您的代理定义将不受影响。 使用客户管理的密钥进行加密不适用于免费搜索服务，仅适用于 2019 年 1 月 1 日或之后创建的付费服务。

searchIndex

知识源的类型。

string

知识源的名称。

SearchIndexKnowledgeSourceParameters

知识源的参数。

string

搜索索引的名称。

string

用于请求引用源数据的其他字段。

AzureActiveDirectoryApplicationCredentials

用于访问 Azure Key Vault 的可选 Azure Active Directory 凭据。 如果改用托管标识，则不需要。

• SearchIndexerDataNoneIdentity
• SearchIndexerDataUserAssignedIdentity

用于此加密密钥的显式托管标识。 如果未指定且访问凭据属性为 null，则使用系统分配的托管标识。 更新资源时，如果未指定显式标识，则该标识保持不变。 如果指定了“none”，则清除此属性的值。

string

用于加密静态数据的 Azure Key Vault 密钥的名称。

string

用于加密静态数据的 Azure Key Vault 密钥版本。

string

Azure 密钥保管库的 URI（也称为 DNS 名称），其中包含用于加密静态数据的密钥。 一个示例 URI 可能是 https://my-keyvault-name.vault.azure.net。

• SearchIndexerDataNoneIdentity
• SearchIndexerDataUserAssignedIdentity

用于出站连接的用户分配的托管标识。 如果提供了 authResourceId 但未指定，则使用系统分配的托管标识。 在更新索引器时，如果未指定标识，则该值保持不变。 如果设置为“none”，则清除此属性的值。

string

适用于连接到 Azure 函数中的外部代码或提供转换的其他应用程序中的自定义终结点。 此值应是向 Azure Active Directory 注册时为函数或应用创建的应用程序 ID。 指定后，矢量化使用搜索服务的托管 ID（系统或用户分配）和函数或应用的访问令牌连接到函数或应用，并将此值用作创建访问令牌范围的资源 ID。

object

发出 HTTP 请求所需的标头。

string

HTTP 请求的方法。

string (duration)

请求的所需超时。 默认值为 30 秒。

string (uri)

提供矢量化器的 Web API 的 URI。

WebApiParameters

指定用户定义矢量化器的属性。

customWebApi

配置为用于向量搜索的矢量化方法的名称。

string

要与此特定矢量化方法关联的名称。