Knowledge Sources - Get

Pobiera definicję źródła wiedzy.

GET {endpoint}/knowledgesources('{sourceName}')?api-version=2026-11-01-preview

Parametry identyfikatora URI

Nazwisko W Wymagane Typ Opis
endpoint
path True

string (uri)

Adres URL punktu końcowego usługi wyszukiwania.

sourceName
path True

string

Nazwa źródła wiedzy.

api-version
query True

string

minLength: 1

Wersja interfejsu API do użycia dla tej operacji.

Nagłówek żądania

Nazwisko Wymagane Typ Opis
x-ms-client-request-id

string (uuid)

Nieprzezroczystym, globalnie unikatowym identyfikatorem ciągu generowanego przez klienta dla żądania.

Accept

Accept

Nagłówek „Accept”.

Odpowiedzi

Nazwisko Typ Opis
200 OK KnowledgeSource:

Żądanie zakończyło się pomyślnie.

Other Status Codes

ErrorResponse

Nieoczekiwana odpowiedź na błąd.

Zabezpieczenia

api-key

Typ: apiKey
W: header

OAuth2Auth

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Zakresy

Nazwisko Opis
https://search.azure.com/.default

Przykłady

SearchServiceGetKnowledgeSource
SearchServiceGetKnowledgeSourceAzureBlob
SearchServiceGetKnowledgeSourceAzureBlobGraphCache
SearchServiceGetKnowledgeSourceCompatibleChat
SearchServiceGetKnowledgeSourceFile
SearchServiceGetKnowledgeSourceIndexedOneLake
SearchServiceGetKnowledgeSourceIndexedSharePoint
SearchServiceGetKnowledgeSourceIndexedSql
SearchServiceGetKnowledgeSourceMcpServer
SearchServiceGetKnowledgeSourceOpenAICompatible
SearchServiceGetKnowledgeSourceWeb
SearchServiceGetKnowledgeSourceWorkIQ

SearchServiceGetKnowledgeSource

Przykładowe żądanie

GET https://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-preview-test')?api-version=2026-11-01-preview


Przykładowa odpowiedź

{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "ks-preview-test",
  "kind": "searchIndex",
  "description": "Description of the knowledge source.",
  "resultsProcessing": "none",
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "isServiceLevelKey": false,
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": "<applicationSecret>"
    }
  },
  "searchIndexParameters": {
    "searchIndexName": "preview-test",
    "semanticConfigurationName": "testconfig",
    "baseFilter": "category eq 'news'",
    "sourceDataFields": [
      {
        "name": "description"
      },
      {
        "name": "category"
      }
    ],
    "searchFields": [
      {
        "name": "*"
      }
    ],
    "queryHints": {
      "filters": [
        {
          "field": "model",
          "fieldValues": [
            "Model-X100",
            "Model-X200",
            "Model-Pro"
          ],
          "filterInstructions": "Product model name."
        }
      ],
      "boosts": [
        {
          "kind": "fieldValue",
          "field": "language",
          "fieldValues": [
            "en",
            "ja",
            "fr",
            "de"
          ],
          "boost": 2,
          "boostInstructions": "Document language; pick from the user's locale."
        }
      ]
    }
  }
}

SearchServiceGetKnowledgeSourceAzureBlob

Przykładowe żądanie

GET https://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-preview-test')?api-version=2026-11-01-preview


Przykładowa odpowiedź

{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "ks-preview-test",
  "kind": "azureBlob",
  "description": "Description of the knowledge source.",
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "isServiceLevelKey": false,
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": "<applicationSecret>"
    }
  },
  "azureBlobParameters": {
    "connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
    "containerName": "test-container",
    "folderPath": "test-path",
    "isADLSGen2": false,
    "ingestionParameters": {
      "disableImageVerbalization": false,
      "ingestionPermissionOptions": [
        "rbacScope"
      ],
      "contentExtractionMode": "standard",
      "networkAccessMode": "private",
      "identity": {
        "@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
        "userAssignedIdentity": "/my/userassigned/id"
      },
      "embeddingModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com",
          "deploymentId": "model",
          "apiKey": "<redacted>",
          "modelName": "text-embedding-3-large"
        }
      },
      "chatCompletionModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com",
          "deploymentId": "myDeployment",
          "apiKey": "<redacted>",
          "modelName": "gpt-4o-mini"
        }
      },
      "ingestionSchedule": {
        "interval": "P1D",
        "startTime": "2024-06-06T00:01:50.265Z"
      },
      "assetStore": {
        "connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
        "containerName": "image-assets"
      },
      "aiServices": {
        "uri": "https://my-ai-service.azure.com/",
        "apiKey": "<redacted>"
      },
      "freshnessPolicy": {
        "boostingDuration": "P90D"
      }
    },
    "createdResources": {
      "datasource": "ks-preview-test-datasource",
      "indexer": "ks-preview-test-indexer",
      "skillset": "ks-preview-test-skillset",
      "index": "ks-preview-test-index"
    }
  }
}

SearchServiceGetKnowledgeSourceAzureBlobGraphCache

Przykładowe żądanie

GET https://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-graph-cache')?api-version=2026-11-01-preview


Przykładowa odpowiedź

{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "ks-graph-cache",
  "kind": "azureBlob",
  "azureBlobParameters": {
    "connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
    "containerName": "test-container",
    "isADLSGen2": false,
    "ingestionParameters": {
      "disableImageVerbalization": true,
      "ingestionPermissionOptions": [],
      "contentExtractionMode": "minimal",
      "networkAccessMode": "public",
      "embeddingModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com",
          "deploymentId": "model",
          "apiKey": "<redacted>",
          "modelName": "text-embedding-3-large"
        }
      },
      "chatCompletionModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com",
          "deploymentId": "myDeployment",
          "apiKey": "<redacted>",
          "modelName": "gpt-4o-mini"
        }
      },
      "ingestionSchedule": {
        "interval": "P1D",
        "startTime": "2024-06-06T00:01:50.265Z"
      },
      "cache": {
        "enableReprocessing": true
      }
    },
    "graphExtraction": {
      "graphName": "products"
    },
    "createdResources": {
      "datasource": "ks-graph-cache-datasource",
      "indexer": "ks-graph-cache-indexer",
      "skillset": "ks-graph-cache-skillset",
      "index": "ks-graph-cache-index",
      "graphIndex": "ks-graph-cache-graph-index"
    }
  }
}

SearchServiceGetKnowledgeSourceCompatibleChat

Przykładowe żądanie

GET https://typespecpreviewexampleservice.search.windows.net/knowledgesources('image-documents')?api-version=2026-11-01-preview


Przykładowa odpowiedź

{
  "name": "image-documents",
  "kind": "azureBlob",
  "azureBlobParameters": {
    "connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
    "containerName": "documents",
    "ingestionParameters": {
      "chatCompletionModel": {
        "kind": "openAICompatible",
        "openAICompatibleParameters": {
          "uri": "https://model-gateway.contoso.com/teams/catalog/chat/completions?route=primary&api-version=2026-01-01",
          "modelName": "gpt-4.1-mini"
        }
      },
      "disableImageVerbalization": false,
      "contentExtractionMode": "minimal"
    }
  }
}

SearchServiceGetKnowledgeSourceFile

Przykładowe żądanie

GET https://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-preview-test')?api-version=2026-11-01-preview


Przykładowa odpowiedź

{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "ks-preview-test",
  "kind": "file",
  "description": "Description of the File knowledge source.",
  "fileParameters": {
    "ingestionParameters": {
      "ingestionPermissionOptions": [],
      "contentExtractionMode": "standard",
      "embeddingModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com",
          "deploymentId": "model",
          "apiKey": "<redacted>",
          "modelName": "text-embedding-3-large"
        }
      },
      "chatCompletionModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com",
          "deploymentId": "myDeployment",
          "apiKey": "<redacted>",
          "modelName": "gpt-4o-mini"
        }
      },
      "aiServices": {
        "uri": "https://my-ai-service.azure.com/",
        "apiKey": "<redacted>"
      }
    },
    "createdResources": {
      "index": "ks-preview-test-index"
    }
  },
  "corsOptions": {
    "allowedOrigins": [
      "https://myapp.example.com"
    ],
    "maxAgeInSeconds": 300
  }
}

SearchServiceGetKnowledgeSourceIndexedOneLake

Przykładowe żądanie

GET https://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-preview-test')?api-version=2026-11-01-preview


Przykładowa odpowiedź

{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "ks-preview-test",
  "kind": "indexedOneLake",
  "description": "Description of the OneLake knowledge source.",
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "isServiceLevelKey": false,
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": "<applicationSecret>"
    }
  },
  "indexedOneLakeParameters": {
    "fabricWorkspaceId": "<redacted>",
    "lakehouseId": "fakeLakehouseId",
    "targetPath": "testfolder",
    "ingestionParameters": {
      "disableImageVerbalization": false,
      "ingestionPermissionOptions": [],
      "contentExtractionMode": "standard",
      "networkAccessMode": "public",
      "identity": {
        "@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
        "userAssignedIdentity": "/my/userassigned/id"
      },
      "embeddingModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com",
          "deploymentId": "model",
          "apiKey": "<redacted>",
          "modelName": "text-embedding-3-large"
        }
      },
      "chatCompletionModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com",
          "deploymentId": "myDeployment",
          "apiKey": "<redacted>",
          "modelName": "gpt-4o-mini"
        }
      },
      "ingestionSchedule": {
        "interval": "P1D",
        "startTime": "2024-06-06T00:01:50.265Z"
      },
      "assetStore": {
        "connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
        "containerName": "image-assets"
      },
      "aiServices": {
        "uri": "https://my-ai-service.azure.com/",
        "apiKey": "<redacted>"
      }
    },
    "createdResources": {
      "datasource": "ks-preview-test-datasource",
      "indexer": "ks-preview-test-indexer",
      "skillset": "ks-preview-test-skillset",
      "index": "ks-preview-test-index"
    }
  }
}

SearchServiceGetKnowledgeSourceIndexedSharePoint

Przykładowe żądanie

GET https://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-preview-test')?api-version=2026-11-01-preview


Przykładowa odpowiedź

{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "ks-preview-test",
  "kind": "indexedSharePoint",
  "description": "Description of the SharePoint knowledge source.",
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "isServiceLevelKey": false,
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": "<applicationSecret>"
    }
  },
  "indexedSharePointParameters": {
    "connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
    "containerName": "defaultSiteLibrary",
    "query": "*.docx OR *.pdf",
    "ingestionParameters": {
      "disableImageVerbalization": false,
      "ingestionPermissionOptions": [
        "userIds",
        "groupIds"
      ],
      "contentExtractionMode": "standard",
      "networkAccessMode": "public",
      "identity": {
        "@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
        "userAssignedIdentity": "/my/userassigned/id"
      },
      "embeddingModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com",
          "deploymentId": "model",
          "apiKey": "<redacted>",
          "modelName": "text-embedding-3-large"
        }
      },
      "chatCompletionModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com",
          "deploymentId": "myDeployment",
          "apiKey": "<redacted>",
          "modelName": "gpt-4o-mini"
        }
      },
      "ingestionSchedule": {
        "interval": "P1D",
        "startTime": "2024-06-06T00:01:50.265Z"
      },
      "assetStore": {
        "connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
        "containerName": "image-assets"
      },
      "aiServices": {
        "uri": "https://my-ai-service.azure.com/",
        "apiKey": "<redacted>"
      },
      "freshnessPolicy": {
        "boostingDuration": "P90D"
      }
    },
    "createdResources": {
      "datasource": "ks-preview-test-datasource",
      "indexer": "ks-preview-test-indexer",
      "skillset": "ks-preview-test-skillset",
      "index": "ks-preview-test-index"
    }
  }
}

SearchServiceGetKnowledgeSourceIndexedSql

Przykładowe żądanie

GET https://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-preview-test')?api-version=2026-11-01-preview


Przykładowa odpowiedź

{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "ks-preview-test",
  "kind": "indexedSql",
  "description": "Description of the SQL knowledge source.",
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "isServiceLevelKey": false,
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": "<applicationSecret>"
    }
  },
  "indexedSqlParameters": {
    "connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
    "tableOrView": "dbo.Products",
    "contentColumns": [
      {
        "name": "title",
        "sourceField": "Title",
        "searchFieldType": "Edm.String"
      },
      {
        "name": "description",
        "sourceField": "Description",
        "searchFieldType": "Edm.String"
      },
      {
        "name": "price",
        "sourceField": "Price",
        "searchFieldType": "Edm.Double"
      }
    ],
    "embeddingColumns": [
      {
        "name": "descriptionEmbedding",
        "sourceField": "Description"
      }
    ],
    "ingestionParameters": {
      "ingestionPermissionOptions": [],
      "contentExtractionMode": "minimal",
      "networkAccessMode": "public",
      "identity": {
        "@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
        "userAssignedIdentity": "/my/userassigned/id"
      },
      "embeddingModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com",
          "deploymentId": "model",
          "apiKey": "<redacted>",
          "modelName": "text-embedding-3-large"
        }
      },
      "ingestionSchedule": {
        "interval": "P1D",
        "startTime": "2024-06-06T00:01:50.265Z"
      }
    },
    "createdResources": {
      "datasource": "ks-preview-test-datasource",
      "indexer": "ks-preview-test-indexer",
      "skillset": "ks-preview-test-skillset",
      "index": "ks-preview-test-index"
    }
  }
}

SearchServiceGetKnowledgeSourceMcpServer

Przykładowe żądanie

GET https://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-preview-test')?api-version=2026-11-01-preview


Przykładowa odpowiedź

{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "ks-preview-test",
  "kind": "mcpServer",
  "description": "Description of the MCP server knowledge source.",
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "isServiceLevelKey": false,
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": "<applicationSecret>"
    }
  },
  "mcpServerParameters": {
    "serverURL": "https://mcp.contoso.com/sse",
    "authentication": {
      "kind": "foundryConnection",
      "foundryConnectionParameters": {
        "connectionId": "conn-123"
      }
    },
    "tools": [
      {
        "name": "search-code",
        "resultsProcessing": "rerank",
        "maxOutputTokens": 4096,
        "outputParsing": {
          "kind": "json",
          "jsonParameters": {
            "documentsPath": "$.documents[*]",
            "includeContext": true
          }
        }
      }
    ]
  }
}

SearchServiceGetKnowledgeSourceOpenAICompatible

Przykładowe żądanie

GET https://typespecpreviewexampleservice.search.windows.net/knowledgesources('compatible-preview-file-source')?api-version=2026-11-01-preview


Przykładowa odpowiedź

{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "compatible-preview-file-source",
  "kind": "file",
  "description": "Description of the File knowledge source.",
  "fileParameters": {
    "ingestionParameters": {
      "ingestionPermissionOptions": [],
      "contentExtractionMode": "standard",
      "embeddingModel": {
        "kind": "openAICompatible",
        "openAICompatibleParameters": {
          "uri": "https://model-gateway.contoso.com/teams/catalog/embeddings?route=primary&api-version=2026-01-01",
          "modelName": "text-embedding-3-small",
          "dimensions": 1024
        }
      },
      "chatCompletionModel": {
        "kind": "azureOpenAI",
        "azureOpenAIParameters": {
          "resourceUri": "https://test-sample.openai.azure.com",
          "deploymentId": "myDeployment",
          "apiKey": "<redacted>",
          "modelName": "gpt-4o-mini"
        }
      },
      "aiServices": {
        "uri": "https://my-ai-service.azure.com/",
        "apiKey": "<redacted>"
      }
    },
    "createdResources": {
      "index": "compatible-preview-file-source-index"
    }
  },
  "corsOptions": {
    "allowedOrigins": [
      "https://myapp.example.com"
    ],
    "maxAgeInSeconds": 300
  }
}

SearchServiceGetKnowledgeSourceWeb

Przykładowe żądanie

GET https://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-preview-test')?api-version=2026-11-01-preview


Przykładowa odpowiedź

{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "ks-preview-test",
  "kind": "web",
  "description": "Description of the knowledge source.",
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "isServiceLevelKey": false,
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": "<applicationSecret>"
    }
  },
  "webParameters": {
    "domains": {
      "allowedDomains": [
        {
          "address": "example.com",
          "includeSubpages": true
        },
        {
          "address": "another-example.com"
        }
      ],
      "blockedDomains": [
        {
          "address": "blocked.com"
        },
        {
          "address": "spam.com",
          "includeSubpages": true
        }
      ]
    }
  }
}

SearchServiceGetKnowledgeSourceWorkIQ

Przykładowe żądanie

GET https://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-preview-test')?api-version=2026-11-01-preview


Przykładowa odpowiedź

{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "ks-preview-test",
  "kind": "workIQ",
  "description": "Description of the WorkIQ knowledge source.",
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "isServiceLevelKey": false,
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": "<applicationSecret>"
    }
  },
  "workIQParameters": {
    "entraAppAuthentication": {
      "applicationId": "11111111-1111-1111-1111-111111111111",
      "federatedCredentialId": "22222222-2222-2222-2222-222222222222"
    }
  }
}

Definicje

Nazwisko Opis
Accept

Nagłówek „Accept”.

AIServices

Parametry dla usług AI.

AssetStore

Konfiguracja magazynu zasobów używanego do przechowywania wyodrębnionych zasobów, takich jak obrazy.

AzureBlobKnowledgeSource

Konfiguracja źródła wiedzy Azure Blob Storage.

AzureBlobKnowledgeSourceParameters

Parametry źródła wiedzy Azure Blob Storage.

AzureOpenAIModelName

Nazwa modelu Azure Open AI, który zostanie wywołany.

AzureOpenAIVectorizerParameters

Określa parametry nawiązywania połączenia z zasobem usługi Azure OpenAI.

BalancedVectorQueryTopicGraph

Łączy czyste podobieństwo wektorowe z wyszukiwaniem uwzględniającym różnorodność. Zalecany domyślny sposób jest równoważenie różnorodności z trafnością.

ContentColumnMapping

Mapuje kolumnę SQL na pole indeksu wyszukiwania.

CorsOptions

Definiuje opcje kontrolowania współużytkowania zasobów między źródłami (CORS) dla indeksu.

DiverseVectorQueryTopicGraph

Wykorzystuje wykres tematyczny do różnorodnego wyszukiwania.

EmbeddingColumnMapping

Mapuje kolumnę SQL na pole wektorowe do osadzania.

EntraAppAuthentication

Konfiguracja rejestracji aplikacji Microsoft Entra należącej do klienta do federacyjnej uwierzytelniania opartej na poświadczeniu na zlecenie.

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

ErrorDetail

Szczegóły błędu.

ErrorResponse

Typowa odpowiedź na błędy dla wszystkich interfejsów API usługi Azure Resource Manager w celu zwrócenia szczegółów błędu dla operacji, które zakończyły się niepowodzeniem. (Jest to również zgodne z formatem odpowiedzi na błąd OData).

FabricDataAgentKnowledgeSource

Konfiguracja dla źródła wiedzy Fabric Data Agent.

FabricDataAgentKnowledgeSourceParameters

Parametry dla źródła wiedzy Fabric Data Agent.

FabricOntologyKnowledgeSource

Konfiguracja dla źródła wiedzy Fabric Ontology.

FabricOntologyKnowledgeSourceParameters

Parametry dla źródła wiedzy o Fabric Ontology.

FileKnowledgeSource

Konfiguracja dla źródła wiedzy plików, które obsługuje bezpośredni upload i indeksowanie plików.

FileKnowledgeSourceParameters

Parametry dla źródła wiedzy pliku.

FreshnessPolicy

Konfiguracja do pobierania z uwzględnieniem świeżości. Po ustawieniu nowsze dokumenty otrzymują wzrost rankingu podczas pobierania.

IndexedOneLakeKnowledgeSource

Konfiguracja dla źródła wiedzy OneLake.

IndexedOneLakeKnowledgeSourceParameters

Parametry źródła wiedzy OneLake.

IndexedSharePointContainerName

Określa, do których bibliotek programu SharePoint należy uzyskać dostęp.

IndexedSharePointKnowledgeSource

Konfiguracja źródła wiedzy programu SharePoint.

IndexedSharePointKnowledgeSourceParameters

Parametry źródła wiedzy programu SharePoint.

IndexedSqlKnowledgeSource

Konfiguracja dla indeksowanego źródła wiedzy SQL.

IndexedSqlKnowledgeSourceParameters

Parametry dla indeksowanego źródła wiedzy SQL.

IndexingSchedule

Reprezentuje harmonogram wykonywania indeksatora.

KnowledgeBaseAzureOpenAIModel

Określa zasób usługi Azure OpenAI używany do planowania zapytań.

KnowledgeBaseMicrosoftRetriever1Model

Określa Microsoft Retriever 1 używany do planowania i pobierania zapytań.

KnowledgeBaseModelKind

Model sztucznej inteligencji, który ma być używany do planowania zapytań.

KnowledgeBaseOpenAICompatibleModel

Określa kontrolowany przez klienta model zgodny z OpenAI do wyszukiwania bazy wiedzy lub werbalizacji obrazu źródła wiedzy w trybie minimalnym. Do pobrania profil modelu wybiera Zakończenia czatu lub Odpowiedzi. Nie obsługiwane dla ekstrakcji Standard/CU lub baz wiedzy z Web Resources Resources.

KnowledgeBaseOpenAICompatibleParameters

Parametry połączenia dla kompatybilnego z OpenAI punktu końcowego Chat Completions lub Responses. Tworzenie wymaga dokładnie jednego z niepustych nagłówków lub managedIdentityAudience. Aktualizacje mogą pominąć nagłówki, aby zachować dane uwierzytelniające dla niezmienionego połączenia i profilu modelu.

KnowledgeSourceAzureOpenAIVectorizer

Określa zasób usługi Azure OpenAI używany do wektoryzacji ciągu zapytania.

KnowledgeSourceCache

Konfiguruje pamięć dla wyników wzbogacania buforowanego źródła wiedzy. Wymaga konta pamięci masowej GPv2 z punktami końcowymi Blob i Table. Powiązanie pamięci podręcznej i tożsamość nie mogą być zmieniane po utworzeniu, a pamięci podręcznej nie można usunąć podczas korzystania z przepływu pracy z ekstrakcją grafów.

KnowledgeSourceGraphExtractionParameters

Konfiguruje ekstrakcję grafu ze źródła wiedzy Azure Blob z włączonym natywnym miękkim usuwaniem Blob przed indeksowaniem. ADLS Gen2, przyjmowanie ACL oraz pobieranie etykiet wrażliwości nie są obsługiwane. Zmiany w różnych ontologiach muszą poczekać, aż synchronizacja nie będzie aktywna.

KnowledgeSourceGraphGrounding

Źródło uziemienia do ekstrakcji grafów. Obsługiwane są tylko indeksy wyszukiwania tej samej usługi.

KnowledgeSourceGraphGroundingIndex

Identyfikuje indeks wyszukiwania używany do uziemiania wyodrębnionych obiektów.

KnowledgeSourceGraphGroundingSourceKind

Rodzaj źródła jawnego dla odniesienia uziemiającego. Obsługiwany jest tylko searchIndex.

KnowledgeSourceGraphOntology

Ontologia inline do ekstrakcji grafów. Jedynym obsługiwanym źródłem jest dokument z ograniczonym JSON-LD dostarczony bezpośrednio w żądaniu.

KnowledgeSourceGraphOntologySourceKind

Jawny rodzaj źródła dla referencji ontologicznej. Obsługiwane jest tylko "inline".

KnowledgeSourceIngestionParameters

Konsoliduje wszystkie ogólne ustawienia pozyskiwania dla źródeł wiedzy.

KnowledgeSourceIngestionPermissionOption

Rodzaje uprawnień do pobierania razem z treścią dokumentu.

KnowledgeSourceKind

Rodzaj źródła wiedzy.

KnowledgeSourceNetworkAccessMode

Określa tryb dostępu sieciowego do pobierania źródeł danych. Domyślnie jest 'publiczne'.

KnowledgeSourceOpenAICompatibleVectorizer

Kompatybilny z OpenAI punkt końcowy osadzeń używany do zarządzanego importu źródeł wiedzy oraz generowanej wektoryzacji zapytań. Zmiana modelu osadzania natywnego wymaga ponownego odtworzenia źródła wiedzy i ponownego indeksowania. URI, modelName i wymiary nie mogą zostać zmienione po utworzeniu.

KnowledgeSourceResultsProcessing

Kontroluje, czy wyniki źródła wiedzy zostaną ponownie uszeregowane.

McpServerAuthenticationKind

Taki rodzaj uwierzytelniania dla serwera MCP.

McpServerAutoOutputParsing

Automatycznie wykrywaj format wyjściowy i analizuj odpowiednio.

McpServerFoundryConnectionAuthentication

Uwierzytelnianie za pomocą połączenia Azure AI Foundry.

McpServerFoundryConnectionParameters

Parametry uwierzytelniania połączenia z Foundry.

McpServerJsonOutputParsing

Analizuj wynik jako dokument JSON, używając skonfigurowanych parametrów JSON.

McpServerKnowledgeSource

Konfiguracja dla źródła wiedzy wspieranego przez serwer MCP (Model Context Protocol).

McpServerKnowledgeSourceParameters

Parametry dla źródła wiedzy serwera MCP.

McpServerNoneOutputParsing

Traktuj wyjście jako pojedynczy blok bez żadnego parsowania.

McpServerOutputParsingJsonParameters

Parametry parsowania wyjściowego JSON.

McpServerOutputParsingKind

Taki rodzaj parsowania wyników dla narzędzia serwera MCP.

McpServerOutputParsingSplitParameters

Parametry do parsowania wyjścia podzielonego.

McpServerSplitOutputParsing

Podziel wyjście na strony za pomocą skonfigurowanych parametrów podziału.

McpServerStoredHeadersAuthentication

Uwierzytelnianie za pomocą zapisanych nagłówków HTTP.

McpServerStoredHeadersParameters

Parametry uwierzytelniania zapisanych nagłówków.

McpServerTool

Reprezentuje pojedyncze narzędzie w źródle wiedzy serwera MCP.

NoneVectorQueryTopicGraph

Używa normalnego wyszukiwania wektorowego bez wykresu tematów – różnorodne wyszukiwanie.

OpenAICompatibleVectorizerParameters

Parametry połączenia dla bezpośredniego punktu końcowego embeddings zgodnego z OpenAI. Tworzenie wymaga dokładnie jednego z niepustych nagłówków lub managedIdentityAudience. Aktualizacje mogą pominąć nagłówki, aby zachować dane uwierzytelniające dla niezmienionego profilu połączenia i osadzania.

RemoteSharePointKnowledgeSource

Konfiguracja zdalnego źródła wiedzy programu SharePoint.

RemoteSharePointKnowledgeSourceParameters

Parametry zdalnego źródła wiedzy programu SharePoint.

SearchIndexerDataNoneIdentity

Czyści właściwość tożsamości źródła danych.

SearchIndexerDataUserAssignedIdentity

Określa tożsamość źródła danych do użycia.

SearchIndexFieldReference

Referencja polowa dla indeksu wyszukiwania.

SearchIndexKnowledgeSource

Źródło wiedzy przeznaczone dla indeksu wyszukiwania.

SearchIndexKnowledgeSourceBoostKind

Taki rodzaj podpowiedzi do indeksu wyszukiwania jako źródło wiedzy.

SearchIndexKnowledgeSourceFieldValueBoost

Wskazówka, która zwiększa liczbę dokumentów na podstawie wartości pola.

SearchIndexKnowledgeSourceFilterHint

Podpowiedzi identyfikującej pole oraz wyczerpujące wartości uziemienia, które planer zapytań może wykorzystać podczas tworzenia filtra.

SearchIndexKnowledgeSourceFilterHintAutoConfiguration

Konfiguruje automatyczne rozwiązywanie wartości uziemienia wskazówki filtra na podstawie faset indeksu docelowego.

SearchIndexKnowledgeSourceMultiWordExpressionBoost

Wskazówka, która wzmacnia dokumenty oparte na wielowyrazowym wyrażeniu.

SearchIndexKnowledgeSourceParameters

Parametry źródła wiedzy indeksu wyszukiwania.

SearchIndexKnowledgeSourceQueryHints

Wskazówki, które prowadzą planowanie zapytań do przydatnych filtrów i wzmocnień dla źródła wiedzy indeksu wyszukiwania.

SearchResourceEncryptionKey

Klucz szyfrowania zarządzany przez klienta w usłudze Azure Key Vault. Klucze, które tworzysz i którymi zarządzasz, mogą służyć do szyfrowania lub odszyfrowywania danych magazynowanych, takich jak indeksy i mapy synonimów.

SplitSkillLanguage

Kody języków obsługiwane dla tekstu wejściowego przez SplitSkill.

TextSplitMode

Wartość wskazująca tryb podziału do wykonania.

VectorSearchTopicGraphKind

Rodzaj wyszukiwania wektorowego na grafach tematycznych, którego należy użyć.

VectorSearchVectorizerKind

Metoda wektoryzacji, która ma być używana w czasie wykonywania zapytania.

WebKnowledgeSource

Źródło wiedzy kierowane na wyniki w internecie.

WebKnowledgeSourceDomain

Konfiguracja domeny źródła wiedzy sieci Web.

WebKnowledgeSourceDomains

Konfiguracja zezwalania/blokowania domeny dla internetowego źródła wiedzy.

WebKnowledgeSourceParameters

Parametry źródła wiedzy internetowej.

WorkIQKnowledgeSource

Konfiguracja dla źródła wiedzy WorkIQ.

WorkIQKnowledgeSourceParameters

Parametry dla źródła wiedzy o WorkIQ.

Accept

Nagłówek „Accept”.

Wartość Opis
application/json;odata.metadata=minimal

AIServices

Parametry dla usług AI.

Nazwisko Typ Opis
apiKey

string

Klucz interfejsu API służący do uzyskiwania dostępu do usług AI.

uri

string (uri)

Identyfikator URI punktu końcowego usług AI.

AssetStore

Konfiguracja magazynu zasobów używanego do przechowywania wyodrębnionych zasobów, takich jak obrazy.

Nazwisko Typ Opis
connectionString

string

Ciąg parametry połączenia dla magazynu zasobów.

containerName

string

Nazwa kontenera blob w magazynie zasobów, gdzie przechowywane są wyodrębnione zasoby (na przykład obrazy).

AzureBlobKnowledgeSource

Konfiguracja źródła wiedzy Azure Blob Storage.

Nazwisko Typ Opis
@odata.etag

string

ETag źródła wiedzy.

azureBlobParameters

AzureBlobKnowledgeSourceParameters

Typ źródła wiedzy.

description

string

Opcjonalny opis zdefiniowany przez użytkownika.

encryptionKey

SearchResourceEncryptionKey

Opis klucza szyfrowania utworzonego w usłudze Azure Key Vault. Ten klucz służy do zapewnienia dodatkowego poziomu szyfrowania w spoczynku dla definicji źródła wiedzy, gdy chcesz mieć pełną pewność, że nikt, nawet Microsoft, nie jest w stanie go odszyfrować. Gdy już zaszyfrujesz definicję źródła wiedzy, zawsze pozostanie ona zaszyfrowana. Usługa wyszukiwania zignoruje próby ustawienia tej właściwości na wartość null. Możesz zmienić tę właściwość w razie potrzeby, jeśli chcesz obracać klucz szyfrujący; Definicja źródła wiedzy nie zostanie zmieniona. Szyfrowanie za pomocą kluczy zarządzanych przez klienta nie jest dostępne dla bezpłatnych usług wyszukiwania i jest dostępne tylko dla płatnych usług utworzonych w dniu 1 stycznia 2019 r. lub po 1 stycznia 2019 r.

kind string:

azureBlob

Typ źródła wiedzy.

name

string

Nazwa źródła wiedzy.

resultsProcessing

KnowledgeSourceResultsProcessing

Kontroluje, czy wyniki z tego źródła wiedzy zostaną ponownie ocenione, zanim zostaną uwzględnione w ostatecznym zestawie wyników. Domyślnie zmienia ranking, gdy nie jest to określone.

AzureBlobKnowledgeSourceParameters

Parametry źródła wiedzy Azure Blob Storage.

Nazwisko Typ Domyślna wartość Opis
connectionString

string

Parametry połączenia oparte na kluczach lub format ResourceId w przypadku korzystania z tożsamości zarządzanej.

containerName

string

Nazwa kontenera przechowywania blobów.

createdResources

object

Zasoby utworzone przez źródło wiedzy.

folderPath

string

Opcjonalna ścieżka folderu w kontenerze.

graphExtraction

KnowledgeSourceGraphExtractionParameters

Konfiguracja ekstrakcji grafów dla źródeł wiedzy Azure Blob. Skonfiguruj natywne miękkie usuwanie Blob na źródle przed pierwszym uruchomieniem indeksowania. ADLS Gen2, pobieranie ACL oraz pobieranie etykiet wrażliwości nie są obsługiwane w tym przepływie pracy.

ingestionParameters

KnowledgeSourceIngestionParameters

Konsoliduje wszystkie ogólne ustawienia pozyskiwania.

isADLSGen2

boolean

False

Ustaw wartość true w przypadku nawiązywania połączenia z kontem magazynu usługi ADLS Gen2. Wartość domyślna to „false”.

topicGraph VectorQueryTopicGraph:

Domyślne opcje wyszukiwania wektorowego wykresu tematu dla tego źródła wiedzy Azure Blob.

AzureOpenAIModelName

Nazwa modelu Azure Open AI, który zostanie wywołany.

Wartość Opis
text-embedding-ada-002

Model TextEmbeddingAda002.

text-embedding-3-large

Model TextEmbedding3Large.

text-embedding-3-small

Model TextEmbedding3Small.

gpt-4o

Model Gpt4o.

gpt-4o-mini

Model Gpt4oMini.

gpt-4.1

Model Gpt41.

gpt-4.1-mini

Model Gpt41Mini.

gpt-4.1-nano

Model Gpt41Nano.

gpt-5

Model GPT5.

gpt-5-mini

Model Gpt5Mini.

gpt-5-nano

Model Gpt5Nano.

gpt-5.1

Model Gpt51.

gpt-5.2

Model Gpt52.

gpt-5.4

Model Gpt54.

gpt-5.4-mini

Model Gpt54Mini.

gpt-5.4-nano

Model Gpt54Nano.

gpt-5.5

Model Gpt55.

gpt-5.6-sol

Model Gpt56Sol.

gpt-5.6-terra

Model Gpt56Terra.

gpt-5.6-luna

Model Gpt56Luna.

gpt-6-astra

Model Gpt6Astra.

gpt-6-sol

Model Gpt6Sol.

gpt-6-luna

Model Gpt6Luna.

gpt-6.1-sol

Model GPT61Sol.

AzureOpenAIVectorizerParameters

Określa parametry nawiązywania połączenia z zasobem usługi Azure OpenAI.

Nazwisko Typ Opis
apiKey

string

Klucz interfejsu API wyznaczonego zasobu usługi Azure OpenAI.

authIdentity SearchIndexerDataIdentity:

Tożsamość zarządzana przypisana przez użytkownika używana na potrzeby połączeń wychodzących.

deploymentId

string

Identyfikator wdrożenia modelu Usługi Azure OpenAI w wyznaczonym zasobie.

modelName

AzureOpenAIModelName

Nazwa modelu osadzania wdrożonego w podanej ścieżce deploymentId.

resourceUri

string (uri)

Identyfikator URI zasobu usługi Azure OpenAI.

BalancedVectorQueryTopicGraph

Łączy czyste podobieństwo wektorowe z wyszukiwaniem uwzględniającym różnorodność. Zalecany domyślny sposób jest równoważenie różnorodności z trafnością.

Nazwisko Typ Opis
kind string:

balanced

Rodzaj wyszukiwania wektorowego na grafach tematycznych, którego należy użyć.

minDiversityPoolSize

integer (int32)

minimum: 250
maximum: 10000

Minimalna liczba kandydatów na wektory do pobrania przed próbkowaniem grafu tematycznego. Wartość domyślna to 1000.

ContentColumnMapping

Mapuje kolumnę SQL na pole indeksu wyszukiwania.

Nazwisko Typ Opis
name

string

Nazwa pola indeksu docelowego.

searchFieldType

string

Wyszukiwanie AI platformy Azure field type (np. Edm.String, Edm.Int32).

sourceField

string

Nazwa kolumny SQL.

CorsOptions

Definiuje opcje kontrolowania współużytkowania zasobów między źródłami (CORS) dla indeksu.

Nazwisko Typ Opis
allowedOrigins

string[]

Lista źródeł, z których kod JavaScript będzie miał dostęp do indeksu. Może zawierać listę hostów w postaci {protocol}://{fully-qualified-domain-name}[:{port#}] lub pojedynczy znak "*", aby zezwolić na wszystkie źródła (niezalecane).

maxAgeInSeconds

integer (int64)

Czas, przez jaki przeglądarki powinny buforować odpowiedzi inspekcji wstępnej CORS. Wartość domyślna to 5 minut.

DiverseVectorQueryTopicGraph

Wykorzystuje wykres tematyczny do różnorodnego wyszukiwania.

Nazwisko Typ Opis
diversityFactor

number (float)

minimum: 0
maximum: 1

Współczynnik różnorodności używany do wyszukiwania różnorodności na wykresie tematycznym. Jeśli zostanie pominięty, używany jest domyślny profil wykresu tematu.

kind string:

diverse

Rodzaj wyszukiwania wektorowego na grafach tematycznych, którego należy użyć.

minDiversityPoolSize

integer (int32)

minimum: 250
maximum: 10000

Minimalna liczba kandydatów na wektory do pobrania przed próbkowaniem grafu tematycznego. Wartość domyślna to 1000.

EmbeddingColumnMapping

Mapuje kolumnę SQL na pole wektorowe do osadzania.

Nazwisko Typ Opis
name

string

Nazwa pola wektora docelowego w indeksie wyszukiwania.

sourceField

string

Kolumna SQL używana jako wejście do generowania osadzeń.

EntraAppAuthentication

Konfiguracja rejestracji aplikacji Microsoft Entra należącej do klienta do federacyjnej uwierzytelniania opartej na poświadczeniu na zlecenie.

Nazwisko Typ Opis
applicationId

string (uuid)

ID aplikacji (klienta) rejestracji aplikacji Entra należącej do klienta.

federatedCredentialId

string (uuid)

Federowany identyfikator uwierzytelniający konfigurował się podczas rejestracji aplikacji, umożliwiając usłudze wyszukiwania uwierzytelnianie się jako aplikacja bez zapisanego sekretu klienta.

tenantId

string (uuid)

Identyfikator najemcy rejestracji aplikacji. Wymagane, gdy rejestracja aplikacji jest w innym najemcy niż usługa wyszukiwania. Jeśli zostanie pominięty, używa się najemcy usługi wyszukiwania.

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwisko Typ Opis
info

Dodatkowe informacje.

type

string

Dodatkowy typ informacji.

ErrorDetail

Szczegóły błędu.

Nazwisko Typ Opis
additionalInfo

ErrorAdditionalInfo[]

Dodatkowe informacje o błędzie

code

string

Kod błędu.

details

ErrorDetail[]

Szczegóły błędu.

message

string

Komunikat o błędzie.

target

string

Cel błędu.

ErrorResponse

Typowa odpowiedź na błędy dla wszystkich interfejsów API usługi Azure Resource Manager w celu zwrócenia szczegółów błędu dla operacji, które zakończyły się niepowodzeniem. (Jest to również zgodne z formatem odpowiedzi na błąd OData).

Nazwisko Typ Opis
error

ErrorDetail

Obiekt błędu.

FabricDataAgentKnowledgeSource

Konfiguracja dla źródła wiedzy Fabric Data Agent.

Nazwisko Typ Opis
@odata.etag

string

ETag źródła wiedzy.

description

string

Opcjonalny opis zdefiniowany przez użytkownika.

encryptionKey

SearchResourceEncryptionKey

Opis klucza szyfrowania utworzonego w usłudze Azure Key Vault. Ten klucz służy do zapewnienia dodatkowego poziomu szyfrowania w spoczynku dla definicji źródła wiedzy, gdy chcesz mieć pełną pewność, że nikt, nawet Microsoft, nie jest w stanie go odszyfrować. Gdy już zaszyfrujesz definicję źródła wiedzy, zawsze pozostanie ona zaszyfrowana. Usługa wyszukiwania zignoruje próby ustawienia tej właściwości na wartość null. Możesz zmienić tę właściwość w razie potrzeby, jeśli chcesz obracać klucz szyfrujący; Definicja źródła wiedzy nie zostanie zmieniona. Szyfrowanie za pomocą kluczy zarządzanych przez klienta nie jest dostępne dla bezpłatnych usług wyszukiwania i jest dostępne tylko dla płatnych usług utworzonych w dniu 1 stycznia 2019 r. lub po 1 stycznia 2019 r.

fabricDataAgentParameters

FabricDataAgentKnowledgeSourceParameters

Parametry źródła wiedzy Fabric Data Agent.

kind string:

fabricDataAgent

Typ źródła wiedzy.

name

string

Nazwa źródła wiedzy.

resultsProcessing

KnowledgeSourceResultsProcessing

Kontroluje, czy wyniki z tego źródła wiedzy zostaną ponownie ocenione, zanim zostaną uwzględnione w ostatecznym zestawie wyników. Domyślnie zmienia ranking, gdy nie jest to określone.

FabricDataAgentKnowledgeSourceParameters

Parametry dla źródła wiedzy Fabric Data Agent.

Nazwisko Typ Opis
dataAgentId

string

Określa, do którego agenta danych Fabric należy uruchomić.

workspaceId

string

Identyfikator przestrzeni roboczej Fabric.

FabricOntologyKnowledgeSource

Konfiguracja dla źródła wiedzy Fabric Ontology.

Nazwisko Typ Opis
@odata.etag

string

ETag źródła wiedzy.

description

string

Opcjonalny opis zdefiniowany przez użytkownika.

encryptionKey

SearchResourceEncryptionKey

Opis klucza szyfrowania utworzonego w usłudze Azure Key Vault. Ten klucz służy do zapewnienia dodatkowego poziomu szyfrowania w spoczynku dla definicji źródła wiedzy, gdy chcesz mieć pełną pewność, że nikt, nawet Microsoft, nie jest w stanie go odszyfrować. Gdy już zaszyfrujesz definicję źródła wiedzy, zawsze pozostanie ona zaszyfrowana. Usługa wyszukiwania zignoruje próby ustawienia tej właściwości na wartość null. Możesz zmienić tę właściwość w razie potrzeby, jeśli chcesz obracać klucz szyfrujący; Definicja źródła wiedzy nie zostanie zmieniona. Szyfrowanie za pomocą kluczy zarządzanych przez klienta nie jest dostępne dla bezpłatnych usług wyszukiwania i jest dostępne tylko dla płatnych usług utworzonych w dniu 1 stycznia 2019 r. lub po 1 stycznia 2019 r.

fabricOntologyParameters

FabricOntologyKnowledgeSourceParameters

Parametry źródła wiedzy Fabric Ontology.

kind string:

fabricOntology

Typ źródła wiedzy.

name

string

Nazwa źródła wiedzy.

resultsProcessing

KnowledgeSourceResultsProcessing

Kontroluje, czy wyniki z tego źródła wiedzy zostaną ponownie ocenione, zanim zostaną uwzględnione w ostatecznym zestawie wyników. Domyślnie zmienia ranking, gdy nie jest to określone.

FabricOntologyKnowledgeSourceParameters

Parametry dla źródła wiedzy o Fabric Ontology.

Nazwisko Typ Opis
ontologyId

string

ID ontologii do użycia z przestrzeni roboczej Fabric.

workspaceId

string

Identyfikator przestrzeni roboczej Fabric zawierający ontologię.

FileKnowledgeSource

Konfiguracja dla źródła wiedzy plików, które obsługuje bezpośredni upload i indeksowanie plików.

Nazwisko Typ Opis
@odata.etag

string

ETag źródła wiedzy.

corsOptions

CorsOptions

Opcje sterowania Cross-Origin Resource Sharing (CORS) dla końcowych punktów plików źródła wiedzy plikowej (przesyłanie, listowanie, aktualizacja, usuwanie).

description

string

Opcjonalny opis zdefiniowany przez użytkownika.

encryptionKey

SearchResourceEncryptionKey

Opis klucza szyfrowania utworzonego w usłudze Azure Key Vault. Ten klucz służy do zapewnienia dodatkowego poziomu szyfrowania w spoczynku dla definicji źródła wiedzy, gdy chcesz mieć pełną pewność, że nikt, nawet Microsoft, nie jest w stanie go odszyfrować. Gdy już zaszyfrujesz definicję źródła wiedzy, zawsze pozostanie ona zaszyfrowana. Usługa wyszukiwania zignoruje próby ustawienia tej właściwości na wartość null. Możesz zmienić tę właściwość w razie potrzeby, jeśli chcesz obracać klucz szyfrujący; Definicja źródła wiedzy nie zostanie zmieniona. Szyfrowanie za pomocą kluczy zarządzanych przez klienta nie jest dostępne dla bezpłatnych usług wyszukiwania i jest dostępne tylko dla płatnych usług utworzonych w dniu 1 stycznia 2019 r. lub po 1 stycznia 2019 r.

fileParameters

FileKnowledgeSourceParameters

Parametry dla źródła wiedzy pliku.

kind string:

file

Typ źródła wiedzy.

name

string

Nazwa źródła wiedzy.

resultsProcessing

KnowledgeSourceResultsProcessing

Kontroluje, czy wyniki z tego źródła wiedzy zostaną ponownie ocenione, zanim zostaną uwzględnione w ostatecznym zestawie wyników. Domyślnie zmienia ranking, gdy nie jest to określone.

FileKnowledgeSourceParameters

Parametry dla źródła wiedzy pliku.

Nazwisko Typ Opis
createdResources

object

Zasoby tworzone przez źródło wiedzy pliku.

ingestionParameters

KnowledgeSourceIngestionParameters

Konsoliduje wszystkie ogólne ustawienia pobierania dla źródła wiedzy pliku, w tym tryb ekstrakcji treści oraz opcjonalny model embedding.

FreshnessPolicy

Konfiguracja do pobierania z uwzględnieniem świeżości. Po ustawieniu nowsze dokumenty otrzymują wzrost rankingu podczas pobierania.

Nazwisko Typ Opis
boostingDuration

string

Czas trwania ISO 8601 dla okna wzmacniającego świeżość (np. 'P90D' przez 90 dni). Dokumenty nowsze niż ten czas otrzymują podwyższenie podczas wyszukiwania.

IndexedOneLakeKnowledgeSource

Konfiguracja dla źródła wiedzy OneLake.

Nazwisko Typ Opis
@odata.etag

string

ETag źródła wiedzy.

description

string

Opcjonalny opis zdefiniowany przez użytkownika.

encryptionKey

SearchResourceEncryptionKey

Opis klucza szyfrowania utworzonego w usłudze Azure Key Vault. Ten klucz służy do zapewnienia dodatkowego poziomu szyfrowania w spoczynku dla definicji źródła wiedzy, gdy chcesz mieć pełną pewność, że nikt, nawet Microsoft, nie jest w stanie go odszyfrować. Gdy już zaszyfrujesz definicję źródła wiedzy, zawsze pozostanie ona zaszyfrowana. Usługa wyszukiwania zignoruje próby ustawienia tej właściwości na wartość null. Możesz zmienić tę właściwość w razie potrzeby, jeśli chcesz obracać klucz szyfrujący; Definicja źródła wiedzy nie zostanie zmieniona. Szyfrowanie za pomocą kluczy zarządzanych przez klienta nie jest dostępne dla bezpłatnych usług wyszukiwania i jest dostępne tylko dla płatnych usług utworzonych w dniu 1 stycznia 2019 r. lub po 1 stycznia 2019 r.

indexedOneLakeParameters

IndexedOneLakeKnowledgeSourceParameters

Parametry źródła wiedzy.

kind string:

indexedOneLake

Typ źródła wiedzy.

name

string

Nazwa źródła wiedzy.

resultsProcessing

KnowledgeSourceResultsProcessing

Kontroluje, czy wyniki z tego źródła wiedzy zostaną ponownie ocenione, zanim zostaną uwzględnione w ostatecznym zestawie wyników. Domyślnie zmienia ranking, gdy nie jest to określone.

IndexedOneLakeKnowledgeSourceParameters

Parametry źródła wiedzy OneLake.

Nazwisko Typ Opis
createdResources

object

Zasoby utworzone przez źródło wiedzy.

fabricWorkspaceId

string

Identyfikator obszaru roboczego usługi OneLake.

ingestionParameters

KnowledgeSourceIngestionParameters

Konsoliduje wszystkie ogólne ustawienia pozyskiwania.

lakehouseId

string

Określa, do którego lakehouse'u OneLake chcesz uzyskać dostęp.

targetPath

string

Opcjonalny folder lub skrót OneLakehouse do filtrowania zawartości OneLake.

IndexedSharePointContainerName

Określa, do których bibliotek programu SharePoint należy uzyskać dostęp.

Wartość Opis
defaultSiteLibrary

Indeksowanie zawartości z domyślnej biblioteki dokumentów witryny.

allSiteLibraries

Indeksowanie zawartości z każdej biblioteki dokumentów w witrynie.

useQuery

Użyj zapytania, aby filtrować zawartość SharePoint.

allSiteLists

Indeksuj zawartość ze wszystkich list na stronie.

allSitePages

Indeksuj zawartość ze wszystkich stron witryny.

allSiteContent

Indeksuj zawartość ze wszystkich obsługiwanych bibliotek, list i stron w witrynie.

IndexedSharePointKnowledgeSource

Konfiguracja źródła wiedzy programu SharePoint.

Nazwisko Typ Opis
@odata.etag

string

ETag źródła wiedzy.

description

string

Opcjonalny opis zdefiniowany przez użytkownika.

encryptionKey

SearchResourceEncryptionKey

Opis klucza szyfrowania utworzonego w usłudze Azure Key Vault. Ten klucz służy do zapewnienia dodatkowego poziomu szyfrowania w spoczynku dla definicji źródła wiedzy, gdy chcesz mieć pełną pewność, że nikt, nawet Microsoft, nie jest w stanie go odszyfrować. Gdy już zaszyfrujesz definicję źródła wiedzy, zawsze pozostanie ona zaszyfrowana. Usługa wyszukiwania zignoruje próby ustawienia tej właściwości na wartość null. Możesz zmienić tę właściwość w razie potrzeby, jeśli chcesz obracać klucz szyfrujący; Definicja źródła wiedzy nie zostanie zmieniona. Szyfrowanie za pomocą kluczy zarządzanych przez klienta nie jest dostępne dla bezpłatnych usług wyszukiwania i jest dostępne tylko dla płatnych usług utworzonych w dniu 1 stycznia 2019 r. lub po 1 stycznia 2019 r.

indexedSharePointParameters

IndexedSharePointKnowledgeSourceParameters

Parametry źródła wiedzy.

kind string:

indexedSharePoint

Typ źródła wiedzy.

name

string

Nazwa źródła wiedzy.

resultsProcessing

KnowledgeSourceResultsProcessing

Kontroluje, czy wyniki z tego źródła wiedzy zostaną ponownie ocenione, zanim zostaną uwzględnione w ostatecznym zestawie wyników. Domyślnie zmienia ranking, gdy nie jest to określone.

IndexedSharePointKnowledgeSourceParameters

Parametry źródła wiedzy programu SharePoint.

Nazwisko Typ Opis
connectionString

string

Parametry połączenia z programem SharePoint w formacie: SharePointOnlineEndpoint=[Adres URL witryny programu SharePoint]; ApplicationId=[Identyfikator aplikacji Azure AD]; ApplicationSecret=[Klucz tajny klienta aplikacji Azure AD]; TenantId=[Identyfikator dzierżawy witryny SharePoint]

containerName

IndexedSharePointContainerName

Określa, do których bibliotek programu SharePoint należy uzyskać dostęp.

createdResources

object

Zasoby utworzone przez źródło wiedzy.

ingestionParameters

KnowledgeSourceIngestionParameters

Konsoliduje wszystkie ogólne ustawienia pozyskiwania.

query

string

Opcjonalne zapytanie do filtrowania zawartości programu SharePoint.

IndexedSqlKnowledgeSource

Konfiguracja dla indeksowanego źródła wiedzy SQL.

Nazwisko Typ Opis
@odata.etag

string

ETag źródła wiedzy.

description

string

Opcjonalny opis zdefiniowany przez użytkownika.

encryptionKey

SearchResourceEncryptionKey

Opis klucza szyfrowania utworzonego w usłudze Azure Key Vault. Ten klucz służy do zapewnienia dodatkowego poziomu szyfrowania w spoczynku dla definicji źródła wiedzy, gdy chcesz mieć pełną pewność, że nikt, nawet Microsoft, nie jest w stanie go odszyfrować. Gdy już zaszyfrujesz definicję źródła wiedzy, zawsze pozostanie ona zaszyfrowana. Usługa wyszukiwania zignoruje próby ustawienia tej właściwości na wartość null. Możesz zmienić tę właściwość w razie potrzeby, jeśli chcesz obracać klucz szyfrujący; Definicja źródła wiedzy nie zostanie zmieniona. Szyfrowanie za pomocą kluczy zarządzanych przez klienta nie jest dostępne dla bezpłatnych usług wyszukiwania i jest dostępne tylko dla płatnych usług utworzonych w dniu 1 stycznia 2019 r. lub po 1 stycznia 2019 r.

indexedSqlParameters

IndexedSqlKnowledgeSourceParameters

Parametry źródła wiedzy SQL.

kind string:

indexedSql

Typ źródła wiedzy.

name

string

Nazwa źródła wiedzy.

resultsProcessing

KnowledgeSourceResultsProcessing

Kontroluje, czy wyniki z tego źródła wiedzy zostaną ponownie ocenione, zanim zostaną uwzględnione w ostatecznym zestawie wyników. Domyślnie zmienia ranking, gdy nie jest to określone.

IndexedSqlKnowledgeSourceParameters

Parametry dla indeksowanego źródła wiedzy SQL.

Nazwisko Typ Opis
connectionString

string

Ciąg parametry połączenia dla Azure SQL Database lub SQL Managed Instance.

contentColumns

ContentColumnMapping[]

Opcjonalne mapowanie kolumn dla pól treści. Jeśli zostanie pominięty, wszystkie kolumny są automatycznie odkrywane.

createdResources

object

Zasoby utworzone przez źródło wiedzy.

embeddingColumns

EmbeddingColumnMapping[]

Opcjonalne odwzorowania kolumn do osadzania pól wektorowych. Jeśli zostanie pominięta, nie tworzy się żadnych pól wektorowych.

highWaterMarkColumnName

string

Opcjonalna nazwa kolumny do wykrywania wysokich zmian znaków wody. Jeśli jest dostępna, używa HighWaterMarkChangeDetectionPolicy.

ingestionParameters

KnowledgeSourceIngestionParameters

Konsoliduje wszystkie ogólne ustawienia pobierania, w tym model osadzania, harmonogram i tożsamość.

tableOrView

string

Nazwa tabeli lub widoku do indeksowania. Może być kwalifikowany według schematu (np. 'dbo. MyTable').

IndexingSchedule

Reprezentuje harmonogram wykonywania indeksatora.

Nazwisko Typ Opis
interval

string (duration)

Interwał czasu między wykonaniami indeksatora.

startTime

string (date-time)

Czas, w którym indeksator powinien zacząć działać.

KnowledgeBaseAzureOpenAIModel

Określa zasób usługi Azure OpenAI używany do planowania zapytań.

Nazwisko Typ Opis
azureOpenAIParameters

AzureOpenAIVectorizerParameters

Azure OpenAI parametry.

kind string:

azureOpenAI

Model sztucznej inteligencji, który ma być używany do planowania zapytań.

KnowledgeBaseMicrosoftRetriever1Model

Określa Microsoft Retriever 1 używany do planowania i pobierania zapytań.

Nazwisko Typ Opis
kind string:

microsoftRetriever1

Model sztucznej inteligencji, który ma być używany do planowania zapytań.

KnowledgeBaseModelKind

Model sztucznej inteligencji, który ma być używany do planowania zapytań.

Wartość Opis
azureOpenAI

Używanie modeli sztucznej inteligencji usługi Azure Open do planowania zapytań.

openAICompatible

Używaj kontrolowanego przez klienta punktu końcowego zgodnego z OpenAI do wyszukiwania bazy wiedzy lub werbalizacji obrazów źródłowych wiedzy.

microsoftRetriever1

Używaj Microsoft Retriever 1 do planowania i wyszukiwania zapytań.

KnowledgeBaseOpenAICompatibleModel

Określa kontrolowany przez klienta model zgodny z OpenAI do wyszukiwania bazy wiedzy lub werbalizacji obrazu źródła wiedzy w trybie minimalnym. Do pobrania profil modelu wybiera Zakończenia czatu lub Odpowiedzi. Nie obsługiwane dla ekstrakcji Standard/CU lub baz wiedzy z Web Resources Resources.

Nazwisko Typ Opis
kind string:

openAICompatible

Model sztucznej inteligencji, który ma być używany do planowania zapytań.

openAICompatibleParameters

KnowledgeBaseOpenAICompatibleParameters

Parametry połączenia i uwierzytelniania dla punktu końcowego zgodnego z OpenAI.

KnowledgeBaseOpenAICompatibleParameters

Parametry połączenia dla kompatybilnego z OpenAI punktu końcowego Chat Completions lub Responses. Tworzenie wymaga dokładnie jednego z niepustych nagłówków lub managedIdentityAudience. Aktualizacje mogą pominąć nagłówki, aby zachować dane uwierzytelniające dla niezmienionego połączenia i profilu modelu.

Nazwisko Typ Opis
authIdentity SearchIndexerDataIdentity:

Przypisana przez użytkownika zarządzana tożsamość używana do pozyskania tokena dla managedIdentityAudience. Pomiń używanie systemowej tożsamości usługi wyszukiwania. Dozwolone tylko z managedIdentityAudience.

headers

object (password)

Niepuste przechowywane nagłówki HTTP do uwierzytelniania punktów końcowych. Zarówno nazwy, jak i wartości są tajne i nigdy nie są zwracane w odpowiedziach. Puste mapy są nieprawidłowe. Wzajemnie wyłączające się z managedIdentityAudience i authIdentity. Po aktualizacji pominięte nagłówki są zachowywane tylko na tym samym powiązaniu zasobu i modelu, gdy dokładny punkt końcowy, profil modelu i tożsamość uwierzytelniania pozostają niezmienione; w przeciwnym razie należy podać świeże dane uwierzytelniające.

managedIdentityAudience

string

Podstawowy kanoniczny identyfikator GUID aplikacji klienta Microsoft Entra do uwierzytelniania zarządzanej tożsamości. Nie dołączaj prefiksu api:// ani sufiksu /.default. Wzajemnie wykluczające się z nagłówkami.

modelName

AzureOpenAIModelName

Obsługiwana nazwa modelu czatu, która określa możliwości i ograniczenia Search. Dla werbalizacji obrazu źródła wiedzy jest to wysyłane jako selektor modelu w treści żądania; ścieżka URI wybiera Zakończenia czatu lub Odpowiedzi niezależnie od tej nazwy. Do wyszukiwania bazy wiedzy profile modeli GPT-6 używają Responses, a istniejące profile modeli korzystają z Chat Completions; punkt końcowy musi wspierać wybrany protokół, w tym kontynuację narzędzi bezstanowych dla Responses. Ciało żądania pobierania pomija model; URI lub brama wybiera właściwy model i podaje wymagany identyfikator modelu dostawcy. Modele osadzania i dowolne protokoły dostawców nie są obsługiwane.

uri

string (uri)

Pełny adres HTTPS POST URL, wraz ze ścieżką i parametrami zapytania. Wysyłane bez zmian bez dodawania ścieżki lub wersji API; przekierowania nie są śledzone. Aby pobrać bazę wiedzy, punkt końcowy musi akceptować protokół Chat Completions lub Responses profilu modelu. Dla werbalizacji obrazu źródła wiedzy ścieżka URI musi kończyć się na /chat/completions lub /response; parametry zapytania nie wybierają protokołu.

KnowledgeSourceAzureOpenAIVectorizer

Określa zasób usługi Azure OpenAI używany do wektoryzacji ciągu zapytania.

Nazwisko Typ Opis
azureOpenAIParameters

AzureOpenAIVectorizerParameters

Zawiera parametry specyficzne dla wektoryzacji osadzania usługi Azure OpenAI.

kind string:

azureOpenAI

Nazwa rodzaju metody wektoryzacji konfigurowanej do użycia z wyszukiwaniem wektorowym.

KnowledgeSourceCache

Konfiguruje pamięć dla wyników wzbogacania buforowanego źródła wiedzy. Wymaga konta pamięci masowej GPv2 z punktami końcowymi Blob i Table. Powiązanie pamięci podręcznej i tożsamość nie mogą być zmieniane po utworzeniu, a pamięci podręcznej nie można usunąć podczas korzystania z przepływu pracy z ekstrakcją grafów.

Nazwisko Typ Domyślna wartość Opis
enableReprocessing

boolean

True

Czy wyniki wzbogacania w pamięci podręcznej mogą być ponownie przetwarzane po zmianie konfiguracji wzbogacenia. Musi to być prawda dla powtórek pamięci podręcznej ekstrakcji grafów.

identity SearchIndexerDataIdentity:

Zarządzana tożsamość używana do połączenia z pamięcią podręczną wzbogacania. Jeśli zostanie pominięty dla parametry połączenia ResourceId, używana jest zarządzana tożsamość przypisana przez system. Tożsamość nie może zostać zmieniona po skonfigurowaniu pamięci podręcznej.

storageConnectionString

string (password)

Connection string do konta magazynowego, na którym przechowywane są wyniki buforowanego wzbogacania.

KnowledgeSourceGraphExtractionParameters

Konfiguruje ekstrakcję grafu ze źródła wiedzy Azure Blob z włączonym natywnym miękkim usuwaniem Blob przed indeksowaniem. ADLS Gen2, przyjmowanie ACL oraz pobieranie etykiet wrażliwości nie są obsługiwane. Zmiany w różnych ontologiach muszą poczekać, aż synchronizacja nie będzie aktywna.

Nazwisko Typ Domyślna wartość Opis
graphName

string

Nazwa grafu do utworzenia.

grounding

KnowledgeSourceGraphGrounding

Opcjonalne źródło uziemienia używane do rozwiązywania wyodrębnionych elementów.

ontology

KnowledgeSourceGraphOntology

Ontologia używana do ekstrakcji potrójnych. Jeśli nie ma ich lub jest null podczas tworzenia, skonfigurowana pamięć podręczna wzbogacania pozwala na przetwarzanie przeszukiwalnych fragmentów i buforowanych wzbogaceń bez konieczności wyodrębniania potrójnych. Po dołączeniu ontologii nie można jej usunąć. Zmiany w różnych ontologiach muszą poczekać, aż synchronizacja nie będzie aktywna.

pageDegreeOfParallelism

integer (int32)

minimum: 1
maximum: 1024
128

Maksymalna liczba stron przetwarzanych równolegle do wyodrębniania grafów.

KnowledgeSourceGraphGrounding

Źródło uziemienia do ekstrakcji grafów. Obsługiwane są tylko indeksy wyszukiwania tej samej usługi.

Nazwisko Typ Domyślna wartość Opis
index

KnowledgeSourceGraphGroundingIndex

Indeks wyszukiwania tej samej usługi używany do uziemienia. Wymagane dla źródeł searchIndex.

kind

KnowledgeSourceGraphGroundingSourceKind

searchIndex

Źródłowy. Jeśli zostanie pominięty, zakłada się searchIndex. Inne rodzaje są odrzucane.

KnowledgeSourceGraphGroundingIndex

Identyfikuje indeks wyszukiwania używany do uziemiania wyodrębnionych obiektów.

Nazwisko Typ Opis
indexName

string

Nazwa indeksu wyszukiwania uziemienia.

vectorFieldName

string

Nazwa pola wektorowego używanego do uziemienia, gdy konfigurowane jest wyszukiwanie wektorowe.

KnowledgeSourceGraphGroundingSourceKind

Rodzaj źródła jawnego dla odniesienia uziemiającego. Obsługiwany jest tylko searchIndex.

Wartość Opis
searchIndex

Indeks wyszukiwania w tej samej usłudze wyszukiwania.

KnowledgeSourceGraphOntology

Ontologia inline do ekstrakcji grafów. Jedynym obsługiwanym źródłem jest dokument z ograniczonym JSON-LD dostarczony bezpośrednio w żądaniu.

Nazwisko Typ Opis
kind

KnowledgeSourceGraphOntologySourceKind

Źródłowy. Obsługiwane jest tylko "inline".

name

string

Opcjonalna nazwa podanych przez klienta dla ontologii, potwierdzona na graphStatistics.ontologyName.

value

string

Ograniczony dokument ontologii JSON-LD 1.1 (klasy płaskie i właściwości obiektu/typu danych), dostarczany jako ciąg znaków zakodowany w JSON.

KnowledgeSourceGraphOntologySourceKind

Jawny rodzaj źródła dla referencji ontologicznej. Obsługiwane jest tylko "inline".

Wartość Opis
inline

Zawartość ontologii podana w żądaniu jako dokument JSON-LD ograniczony.

KnowledgeSourceIngestionParameters

Konsoliduje wszystkie ogólne ustawienia pozyskiwania dla źródeł wiedzy.

Nazwisko Typ Domyślna wartość Opis
aiServices

AIServices

Opcjonalna konfiguracja usług AI Services do przetwarzania zawartości.

assetStore

AssetStore

Opcjonalna konfiguracja magazynu zasobów do przechowywania wyodrębnionych zasobów, takich jak obrazy.

cache

KnowledgeSourceCache

Konfiguracja pamięci podręcznej wzbogacania dla ekstrakcji grafu Azure Blob. Wymaga konta pamięci masowej GPv2 z punktami końcowymi Blob i Table oraz włączonym przetwarzaniem. Po skonfigurowaniu pamięci podręcznej nie można usunąć ani zmienić jej wiązania pamięci lub tożsamości.

chatCompletionModel KnowledgeBaseModel:

Opcjonalny model uzupełniania czatu do werbalizacji obrazu lub wyodrębniania kontekstu.

contentExtractionMode enum:
  • minimal
  • standard
minimal

Opcjonalny tryb wyodrębniania zawartości. Wartość domyślna to "minimalny".

disableImageVerbalization

boolean

False

Wskazuje, czy werbalizacja obrazu powinna być wyłączona. Wartość domyślna to „false”.

embeddingModel KnowledgeSourceVectorizer:

Opcjonalna konfiguracja wektoryzatora do wektoryzacji zawartości.

freshnessPolicy

FreshnessPolicy

Opcjonalna polityka świeżości w celu skłaniania wyszukiwania do nowszych dokumentów.

identity SearchIndexerDataIdentity:

Jawna tożsamość do użycia dla tego źródła wiedzy.

ingestionPermissionOptions

KnowledgeSourceIngestionPermissionOption[]

Opcjonalna lista typów uprawnień do pozyskiwania wraz z zawartością dokumentu. Jeśli zostanie określony, ustawi opcje uprawnień indeksatora dla źródła danych.

ingestionSchedule

IndexingSchedule

Opcjonalny harmonogram pozyskiwania danych.

networkAccessMode

KnowledgeSourceNetworkAccessMode

public

Opcjonalny tryb dostępu sieciowego do pobierania danych. Ustaw na "prywatne", aby uruchamiać pobieranie w prywatnym środowisku wykonawczym, które może dotrzeć do źródeł danych i zależności przez sieć prywatną. Domyślnie jest 'publiczne'. Jest to ustawienie w czasie tworzenia i nie można go zmienić po utworzeniu źródła wiedzy.

KnowledgeSourceIngestionPermissionOption

Rodzaje uprawnień do pobierania razem z treścią dokumentu.

Wartość Opis
userIds

Pozyskiwanie jawnych identyfikatorów użytkowników wraz z zawartością dokumentu.

groupIds

Pozyskiwanie identyfikatorów grup wraz z zawartością dokumentu.

rbacScope

Pozyskiwanie informacji o zakresie RBAC wraz z zawartością dokumentu.

oneLakeParentFolders

Importuj ścieżki folderów nadrzędnych OneLake i włącz filtrowanie uprawnień OneLake na wygenerowanym indeksie. Obsługiwane tylko dla indeksowanych źródeł wiedzy OneLake.

oneLakeLakehouseId

Importuj identyfikator OneLake Lakehouse elementu źródłowego i włącz filtrowanie uprawnień OneLake na wygenerowanym indeksie. Obsługiwane tylko dla indeksowanych źródeł wiedzy OneLake.

sensitivityLabels

Pobieraj etykiety wrażliwości Microsoft Purview obok treści dokumentu.

KnowledgeSourceKind

Rodzaj źródła wiedzy.

Wartość Opis
searchIndex

Źródło wiedzy, które odczytuje dane z indeksu wyszukiwania.

azureBlob

Źródło wiedzy, które odczytuje i pozyskuje dane z Azure Blob Storage do indeksu wyszukiwania.

indexedSharePoint

Źródło wiedzy odczytujące dane z indeksowanego SharePoint.

indexedOneLake

Źródło wiedzy odczytujące dane z indeksowanego OneLake.

indexedSql

Źródło wiedzy, które pobiera i przetwarza dane z Azure SQL Database lub SQL Managed Instance do indeksu wyszukiwania.

web

Źródło wiedzy, które odczytuje dane z internetu.

remoteSharePoint

Źródło wiedzy, które odczytuje dane ze zdalnego SharePoint.

workIQ

Źródło wiedzy, które odczytuje dane z IQ pracy

file

Źródło wiedzy wspierające bezpośredni przesyłanie i indeksowanie plików.

mcpServer

Źródło wiedzy wspierane przez serwer MCP (Model Context Protocol).

fabricDataAgent

Źródło wiedzy pobierające dane z agenta danych Fabric.

fabricOntology

Źródło wiedzy pozyskujące dane z ontologii ontologii Microsoft Fabric.

KnowledgeSourceNetworkAccessMode

Określa tryb dostępu sieciowego do pobierania źródeł danych. Domyślnie jest 'publiczne'.

Wartość Opis
public

Ingestion działa w standardowym, publicznie dostępnym środowisku wykonawczym. Jest to opcja domyślna.

private

Ingestion działa w prywatnym środowisku wykonawczym, dzięki czemu może docierać do źródeł danych i zależności przez sieć prywatną (prywatny punkt końcowy / wspólne połączenie prywatne).

KnowledgeSourceOpenAICompatibleVectorizer

Kompatybilny z OpenAI punkt końcowy osadzeń używany do zarządzanego importu źródeł wiedzy oraz generowanej wektoryzacji zapytań. Zmiana modelu osadzania natywnego wymaga ponownego odtworzenia źródła wiedzy i ponownego indeksowania. URI, modelName i wymiary nie mogą zostać zmienione po utworzeniu.

Nazwisko Typ Opis
kind string:

openAICompatible

Nazwa rodzaju metody wektoryzacji konfigurowanej do użycia z wyszukiwaniem wektorowym.

openAICompatibleParameters

OpenAICompatibleVectorizerParameters

Parametry profilu połączenia, uwierzytelniania i osadzania.

KnowledgeSourceResultsProcessing

Kontroluje, czy wyniki źródła wiedzy zostaną ponownie uszeregowane.

Wartość Opis
rerank

Wyniki z tego źródła wiedzy przechodzą przez proces rerankingu. Jest to zachowanie domyślne.

none

Wyniki tego źródła wiedzy omijają ponowne rankingi i zachowują ich pierwotny porządek.

McpServerAuthenticationKind

Taki rodzaj uwierzytelniania dla serwera MCP.

Wartość Opis
foundryConnection

Uwierzytelnij za pomocą połączenia Azure AI Foundry.

storedHeaders

Uwierzytelniaj się za pomocą zapisanych nagłówków HTTP.

McpServerAutoOutputParsing

Automatycznie wykrywaj format wyjściowy i analizuj odpowiednio.

Nazwisko Typ Opis
kind string:

auto

Taki rodzaj parsowania wyniku, który należy zastosować.

McpServerFoundryConnectionAuthentication

Uwierzytelnianie za pomocą połączenia Azure AI Foundry.

Nazwisko Typ Opis
foundryConnectionParameters

McpServerFoundryConnectionParameters

Parametry uwierzytelniania połączenia z Foundry.

kind string:

foundryConnection

Rodzaj uwierzytelniania, którego warto użyć.

McpServerFoundryConnectionParameters

Parametry uwierzytelniania połączenia z Foundry.

Nazwisko Typ Opis
connectionId

string

Identyfikator połączenia Azure AI Foundry.

McpServerJsonOutputParsing

Analizuj wynik jako dokument JSON, używając skonfigurowanych parametrów JSON.

Nazwisko Typ Opis
jsonParameters

McpServerOutputParsingJsonParameters

Parametry parsowania wyjściowego JSON. Wymagane, gdy rodzaj to 'json'.

kind string:

json

Taki rodzaj parsowania wyniku, który należy zastosować.

McpServerKnowledgeSource

Konfiguracja dla źródła wiedzy wspieranego przez serwer MCP (Model Context Protocol).

Nazwisko Typ Opis
@odata.etag

string

ETag źródła wiedzy.

description

string

Opcjonalny opis zdefiniowany przez użytkownika.

encryptionKey

SearchResourceEncryptionKey

Opis klucza szyfrowania utworzonego w usłudze Azure Key Vault. Ten klucz służy do zapewnienia dodatkowego poziomu szyfrowania w spoczynku dla definicji źródła wiedzy, gdy chcesz mieć pełną pewność, że nikt, nawet Microsoft, nie jest w stanie go odszyfrować. Gdy już zaszyfrujesz definicję źródła wiedzy, zawsze pozostanie ona zaszyfrowana. Usługa wyszukiwania zignoruje próby ustawienia tej właściwości na wartość null. Możesz zmienić tę właściwość w razie potrzeby, jeśli chcesz obracać klucz szyfrujący; Definicja źródła wiedzy nie zostanie zmieniona. Szyfrowanie za pomocą kluczy zarządzanych przez klienta nie jest dostępne dla bezpłatnych usług wyszukiwania i jest dostępne tylko dla płatnych usług utworzonych w dniu 1 stycznia 2019 r. lub po 1 stycznia 2019 r.

kind string:

mcpServer

Typ źródła wiedzy.

mcpServerParameters

McpServerKnowledgeSourceParameters

Parametry źródła wiedzy serwera MCP.

name

string

Nazwa źródła wiedzy.

resultsProcessing

KnowledgeSourceResultsProcessing

Kontroluje, czy wyniki z tego źródła wiedzy zostaną ponownie ocenione, zanim zostaną uwzględnione w ostatecznym zestawie wyników. Domyślnie zmienia ranking, gdy nie jest to określone.

McpServerKnowledgeSourceParameters

Parametry dla źródła wiedzy serwera MCP.

Nazwisko Typ Opis
authentication McpServerAuthentication:

Konfiguracja uwierzytelniania dla serwera MCP.

serverURL

string

URL punktu końcowego serwera MCP.

tools

McpServerTool[]

Lista narzędzi do wywołania na serwerze MCP.

McpServerNoneOutputParsing

Traktuj wyjście jako pojedynczy blok bez żadnego parsowania.

Nazwisko Typ Opis
kind string:

none

Taki rodzaj parsowania wyniku, który należy zastosować.

McpServerOutputParsingJsonParameters

Parametry parsowania wyjściowego JSON.

Nazwisko Typ Opis
documentsPath

string

Ścieżka JSON do tablicy dokumentów w wyjściu narzędzia.

includeContext

boolean

Czy uwzględnić kontekst z wydanych danych JSON obok wyodrębnionych dokumentów.

McpServerOutputParsingKind

Taki rodzaj parsowania wyników dla narzędzia serwera MCP.

Wartość Opis
auto

Automatycznie wykrywaj format wyjściowy i analizuj odpowiednio.

json

Analizuj wynik jako dokument JSON, używając skonfigurowanych parametrów JSON.

split

Podziel wyjście na strony za pomocą skonfigurowanych parametrów podziału.

none

Traktuj wyjście jako pojedynczy blok bez żadnego parsowania.

McpServerOutputParsingSplitParameters

Parametry do parsowania wyjścia podzielonego.

Nazwisko Typ Opis
defaultLanguageCode

SplitSkillLanguage

Wartość wskazująca, który kod języka ma być używany. Wartość domyślna to en.

maximumPageLength

integer (int32)

Maksymalna liczba znaków na stronie.

maximumPagesToTake

integer (int32)

Maksymalna liczba stron, które należy pobrać z wydruku.

pageOverlapLength

integer (int32)

Liczba znaków, które nakładają się na strony.

textSplitMode

TextSplitMode

Tryb podziału tekstu do użycia.

McpServerSplitOutputParsing

Podziel wyjście na strony za pomocą skonfigurowanych parametrów podziału.

Nazwisko Typ Opis
kind string:

split

Taki rodzaj parsowania wyniku, który należy zastosować.

splitParameters

McpServerOutputParsingSplitParameters

Parametry do parsowania wyjścia podzielonego.

McpServerStoredHeadersAuthentication

Uwierzytelnianie za pomocą zapisanych nagłówków HTTP.

Nazwisko Typ Opis
kind string:

storedHeaders

Rodzaj uwierzytelniania, którego warto użyć.

storedHeadersParameters

McpServerStoredHeadersParameters

Parametry uwierzytelniania zapisanych nagłówków.

McpServerStoredHeadersParameters

Parametry uwierzytelniania zapisanych nagłówków.

Nazwisko Typ Opis
headers

object

Przechowywane nagłówki HTTP do uwzględnienia w żądaniach serwera MCP.

McpServerTool

Reprezentuje pojedyncze narzędzie w źródle wiedzy serwera MCP.

Nazwisko Typ Opis
maxOutputTokens

integer (int32)

Opcjonalny limit tokenów po parsowaniu dla wyjścia tego narzędzia. Musi być większa niż 0, gdy jest to zaznaczone.

name

string

Nazwa narzędzia MCP do wywołania.

outputParsing McpServerOutputParsing:

Opcjonalna konfiguracja do parsowania wyników narzędzia.

resultsProcessing

KnowledgeSourceResultsProcessing

Kontroluje, czy wyniki parsowane z tego narzędzia są ponownie rangowane. Domyślnie zmienia ranking, gdy nie jest to określone.

NoneVectorQueryTopicGraph

Używa normalnego wyszukiwania wektorowego bez wykresu tematów – różnorodne wyszukiwanie.

Nazwisko Typ Opis
kind string:

none

Rodzaj wyszukiwania wektorowego na grafach tematycznych, którego należy użyć.

OpenAICompatibleVectorizerParameters

Parametry połączenia dla bezpośredniego punktu końcowego embeddings zgodnego z OpenAI. Tworzenie wymaga dokładnie jednego z niepustych nagłówków lub managedIdentityAudience. Aktualizacje mogą pominąć nagłówki, aby zachować dane uwierzytelniające dla niezmienionego profilu połączenia i osadzania.

Nazwisko Typ Opis
authIdentity SearchIndexerDataIdentity:

Przypisana przez użytkownika zarządzana tożsamość używana do pozyskania tokena dla managedIdentityAudience. Pomiń używanie systemowej tożsamości usługi wyszukiwania. Dozwolone tylko z managedIdentityAudience.

dimensions

integer (int32)

minimum: 1

Wymiary wyjściowe, które muszą odpowiadać polu wektora docelowego. Domyślnie ustawia się 1536 dla text-embedding-ada-002 i text-embedding-3-small lub 3072 dla text-embedding-3-large. Ada wymaga 1536; text-embedding-3-small obsługuje 1 do 1536, a text-embedding-3-large obsługuje od 1 do 3072. Zachowanie pominiętych nagłówków podczas aktualizacji wymaga, aby skonfigurowane wymiary pozostały bez zmian; pominięcie wymiarów różni się od wyraźnego określenia domyślnego.

headers

object (password)

Niepuste przechowywane nagłówki HTTP do uwierzytelniania punktów końcowych. Zarówno nazwy, jak i wartości są tajne i nigdy nie są zwracane w odpowiedziach. Puste mapy są nieprawidłowe. Wzajemnie wyłączające się z managedIdentityAudience i authIdentity. Po aktualizacji pominięte nagłówki są zachowywane tylko na tym samym zasobie i powiązaniu wektoryzatora, gdy dokładny punkt końcowy, profil osadzenia wraz z skonfigurowanymi wymiarami oraz tożsamość uwierzytelniania pozostają niezmienione; w przeciwnym razie należy podać świeże dane uwierzytelniające.

managedIdentityAudience

string

Podstawowy kanoniczny identyfikator GUID aplikacji klienta Microsoft Entra do uwierzytelniania zarządzanej tożsamości. Nie dołączaj prefiksu api:// ani sufiksu /.default. Wzajemnie wykluczające się z nagłówkami.

modelName

AzureOpenAIModelName

Profil osadzający, używający tego samego enum nazwy modelu co natywne wektoryzatory Azure OpenAI. W czasie działania obsługiwane są tylko text-embedding-ada-002, text-embedding-3-small oraz text-embedding-3-large; nazwy czatów w udostępnionym enum są odrzucane. Kontroluje limity i domyślne wymiary Search; ciało wychodzące pomija model, więc URI lub brama musi wybrać faktyczny model. Dowolne protokoły dostawcy nie są obsługiwane.

uri

string (uri)

Pełne osadzenia HTTPS POST URL, w tym wszelkie ścieżki i parametry zapytania. Wysłane bez zmian bez dodawania ścieżki lub wersji API. Przekierowania nie są przestrzegane.

RemoteSharePointKnowledgeSource

Konfiguracja zdalnego źródła wiedzy programu SharePoint.

Nazwisko Typ Opis
@odata.etag

string

ETag źródła wiedzy.

description

string

Opcjonalny opis zdefiniowany przez użytkownika.

encryptionKey

SearchResourceEncryptionKey

Opis klucza szyfrowania utworzonego w usłudze Azure Key Vault. Ten klucz służy do zapewnienia dodatkowego poziomu szyfrowania w spoczynku dla definicji źródła wiedzy, gdy chcesz mieć pełną pewność, że nikt, nawet Microsoft, nie jest w stanie go odszyfrować. Gdy już zaszyfrujesz definicję źródła wiedzy, zawsze pozostanie ona zaszyfrowana. Usługa wyszukiwania zignoruje próby ustawienia tej właściwości na wartość null. Możesz zmienić tę właściwość w razie potrzeby, jeśli chcesz obracać klucz szyfrujący; Definicja źródła wiedzy nie zostanie zmieniona. Szyfrowanie za pomocą kluczy zarządzanych przez klienta nie jest dostępne dla bezpłatnych usług wyszukiwania i jest dostępne tylko dla płatnych usług utworzonych w dniu 1 stycznia 2019 r. lub po 1 stycznia 2019 r.

kind string:

remoteSharePoint

Typ źródła wiedzy.

name

string

Nazwa źródła wiedzy.

remoteSharePointParameters

RemoteSharePointKnowledgeSourceParameters

Parametry zdalnego źródła wiedzy SharePoint.

resultsProcessing

KnowledgeSourceResultsProcessing

Kontroluje, czy wyniki z tego źródła wiedzy zostaną ponownie ocenione, zanim zostaną uwzględnione w ostatecznym zestawie wyników. Domyślnie zmienia ranking, gdy nie jest to określone.

RemoteSharePointKnowledgeSourceParameters

Parametry zdalnego źródła wiedzy programu SharePoint.

Nazwisko Typ Opis
containerTypeId

string

Identyfikator kontenera dla połączenia z systemem SharePoint Embedded. Jeśli ta wartość ma wartość null, będzie używać usługi SharePoint Online.

filterExpression

string

Wyrażenie języka KQL (Keyword Query Language) z właściwościami i atrybutami programu SharePoint z możliwością wykonywania zapytań w celu określenia zakresu pobierania przed uruchomieniem zapytania.

resourceMetadata

string[]

Lista pól metadanych, które mają zostać zwrócone dla każdego elementu w odpowiedzi. Na tej liście można uwzględnić tylko właściwości metadanych, które można pobrać. Domyślnie nie są zwracane żadne metadane.

SearchIndexerDataNoneIdentity

Czyści właściwość tożsamości źródła danych.

Nazwisko Typ Opis
@odata.type string:

#Microsoft.Azure.Search.DataNoneIdentity

Fragment identyfikatora URI określający typ tożsamości.

SearchIndexerDataUserAssignedIdentity

Określa tożsamość źródła danych do użycia.

Nazwisko Typ Opis
@odata.type string:

#Microsoft.Azure.Search.DataUserAssignedIdentity

Fragment identyfikatora URI określający typ tożsamości.

federatedIdentityClientId

string

Wsparcie tożsamości zarządzanej User-Assigned wielodzierżawcowej: identyfikator klienta aplikacji wielonamiętnej, skonfigurowanej do federacji z przypisaną przez użytkownika tożsamością zarządzaną.

userAssignedIdentity

string

W pełni kwalifikowany identyfikator zasobu platformy Azure przypisanej przez użytkownika tożsamości zarządzanej zazwyczaj w postaci "/subscriptions/12345678-1234-1234-1234-1234567890ab/resourceGroups/rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId", który powinien zostać przypisany do usługi wyszukiwania.

SearchIndexFieldReference

Referencja polowa dla indeksu wyszukiwania.

Nazwisko Typ Opis
name

string

Nazwa pola.

SearchIndexKnowledgeSource

Źródło wiedzy przeznaczone dla indeksu wyszukiwania.

Nazwisko Typ Opis
@odata.etag

string

ETag źródła wiedzy.

description

string

Opcjonalny opis zdefiniowany przez użytkownika.

encryptionKey

SearchResourceEncryptionKey

Opis klucza szyfrowania utworzonego w usłudze Azure Key Vault. Ten klucz służy do zapewnienia dodatkowego poziomu szyfrowania w spoczynku dla definicji źródła wiedzy, gdy chcesz mieć pełną pewność, że nikt, nawet Microsoft, nie jest w stanie go odszyfrować. Gdy już zaszyfrujesz definicję źródła wiedzy, zawsze pozostanie ona zaszyfrowana. Usługa wyszukiwania zignoruje próby ustawienia tej właściwości na wartość null. Możesz zmienić tę właściwość w razie potrzeby, jeśli chcesz obracać klucz szyfrujący; Definicja źródła wiedzy nie zostanie zmieniona. Szyfrowanie za pomocą kluczy zarządzanych przez klienta nie jest dostępne dla bezpłatnych usług wyszukiwania i jest dostępne tylko dla płatnych usług utworzonych w dniu 1 stycznia 2019 r. lub po 1 stycznia 2019 r.

kind string:

searchIndex

Typ źródła wiedzy.

name

string

Nazwa źródła wiedzy.

resultsProcessing

KnowledgeSourceResultsProcessing

Kontroluje, czy wyniki z tego źródła wiedzy zostaną ponownie ocenione, zanim zostaną uwzględnione w ostatecznym zestawie wyników. Domyślnie zmienia ranking, gdy nie jest to określone.

searchIndexParameters

SearchIndexKnowledgeSourceParameters

Parametry źródła wiedzy.

SearchIndexKnowledgeSourceBoostKind

Taki rodzaj podpowiedzi do indeksu wyszukiwania jako źródło wiedzy.

Wartość Opis
fieldValue

Ulepszaj dokumenty na podstawie wartości pola.

multiWordExpression

Ulepszaj dokumenty oparte na wielowyrazowym wyrażeniu.

SearchIndexKnowledgeSourceFieldValueBoost

Wskazówka, która zwiększa liczbę dokumentów na podstawie wartości pola.

Nazwisko Typ Opis
boost

number (double)

Mnożnik dla wyniku dokumentu. Musi być liczbą dodatnią, która nie jest równa 1,0.

boostInstructions

string

Instrukcje w naturalnym języku, które wyjaśniają, kiedy i jak zastosować boost.

field

string

minLength: 1

Nazwa pola indeksu wyszukiwania.

fieldValues

string[]

Reprezentatywne wartości dla tej dziedziny.

kind string:

fieldValue

Taka wskazówka do boostu.

SearchIndexKnowledgeSourceFilterHint

Podpowiedzi identyfikującej pole oraz wyczerpujące wartości uziemienia, które planer zapytań może wykorzystać podczas tworzenia filtra.

Nazwisko Typ Opis
autoConfiguration

SearchIndexKnowledgeSourceFilterHintAutoConfiguration

Konfiguruje usługę do rozwiązywania wartości uziemienia z faset pola. Jego obecność umożliwia automatyczną konfigurację. Pole musi być filtrowalne i mieć tablicę do tablic twarzy. Nie obsługiwane, gdy indeks docelowy ma włączone uprawnienia na poziomie dokumentu lub etykiety wrażliwości Purview; to ograniczenie jest weryfikowane w czasie tworzenia/aktualizacji źródła wiedzy oraz pobierania bazy wiedzy. Wzajemnie wykluczające się z fieldValues. Obsługiwane tylko w magazynowanych queryHintsw źródle wiedzy, a nie w czasie queryHintOverridesżądania.

field

string

minLength: 1

Nazwa filtrowalnego pola indeksu wyszukiwania.

fieldValues

string[]

Pełny zestaw wartości dla pola. Maksymalnie 160 wartości, z maksymalnie 128 znakami na wartość oraz łącznie 2048 znakami. W wersjach obsługujących autoConfiguration, wymagane, chyba że autoConfiguration jest to określone i wzajemnie się z nim wyklucza.

filterInstructions

string

Instrukcje w języku naturalnym, które wyjaśniają, kiedy i jak filtrować na polu.

SearchIndexKnowledgeSourceFilterHintAutoConfiguration

Konfiguruje automatyczne rozwiązywanie wartości uziemienia wskazówki filtra na podstawie faset indeksu docelowego.

Nazwisko Typ Opis
cacheTtl

integer (int32)

minimum: 60
maximum: 3600

Liczba sekund rozwiązywanych wartości fasetów jest buforowana. Dozwolony zakres to 60 do 3600 dla usług dedykowanych oraz od 60 do 900 dla usług bezserwerowych. Po pominięciu domyślnie 3600 sekund dla usług dedykowanych i 900 sekund dla usług bezserwerowych.

maxFacetValueCount

integer (int32)

minimum: 1
maximum: 64

Maksymalna liczba wartości faset, które można użyć jako uziemienie. Domyślnie ustawione jest 64; dozwolony zakres to od 1 do 64. Wartości są wybierane w kolejności malejącej liczby faset, z tym samym limitem łącznej długości 2048 znaków oraz limitem 128 znaków na wartość jak ręcznie określone wartości filtra.

SearchIndexKnowledgeSourceMultiWordExpressionBoost

Wskazówka, która wzmacnia dokumenty oparte na wielowyrazowym wyrażeniu.

Nazwisko Typ Opis
boost

number (double)

Mnożnik dla wyniku dokumentu. Musi być liczbą dodatnią, która nie jest równa 1,0.

boostInstructions

string

Instrukcje w naturalnym języku, które wyjaśniają, kiedy i jak zastosować boost.

fieldValues

string[]

Reprezentatywne wartości dla boostu.

kind string:

multiWordExpression

Taka wskazówka do boostu.

SearchIndexKnowledgeSourceParameters

Parametry źródła wiedzy indeksu wyszukiwania.

Nazwisko Typ Opis
baseFilter

string

Domyślny warunek filtra stosowany do indeksu w czasie pobierania (np. 'Stan eq VA'). Można je nadpisać w czasie zapytań za pomocą parametrów wykonawczych źródła wiedzy.

queryHints

SearchIndexKnowledgeSourceQueryHints

Domyślne wskazówki, które kierują planowaniem zapytań w kierunku przydatnych filtrów i wzmocnień dla tego źródła wiedzy indeksu wyszukiwania. Wskazówki zapytania w czasie żądania zastępują te domyślne jako kompletny obiekt.

searchFields

SearchIndexFieldReference[]

Służy do ograniczania pól do przeszukania w indeksie wyszukiwania.

searchIndexName

string

Nazwa indeksu wyszukiwania.

semanticConfigurationName

string

Służy do określania innej konfiguracji semantycznej w docelowym indeksie wyszukiwania innej niż domyślna.

sourceDataFields

SearchIndexFieldReference[]

Służy do żądania dodatkowych pól dla danych źródłowych, do których się odwołuje.

topicGraph VectorQueryTopicGraph:

Domyślne opcje wyszukiwania wektorowego wykresu tematu dla tego źródła wiedzy indeksu wyszukiwania.

SearchIndexKnowledgeSourceQueryHints

Wskazówki, które prowadzą planowanie zapytań do przydatnych filtrów i wzmocnień dla źródła wiedzy indeksu wyszukiwania.

Nazwisko Typ Opis
boosts SearchIndexKnowledgeSourceBoost[]:

Wzmacniaj wskazówki, które identyfikują warunki, które planista zapytań może wykorzystać, aby wpłynąć na pozycję dokumentu.

filters

SearchIndexKnowledgeSourceFilterHint[]

Podpowiedzi filtrujące identyfikujące pola i reprezentatywne wartości, których planer zapytań może używać podczas tworzenia filtrów.

SearchResourceEncryptionKey

Klucz szyfrowania zarządzany przez klienta w usłudze Azure Key Vault. Klucze, które tworzysz i którymi zarządzasz, mogą służyć do szyfrowania lub odszyfrowywania danych magazynowanych, takich jak indeksy i mapy synonimów.

Nazwisko Typ Domyślna wartość Opis
accessCredentials.applicationId

string

Identyfikator aplikacji usługi AAD, któremu udzielono wymaganych uprawnień dostępu do usługi Azure Key Vault, która ma być używana podczas szyfrowania danych magazynowanych. Identyfikator aplikacji nie powinien być mylony z identyfikatorem obiektu aplikacji usługi AAD.

accessCredentials.applicationSecret

string

Klucz uwierzytelniania określonej aplikacji usługi AAD.

identity SearchIndexerDataIdentity:

Jawna tożsamość zarządzana używana dla tego klucza szyfrowania. Jeśli nie zostanie określona, a właściwość poświadczeń dostępu ma wartość null, zostanie użyta tożsamość zarządzana przypisana przez system. Po zaktualizowaniu zasobu, jeśli tożsamość jawna jest nieokreślona, pozostaje niezmieniona. Jeśli określono wartość "none", wartość tej właściwości zostanie wyczyszczone.

isServiceLevelKey

boolean

False

Opcjonalna wartość wskazująca, czy ten klucz jest kluczem poziomu usługi. Wartość domyślna to „false”.

keyVaultKeyName

string

Nazwa klucza usługi Azure Key Vault, który ma być używany do szyfrowania danych magazynowanych.

keyVaultKeyVersion

string

Wersja klucza usługi Azure Key Vault, która ma być używana do szyfrowania danych magazynowanych.

keyVaultUri

string

Identyfikator URI usługi Azure Key Vault, nazywany również nazwą DNS, który zawiera klucz używany do szyfrowania danych magazynowanych. Przykładowy identyfikator URI może być https://my-keyvault-name.vault.azure.net.

SplitSkillLanguage

Kody języków obsługiwane dla tekstu wejściowego przez SplitSkill.

Wartość Opis
am

Amharski

bs

Bośniacki

cs

Czeski

da

Duński

de

Niemiecki

en

angielski

es

Hiszpański

et

Estoński

fi

Fiński

fr

Francuski

he

Hebrajski

hi

Język hindi

hr

Chorwacki

hu

Węgierski

id

Indonesian

is

Islandzki

it

Włoski

ja

Japoński

ko

Koreański

lv

Łotewski

nb

Norweski

nl

Niderlandzki

pl

Polski

pt

Język portugalski (Portugalia)

pt-br

portugalski (Brazylia)

ru

Rosyjski

sk

Słowacki

sl

Słoweński

sr

Serbski

sv

Szwedzki

tr

Turecki

ur

język urdu

zh

Chiński (uproszczony)

TextSplitMode

Wartość wskazująca tryb podziału do wykonania.

Wartość Opis
pages

Podziel tekst na poszczególne strony.

sentences

Podziel tekst na poszczególne zdania.

VectorSearchTopicGraphKind

Rodzaj wyszukiwania wektorowego na grafach tematycznych, którego należy użyć.

Wartość Opis
none

Używaj normalnego wyszukiwania wektorowego, gdy wyszukiwanie różnorodności wykresu tematów jest nieprawidłowe.

diverse

Korzystaj z wykresu tematycznego – różnorodne wyszukiwanie.

balanced

Łączy czyste podobieństwo wektorowe z wyszukiwaniem uwzględniającym różnorodność. Zalecany domyślny sposób jest równoważenie różnorodności z trafnością.

VectorSearchVectorizerKind

Metoda wektoryzacji, która ma być używana w czasie wykonywania zapytania.

Wartość Opis
azureOpenAI

Generowanie osadzania przy użyciu zasobu usługi Azure OpenAI w czasie wykonywania zapytania.

openAICompatible

Generuj embeddingi za pomocą kontrolowanego przez klienta punktu końcowego embeddings kompatybilnego z OpenAI.

customWebApi

Generowanie osadzania przy użyciu niestandardowego internetowego punktu końcowego w czasie wykonywania zapytań.

aiServicesVision

Generuj osadzanie dla obrazu lub tekstu wejściowego w czasie wykonywania zapytania przy użyciu interfejsu API przetwarzania obrazów usług Azure AI Services Vision Vectorize.

aml

Generowanie osadzania przy użyciu punktu końcowego usługi Azure Machine Learning wdrożonego za pośrednictwem wykazu modeli usługi Azure AI Foundry w czasie wykonywania zapytania.

WebKnowledgeSource

Źródło wiedzy kierowane na wyniki w internecie.

Nazwisko Typ Opis
@odata.etag

string

ETag źródła wiedzy.

description

string

Opcjonalny opis zdefiniowany przez użytkownika.

encryptionKey

SearchResourceEncryptionKey

Opis klucza szyfrowania utworzonego w usłudze Azure Key Vault. Ten klucz służy do zapewnienia dodatkowego poziomu szyfrowania w spoczynku dla definicji źródła wiedzy, gdy chcesz mieć pełną pewność, że nikt, nawet Microsoft, nie jest w stanie go odszyfrować. Gdy już zaszyfrujesz definicję źródła wiedzy, zawsze pozostanie ona zaszyfrowana. Usługa wyszukiwania zignoruje próby ustawienia tej właściwości na wartość null. Możesz zmienić tę właściwość w razie potrzeby, jeśli chcesz obracać klucz szyfrujący; Definicja źródła wiedzy nie zostanie zmieniona. Szyfrowanie za pomocą kluczy zarządzanych przez klienta nie jest dostępne dla bezpłatnych usług wyszukiwania i jest dostępne tylko dla płatnych usług utworzonych w dniu 1 stycznia 2019 r. lub po 1 stycznia 2019 r.

kind string:

web

Typ źródła wiedzy.

name

string

Nazwa źródła wiedzy.

resultsProcessing

KnowledgeSourceResultsProcessing

Kontroluje, czy wyniki z tego źródła wiedzy zostaną ponownie ocenione, zanim zostaną uwzględnione w ostatecznym zestawie wyników. Domyślnie zmienia ranking, gdy nie jest to określone.

webParameters

WebKnowledgeSourceParameters

Parametry internetowego źródła wiedzy.

WebKnowledgeSourceDomain

Konfiguracja domeny źródła wiedzy sieci Web.

Nazwisko Typ Opis
address

string

Adres domeny.

includeSubpages

boolean

Czy uwzględnić podstrony z tej domeny, czy nie.

WebKnowledgeSourceDomains

Konfiguracja zezwalania/blokowania domeny dla internetowego źródła wiedzy.

Nazwisko Typ Opis
allowedDomains

WebKnowledgeSourceDomain[]

Domeny dozwolone dla wyników internetowych.

blockedDomains

WebKnowledgeSourceDomain[]

Domeny zablokowane w wynikach wyszukiwania w sieci.

WebKnowledgeSourceParameters

Parametry źródła wiedzy internetowej.

Nazwisko Typ Opis
count

integer (int32)

Domyślna liczba wyników internetowych do zwrócenia. Można je nadpisać w czasie zapytań za pomocą parametrów wykonawczych źródła wiedzy.

domains

WebKnowledgeSourceDomains

Konfiguracja zezwalania/blokowania domeny dla wyników internetowych.

freshness

string

Domyślny filtr świeżości wyników internetowych. Można je nadpisać w czasie zapytań za pomocą parametrów wykonawczych źródła wiedzy.

language

string

Domyślny język wyników internetowych. Można je nadpisać w czasie zapytań za pomocą parametrów wykonawczych źródła wiedzy.

market

string

Domyślny rynek wyników internetowych. Można je nadpisać w czasie zapytań za pomocą parametrów wykonawczych źródła wiedzy.

WorkIQKnowledgeSource

Konfiguracja dla źródła wiedzy WorkIQ.

Nazwisko Typ Opis
@odata.etag

string

ETag źródła wiedzy.

description

string

Opcjonalny opis zdefiniowany przez użytkownika.

encryptionKey

SearchResourceEncryptionKey

Opis klucza szyfrowania utworzonego w usłudze Azure Key Vault. Ten klucz służy do zapewnienia dodatkowego poziomu szyfrowania w spoczynku dla definicji źródła wiedzy, gdy chcesz mieć pełną pewność, że nikt, nawet Microsoft, nie jest w stanie go odszyfrować. Gdy już zaszyfrujesz definicję źródła wiedzy, zawsze pozostanie ona zaszyfrowana. Usługa wyszukiwania zignoruje próby ustawienia tej właściwości na wartość null. Możesz zmienić tę właściwość w razie potrzeby, jeśli chcesz obracać klucz szyfrujący; Definicja źródła wiedzy nie zostanie zmieniona. Szyfrowanie za pomocą kluczy zarządzanych przez klienta nie jest dostępne dla bezpłatnych usług wyszukiwania i jest dostępne tylko dla płatnych usług utworzonych w dniu 1 stycznia 2019 r. lub po 1 stycznia 2019 r.

kind string:

workIQ

Typ źródła wiedzy.

name

string

Nazwa źródła wiedzy.

resultsProcessing

KnowledgeSourceResultsProcessing

Kontroluje, czy wyniki z tego źródła wiedzy zostaną ponownie ocenione, zanim zostaną uwzględnione w ostatecznym zestawie wyników. Domyślnie zmienia ranking, gdy nie jest to określone.

workIQParameters

WorkIQKnowledgeSourceParameters

Parametry dla źródła wiedzy WorkIQ, w tym konfiguracja aplikacji Entra należąca do klienta, używana do uwierzytelniania w imieniu użytkownika.

WorkIQKnowledgeSourceParameters

Parametry dla źródła wiedzy o WorkIQ.

Nazwisko Typ Opis
entraAppAuthentication

EntraAppAuthentication

Konfiguracja rejestracji aplikacji Microsoft Entra należąca do klienta służyła do uwierzytelniania w imieniu użytkownika do API Work IQ. Klient rejestruje aplikację Entra należącą do dzierżawicy, nadaje jej uprawnienia WorkIQAgent.Ask oraz konfiguruje federowane dane uwierzytelniające tak, aby Wyszukiwanie AI platformy Azure mogło uwierzytelnić się jako ta aplikacja bez zapisanego sekretu klienta.