forget
Removes entities from your knowledge vault. Uses a two-step process to prevent accidental deletion.
Parameters
| Parameter | Type | Required | Description |
|---|
name | string | Yes | Name of the entity to remove |
confirm | boolean | No | Set to true to confirm deletion. Default: false (preview only) |
Two-step process
Step 1: Preview: Call forget without confirm. Returns what will be deleted, including the entity and its relationships.
Step 2: Confirm: Call forget again with confirm: true to actually delete.
This prevents accidental removal of important knowledge.
Example
“Forget the entity called ‘Project Omega’”
The AI calls: forget(name: "Project Omega") → shows preview
“Yes, go ahead and delete it”
The AI calls: forget(name: "Project Omega", confirm: true) → deleted
Deletion is permanent. The entity and its direct relationships are removed from your vault. Other entities that referenced it will retain their own content but lose the connection.
When to use
- Removing test or junk entities
- Cleaning up duplicates (after merging information to the correct entity)
- Deleting entities created from misunderstood conversations
