talemate/docs/user-guide/agents/editor/settings.md

4 KiB

Settings

General

Editor agent settings

Fix exposition

If enabled the editor will attempt to fix exposition in the generated dialogue.

It will do this based on the selected format.

Fix narrator messages

Applies the same rules as above to the narrator messages.

Fix user input

Applies the same rules as above to the user input messages.

Add detail

Will take the generate message and attempt to add more detail to it.

Long Term Memory

--8<-- "docs/snippets/tips.md:agent_long_term_memory_settings"

Revision

Editor agent revision settings

When :material-typewriter: revision is enabled the editor will analyze and attempt to fix character and narrator messages.

Currently it can detect the following issues:

  • Repetition of phrases / concepts
  • Unwanted prose as defined in the writing style

The revision action is split into three parts:

  • Find any issues through fuzzy, regex and semantic similarity (embeddings) matching
  • Analyze the issues and plan a fix
  • Apply the fix

This means it comes at a noticable delay IF it finds issues, but the improvements may be worth it.

Enable Revision

Check this to enable revision.

Automatic Revision

Check this to enable automatic revision - this will analyze each incoming actor or narrator message and attempt to fix it if there are issues.

Revision Method

Which method to use to fix issues.

  • Dedupe (Fast and dumb) - this is the default
  • Rewrite (AI assisted, slower and less dumb, probably)

When Dedupe is active it will be restricting to find repetition and remove it without replacing it with something else, nor understanding the intent or context, so it may sometimes cause disjointed dialogue. This method is much faster as it will never prompt the AI for analysis and fixes.

When Rewrite is active, unwanted prose detection will become available and when issues are detected the AI will attempt to rewrite the message to fix the issues.

Repetition

Repetition Detection Method

How is repetition detected.

  • Fuzzy - fuzzy matching will match based on character-level similarity, finding text that is approximately the same with small differences (like typos, missing letters, or minor variations). This is faster but less context-aware than semantic matching.
  • Semantic Similarity - will match based on the semantic meaning of the text using the Memory Agent's embedding function. (default)

!!! warning "Semantic Similarity" Uses the memory agent's embedding function to compare the text. Will use batching when available, but has the potential to do A LOT of calls to the embedding model.

Similarity Threshold

How similar does the text need to be to be considered repetitive. (50 - 100%)

You want to keep this relatively high.

Repetition Range

This is the number of MESSAGES to consider in the history when checking for repetition.

At its default ot 15 it means the last 15 messages will be considered.

Repetition Min. Length

The minimum length of a phrase (in characters) to be considered for repetition. Shorter phrases will be ignored.

Rewrite Mode

Once switched to rewrite mode some extra settings will become available.

Editor agent revision settings

Preferences for Rewriting

Test parts of setences, split on commas

If active this means that when a sentence doen't produce a hit, if it has one or more commas it will split the sentence on the commas and test each part individually.

Minimum issues

The minimum amount of issues that need to be detected to trigger a rewrite.

Unwanted Prose

Detect Unwanted Prose

Check this to enable unwanted prose detection.

--8<-- "docs/snippets/common.md:editor-revision-unwanted-propse-requirement"

Unwanted Prose Threshold

Similarity threshold for unwanted prose detection. (0.4 - 1.0)

You want to keep this relatively high.