Guides Knowledge AI Documentation
Administration / Settings

Settings

Each domain has a Settings panel accessible from the domain sidebar. Settings are organized into tabs: Model configuration, Cache control, Chatbot widget, MCP configuration, API keys, and Slack integration. Widget, MCP, and Slack configuration are covered in the Chatbot integrations topics.

Edit the LLM, embedding, and evaluation LLM settings for an existing domain. The form is identical to the one used during domain creation — see the BYOM section in Creating domains for a full description of providers, fields, and behavioral parameters. After making changes, click Validate to re-verify connectivity, then Save.

Guides Knowledge AI includes a semantic cache that stores previous answers and reuses them when a sufficiently similar question is asked. The Cache control tab lets you tune this behavior:

  • Cache cutoff date — only cache entries created after this date are considered. Set this to the date of a major content update to ensure stale answers are not served.
  • Similarity threshold — a value between 0 and 1 representing the minimum cosine similarity required for a cache hit. Higher values require closer matches and reduce false positives; lower values increase cache hit rates but may return less precise answers.

The tab also displays read-only timestamps for the last content indexing, last prompt change, and last model configuration change, so you can decide whether to adjust the cutoff date.

API keys authenticate external integrations (widget, MCP, Slack) and programmatic API calls. Manage them under Settings → API keys.

  1. Click Generate key, enter a label, and confirm. The full secret is displayed only once — copy it immediately.
  2. Keys appear in a list showing the label, masked prefix, creation date, creator, and which integration they are assigned to (widget, MCP, Slack, or unassigned).
  3. Assign a key to an integration from the respective settings tab (e.g. Chatbot widget → API integration, MCP → Configure, or Slack).
  4. To delete a key, click the delete icon and confirm. Deleting a key immediately revokes access for any integration using it.

FAQ

Where do I find a domain’s Settings panel, and what tabs are available?
Each domain has a Settings panel accessible from the domain sidebar. Settings are organized into tabs for Model configuration, Cache control, Chatbot widget, MCP configuration, API keys, and Slack integration. The Widget, MCP, and Slack configuration details are covered in the Chatbot integrations topics.
How do I update a domain’s model configuration settings?
In Settings → Model configuration, edit the LLM, embedding, and evaluation LLM settings for an existing domain. After making changes, click Validate to re-verify connectivity, then click Save. The form matches the one used during domain creation, with providers, fields, and behavioral parameters described in the BYOM section of Creating domains.
What do Cache cutoff date and Similarity threshold do in Cache control?
Cache cutoff date limits cache hits to entries created after the specified date, which you can set to the date of a major content update to avoid serving stale answers. Similarity threshold is a 0–1 value for the minimum cosine similarity required for a cache hit; higher values reduce false positives but lower hit rates, while lower values increase hit rates but may return less precise answers. The tab also shows read-only timestamps for last content indexing, last prompt change, and last model configuration change to help you decide whether to adjust the cutoff date.
How do I generate, assign, and delete API keys for integrations?
Go to Settings → API keys, click Generate key, enter a label, and confirm; the full secret is shown only once, so copy it immediately. Keys are listed with their label, masked prefix, creation date, creator, and assignment (widget, MCP, Slack, or unassigned), and you assign a key from the relevant integration tab (Chatbot widget → API integration, MCP → Configure, or Slack). To delete a key, click the delete icon and confirm; deletion immediately revokes access for any integration using that key.