Knowledge Sources - Create Or Update
Tworzy nowe źródło wiedzy lub aktualizuje źródło wiedzy, jeśli już istnieje.
PUT {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. |
|
source
|
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 |
Nagłówek „Accept”. |
||
| If-Match |
string |
Definiuje warunek If-Match. Operacja zostanie wykonana tylko wtedy, gdy element ETag na serwerze jest zgodny z tą wartością. |
|
| If-None-Match |
string |
Definiuje warunek If-None-Match. Operacja zostanie wykonana tylko wtedy, gdy element ETag na serwerze nie jest zgodny z tą wartością. |
|
| Prefer | True |
W przypadku żądań HTTP PUT instruuje usługę, aby zwróciła utworzony/zaktualizowany zasób w przypadku powodzenia. |
Treść żądania
Treść żądania może być jedną z następujących:
| Nazwisko | Opis |
|---|---|
|
Azure |
Konfiguracja źródła wiedzy Azure Blob Storage. |
|
Fabric |
Konfiguracja dla źródła wiedzy Fabric Data Agent. |
|
Fabric |
Konfiguracja dla źródła wiedzy Fabric Ontology. |
|
File |
Konfiguracja dla źródła wiedzy plików, które obsługuje bezpośredni upload i indeksowanie plików. |
|
Indexed |
Konfiguracja dla źródła wiedzy OneLake. |
|
Indexed |
Konfiguracja źródła wiedzy programu SharePoint. |
|
Indexed |
Konfiguracja dla indeksowanego źródła wiedzy SQL. |
|
Mcp |
Konfiguracja dla źródła wiedzy wspieranego przez serwer MCP (Model Context Protocol). |
|
Remote |
Konfiguracja zdalnego źródła wiedzy programu SharePoint. |
|
Search |
Źródło wiedzy przeznaczone dla indeksu wyszukiwania. |
|
Web |
Źródło wiedzy kierowane na wyniki w internecie. |
|
Work |
Konfiguracja dla źródła wiedzy WorkIQ. |
AzureBlobKnowledgeSource
Konfiguracja źródła wiedzy Azure Blob Storage.
| Nazwisko | Wymagane | Typ | Opis |
|---|---|---|---|
| azureBlobParameters | True |
Typ źródła wiedzy. |
|
| kind | True |
string:
azure |
Typ źródła wiedzy. |
| name | True |
string |
Nazwa źródła wiedzy. |
| @odata.etag |
string |
ETag źródła wiedzy. |
|
| description |
string |
Opcjonalny opis zdefiniowany przez użytkownika. |
|
| encryptionKey |
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. |
||
| resultsProcessing |
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. |
FabricDataAgentKnowledgeSource
Konfiguracja dla źródła wiedzy Fabric Data Agent.
| Nazwisko | Wymagane | Typ | Opis |
|---|---|---|---|
| fabricDataAgentParameters | True |
Parametry źródła wiedzy Fabric Data Agent. |
|
| kind | True |
string:
fabric |
Typ źródła wiedzy. |
| name | True |
string |
Nazwa źródła wiedzy. |
| @odata.etag |
string |
ETag źródła wiedzy. |
|
| description |
string |
Opcjonalny opis zdefiniowany przez użytkownika. |
|
| encryptionKey |
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. |
||
| resultsProcessing |
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. |
FabricOntologyKnowledgeSource
Konfiguracja dla źródła wiedzy Fabric Ontology.
| Nazwisko | Wymagane | Typ | Opis |
|---|---|---|---|
| fabricOntologyParameters | True |
Parametry źródła wiedzy Fabric Ontology. |
|
| kind | True |
string:
fabric |
Typ źródła wiedzy. |
| name | True |
string |
Nazwa źródła wiedzy. |
| @odata.etag |
string |
ETag źródła wiedzy. |
|
| description |
string |
Opcjonalny opis zdefiniowany przez użytkownika. |
|
| encryptionKey |
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. |
||
| resultsProcessing |
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. |
FileKnowledgeSource
Konfiguracja dla źródła wiedzy plików, które obsługuje bezpośredni upload i indeksowanie plików.
| Nazwisko | Wymagane | Typ | Opis |
|---|---|---|---|
| fileParameters | True |
Parametry dla źródła wiedzy pliku. |
|
| kind | True |
string:
file |
Typ źródła wiedzy. |
| name | True |
string |
Nazwa źródła wiedzy. |
| @odata.etag |
string |
ETag źródła wiedzy. |
|
| 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 |
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. |
||
| resultsProcessing |
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. |
IndexedOneLakeKnowledgeSource
Konfiguracja dla źródła wiedzy OneLake.
| Nazwisko | Wymagane | Typ | Opis |
|---|---|---|---|
| indexedOneLakeParameters | True |
Parametry źródła wiedzy. |
|
| kind | True |
string:
indexed |
Typ źródła wiedzy. |
| name | True |
string |
Nazwa źródła wiedzy. |
| @odata.etag |
string |
ETag źródła wiedzy. |
|
| description |
string |
Opcjonalny opis zdefiniowany przez użytkownika. |
|
| encryptionKey |
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. |
||
| resultsProcessing |
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. |
IndexedSharePointKnowledgeSource
Konfiguracja źródła wiedzy programu SharePoint.
| Nazwisko | Wymagane | Typ | Opis |
|---|---|---|---|
| indexedSharePointParameters | True |
Parametry źródła wiedzy. |
|
| kind | True |
string:
indexed |
Typ źródła wiedzy. |
| name | True |
string |
Nazwa źródła wiedzy. |
| @odata.etag |
string |
ETag źródła wiedzy. |
|
| description |
string |
Opcjonalny opis zdefiniowany przez użytkownika. |
|
| encryptionKey |
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. |
||
| resultsProcessing |
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. |
IndexedSqlKnowledgeSource
Konfiguracja dla indeksowanego źródła wiedzy SQL.
| Nazwisko | Wymagane | Typ | Opis |
|---|---|---|---|
| indexedSqlParameters | True |
Parametry źródła wiedzy SQL. |
|
| kind | True |
string:
indexed |
Typ źródła wiedzy. |
| name | True |
string |
Nazwa źródła wiedzy. |
| @odata.etag |
string |
ETag źródła wiedzy. |
|
| description |
string |
Opcjonalny opis zdefiniowany przez użytkownika. |
|
| encryptionKey |
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. |
||
| resultsProcessing |
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. |
McpServerKnowledgeSource
Konfiguracja dla źródła wiedzy wspieranego przez serwer MCP (Model Context Protocol).
| Nazwisko | Wymagane | Typ | Opis |
|---|---|---|---|
| kind | True |
string:
mcp |
Typ źródła wiedzy. |
| mcpServerParameters | True |
Parametry źródła wiedzy serwera MCP. |
|
| name | True |
string |
Nazwa źródła wiedzy. |
| @odata.etag |
string |
ETag źródła wiedzy. |
|
| description |
string |
Opcjonalny opis zdefiniowany przez użytkownika. |
|
| encryptionKey |
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. |
||
| resultsProcessing |
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. |
RemoteSharePointKnowledgeSource
Konfiguracja zdalnego źródła wiedzy programu SharePoint.
| Nazwisko | Wymagane | Typ | Opis |
|---|---|---|---|
| kind | True |
string:
remote |
Typ źródła wiedzy. |
| name | True |
string |
Nazwa źródła wiedzy. |
| @odata.etag |
string |
ETag źródła wiedzy. |
|
| description |
string |
Opcjonalny opis zdefiniowany przez użytkownika. |
|
| encryptionKey |
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. |
||
| remoteSharePointParameters |
Parametry zdalnego źródła wiedzy SharePoint. |
||
| resultsProcessing |
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. |
SearchIndexKnowledgeSource
Źródło wiedzy przeznaczone dla indeksu wyszukiwania.
| Nazwisko | Wymagane | Typ | Opis |
|---|---|---|---|
| kind | True |
string:
search |
Typ źródła wiedzy. |
| name | True |
string |
Nazwa źródła wiedzy. |
| searchIndexParameters | True |
Parametry źródła wiedzy. |
|
| @odata.etag |
string |
ETag źródła wiedzy. |
|
| description |
string |
Opcjonalny opis zdefiniowany przez użytkownika. |
|
| encryptionKey |
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. |
||
| resultsProcessing |
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. |
WebKnowledgeSource
Źródło wiedzy kierowane na wyniki w internecie.
| Nazwisko | Wymagane | Typ | Opis |
|---|---|---|---|
| kind | True |
string:
web |
Typ źródła wiedzy. |
| name | True |
string |
Nazwa źródła wiedzy. |
| @odata.etag |
string |
ETag źródła wiedzy. |
|
| description |
string |
Opcjonalny opis zdefiniowany przez użytkownika. |
|
| encryptionKey |
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. |
||
| resultsProcessing |
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 |
Parametry internetowego źródła wiedzy. |
WorkIQKnowledgeSource
Konfiguracja dla źródła wiedzy WorkIQ.
| Nazwisko | Wymagane | Typ | Opis |
|---|---|---|---|
| kind | True |
string:
workIQ |
Typ źródła wiedzy. |
| name | True |
string |
Nazwa źródła wiedzy. |
| workIQParameters | True |
Parametry dla źródła wiedzy WorkIQ, w tym konfiguracja aplikacji Entra należąca do klienta, używana do uwierzytelniania w imieniu użytkownika. |
|
| @odata.etag |
string |
ETag źródła wiedzy. |
|
| description |
string |
Opcjonalny opis zdefiniowany przez użytkownika. |
|
| encryptionKey |
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. |
||
| resultsProcessing |
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. |
Odpowiedzi
| Nazwisko | Typ | Opis |
|---|---|---|
| 200 OK |
KnowledgeSource:
|
Żądanie zakończyło się pomyślnie. |
| 201 Created |
KnowledgeSource:
|
Żądanie zakończyło się pomyślnie i w rezultacie został utworzony nowy zasób. |
| Other Status Codes |
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
SearchServiceAttachKnowledgeSourceGraphOntology
Przykładowe żądanie
PUT https://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-graph-cache')?api-version=2026-11-01-preview
{
"name": "ks-graph-cache",
"kind": "azureBlob",
"@odata.etag": "\"0\"",
"azureBlobParameters": {
"connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
"containerName": "test-container",
"isADLSGen2": false,
"ingestionParameters": {
"embeddingModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "model",
"apiKey": "api-key",
"modelName": "text-embedding-3-large"
}
},
"chatCompletionModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "myDeployment",
"apiKey": "api-key",
"modelName": "gpt-4o-mini"
}
},
"disableImageVerbalization": true,
"ingestionSchedule": {
"interval": "P1D",
"startTime": "2025-01-07T19:30:00Z"
},
"contentExtractionMode": "minimal",
"cache": {
"storageConnectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
"enableReprocessing": true
}
},
"graphExtraction": {
"graphName": "products",
"ontology": {
"kind": "inline",
"name": "product-ontology",
"value": "{\n \"@context\": {\n \"@version\": 1.1,\n \"owl\": \"http://www.w3.org/2002/07/owl#\",\n \"rdfs\": \"http://www.w3.org/2000/01/rdf-schema#\",\n \"xsd\": \"http://www.w3.org/2001/XMLSchema#\",\n \"ex\": \"https://example.com/products#\"\n },\n \"@graph\": [\n { \"@id\": \"ex:Product\", \"@type\": \"owl:Class\" },\n { \"@id\": \"ex:Category\", \"@type\": \"owl:Class\" },\n { \"@id\": \"ex:belongsTo\", \"@type\": \"owl:ObjectProperty\",\n \"rdfs:domain\": { \"@id\": \"ex:Product\" }, \"rdfs:range\": { \"@id\": \"ex:Category\" } }\n ]\n}"
}
}
}
}
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,
"contentExtractionMode": "minimal",
"embeddingModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "model",
"apiKey": "api-key",
"modelName": "text-embedding-3-large"
}
},
"chatCompletionModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "myDeployment",
"apiKey": "api-key",
"modelName": "gpt-4o-mini"
}
},
"ingestionSchedule": {
"interval": "P1D",
"startTime": "2024-06-06T00:01:50.265Z"
},
"cache": {
"enableReprocessing": true
}
},
"graphExtraction": {
"graphName": "products",
"ontology": {
"kind": "inline",
"name": "product-ontology",
"value": "{\n \"@context\": {\n \"@version\": 1.1,\n \"owl\": \"http://www.w3.org/2002/07/owl#\",\n \"rdfs\": \"http://www.w3.org/2000/01/rdf-schema#\",\n \"xsd\": \"http://www.w3.org/2001/XMLSchema#\",\n \"ex\": \"https://example.com/products#\"\n },\n \"@graph\": [\n { \"@id\": \"ex:Product\", \"@type\": \"owl:Class\" },\n { \"@id\": \"ex:Category\", \"@type\": \"owl:Class\" },\n { \"@id\": \"ex:belongsTo\", \"@type\": \"owl:ObjectProperty\",\n \"rdfs:domain\": { \"@id\": \"ex:Product\" }, \"rdfs:range\": { \"@id\": \"ex:Category\" } }\n ]\n}"
}
},
"createdResources": {
"datasource": "ks-graph-cache-datasource",
"indexer": "ks-graph-cache-indexer",
"skillset": "ks-graph-cache-skillset",
"index": "ks-graph-cache-index"
}
}
}
{
"@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,
"contentExtractionMode": "minimal",
"embeddingModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "model",
"apiKey": "api-key",
"modelName": "text-embedding-3-large"
}
},
"chatCompletionModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "myDeployment",
"apiKey": "api-key",
"modelName": "gpt-4o-mini"
}
},
"ingestionSchedule": {
"interval": "P1D",
"startTime": "2024-06-06T00:01:50.265Z"
},
"cache": {
"enableReprocessing": true
}
},
"graphExtraction": {
"graphName": "products",
"ontology": {
"kind": "inline",
"name": "product-ontology",
"value": "{\n \"@context\": {\n \"@version\": 1.1,\n \"owl\": \"http://www.w3.org/2002/07/owl#\",\n \"rdfs\": \"http://www.w3.org/2000/01/rdf-schema#\",\n \"xsd\": \"http://www.w3.org/2001/XMLSchema#\",\n \"ex\": \"https://example.com/products#\"\n },\n \"@graph\": [\n { \"@id\": \"ex:Product\", \"@type\": \"owl:Class\" },\n { \"@id\": \"ex:Category\", \"@type\": \"owl:Class\" },\n { \"@id\": \"ex:belongsTo\", \"@type\": \"owl:ObjectProperty\",\n \"rdfs:domain\": { \"@id\": \"ex:Product\" }, \"rdfs:range\": { \"@id\": \"ex:Category\" } }\n ]\n}"
}
},
"createdResources": {
"datasource": "ks-graph-cache-datasource",
"indexer": "ks-graph-cache-indexer",
"skillset": "ks-graph-cache-skillset",
"index": "ks-graph-cache-index"
}
}
}
SearchServiceCreateOrUpdateKnowledgeSource
Przykładowe żądanie
PUT https://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-preview-test')?api-version=2026-11-01-preview
{
"name": "ks-preview-test",
"description": "Description of the knowledge source.",
"kind": "searchIndex",
"resultsProcessing": "none",
"@odata.etag": "0x1234568AE7E58A1",
"encryptionKey": {
"keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
"keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
"keyVaultUri": "https://myKeyVault.vault.azure.net",
"accessCredentials": {
"applicationId": "00000000-0000-0000-0000-000000000000",
"applicationSecret": "<applicationSecret>"
}
},
"searchIndexParameters": {
"searchIndexName": "preview-test",
"sourceDataFields": [
{
"name": "description"
},
{
"name": "category"
}
],
"searchFields": [
{
"name": "*"
}
],
"semanticConfigurationName": "testconfig",
"baseFilter": "category eq 'news'",
"queryHints": {
"filters": [
{
"field": "model",
"fieldValues": [
"Model-X100",
"Model-X200",
"Model-Pro"
],
"filterInstructions": "Product model name."
}
],
"boosts": [
{
"kind": "fieldValue",
"boostInstructions": "Document language; pick from the user's locale.",
"field": "language",
"fieldValues": [
"en",
"ja",
"fr",
"de"
],
"boost": 2
}
]
}
}
}
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."
}
]
}
}
}
{
"@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."
}
]
}
}
}
SearchServiceCreateOrUpdateKnowledgeSourceAzureBlob
Przykładowe żądanie
PUT https://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-preview-test')?api-version=2026-11-01-preview
{
"name": "ks-preview-test",
"description": "Description of the knowledge source.",
"kind": "azureBlob",
"@odata.etag": "0x1234568AE7E58A1",
"encryptionKey": {
"keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
"keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
"keyVaultUri": "https://myKeyVault.vault.azure.net",
"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": {
"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": "api-key",
"modelName": "text-embedding-3-large"
}
},
"chatCompletionModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "myDeployment",
"apiKey": "api-key",
"modelName": "gpt-4o-mini"
}
},
"disableImageVerbalization": false,
"ingestionSchedule": {
"interval": "P1D",
"startTime": "2025-01-07T19:30:00Z"
},
"ingestionPermissionOptions": [
"rbacScope"
],
"contentExtractionMode": "standard",
"aiServices": {
"uri": "https://my-ai-service.azure.com/",
"apiKey": "api-key"
},
"assetStore": {
"connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
"containerName": "image-assets"
},
"freshnessPolicy": {
"boostingDuration": "P90D"
},
"networkAccessMode": "private"
}
}
}
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": "api-key",
"modelName": "text-embedding-3-large"
}
},
"chatCompletionModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "myDeployment",
"apiKey": "api-key",
"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": "api-key"
},
"freshnessPolicy": {
"boostingDuration": "P90D"
}
},
"createdResources": {
"datasource": "ks-preview-test-datasource",
"indexer": "ks-preview-test-indexer",
"skillset": "ks-preview-test-skillset",
"index": "ks-preview-test-index"
}
}
}
{
"@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": "api-key",
"modelName": "text-embedding-3-large"
}
},
"chatCompletionModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "myDeployment",
"apiKey": "api-key",
"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": "api-key"
},
"freshnessPolicy": {
"boostingDuration": "P90D"
}
},
"createdResources": {
"datasource": "ks-preview-test-datasource",
"indexer": "ks-preview-test-indexer",
"skillset": "ks-preview-test-skillset",
"index": "ks-preview-test-index"
}
}
}
SearchServiceCreateOrUpdateKnowledgeSourceAzureBlobWithTopicGraphs
Przykładowe żądanie
PUT https://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-preview-test')?api-version=2026-11-01-preview
{
"name": "ks-preview-test",
"description": "Description of the knowledge source.",
"kind": "azureBlob",
"@odata.etag": "0x1234568AE7E58A1",
"encryptionKey": {
"keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
"keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
"keyVaultUri": "https://myKeyVault.vault.azure.net",
"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": {
"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": "api-key",
"modelName": "text-embedding-3-large"
}
},
"chatCompletionModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "myDeployment",
"apiKey": "api-key",
"modelName": "gpt-4o-mini"
}
},
"disableImageVerbalization": false,
"ingestionSchedule": {
"interval": "P1D",
"startTime": "2025-01-07T19:30:00Z"
},
"ingestionPermissionOptions": [
"rbacScope"
],
"contentExtractionMode": "standard",
"aiServices": {
"uri": "https://my-ai-service.azure.com/",
"apiKey": "api-key"
},
"assetStore": {
"connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
"containerName": "image-assets"
},
"freshnessPolicy": {
"boostingDuration": "P90D"
},
"networkAccessMode": "private"
},
"topicGraph": {
"kind": "diverse",
"minDiversityPoolSize": 1000,
"diversityFactor": 0.1
}
}
}
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": "api-key",
"modelName": "text-embedding-3-large"
}
},
"chatCompletionModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "myDeployment",
"apiKey": "api-key",
"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": "api-key"
},
"freshnessPolicy": {
"boostingDuration": "P90D"
}
},
"topicGraph": {
"kind": "diverse",
"diversityFactor": 0.1,
"minDiversityPoolSize": 1000
},
"createdResources": {
"datasource": "ks-preview-test-datasource",
"indexer": "ks-preview-test-indexer",
"skillset": "ks-preview-test-skillset",
"index": "ks-preview-test-index"
}
}
}
{
"@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": "api-key",
"modelName": "text-embedding-3-large"
}
},
"chatCompletionModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "myDeployment",
"apiKey": "api-key",
"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": "api-key"
},
"freshnessPolicy": {
"boostingDuration": "P90D"
}
},
"topicGraph": {
"kind": "diverse",
"diversityFactor": 0.1,
"minDiversityPoolSize": 1000
},
"createdResources": {
"datasource": "ks-preview-test-datasource",
"indexer": "ks-preview-test-indexer",
"skillset": "ks-preview-test-skillset",
"index": "ks-preview-test-index"
}
}
}
SearchServiceCreateOrUpdateKnowledgeSourceCompatibleResponses
Przykładowe żądanie
PUT https://typespecpreviewexampleservice.search.windows.net/knowledgesources('image-documents')?api-version=2026-11-01-preview
{
"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/responses?route=primary&api-version=2026-01-01",
"modelName": "gpt-4.1-mini",
"headers": {
"api-key": "test-key"
}
}
},
"disableImageVerbalization": false,
"contentExtractionMode": "minimal"
}
}
}
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/responses?route=primary&api-version=2026-01-01",
"modelName": "gpt-4.1-mini"
}
},
"disableImageVerbalization": false,
"contentExtractionMode": "minimal"
}
}
}
{
"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/responses?route=primary&api-version=2026-01-01",
"modelName": "gpt-4.1-mini"
}
},
"disableImageVerbalization": false,
"contentExtractionMode": "minimal"
}
}
}
SearchServiceCreateOrUpdateKnowledgeSourceFile
Przykładowe żądanie
PUT https://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-preview-test')?api-version=2026-11-01-preview
{
"name": "ks-preview-test",
"description": "Description of the File knowledge source.",
"kind": "file",
"fileParameters": {
"ingestionParameters": {
"embeddingModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "model",
"apiKey": "api-key",
"modelName": "text-embedding-3-large"
}
},
"chatCompletionModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "myDeployment",
"apiKey": "api-key",
"modelName": "gpt-4o-mini"
}
},
"contentExtractionMode": "standard",
"aiServices": {
"uri": "https://my-ai-service.azure.com/",
"apiKey": "api-key"
}
}
},
"corsOptions": {
"allowedOrigins": [
"https://myapp.example.com"
],
"maxAgeInSeconds": 300
}
}
Przykładowa odpowiedź
{
"@odata.etag": "0x1234568AE7E58A1",
"name": "ks-preview-test",
"kind": "file",
"description": "Description of the File knowledge source.",
"fileParameters": {
"ingestionParameters": {
"contentExtractionMode": "standard",
"embeddingModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "model",
"apiKey": "api-key",
"modelName": "text-embedding-3-large"
}
},
"chatCompletionModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "myDeployment",
"apiKey": "api-key",
"modelName": "gpt-4o-mini"
}
},
"aiServices": {
"uri": "https://my-ai-service.azure.com/",
"apiKey": "api-key"
}
},
"createdResources": {
"index": "ks-preview-test-index"
}
},
"corsOptions": {
"allowedOrigins": [
"https://myapp.example.com"
],
"maxAgeInSeconds": 300
}
}
{
"@odata.etag": "0x1234568AE7E58A1",
"name": "ks-preview-test",
"kind": "file",
"description": "Description of the File knowledge source.",
"fileParameters": {
"ingestionParameters": {
"contentExtractionMode": "standard",
"embeddingModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "model",
"apiKey": "api-key",
"modelName": "text-embedding-3-large"
}
},
"chatCompletionModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "myDeployment",
"apiKey": "api-key",
"modelName": "gpt-4o-mini"
}
},
"aiServices": {
"uri": "https://my-ai-service.azure.com/",
"apiKey": "api-key"
}
},
"createdResources": {
"index": "ks-preview-test-index"
}
},
"corsOptions": {
"allowedOrigins": [
"https://myapp.example.com"
],
"maxAgeInSeconds": 300
}
}
SearchServiceCreateOrUpdateKnowledgeSourceIndexedOneLake
Przykładowe żądanie
PUT https://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-preview-test')?api-version=2026-11-01-preview
{
"name": "ks-preview-test",
"description": "Description of the OneLake knowledge source.",
"kind": "indexedOneLake",
"@odata.etag": "0x1234568AE7E58A1",
"encryptionKey": {
"keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
"keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
"keyVaultUri": "https://myKeyVault.vault.azure.net",
"accessCredentials": {
"applicationId": "00000000-0000-0000-0000-000000000000",
"applicationSecret": "<applicationSecret>"
}
},
"indexedOneLakeParameters": {
"fabricWorkspaceId": "ResourceId=fakeWorkspaceId",
"lakehouseId": "fakeLakehouseId",
"targetPath": "testfolder",
"ingestionParameters": {
"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": "api-key",
"modelName": "text-embedding-3-large"
}
},
"chatCompletionModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "myDeployment",
"apiKey": "api-key",
"modelName": "gpt-4o-mini"
}
},
"disableImageVerbalization": false,
"ingestionSchedule": {
"interval": "P1D",
"startTime": "2025-01-07T19:30:00Z"
},
"contentExtractionMode": "standard",
"aiServices": {
"uri": "https://my-ai-service.azure.com/",
"apiKey": "api-key"
},
"assetStore": {
"connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
"containerName": "image-assets"
}
}
}
}
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": "ResourceId=fakeWorkspaceId",
"lakehouseId": "fakeLakehouseId",
"targetPath": "testfolder",
"ingestionParameters": {
"disableImageVerbalization": false,
"contentExtractionMode": "standard",
"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": "api-key",
"modelName": "text-embedding-3-large"
}
},
"chatCompletionModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "myDeployment",
"apiKey": "api-key",
"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": "api-key"
}
}
}
}
{
"@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": "ResourceId=fakeWorkspaceId",
"lakehouseId": "fakeLakehouseId",
"targetPath": "testfolder",
"ingestionParameters": {
"disableImageVerbalization": false,
"contentExtractionMode": "standard",
"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": "api-key",
"modelName": "text-embedding-3-large"
}
},
"chatCompletionModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "myDeployment",
"apiKey": "api-key",
"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": "api-key"
}
}
}
}
SearchServiceCreateOrUpdateKnowledgeSourceIndexedSharePoint
Przykładowe żądanie
PUT https://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-preview-test')?api-version=2026-11-01-preview
{
"name": "ks-preview-test",
"description": "Description of the SharePoint knowledge source.",
"kind": "indexedSharePoint",
"@odata.etag": "0x1234568AE7E58A1",
"encryptionKey": {
"keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
"keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
"keyVaultUri": "https://myKeyVault.vault.azure.net",
"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": {
"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": "api-key",
"modelName": "text-embedding-3-large"
}
},
"chatCompletionModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "myDeployment",
"apiKey": "api-key",
"modelName": "gpt-4o-mini"
}
},
"disableImageVerbalization": false,
"ingestionSchedule": {
"interval": "P1D",
"startTime": "2025-01-07T19:30:00Z"
},
"ingestionPermissionOptions": [
"userIds",
"groupIds"
],
"contentExtractionMode": "standard",
"aiServices": {
"uri": "https://my-ai-service.azure.com/",
"apiKey": "api-key"
},
"assetStore": {
"connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net ",
"containerName": "image-assets"
},
"freshnessPolicy": {
"boostingDuration": "P90D"
}
}
}
}
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",
"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": "api-key",
"modelName": "text-embedding-3-large"
}
},
"chatCompletionModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "myDeployment",
"apiKey": "api-key",
"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": "api-key"
},
"freshnessPolicy": {
"boostingDuration": "P90D"
}
}
}
}
{
"@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",
"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": "api-key",
"modelName": "text-embedding-3-large"
}
},
"chatCompletionModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "myDeployment",
"apiKey": "api-key",
"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": "api-key"
},
"freshnessPolicy": {
"boostingDuration": "P90D"
}
}
}
}
SearchServiceCreateOrUpdateKnowledgeSourceIndexedSql
Przykładowe żądanie
PUT https://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-preview-test')?api-version=2026-11-01-preview
{
"name": "ks-preview-test",
"description": "Description of the SQL knowledge source.",
"kind": "indexedSql",
"@odata.etag": "0x1234568AE7E58A1",
"encryptionKey": {
"keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
"keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
"keyVaultUri": "https://myKeyVault.vault.azure.net",
"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": {
"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": "api-key",
"modelName": "text-embedding-3-large"
}
},
"ingestionSchedule": {
"interval": "P1D",
"startTime": "2025-01-07T19:30:00Z"
},
"contentExtractionMode": "minimal"
}
}
}
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": {
"contentExtractionMode": "minimal",
"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": "api-key",
"modelName": "text-embedding-3-large"
}
},
"ingestionSchedule": {
"interval": "P1D",
"startTime": "2024-06-06T00:01:50.265Z"
}
}
}
}
{
"@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": {
"contentExtractionMode": "minimal",
"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": "api-key",
"modelName": "text-embedding-3-large"
}
},
"ingestionSchedule": {
"interval": "P1D",
"startTime": "2024-06-06T00:01:50.265Z"
}
}
}
}
SearchServiceCreateOrUpdateKnowledgeSourceMcpServer
Przykładowe żądanie
PUT https://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-preview-test')?api-version=2026-11-01-preview
{
"name": "ks-preview-test",
"description": "Description of the MCP server knowledge source.",
"kind": "mcpServer",
"@odata.etag": "0x1234568AE7E58A1",
"encryptionKey": {
"keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
"keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
"keyVaultUri": "https://myKeyVault.vault.azure.net",
"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",
"outputParsing": {
"kind": "json",
"jsonParameters": {
"documentsPath": "$.documents[*]",
"includeContext": true
}
},
"resultsProcessing": "rerank",
"maxOutputTokens": 4096
}
]
}
}
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
}
}
}
]
}
}
{
"@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
}
}
}
]
}
}
SearchServiceCreateOrUpdateKnowledgeSourceOpenAICompatible
Przykładowe żądanie
PUT https://typespecpreviewexampleservice.search.windows.net/knowledgesources('compatible-preview-file-source')?api-version=2026-11-01-preview
{
"name": "compatible-preview-file-source",
"description": "Description of the File knowledge source.",
"kind": "file",
"fileParameters": {
"ingestionParameters": {
"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,
"headers": {
"api-key": "EXAMPLE-NOT-A-REAL-SECRET",
"x-route-key": "EXAMPLE-NOT-A-REAL-ROUTING-SECRET"
}
}
},
"chatCompletionModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"resourceUri": "https://test-sample.openai.azure.com/",
"deploymentId": "myDeployment",
"apiKey": "api-key",
"modelName": "gpt-4o-mini"
}
},
"contentExtractionMode": "standard",
"aiServices": {
"uri": "https://my-ai-service.azure.com/",
"apiKey": "api-key"
}
}
},
"corsOptions": {
"allowedOrigins": [
"https://myapp.example.com"
],
"maxAgeInSeconds": 300
}
}
Przykładowa odpowiedź
{
"@odata.etag": "0x1234568AE7E58A1",
"name": "compatible-preview-file-source",
"kind": "file",
"description": "Description of the File knowledge source.",
"fileParameters": {
"ingestionParameters": {
"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": "api-key",
"modelName": "gpt-4o-mini"
}
},
"aiServices": {
"uri": "https://my-ai-service.azure.com/",
"apiKey": "api-key"
}
},
"createdResources": {
"index": "compatible-preview-file-source-index"
}
},
"corsOptions": {
"allowedOrigins": [
"https://myapp.example.com"
],
"maxAgeInSeconds": 300
}
}
{
"@odata.etag": "0x1234568AE7E58A1",
"name": "compatible-preview-file-source",
"kind": "file",
"description": "Description of the File knowledge source.",
"fileParameters": {
"ingestionParameters": {
"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": "api-key",
"modelName": "gpt-4o-mini"
}
},
"aiServices": {
"uri": "https://my-ai-service.azure.com/",
"apiKey": "api-key"
}
},
"createdResources": {
"index": "compatible-preview-file-source-index"
}
},
"corsOptions": {
"allowedOrigins": [
"https://myapp.example.com"
],
"maxAgeInSeconds": 300
}
}
SearchServiceCreateOrUpdateKnowledgeSourceWeb
Przykładowe żądanie
PUT https://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-preview-test')?api-version=2026-11-01-preview
{
"webParameters": {
"domains": {
"allowedDomains": [
{
"address": "example.com",
"includeSubpages": true
},
{
"address": "another-example.com"
}
],
"blockedDomains": [
{
"address": "blocked.com"
},
{
"address": "spam.com",
"includeSubpages": true
}
]
}
},
"name": "ks-preview-test",
"description": "Description of the knowledge source.",
"kind": "web",
"@odata.etag": "0x1234568AE7E58A1",
"encryptionKey": {
"keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
"keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
"keyVaultUri": "https://myKeyVault.vault.azure.net",
"accessCredentials": {
"applicationId": "00000000-0000-0000-0000-000000000000",
"applicationSecret": "<applicationSecret>"
}
}
}
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
}
]
}
}
}
{
"@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
}
]
}
}
}
SearchServiceCreateOrUpdateKnowledgeSourceWithTopicGraphs
Przykładowe żądanie
PUT https://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-preview-test')?api-version=2026-11-01-preview
{
"name": "ks-preview-test",
"description": "Description of the knowledge source.",
"kind": "searchIndex",
"resultsProcessing": "none",
"@odata.etag": "0x1234568AE7E58A1",
"encryptionKey": {
"keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
"keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
"keyVaultUri": "https://myKeyVault.vault.azure.net",
"accessCredentials": {
"applicationId": "00000000-0000-0000-0000-000000000000",
"applicationSecret": "<applicationSecret>"
}
},
"searchIndexParameters": {
"searchIndexName": "preview-test",
"sourceDataFields": [
{
"name": "description"
},
{
"name": "category"
}
],
"searchFields": [
{
"name": "*"
}
],
"semanticConfigurationName": "testconfig",
"baseFilter": "category eq 'news'",
"queryHints": {
"filters": [
{
"field": "model",
"fieldValues": [
"Model-X100",
"Model-X200",
"Model-Pro"
],
"filterInstructions": "Product model name."
}
],
"boosts": [
{
"kind": "fieldValue",
"boostInstructions": "Document language; pick from the user's locale.",
"field": "language",
"fieldValues": [
"en",
"ja",
"fr",
"de"
],
"boost": 2
}
]
},
"topicGraph": {
"kind": "diverse",
"minDiversityPoolSize": 1000,
"diversityFactor": 0.1
}
}
}
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."
}
]
},
"topicGraph": {
"kind": "diverse",
"diversityFactor": 0.1,
"minDiversityPoolSize": 1000
}
}
}
{
"@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."
}
]
},
"topicGraph": {
"kind": "diverse",
"diversityFactor": 0.1,
"minDiversityPoolSize": 1000
}
}
}
SearchServiceCreateOrUpdateKnowledgeSourceWorkIQ
Przykładowe żądanie
PUT https://typespecpreviewexampleservice.search.windows.net/knowledgesources('ks-preview-test')?api-version=2026-11-01-preview
{
"name": "ks-preview-test",
"description": "Description of the WorkIQ knowledge source.",
"kind": "workIQ",
"@odata.etag": "0x1234568AE7E58A1",
"encryptionKey": {
"keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
"keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
"keyVaultUri": "https://myKeyVault.vault.azure.net",
"accessCredentials": {
"applicationId": "00000000-0000-0000-0000-000000000000",
"applicationSecret": "<applicationSecret>"
}
},
"workIQParameters": {
"entraAppAuthentication": {
"applicationId": "11111111-1111-1111-1111-111111111111",
"federatedCredentialId": "22222222-2222-2222-2222-222222222222"
}
}
}
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"
}
}
}
{
"@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. |
|
Asset |
Konfiguracja magazynu zasobów używanego do przechowywania wyodrębnionych zasobów, takich jak obrazy. |
|
Azure |
Konfiguracja źródła wiedzy Azure Blob Storage. |
|
Azure |
Parametry źródła wiedzy Azure Blob Storage. |
|
Azure |
Nazwa modelu Azure Open AI, który zostanie wywołany. |
|
Azure |
Określa parametry nawiązywania połączenia z zasobem usługi Azure OpenAI. |
|
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ą. |
|
Content |
Mapuje kolumnę SQL na pole indeksu wyszukiwania. |
|
Cors |
Definiuje opcje kontrolowania współużytkowania zasobów między źródłami (CORS) dla indeksu. |
|
Diverse |
Wykorzystuje wykres tematyczny do różnorodnego wyszukiwania. |
|
Embedding |
Mapuje kolumnę SQL na pole wektorowe do osadzania. |
|
Entra |
Konfiguracja rejestracji aplikacji Microsoft Entra należącej do klienta do federacyjnej uwierzytelniania opartej na poświadczeniu na zlecenie. |
|
Error |
Dodatkowe informacje o błędzie zarządzania zasobami. |
|
Error |
Szczegóły błędu. |
|
Error |
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). |
|
Fabric |
Konfiguracja dla źródła wiedzy Fabric Data Agent. |
|
Fabric |
Parametry dla źródła wiedzy Fabric Data Agent. |
|
Fabric |
Konfiguracja dla źródła wiedzy Fabric Ontology. |
|
Fabric |
Parametry dla źródła wiedzy o Fabric Ontology. |
|
File |
Konfiguracja dla źródła wiedzy plików, które obsługuje bezpośredni upload i indeksowanie plików. |
|
File |
Parametry dla źródła wiedzy pliku. |
|
Freshness |
Konfiguracja do pobierania z uwzględnieniem świeżości. Po ustawieniu nowsze dokumenty otrzymują wzrost rankingu podczas pobierania. |
|
Indexed |
Konfiguracja dla źródła wiedzy OneLake. |
|
Indexed |
Parametry źródła wiedzy OneLake. |
|
Indexed |
Określa, do których bibliotek programu SharePoint należy uzyskać dostęp. |
|
Indexed |
Konfiguracja źródła wiedzy programu SharePoint. |
|
Indexed |
Parametry źródła wiedzy programu SharePoint. |
|
Indexed |
Konfiguracja dla indeksowanego źródła wiedzy SQL. |
|
Indexed |
Parametry dla indeksowanego źródła wiedzy SQL. |
|
Indexing |
Reprezentuje harmonogram wykonywania indeksatora. |
|
Knowledge |
Określa zasób usługi Azure OpenAI używany do planowania zapytań. |
|
Knowledge |
Określa Microsoft Retriever 1 używany do planowania i pobierania zapytań. |
|
Knowledge |
Model sztucznej inteligencji, który ma być używany do planowania zapytań. |
|
Knowledge |
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. |
|
Knowledge |
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. |
|
Knowledge |
Określa zasób usługi Azure OpenAI używany do wektoryzacji ciągu zapytania. |
|
Knowledge |
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. |
|
Knowledge |
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. |
|
Knowledge |
Źródło uziemienia do ekstrakcji grafów. Obsługiwane są tylko indeksy wyszukiwania tej samej usługi. |
|
Knowledge |
Identyfikuje indeks wyszukiwania używany do uziemiania wyodrębnionych obiektów. |
|
Knowledge |
Rodzaj źródła jawnego dla odniesienia uziemiającego. Obsługiwany jest tylko searchIndex. |
|
Knowledge |
Ontologia inline do ekstrakcji grafów. Jedynym obsługiwanym źródłem jest dokument z ograniczonym JSON-LD dostarczony bezpośrednio w żądaniu. |
|
Knowledge |
Jawny rodzaj źródła dla referencji ontologicznej. Obsługiwane jest tylko "inline". |
|
Knowledge |
Konsoliduje wszystkie ogólne ustawienia pozyskiwania dla źródeł wiedzy. |
|
Knowledge |
Rodzaje uprawnień do pobierania razem z treścią dokumentu. |
|
Knowledge |
Rodzaj źródła wiedzy. |
|
Knowledge |
Określa tryb dostępu sieciowego do pobierania źródeł danych. Domyślnie jest 'publiczne'. |
|
Knowledge |
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. |
|
Knowledge |
Kontroluje, czy wyniki źródła wiedzy zostaną ponownie uszeregowane. |
|
Mcp |
Taki rodzaj uwierzytelniania dla serwera MCP. |
|
Mcp |
Automatycznie wykrywaj format wyjściowy i analizuj odpowiednio. |
|
Mcp |
Uwierzytelnianie za pomocą połączenia Azure AI Foundry. |
|
Mcp |
Parametry uwierzytelniania połączenia z Foundry. |
|
Mcp |
Analizuj wynik jako dokument JSON, używając skonfigurowanych parametrów JSON. |
|
Mcp |
Konfiguracja dla źródła wiedzy wspieranego przez serwer MCP (Model Context Protocol). |
|
Mcp |
Parametry dla źródła wiedzy serwera MCP. |
|
Mcp |
Traktuj wyjście jako pojedynczy blok bez żadnego parsowania. |
|
Mcp |
Parametry parsowania wyjściowego JSON. |
|
Mcp |
Taki rodzaj parsowania wyników dla narzędzia serwera MCP. |
|
Mcp |
Parametry do parsowania wyjścia podzielonego. |
|
Mcp |
Podziel wyjście na strony za pomocą skonfigurowanych parametrów podziału. |
|
Mcp |
Uwierzytelnianie za pomocą zapisanych nagłówków HTTP. |
|
Mcp |
Parametry uwierzytelniania zapisanych nagłówków. |
|
Mcp |
Reprezentuje pojedyncze narzędzie w źródle wiedzy serwera MCP. |
|
None |
Używa normalnego wyszukiwania wektorowego bez wykresu tematów – różnorodne wyszukiwanie. |
|
Open |
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. |
| Prefer |
W przypadku żądań HTTP PUT instruuje usługę, aby zwróciła utworzony/zaktualizowany zasób w przypadku powodzenia. |
|
Remote |
Konfiguracja zdalnego źródła wiedzy programu SharePoint. |
|
Remote |
Parametry zdalnego źródła wiedzy programu SharePoint. |
|
Search |
Czyści właściwość tożsamości źródła danych. |
|
Search |
Określa tożsamość źródła danych do użycia. |
|
Search |
Referencja polowa dla indeksu wyszukiwania. |
|
Search |
Źródło wiedzy przeznaczone dla indeksu wyszukiwania. |
|
Search |
Taki rodzaj podpowiedzi do indeksu wyszukiwania jako źródło wiedzy. |
|
Search |
Wskazówka, która zwiększa liczbę dokumentów na podstawie wartości pola. |
|
Search |
Podpowiedzi identyfikującej pole oraz wyczerpujące wartości uziemienia, które planer zapytań może wykorzystać podczas tworzenia filtra. |
|
Search |
Konfiguruje automatyczne rozwiązywanie wartości uziemienia wskazówki filtra na podstawie faset indeksu docelowego. |
|
Search |
Wskazówka, która wzmacnia dokumenty oparte na wielowyrazowym wyrażeniu. |
|
Search |
Parametry źródła wiedzy indeksu wyszukiwania. |
|
Search |
Wskazówki, które prowadzą planowanie zapytań do przydatnych filtrów i wzmocnień dla źródła wiedzy indeksu wyszukiwania. |
|
Search |
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. |
|
Split |
Kody języków obsługiwane dla tekstu wejściowego przez SplitSkill. |
|
Text |
Wartość wskazująca tryb podziału do wykonania. |
|
Vector |
Rodzaj wyszukiwania wektorowego na grafach tematycznych, którego należy użyć. |
|
Vector |
Metoda wektoryzacji, która ma być używana w czasie wykonywania zapytania. |
|
Web |
Źródło wiedzy kierowane na wyniki w internecie. |
|
Web |
Konfiguracja domeny źródła wiedzy sieci Web. |
|
Web |
Konfiguracja zezwalania/blokowania domeny dla internetowego źródła wiedzy. |
|
Web |
Parametry źródła wiedzy internetowej. |
|
Work |
Konfiguracja dla źródła wiedzy WorkIQ. |
|
Work |
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 |
Typ źródła wiedzy. |
|
| description |
string |
Opcjonalny opis zdefiniowany przez użytkownika. |
| encryptionKey |
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:
azure |
Typ źródła wiedzy. |
| name |
string |
Nazwa źródła wiedzy. |
| resultsProcessing |
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 |
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 |
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 |
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: 250maximum: 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: 0maximum: 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: 250maximum: 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 |
Dodatkowe informacje o błędzie |
|
| code |
string |
Kod błędu. |
| details |
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 |
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 |
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 |
Parametry źródła wiedzy Fabric Data Agent. |
|
| kind |
string:
fabric |
Typ źródła wiedzy. |
| name |
string |
Nazwa źródła wiedzy. |
| resultsProcessing |
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 |
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 |
Parametry źródła wiedzy Fabric Ontology. |
|
| kind |
string:
fabric |
Typ źródła wiedzy. |
| name |
string |
Nazwa źródła wiedzy. |
| resultsProcessing |
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 |
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 |
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 |
Parametry dla źródła wiedzy pliku. |
|
| kind |
string:
file |
Typ źródła wiedzy. |
| name |
string |
Nazwa źródła wiedzy. |
| resultsProcessing |
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 |
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 |
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 |
Parametry źródła wiedzy. |
|
| kind |
string:
indexed |
Typ źródła wiedzy. |
| name |
string |
Nazwa źródła wiedzy. |
| resultsProcessing |
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 |
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 |
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 |
Parametry źródła wiedzy. |
|
| kind |
string:
indexed |
Typ źródła wiedzy. |
| name |
string |
Nazwa źródła wiedzy. |
| resultsProcessing |
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 |
Określa, do których bibliotek programu SharePoint należy uzyskać dostęp. |
|
| createdResources |
object |
Zasoby utworzone przez źródło wiedzy. |
| ingestionParameters |
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 |
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 |
Parametry źródła wiedzy SQL. |
|
| kind |
string:
indexed |
Typ źródła wiedzy. |
| name |
string |
Nazwa źródła wiedzy. |
| resultsProcessing |
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 |
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 |
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 |
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 |
Azure OpenAI parametry. |
|
| kind |
string:
azure |
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:
microsoft |
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:
open |
Model sztucznej inteligencji, który ma być używany do planowania zapytań. |
| openAICompatibleParameters |
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 |
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 |
Zawiera parametry specyficzne dla wektoryzacji osadzania usługi Azure OpenAI. |
|
| kind |
string:
azure |
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 |
Opcjonalne źródło uziemienia używane do rozwiązywania wyodrębnionych elementów. |
||
| ontology |
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: 1maximum: 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 |
Indeks wyszukiwania tej samej usługi używany do uziemienia. Wymagane dla źródeł searchIndex. |
||
| kind | 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 |
Źródłowy. Obsługiwane jest tylko "inline". |
|
| name |
string |
Opcjonalna nazwa podanych przez klienta dla ontologii, potwierdzona na |
| 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 |
Opcjonalna konfiguracja usług AI Services do przetwarzania zawartości. |
||
| assetStore |
Opcjonalna konfiguracja magazynu zasobów do przechowywania wyodrębnionych zasobów, takich jak obrazy. |
||
| cache |
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 |
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 |
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 |
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 |
Opcjonalny harmonogram pozyskiwania danych. |
||
| networkAccessMode | 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:
open |
Nazwa rodzaju metody wektoryzacji konfigurowanej do użycia z wyszukiwaniem wektorowym. |
| openAICompatibleParameters |
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 |
Parametry uwierzytelniania połączenia z Foundry. |
|
| kind |
string:
foundry |
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 |
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 |
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:
mcp |
Typ źródła wiedzy. |
| mcpServerParameters |
Parametry źródła wiedzy serwera MCP. |
|
| name |
string |
Nazwa źródła wiedzy. |
| resultsProcessing |
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 |
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 |
Wartość wskazująca, który kod języka ma być używany. Wartość domyślna to |
|
| 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 |
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 |
Parametry do parsowania wyjścia podzielonego. |
McpServerStoredHeadersAuthentication
Uwierzytelnianie za pomocą zapisanych nagłówków HTTP.
| Nazwisko | Typ | Opis |
|---|---|---|
| kind |
string:
stored |
Rodzaj uwierzytelniania, którego warto użyć. |
| storedHeadersParameters |
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 |
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 |
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. |
Prefer
W przypadku żądań HTTP PUT instruuje usługę, aby zwróciła utworzony/zaktualizowany zasób w przypadku powodzenia.
| Wartość | Opis |
|---|---|
| return=representation |
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 |
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:
remote |
Typ źródła wiedzy. |
| name |
string |
Nazwa źródła wiedzy. |
| remoteSharePointParameters |
Parametry zdalnego źródła wiedzy SharePoint. |
|
| resultsProcessing |
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. |
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. |
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 |
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:
search |
Typ źródła wiedzy. |
| name |
string |
Nazwa źródła wiedzy. |
| resultsProcessing |
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 |
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:
field |
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 |
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 |
|
| 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 |
| 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: 60maximum: 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: 1maximum: 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:
multi |
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 |
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 |
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 |
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 |
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ć |
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 |
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 |
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 |
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 |
Domeny dozwolone dla wyników internetowych. |
|
| blockedDomains |
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 |
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 |
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 |
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 |
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 |
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. |