Knowledge & memory
Answer from the organisation's documents with citations, and remember what a person or a team has said across conversations.
| Tool | What it does |
|---|---|
search_knowledge | Searches the agent's knowledge collections and returns matching passages, each tagged [chunk:<id>] for citation. |
remember | Saves a durable fact about the person to long-term memory. |
recall | Looks up remembered facts relevant to a question. |
remember_for_workspace | Saves a fact to the workspace's shared memory, visible to every member — team decisions, glossary terms, conventions. |
search_knowledge
Searches the agent's knowledge collections and returns matching passages, each tagged [chunk:<id>] for citation. When nothing matches it says NOT_IN_KNOWLEDGE, so the agent does not guess.
How an agent gets it. Added automatically when the agent names knowledge: collections. Declared with no collections, it reads the knowledge of the workspace the run is in.
- Results respect both workspace visibility and the source system's own permissions — a document you cannot open in Confluence or Drive never comes back to you.
- Citations render in chat as pills with the document's name. See Knowledge & memory.
Arguments
| Argument | Type | Required | Meaning |
|---|---|---|---|
query | string | yes |
remember
Saves a durable fact about the person to long-term memory. Near-duplicates update the existing memory instead of adding a second.
How an agent gets it. Added automatically when the agent's memory: is set (user, agent, user+agent — or owner for an avatar).
- The most relevant memories are placed into later conversations automatically.
- People review and delete their own memories under Settings → Memory.
Arguments
| Argument | Type | Required | Meaning |
|---|---|---|---|
content | string | yes |
recall
Looks up remembered facts relevant to a question.
How an agent gets it. Added automatically when the agent's memory: is set (user, agent, user+agent — or owner for an avatar).
Arguments
| Argument | Type | Required | Meaning |
|---|---|---|---|
query | string | yes |
remember_for_workspace
Saves a fact to the workspace's shared memory, visible to every member — team decisions, glossary terms, conventions. Not for personal preferences.
How an agent gets it. Added automatically on chat and automation runs.
- Works only in a shared workspace the person may write to; elsewhere it refuses.
- A separate tool rather than a flag on
remember, because writing to a shared pool is a different act from remembering for yourself.
Arguments
| Argument | Type | Required | Meaning |
|---|---|---|---|
content | string | yes |