Give an agent reference material, such as product guides or support policies. Use this sample to verify that the agent retrieves the right facts.
Before you start
Open the agent's project. You need permission to add knowledge and edit the agent.
Add the reference material
In Knowledge, add your document or note. For a first test, use a document titled Sample returns policy with this content:
Unused items can be returned within 30 days of delivery.
The customer needs the order reference and proof of purchase.
Used items are not covered by this policy.
This sample does not specify international shipping charges.Save the knowledge item and confirm it appears in the project. If Studio shows processing or an error, resolve that state before testing retrieval.
Make it available to the agent
In Agents, edit the agent. Under Platform Tools, find Veryfront, select Configure, and enable Search knowledge and Get file. Save the agent form to commit the selection.
Search knowledge finds matching file paths and metadata. Get file reads the document body. The agent needs both to answer from the policy's contents.
Add this instruction to the agent: “Search project knowledge for return questions, read the matching files, and answer from their contents. If the policy doesn't contain the answer, say what information is missing.” Save the agent.
Choose documents
Where Add knowledge → Documents is available on the agent form, choose None, All or Selected. With up to 1,000 documents, Selected shows a tree: tick the folders and documents the agent reads. Select Advanced beside Add knowledge for the same documents in a dialog.
A larger catalog shows its patterns instead, with Edit to change them, or Choose knowledge when nothing is chosen yet. Either opens Select knowledge:
- Documents lists the catalog. Switch between All and Selected, search, and page through it. Tick a document to include it; its menu opens it or excludes it.
- Include and Exclude list the patterns the selection is written in, such as
knowledge/support/**. Edit a pattern in place, add one in the last row, or remove one with its trash button. To clear the selection, remove every pattern.
Exclusions take precedence over matching inclusions. Save writes the selection to the agent form, and Cancel drops it. Save the agent to commit the change.
Verify the answer
In Chat, select the agent and ask: “How long do I have to return an unused item?” Its answer should use the 30-day window.
Then ask: “How much does international return shipping cost?” The reference doesn't specify a price, so the agent should say that information is missing.
If the answer ignores the document, check that you're in the same project, the item is available, and both tools are enabled. Open the response's run and check its events for a knowledge search followed by a file read.
Keep the reference current
When a policy changes, update the knowledge item and repeat the same test questions. Remove or distinguish superseded material so conflicting versions don't become competing sources.
Next
- Add a skill: Define how the agent should apply reference material to a task.
- Debug a run: Investigate missing or unexpected retrieval results.