- Who can: any member of the brand. Saving or forgetting a fact for the whole account needs the “Manage account knowledge” permission.
- Where in Cargofy: Knowledge bases, “My memory” and “Account memory”
What it is
Memory keeps short facts your team should know: warehouse hours, a consignee’s rules, a carrier’s habits. The assistant saves them from a chat and finds them later by meaning, not by exact words. A fact is personal or for the whole account. Digital Workers use the account’s facts in their runs.
What it can do
A fact from start to finish
A dispatcher’s conversation with the assistant and Cargofy’s real answers. The terms are in the Glossary. The tools behind each step are in the table at the end.
1. Save a fact for yourself
Remember: “Demo: the Lviv warehouse accepts trucks only until 17:00.”
Cargofy answers created with the scope user: the fact is personal. Quote the fact to keep your wording: otherwise the assistant rewrites it as one sentence of its own.
2. Save a fact for the whole account
Save for the whole account: “Demo: the Odesa consignee wants a call one hour before arrival.”
Cargofy answers created with the scope account. Without the “Manage account knowledge” permission, Cargofy refuses and saves nothing.
3. Find it later
When does the Lviv warehouse close?
The assistant gets the matching facts and answers “until 17:00”.
4. Change it
The Lviv warehouse now closes at 19:00. Update what we saved.
The assistant forgets the old fact and saves the new one. To update an account fact, say “for the whole account”.
5. Forget it
Forget what we saved about the Odesa consignee.
The assistant finds the matching facts. When one clearly matches, it forgets that one; when several do, it asks you which. Cargofy answers forgotten: true. The fact no longer shows in searches.
| Step | Tool | What the assistant sends |
|---|---|---|
| 1 | memory-add | fact |
| 2 | memory-add | fact and scope: account |
| 3 | knowledge-search | query and types: fact |
| 4 | memory-forget twice, then memory-add | query to find the old fact, chunk_id of it to forget, then the new fact |
| 5 | memory-forget twice | query to list candidates, then chunk_id of the matching one |
Save a fact
Remember: “Demo: Carrier LLC trucks arrive 30 minutes early.” I’m about 70% sure.
A fact is one sentence. Over MCP it is personal unless you say “for the whole account”. A personal fact shows only in your own searches and in work you start. An account fact is for everyone in the brand and for the Digital Workers.
You can say how sure you are: the confidence goes from 0 to 1, 1 by default.
The same fact saved again is not copied. To change a fact, forget it and save the new wording. A personal fact and an account fact are separate: the same sentence saved in both is two facts.
Find facts
What do we know about the Odesa consignee? Have we saved anything about Demo: Carrier LLC?
Two tools search. knowledge-search can keep only the kinds you name; memory-search always returns all three kinds:
| Kind | What it is |
|---|---|
| Fact | A fact saved by you, your team or a Digital Worker |
| Episode | A summary of your past sessions with Architect (the Studio AI assistant), with its date |
| Digest | A summary of the account’s activity, with its date |
To get only saved facts, the assistant asks knowledge-search for the type fact. A search covers your personal facts and the account’s facts together.
Each result has the kind, the text, the relevance (similarity, 0 to 1), the confidence and seen_at, the last time the fact was saved or saved again. Results come most relevant first. The search returns 8 results by default and 20 at most.
Forget a fact
Forget the fact about Demo: Carrier LLC arriving early.
Forgetting takes two calls. First, memory-forget with your words lists the matching facts, personal and account ones together; nothing is forgotten yet. Then the assistant sends the ID of the fact you mean (it asks when several match), and Cargofy answers forgotten: true.
A forgotten fact leaves every search. Saving the same sentence later creates a new fact.
Only facts can be forgotten. Episodes and digests stay.
Glossary
The words of this page, what they mean in Cargofy and the name the assistant works with. Paste this table into the chat or add it to your assistant’s project knowledge: the assistant then reads your words the same way Cargofy does.
| Term | Meaning | The assistant sees |
|---|---|---|
| Fact | One sentence to remember | fact in memory-add; type fact in search results |
| Personal fact | A fact only you see, in “My memory” | scope: user, the default over MCP |
| Account fact | A fact for everyone in the brand and the Digital Workers, in “Account memory”. Saving or forgetting one needs “Manage account knowledge” | scope: account |
| Confidence | How sure the fact is, 0 to 1 | confidence, 1 by default |
| Created, updated | A new fact, or the same fact saved again with no copy | result: created, updated |
| Fact ID | The ID of one fact, needed to forget it | chunk_id, a UUID from memory-add or the memory-forget candidates |
| Relevance | How close a result is to the query, 0 to 1 | similarity |
| Last seen | When the fact was last saved or saved again | seen_at |
| Episode | A summary of your past sessions with Architect | type episode |
| Digest | A summary of the account’s activity | type digest |
| Kinds of results | What a search may return | types: fact, episode, digest |
| Forget | Removes a fact from every search | memory-forget with query, then chunk_id |
Limits
- A fact cannot be edited. To change it, forget it and save the new wording. To update an account fact, say “for the whole account”.
- The assistant cannot list all saved facts: it sees only the facts that match a search.
- Files in knowledge bases are not searched over MCP.