Skip to content

Entities and relationships

Entities are the things in your world — people, places, events, groups — and relationships are the typed connections between them. Together they form your world’s graph.

In the portal you browse and read entities and relationships. You create and edit them by connecting an AI tool and describing what you want — see Authoring with AI below.

From a world’s dashboard, select an entity type to see its entities. The list lets you:

  • Search by name to find a specific entity.
  • Sort and paginate (10, 25, 50, or 100 per page) through large worlds.
  • See each entity’s type, slug, and who last edited it and when.

Select an entity to open its detail view.

An entity’s page brings together everything known about it:

  • Properties — the custom fields for its type (a person’s occupation, a place’s address, and so on).
  • Tags — the labels applied to it.
  • Lore — the long-form prose attached to it, shown as titled sections. See Lore.
  • Relationships — every connection to other entities (covered next).

Throughout, you’ll see “last edited” captions showing the date and the collaborator who made the most recent change.

Relationships are directed and typed — “is a member of”, “lives at”, “led to”. On an entity’s page, the relationships table shows:

  • The relationship type and the related entity, which links straight to that entity so you can navigate the graph.
  • A historical marker plus start/end dates when a relationship has ended (for example, someone who used to belong to a group).
  • Who last edited it and when.

You can search and filter the table by relationship type or related entity — useful on entities with many connections.

Creating, editing, and deleting entities, lore, and relationships happens through a connected AI tool, using a read-write key. You describe the change in plain language and the agent makes it; it appears in the portal immediately. For example:

Create a place entity called "Riverside Café", set its category to "coffee shop",
and link it as a spot the person "Maria Santos" frequents.

See How AI integration works for more example prompts and setup.