Poimen Ingest Request Lifecycle

Poimen Ingest Request Lifecycle A sequence diagram generated by Archify. POST /memory/ingest enqueue job 202 pending poll job episode records extract entities JSON entities extract facts (entity pairs) JSON edges INSERT memory_entity INSERT memory_edge store embeddings mark done Ingest Extraction Persist AI Agent · client · Sequence participant AI Agent client Memory API · actix-web · Sequence participant Memory API actix-web Queue · ingest jobs · Sequence participant Queue ingest jobs Worker · pipeline · Sequence participant Worker pipeline LLM · Ollama · Sequence participant LLM Ollama pgvector · postgres · Sequence participant pgvector postgres Legend request return async trace default message

Async Ingest

  • • Agent gets 202 immediately, no blocking
  • • Worker polls jobs from queue independently
  • • Decoupled ingest from extraction latency

LLM Extraction

  • • First call: extract named entities with types
  • • Second call: extract relationships between entity pairs
  • • JSON response cleaned of thinking tags and fences

Persistence

  • • Entities saved with type, summary, confidence
  • • Edges saved with temporal fields (t_valid, t_invalid)
  • • Embeddings stored for vector similarity search