Skip to main content

Contact Knowledge

Contact Knowledge helps Nova understand references like "my mom" in a safe, reviewable way.

In simple terms​

Nova stores people-related memory as:

  • aliases (nicknames)
  • facts (key-value)
  • relationships (typed links)

This memory supports resolution. Final execution still uses deterministic checks.

Why review exists​

AI-extracted memory can be wrong. Each item includes source, confidence, and review status so teams can approve/reject before relying on it.

Main APIs​

  • GET /v1/contacts/:id/knowledge
  • POST /v1/contacts/:id/knowledge/aliases
  • POST /v1/contacts/:id/knowledge/facts
  • POST /v1/contacts/:id/knowledge/relationships
  • review/edit/delete endpoints for each type

Backfill for existing data​

Admins can re-run extraction over past messages:

  • POST /v1/admin/reprocessing/contact-knowledge

Contact knowledge vs life graph​

  • Contact knowledge: who a person is to the user
  • Life graph: personal habits, places, preferences