Knowledge Bases - List

Dienst:: Search Service

API-Version:: 2025-11-01-preview

Listet alle Wissensdatenbanken auf, die für einen Suchdienst verfügbar sind.

GET https:///knowledgebases?api-version=2025-11-01-preview

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
api-version	query	True	string minLength: 1	Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Anforderungsheader

Name	Erforderlich	Typ	Beschreibung
Accept		Accept	Die Überschrift "Annehmen".
x-ms-client-request-id		string (uuid)	Ein undurchsichtiger, global eindeutiger, clientgenerierter Zeichenfolgenbezeichner für die Anforderung.

Antworten

Name	Typ	Beschreibung
200 OK	ListKnowledgeBasesResult	Die Anforderung ist erfolgreich.
Other Status Codes	ErrorResponse	Unerwartete Fehlerantwort.

Sicherheit

api-key

Typ: apiKey
In: header

OAuth2Auth

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Bereiche

Name	Beschreibung
https://search.azure.com/.default

Beispiele

SearchServiceListKnowledgeBases

Beispielanforderung

HTTP

GET https:///knowledgebases?api-version=2025-11-01-preview

Beispiel für eine Antwort

Statuscode:: 200

{
  "value": [
    {
      "@odata.etag": "0x1234568AE7E58A1",
      "name": "base-preview-test",
      "description": "Description of the knowledge base.",
      "retrievalInstructions": "Instructions for retrieval for the knowledge base.",
      "answerInstructions": "Instructions for answer synthesis.",
      "outputMode": "extractiveData",
      "knowledgeSources": [
        {
          "name": "ks-preview-test"
        }
      ],
      "models": [
        {
          "kind": "azureOpenAI",
          "azureOpenAIParameters": {
            "resourceUri": "https://test-sample.openai.azure.com",
            "deploymentId": "myDeployment",
            "apiKey": "<redacted>",
            "modelName": "gpt-4o-mini"
          }
        }
      ],
      "encryptionKey": {
        "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
        "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
        "keyVaultUri": "https://myKeyVault.vault.azure.net",
        "accessCredentials": {
          "applicationId": "00000000-0000-0000-0000-000000000000",
          "applicationSecret": "<applicationSecret>"
        }
      },
      "retrievalReasoningEffort": {
        "kind": "low"
      }
    }
  ]
}

Definitionen

Name	Beschreibung
Accept	Die Überschrift "Annehmen".
AzureOpenAIModelName	Der Name des Azure Open AI-Modells, der aufgerufen wird.
AzureOpenAIVectorizerParameters	Gibt die Parameter für die Verbindung mit der Azure OpenAI-Ressource an.
ErrorAdditionalInfo	Der Ressourcenverwaltungsfehler zusätzliche Informationen.
ErrorDetail	Das Fehlerdetails.
ErrorResponse	Häufige Fehlerantwort für alle Azure Resource Manager-APIs, um Fehlerdetails für fehlgeschlagene Vorgänge zurückzugeben. (Dies folgt auch dem OData-Fehlerantwortformat.)
KnowledgeBase	Stellt eine Definition einer Wissensbasis dar.
KnowledgeBaseAzureOpenAIModel	Gibt die Azure OpenAI-Ressource an, die für die Abfrageplanung verwendet wird.
KnowledgeBaseModelKind	Das KI-Modell, das für die Abfrageplanung verwendet werden soll.
KnowledgeRetrievalLowReasoningEffort	Führen Sie das Abrufen von Wissen mit geringem Argumentationsaufwand durch.
KnowledgeRetrievalMediumReasoningEffort	Führen Sie den Wissensabruf mit mittlerem Argumentationsaufwand durch.
KnowledgeRetrievalMinimalReasoningEffort	Führen Sie den Wissensabruf mit minimalem Argumentationsaufwand durch.
KnowledgeRetrievalOutputMode	Die Ausgabekonfiguration für diesen Abruf.
KnowledgeRetrievalReasoningEffortKind	Der Aufwand, der beim Abrufen verwendet werden soll.
KnowledgeSourceReference	Verweise auf eine Wissensquelle.
ListKnowledgeBasesResult	Ergebnis aus der Auflistung von Wissensdatenbanken.
SearchIndexerDataNoneIdentity	Löscht die Identitätseigenschaft einer Datenquelle.
SearchIndexerDataUserAssignedIdentity	Gibt die Identität für eine zu verwendende Datenquelle an.
SearchResourceEncryptionKey	Ein vom Kunden verwalteter Verschlüsselungsschlüssel im Azure Key Vault. Schlüssel, die Sie erstellen und verwalten, können zum Verschlüsseln oder Entschlüsseln ruhender Daten verwendet werden, z. B. Indizes und Synonymzuordnungen.

Accept

Enumeration

Die Überschrift "Annehmen".

Wert	Beschreibung
application/json;odata.metadata=minimal

AzureOpenAIModelName

Enumeration

Der Name des Azure Open AI-Modells, der aufgerufen wird.

Wert	Beschreibung
text-embedding-ada-002	TextEmbeddingAda002 Modell.
text-embedding-3-large	TextEmbedding3Großes Modell.
text-embedding-3-small	TextEmbedding3Kleines Modell.
gpt-4o	Gpt4o Modell.
gpt-4o-mini	Gpt4oMini-Modell.
gpt-4.1	Gpt41-Modell.
gpt-4.1-mini	Gpt41Mini Modell.
gpt-4.1-nano	Gpt41Nano-Modell.
gpt-5	Gpt5-Modell.
gpt-5-mini	Gpt5Mini-Modell.
gpt-5-nano	Gpt5Nano-Modell.

AzureOpenAIVectorizerParameters

Objekt

Gibt die Parameter für die Verbindung mit der Azure OpenAI-Ressource an.

Name	Typ	Beschreibung
apiKey	string	API-Schlüssel der angegebenen Azure OpenAI-Ressource.
authIdentity	SearchIndexerDataIdentity: SearchIndexerDataNoneIdentity SearchIndexerDataUserAssignedIdentity	Die vom Benutzer zugewiesene verwaltete Identität, die für ausgehende Verbindungen verwendet wird.
deploymentId	string	ID der Azure OpenAI-Modellbereitstellung für die angegebene Ressource.
modelName	AzureOpenAIModelName	Der Name des Einbettungsmodells, das im bereitgestellten deploymentId-Pfad bereitgestellt wird.
resourceUri	string (uri)	Der Ressourcen-URI der Azure OpenAI-Ressource.

ErrorAdditionalInfo

Objekt

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name	Typ	Beschreibung
info		Die zusätzlichen Informationen.
type	string	Der zusätzliche Informationstyp.

ErrorDetail

Objekt

Das Fehlerdetails.

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die zusätzlichen Informationen des Fehlers.
code	string	Der Fehlercode.
details	ErrorDetail[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Das Fehlerziel.

ErrorResponse

Objekt

Häufige Fehlerantwort für alle Azure Resource Manager-APIs, um Fehlerdetails für fehlgeschlagene Vorgänge zurückzugeben. (Dies folgt auch dem OData-Fehlerantwortformat.)

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

KnowledgeBase

Objekt

Stellt eine Definition einer Wissensbasis dar.

Name	Typ	Beschreibung
@odata.etag	string	Das ETag der Wissensdatenbank.
answerInstructions	string	Anweisungen, die von der Wissensdatenbank bei der Erstellung von Antworten berücksichtigt werden.
description	string	Die Beschreibung der Wissensdatenbank.
encryptionKey	SearchResourceEncryptionKey	Eine Beschreibung eines Verschlüsselungsschlüssels, den Sie in Azure Key Vault erstellen.
knowledgeSources	KnowledgeSourceReference[]	Wissensquellen, die von dieser Wissensdatenbank referenziert werden.
models	KnowledgeBaseModel[]: KnowledgeBaseAzureOpenAIModel[]	Enthält Konfigurationsoptionen zum Herstellen einer Verbindung mit KI-Modellen.
name	string	Der Name der Wissensbasis.
outputMode	KnowledgeRetrievalOutputMode	Der Ausgabemodus für die Wissensdatenbank.
retrievalInstructions	string	Anweisungen, die von der Wissensdatenbank bei der Erstellung eines Abfrageplans berücksichtigt werden.
retrievalReasoningEffort	KnowledgeRetrievalReasoningEffort: KnowledgeRetrievalLowReasoningEffort KnowledgeRetrievalMediumReasoningEffort KnowledgeRetrievalMinimalReasoningEffort	Die Konfiguration des Wiederholungs-Denkens.

KnowledgeBaseAzureOpenAIModel

Objekt

Gibt die Azure OpenAI-Ressource an, die für die Abfrageplanung verwendet wird.

Name	Typ	Beschreibung
azureOpenAIParameters	AzureOpenAIVectorizerParameters	Azure OpenAI parameters.
kind	string: azureOpenAI	Das KI-Modell, das für die Abfrageplanung verwendet werden soll.

KnowledgeBaseModelKind

Enumeration

Das KI-Modell, das für die Abfrageplanung verwendet werden soll.

Wert	Beschreibung
azureOpenAI	Verwenden Sie Azure Open AI-Modelle für die Abfrageplanung.

KnowledgeRetrievalLowReasoningEffort

Objekt

Führen Sie das Abrufen von Wissen mit geringem Argumentationsaufwand durch.

Name	Typ	Beschreibung
kind	string: low	Die Art des Argumentationsaufwands.

KnowledgeRetrievalMediumReasoningEffort

Objekt

Führen Sie den Wissensabruf mit mittlerem Argumentationsaufwand durch.

Name	Typ	Beschreibung
kind	string: medium	Die Art des Argumentationsaufwands.

KnowledgeRetrievalMinimalReasoningEffort

Objekt

Führen Sie den Wissensabruf mit minimalem Argumentationsaufwand durch.

Name	Typ	Beschreibung
kind	string: minimal	Die Art des Argumentationsaufwands.

KnowledgeRetrievalOutputMode

Enumeration

Die Ausgabekonfiguration für diesen Abruf.

Wert	Beschreibung
extractiveData	Geben Sie Daten aus den Wissensquellen direkt und ohne generative Änderung zurück.
answerSynthesis	Synthetisieren Sie eine Antwort für die Antwortnutzlast.

KnowledgeRetrievalReasoningEffortKind

Enumeration

Der Aufwand, der beim Abrufen verwendet werden soll.

Wert	Beschreibung
minimal	Führt keine Quellenauswahl, Abfrageplanung oder iterative Suche durch.
low	Verwenden Sie beim Abrufen eine geringe Argumentation.
medium	Verwenden Sie beim Abrufen ein moderates Maß an Argumentation.

KnowledgeSourceReference

Objekt

Verweise auf eine Wissensquelle.

Name	Typ	Beschreibung
name	string	Der Name der Wissensquelle.

ListKnowledgeBasesResult

Objekt

Ergebnis aus der Auflistung von Wissensdatenbanken.

Name	Typ	Beschreibung
value	KnowledgeBase[]	Die Wissensdatenbanken im Dienst.

SearchIndexerDataNoneIdentity

Objekt

Löscht die Identitätseigenschaft einer Datenquelle.

Name	Typ	Beschreibung
@odata.type	string: #Microsoft.Azure.Search.DataNoneIdentity	Ein URI-Fragment, das den Typ der Identität angibt.

SearchIndexerDataUserAssignedIdentity

Objekt

Gibt die Identität für eine zu verwendende Datenquelle an.

Name	Typ	Beschreibung
@odata.type	string: #Microsoft.Azure.Search.DataUserAssignedIdentity	Ein URI-Fragment, das den Typ der Identität angibt.
userAssignedIdentity	string	Die vollqualifizierte Azure-Ressourcen-ID einer benutzerseitig zugewiesenen verwalteten Identität, in der Regel im Format "/subscriptions/12345678-1234-1234-1234-1234567890ab/resourceGroups/rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId", die dem Suchdienst hätte zugewiesen werden sollen.

SearchResourceEncryptionKey

Objekt

Ein vom Kunden verwalteter Verschlüsselungsschlüssel im Azure Key Vault. Schlüssel, die Sie erstellen und verwalten, können zum Verschlüsseln oder Entschlüsseln ruhender Daten verwendet werden, z. B. Indizes und Synonymzuordnungen.

Name	Typ	Beschreibung
accessCredentials.applicationId	string	Eine AAD-Anwendungs-ID, die die erforderlichen Zugriffsberechtigungen für den Azure Key Vault erteilt hat, die beim Verschlüsseln Ihrer ruhenden Daten verwendet werden sollen. Die Anwendungs-ID sollte nicht mit der Objekt-ID für Ihre AAD-Anwendung verwechselt werden.
accessCredentials.applicationSecret	string	Der Authentifizierungsschlüssel der angegebenen AAD-Anwendung.
identity	SearchIndexerDataIdentity: SearchIndexerDataNoneIdentity SearchIndexerDataUserAssignedIdentity	Eine explizite verwaltete Identität, die für diesen Verschlüsselungsschlüssel verwendet werden soll. Wenn diese Eigenschaft nicht angegeben ist und die Eigenschaft für Zugriffsanmeldeinformationen null ist, wird die vom System zugewiesene verwaltete Identität verwendet. Wenn die explizite Identität nicht angegeben ist, bleibt die Aktualisierung der Ressource unverändert. Wenn "none" angegeben wird, wird der Wert dieser Eigenschaft gelöscht.
keyVaultKeyName	string	Der Name Ihres Azure Key Vault-Schlüssels, der zum Verschlüsseln Ihrer ruhenden Daten verwendet werden soll.
keyVaultKeyVersion	string	Die Version Ihres Azure Key Vault-Schlüssels, der zum Verschlüsseln Ihrer ruhenden Daten verwendet werden soll.
keyVaultUri	string	Der URI Ihres Azure Key Vault, auch als DNS-Name bezeichnet, der den Schlüssel enthält, der zum Verschlüsseln Ihrer ruhenden Daten verwendet werden soll. Ein Beispiel-URI kann `https://my-keyvault-name.vault.azure.net`sein.

Freigeben über

Knowledge Bases - List

URI-Parameter

Anforderungsheader

Antworten

Sicherheit

api-key

OAuth2Auth

Bereiche

Beispiele

SearchServiceListKnowledgeBases

Beispielanforderung

Beispiel für eine Antwort

Definitionen

Accept

AzureOpenAIModelName

AzureOpenAIVectorizerParameters

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

KnowledgeBase

KnowledgeBaseAzureOpenAIModel

KnowledgeBaseModelKind

KnowledgeRetrievalLowReasoningEffort

KnowledgeRetrievalMediumReasoningEffort

KnowledgeRetrievalMinimalReasoningEffort

KnowledgeRetrievalOutputMode

KnowledgeRetrievalReasoningEffortKind

KnowledgeSourceReference

ListKnowledgeBasesResult

SearchIndexerDataNoneIdentity

SearchIndexerDataUserAssignedIdentity

SearchResourceEncryptionKey