Guides Knowledge AI
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, 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. Widget, MCP, and Slack configuration 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 the domain. After making changes, click Validate to re-verify connectivity, then click Save. The form matches the one used during domain creation, with provider, field, and behavioral parameter details described in the BYOM section of Creating domains.
How does Cache control work, and what do Cache cutoff date and Similarity threshold do?
Guides Knowledge AI uses a semantic cache that stores previous answers and reuses them when a sufficiently similar question is asked. Cache cutoff date limits cache consideration to entries created after the specified date, which helps avoid serving stale answers after major content updates. Similarity threshold is a 0–1 cosine-similarity minimum for a cache hit: higher values reduce false positives, while lower values increase hit rates but may return less precise answers.
What do the read-only timestamps in Cache control show?
The Cache control tab displays read-only timestamps for the last content indexing, last prompt change, and last model configuration change. These timestamps help you decide whether you should adjust the cache 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 you must copy it immediately. Generated keys appear in a list with the label, masked prefix, creation date, creator, and which integration they’re assigned to (widget, MCP, Slack, or unassigned), and you assign a key from the relevant integration’s settings tab. To delete a key, click the delete icon and confirm; deletion immediately revokes access for any integration using that key.