Skip to main content

Value dictionaries

Under AI → Semantic Layer → Value Dictionaries, link multiple surface forms to one canonical value. Existing dictionaries are paginated in groups of 100, so save the current changes before changing pages.

Value dictionary editor showing basic information and the canonical value, display label, and synonym grid

Edit entries and understand the save boundary​

  • Enter the canonical name and display label, then add synonyms.
  • A canonical name must be unique within the dictionary. A duplicate prevents saving.
  • If different canonical values share a synonym, an ambiguity warning appears. Unlike a duplicate canonical-name error, this warning does not prevent saving.
  • Switch between the structured grid and JSON mode. JSON items use the name, label, and synonyms structure.

Existing entries are loaded 100 at a time. While there are unsaved changes, you cannot search, change pages, or save the resource name or description. Select Save current page first.

Preview value linking​

Enter a surface form in the preview to see matching canonical-value candidates. The result shows string linking in the dictionary; it does not reproduce the value an LLM will choose during an actual run. A newly saved or indexed value can take time to appear.

Generate synonyms with AI​

Select Generate synonyms with AI for an entry. You can also select multiple entries without synonyms and generate them in bulk. Review duplicates and ambiguous surface forms before saving the result.

Import raw values​

Analyze a CSV, TSV, TXT, or JSON file, or pasted values, to create a dictionary draft.

  • One file can be up to 5 MB.
  • A single-value list, canonical-value and label pairs, or an already classified structure is detected automatically.
  • A high-cardinality warning appears when there are more than 500 unique canonical values.
  • AI category classification uses a sample of up to 200 canonical values.

Apply values to an existing dictionary​

MethodResult
AddKeep existing entries and add imported entries. For a matching canonical value, select Merge synonyms / Skip.
ReplaceDelete all existing entries and replace them with the imported entries.

For an existing server-paginated dictionary, the preview may compare against the current page, but duplicate policy and Replace apply to the entire dictionary.

Replace applies to the entire dictionary

This does not replace only the 100 entries currently displayed. Continue only after confirming that all existing entries can be discarded.

This differs from importing an asset definition

This procedure edits raw values inside a value dictionary. To move the complete value-dictionary asset as JSON, use Import and export.