Skip to content

Seed Your Agent's Memory

Add durable knowledge so your agent starts with the context it needs, then watch it apply that knowledge in conversation.

What You'll Use

FeaturePurpose
MemoryPersistent knowledge that agents draw on automatically
Memory TypesDifferent categories for different kinds of knowledge
ChatTest that the agent retrieves and uses your memories

Step 1: Add a long-term note (formatting guidelines)

Tell the agent how you like summaries written.

  1. Go to Knowledge in the sidebar, open the Memory tab.
  2. Stay on the Knowledge sub-tab (not Journal).
  3. Click New Note (creates a new long-term memory item).
FieldValue
ContentLeadership prefers bullet-point summaries over narrative paragraphs. Keep summaries under 10 bullet points. Lead with the most important item. Use bold for key metrics.

Save when done.

Step 2: Add project facts (second long-term note)

Capture enduring facts about a project the same way.

  1. Click New Note again.
FieldValue
ContentProject Phoenix — internal initiative launched January 2025, led by Sarah Chen (VP Engineering). Goal: migrate analytics from on-prem Hadoop to BigQuery. Status: Phase 2 (data migration). Budget: $1.2M. Target completion: Q3 2025. Key risk: legacy ETL pipelines with undocumented transformations.

INFO

Memory retrieval is semantic, not keyword-based. The agent does not need the exact phrase "Project Phoenix" — asking about "the analytics migration" or "Sarah Chen's project" can still match.

Step 3: Test memory retrieval

  1. Open the Chat panel and select an agent.
  2. Ask:

"Write a status update on the analytics migration project."

The agent should use your long-term notes: bullet-style guidance plus Phoenix details (Sarah Chen, BigQuery, Phase 2, budget).

  1. Now ask something unrelated:

"What's a good framework for running a retrospective?"

The agent should answer without leaning on Phoenix-specific facts — retrieval is relevance-based.

Memory types at a glance

TypeBest forHow it's created
EpisodicWhat happened during a specific run or conversationAutomatic (runs / chat)
Long-termEnduring knowledge (policies, project facts, how you like outputs)Memory view (e.g. New Note, topic docs) or distillation
PreferenceExplicit "how we work" preferences tied to correctionsAutomatic (chat correction flow)
PatternRecurring technical observations (e.g. MCP / API usage)Automatic

You typically seed long-term knowledge manually from the Memory view; episodic, preference, and pattern memories accumulate as you use Pencel.

TIP

After important runs, check the Journal sub-tab under Memory — episodic captures often appear there. Use Extract Learnings on the Memory tab to roll journal content into topic-based long-term knowledge.

Step 4: Maintain your memories

Memories can go stale. Periodically review them:

  • Edit when facts change (e.g. project status).
  • Disable items that are temporarily irrelevant.
  • Delete items that are wrong or obsolete.

Low-confidence memories are still used but ranked lower in retrieval. Adjust confidence as you verify accuracy.

What to try next