Skip to main content

Installing 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, a supervisor that independently chooses the best AI agents it needs to achieve those goals;
  • Docs Agent, the default specialized agent with in-depth knowledge of Witboost documentation;
  • Marketplace Agent, a specialized agent that performs semantic search to find meaningful data products in the Witboost Marketplace based on a natural language query;
  • 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.

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;

Witboost MCP Client (Marketplace Agent) microservice​

In order to install the Witboost MCP Client microservice, you need to enable and configure the witboost-mcp-client module in the Witboost configuration file (values.yaml).

...
witboost-mcp-client:
  enabled: true
  configOverride:
    logger:
      level: <DEBUG | INFO | WARNING |  ERROR>
...

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.