Skip to main content

Install Witty

Witty is installed in the customer environment and interacts with Witboost and several components (database, LLMs, embedders).

Witty is composed of multiple microservices:

  • Witty, the core agent that answers user requests, including marketplace search (via the Witboost MCP Server) and documentation lookup;
  • Docs Agent, the default specialized agent with in-depth knowledge of Witboost documentation;
  • Autocomplete Agent, a microservice that provides intelligent, context-aware autocomplete suggestions for form fields based on table data.

Before going through the prerequisites, make sure to read the requirements. Also, Witty requires you to provide an LLM model and an embedder model. Once Witty's microservices are up, you can configure them at runtime through the Administration Panel, as described in the Configuration chapter.

note

Marketplace search, data product details retrieval and query generation require the Witboost MCP Server to be installed and reachable from Witty.

Witty microservice​

In order to install Witty microservice, you need to enable and configure the witty module in the Witboost configuration file (values.yaml).

...
witty:
  enabled: true
  configOverride:
    logger:
      level: <DEBUG | INFO | WARNING |  ERROR>
...

Docs agent (Witboost Helper) microservice​

In order to install the Docs Agent microservice, you need to enable and configure the docs-agent module in the Witboost configuration file (values.yaml).

...
docs-agent:
  enabled: true
  configOverride:
    logger:
      level: <DEBUG | INFO | WARNING |  ERROR>
...

At startup, docs agent will calculate the embeddings of the Witboost documentation. It will take few minutes. Once done, the server will start.

Docs agent needs the vector extension enabled on the PostgreSQL database used by Witboost. Make sure to enable it before starting the microservice. Witty can create the extension automatically if the connected database user has the required permissions. Alternatively, you can create the extension manually by connecting to the database and running the following SQL command:

CREATE EXTENSION IF NOT EXISTS vector;

Autocomplete agent microservice​

In order to install the Autocomplete Agent, you need to enable the autocomplete-agent module in the Witboost configuration file (values.yaml).

...
autocomplete-agent:
  enabled: true
...

The Autocomplete Agent provides intelligent suggestions for form fields based on table data. No precomputation is required at startup; the service is ready to use immediately after deployment.