Pointers

What Are Pointers?

Pointers are a training mechanism in Foldspace that create an explicit link between a question or prompt and a specific knowledge base document. They help your Agent understand not just the obvious connections between topics and content, but also the indirect, implicit ones — including internal terminology, product-specific language, and glossary variations.

Think of Pointers as teaching your Agent which document to reach for when a user asks something — even when the phrasing doesn't perfectly match the document's title or content.

Why Pointers Matter

Out of the box, your Agent searches your knowledge base by semantic similarity. That works well for direct questions, but breaks down in two common scenarios:

Implicit connections — The user's question is conceptually related to a document, but the wording doesn't overlap. For example, a user asking "how do I define my audience?" might need to be pointed to a Segments article, even though the word "segments" never appears in their question.
Internal glossary — Your product uses specific terms that users might express differently. Pointers let you bridge that gap explicitly.

By adding Pointers, you're curating the retrieval layer so your Agent responds with the right content — not just the closest match.

Where to Add Pointers

There are two places in Foldspace where you can manage Pointers:

From the Document (Pointers Tab)

When editing any knowledge base document, navigate to the Pointers tab. Here you can add questions that should map to this document. Each question you add trains the Agent to associate that phrasing — or anything semantically similar — with this content.

Use this view when you're building or reviewing a document and want to proactively define how users might ask about it.

From the Agent Conversations

Inside a specific conversation you can click on the right side of the user prompt (The icon is a sliders/filter icon — three horizontal lines with small adjustment handles) and add content and pointers. This area is title Agent Playground where you can link questions directly to documents in a training-oriented interface. You can:

Enter one or more question variants in the Questions panel
Select the relevant knowledge base document in the Documents panel
Create new internal article
Save to train the Agent on that connection

Use this view when you're testing your Agent, discover a gap in its responses, and want to immediately correct it by linking a question to the right document.

Best Practices for Writing Pointers

Cover phrasing variants — Add multiple phrasings of the same question. Users rarely ask things the same way twice.
Include your product's terminology — If your product uses specific terms that aren't industry-standard, add questions that reflect how users describe the same concept in plain language.
Think in use cases, not just keywords — Write questions the way a user would genuinely ask them mid-workflow, not how you'd title a help article.
Prioritize implicit gaps — Pointers are most valuable where your document titles and content don't obviously match the user's intent. Obvious matches usually don't need Pointers.

Example

Document: _Managing User Roles and Permissions in [Your product]

Pointers you might add:

how do I give my teammate admin access?
where can I change what a user can see?
how do I restrict access to certain features?
can I set different permission levels per workspace?

These Pointers ensure that regardless of how a user phrases their intent, the Agent surfaces the right document.