Relationship Suggestions

MythTapestry can optionally analyse your content and suggest new relationships between entities — or detect when existing relationships have changed. This feature is off by default and must be enabled in World Settings.

How it works

When you save content that mentions multiple entities, the AI can:

1. Detect new relationships — “Aldric serves the Crown” suggests a “serves” relationship between Aldric and The Crown
2. Detect ended relationships — “Aldric left the Crown’s service” suggests the “serves” relationship has ended

Each suggestion includes the evidence text — the snippet from your writing that triggered it.

Suggestion types

Type	What it means	Action on confirm
New	A relationship that doesn’t exist yet	Creates the relationship in the knowledge graph
End	An existing relationship that has ended	Sets valid_to on the existing relationship

For “end” suggestions, the system links to the existing relationship it thinks has ended, so you can verify before confirming.

Triggering suggestions

Relationship detection runs when:

• You save a content unit that has confirmed entity mentions
• The feature is enabled in World Settings (enable_relationship_suggestions)
• You have available quota for the feature

Note

The AI uses the relationship types defined in your world to constrain its suggestions. It only suggests relationship types that exist and are valid for the entity type pair involved. This significantly reduces false positives.

Data privacy

What’s sent: The text of the scene being analysed (up to 8,000 characters), the list of confirmed entities mentioned in that scene, any existing relationships between those entities, and the catalogue of relationship types defined in your world (so the AI knows what types are valid).

What’s NOT sent: Your user identity, world ID, session IDs, or any data beyond what’s needed for relationship detection. Only the specific scene text is sent — not your entire content library.

Where it goes: To the AI model provider via OpenRouter, as configured in your model preferences.

Reviewing suggestions

Suggestions appear in the entity’s Relationships tab as pending items. Each suggestion shows:

• The suggested relationship type and direction
• The source and target entities
• A snippet of the text that triggered the suggestion (evidence text)
• The suggestion type (new or end)
• Confirm and Dismiss actions

Confirming a “new” suggestion creates the actual relationship in your knowledge graph. Confirming an “end” suggestion sets a valid_to timestamp on the existing relationship.

Accuracy

The AI is constrained in two ways:

1. Valid types only — it can only suggest relationship types that exist in your world and are valid for the entity type pair
2. Post-processing validation — invalid suggestions (wrong types, impossible pairings) are filtered out before they reach you

However, you should still review each suggestion — context and nuance matter, and the AI may occasionally misinterpret figurative language or ambiguous phrasing.