ARMARA Course 05

Course 05 / Module 03

Curate what your agent believes

Store facts in three graph scopes, search across them, and prove that deletion requires exact stored text.

Level
Intermediate
Time
18 minutes
Commands
4
Finish
A scoped graph you can verify

Video / coming soon

The written lesson is complete now.

Reuse the agents directory identifier

These commands use the exact directory name found in Module 5.2. Keep the runtime engine enabled through Module 5.6.

Use PowerShell and quote each fact.
01

Keep graph memory separate from KV

Graph memory stores connected semantic facts from runtime work. KV memory stores exact human-managed values. This sitting uses only the graph.

02

Store three deliberately scoped facts

Run in your terminal
armaraos memory graph-remember <AGENT> "<FACT>" --scope agent_private --confidence 1.0
armaraos memory graph-remember <AGENT> "<FACT>" --scope workspace_shared --confidence 0.9
armaraos memory graph-remember <AGENT> "<FACT>" --scope org_shared --confidence 0.8
Real graph facts stored in private, workspace, and organization scopes
Fresh live output / three real scopes / 24 August 2026
03

Read each scope on its own

Run in your terminal
armaraos memory graph-inspect <AGENT> --scope <SCOPE> --limit 20 --json
ScopeUse it for
agent_privateKnowledge for one agent.
workspace_sharedKnowledge shared in one workspace.
org_sharedKnowledge intended for the wider organization.
04

Search across the graph

Run in your terminal
armaraos memory graph-search <AGENT> "Course 5" --limit 20 --json

The real search returned all three nodes. Inspect is the clearer view when scope matters.

05

Copy the exact fact before forgetting

Search is forgiving enough to find related text. Forget is not: it matches the stored fact text exactly.

06

Delete one fact and prove absence

Run in your terminal
armaraos memory graph-forget <AGENT> "<EXACT_FACT>"
armaraos memory graph-search <AGENT> "<UNIQUE_FRAGMENT>" --json
Real exact graph forget removing one row followed by an empty search
Fresh live output / one row removed / absence verified
07

Recognize a near miss

Real near-miss graph forget removing zero rows while the fact remains
Fresh live output / zero removed / fact preserved

A zero-row response is useful evidence, but re-inspection is still the proof.

Check it / prove all three states

Inspect, search, then verify the deletion.

Confirm the private fact is absent while the workspace and organization facts remain for the backup lesson.

Safety note

Graph forget is permanent and has no dry run or undo. Search for the exact stored string first, then re-inspect after every deletion.

Troubleshooting for this sitting
What you seeLikely causeWhat to do
No such agentThe directory identifier is wrong.Inspect the agents folder again.
Search finds every scopeSearch spans graph payloads.Use inspect for a scoped view.
Forget removes zeroThe text is not exact.Copy it from search output.
Confidence has a long decimalFloating-point representation.Use the rounded inspect value.

Back to Module 5.2

Next / Module 5.4

Back up a brain before you risk it

Lesson ready