Interface: SearchPluginConfig
The AI Search plugin’s slice of AppKit config. Every field is optional - the plugin works with nothing but an index name in the environment.
Extends
Section titled “Extends”BasePluginConfig
Indexable
Section titled “Indexable”[
key:string]:unknown
Properties
Section titled “Properties”allowWrite?
Section titled “allowWrite?”
optionalallowWrite?:boolean
Enable the write surface (add_documents tool + POST /documents). Off by default.
columns?
Section titled “columns?”
optionalcolumns?:string[]
Default columns to return per hit. Falls back to each index’s own columns.
embeddingModel?
Section titled “embeddingModel?”
optionalembeddingModel?:string
Embedding model endpoint used when the plugin CREATES a Delta Sync index. Fuzzy-resolved.
endpoint?
Section titled “endpoint?”
optionalendpoint?:string
The Vector Search serving endpoint indexes live on (only needed to create an index).
ensureOnSetup?
Section titled “ensureOnSetup?”
optionalensureOnSetup?:EnsureOnSetupConfig
Provision a REAL index at boot: ensure the endpoint + index exist and seed
documents when the index is empty. Runs in the background during setup()
(a slow first-time endpoint/index build never blocks the server) using the
boot-time SDK auth (env / config profile). Idempotent - safe every boot.
The default is a MANAGED direct-access index (Databricks embeds the text
column), so documents are plain rows and search-by-text works with no
Delta table, no warehouse, and no vectors to compute. Point it at a
sourceTable to provision a Delta Sync index instead.
optionalhost?:string
Inherited from
Section titled “Inherited from”BasePluginConfig.host
index?
Section titled “index?”
optionalindex?:string
The default index searched when a request omits one (name or alias).
indexes?
Section titled “indexes?”
optionalindexes?: (string|SearchIndexConfig)[]
Indexes the plugin should know about (for aliases, universal search, and the UI catalogue).
optionalmode?:"hybrid"|"vector"|"keyword"
Default match mode.
optionalname?:string
Inherited from
Section titled “Inherited from”BasePluginConfig.name
pageSize?
Section titled “pageSize?”
optionalpageSize?:number
Default number of hits a search returns.
telemetry?
Section titled “telemetry?”
optionaltelemetry?:TelemetryOptions
Inherited from
Section titled “Inherited from”BasePluginConfig.telemetry
timeoutMs?
Section titled “timeoutMs?”
optionaltimeoutMs?:number
Per-call timeout in milliseconds.