KnowledgeBase interface

Defines a knowledge base and its stored retrieval configuration.

Properties

answerInstructions

Instructions considered by the knowledge base when generating answers.

corsOptions

Options to control Cross-Origin Resource Sharing (CORS) for the knowledge base.

description

The description of the knowledge base.

encryptionKey

A description of an encryption key that you create in Azure Key Vault. This key is used to provide an additional level of encryption-at-rest for your knowledge base definition when you want full assurance that no one, not even Microsoft, can decrypt them. Once you have encrypted your knowledge base definition, it will always remain encrypted. The search service will ignore attempts to set this property to null. You can change this property as needed if you want to rotate your encryption key; Your knowledge base definition will be unaffected. Encryption with customer-managed keys is not available for free search services, and is only available for paid services created on or after January 1, 2019.

etag

The ETag of the knowledge base.

knowledgeSources

Knowledge sources referenced by this knowledge base.

models

Contains configuration options on how to connect to AI models.

name

The name of the knowledge base.

outputMode

The output mode for the knowledge base.

retrievalInstructions

Instructions considered by the knowledge base when developing the query plan.

retrievalReasoningEffort

The retrieval reasoning effort configuration applied at retrieval time.

retrieveDefaults

Persisted request-wide retrieve defaults for this knowledge base. These values apply to retrieve requests that omit the corresponding fields; request-time values take precedence when present.

tags

User-defined metadata for organizing the knowledge base. Tags do not control billing attribution or retrieval behavior.

Property Details

answerInstructions

Instructions considered by the knowledge base when generating answers.

answerInstructions?: string

Property Value

string

corsOptions

Options to control Cross-Origin Resource Sharing (CORS) for the knowledge base.

corsOptions?: CorsOptions

Property Value

description

The description of the knowledge base.

description?: string

Property Value

string

encryptionKey

A description of an encryption key that you create in Azure Key Vault. This key is used to provide an additional level of encryption-at-rest for your knowledge base definition when you want full assurance that no one, not even Microsoft, can decrypt them. Once you have encrypted your knowledge base definition, it will always remain encrypted. The search service will ignore attempts to set this property to null. You can change this property as needed if you want to rotate your encryption key; Your knowledge base definition will be unaffected. Encryption with customer-managed keys is not available for free search services, and is only available for paid services created on or after January 1, 2019.

encryptionKey?: SearchResourceEncryptionKey

Property Value

etag

The ETag of the knowledge base.

etag?: string

Property Value

string

knowledgeSources

Knowledge sources referenced by this knowledge base.

knowledgeSources: KnowledgeSourceReference[]

Property Value

models

Contains configuration options on how to connect to AI models.

models?: KnowledgeBaseAzureOpenAIModel[]

Property Value

name

The name of the knowledge base.

name: string

Property Value

string

outputMode

The output mode for the knowledge base.

outputMode?: string

Property Value

string

retrievalInstructions

Instructions considered by the knowledge base when developing the query plan.

retrievalInstructions?: string

Property Value

string

retrievalReasoningEffort

The retrieval reasoning effort configuration applied at retrieval time.

retrievalReasoningEffort?: KnowledgeRetrievalReasoningEffortUnion

Property Value

retrieveDefaults

Persisted request-wide retrieve defaults for this knowledge base. These values apply to retrieve requests that omit the corresponding fields; request-time values take precedence when present.

retrieveDefaults?: KnowledgeBaseRetrieveDefaults

Property Value

tags

User-defined metadata for organizing the knowledge base. Tags do not control billing attribution or retrieval behavior.

tags?: Record<string, string>

Property Value

Record<string, string>