What is the Brain?
The Brain is the central repository of additional knowledge that you can use to train your Marblism agents.
Anything you add to the Brain becomes available to your agents when they're working. The more relevant knowledge you give them, the better their output will be.
Types of Knowledge
You can add these types of knowledge to the Brain:
Memories: Instructions in your own words
Images: Visual references for style and branding
Web Pages: Content pulled from any URL
Documents: Uploaded files like PDFs, training docs, etc.
Audio and video: Recordings and clips, for example to use in Sonny's videos
Memories
Memories are instructions you write in plain text, things your agents need to remember in order to do their job right.
Examples of good memories:
How to handle a specific type of customer ("Always offer a free consultation to first-time enquiries")
How to respond to objections ("If a customer says we're too expensive, highlight the time savings")
Pricing information ("Our return policy is 30 days, no questions asked")
Brand voice guidelines ("Keep the tone friendly and conversational.")
To add a memory, give it a title and type your content. It's that simple.
Tip: Be specific. The more detail you include, the better your agents will follow your instructions. Write memories the same way you'd brief a new team member on their first day.
Images
Upload images to give your agents a visual reference for the look and style you want. This is especially useful for agents like Sonny (Social Media Manager) who create visual content.
You can upload multiple images at once. Use this for:
Your logo and brand assets
Examples of social media posts you like
Style references for the look and feel you're going for
This section also replaces the media library. Sonny and Penny can also pull assets from the images tab to for use in their social media and blog posts.
Web Pages
You can add any web page by pasting its URL. Marblism will pull in the content from that page and make it available to your agents.
Important: There's a difference between adding a website's homepage and a specific page:
A homepage URL (e.g.
https://yoursite.com) gives your agents only what's visible on the homepage. To bring in the whole website, tick Import all pages from this website (up to 200 pages).A specific page URL (e.g.
https://yoursite.com/about-us) gives your agents all the content on that particular page
When adding a web page, you can choose whether or not to include the images from that page.
Tick Keep it synced and the page is checked every week and updated in your Brain when it changes.
Processing usually takes a few seconds, but can take up to a minute for larger pages. You can navigate away while it processes, it will continue in the background.
Tip: Add your most important pages: your About page, services page, FAQ, and pricing page are great starting points. This helps your agents answer questions about your business accurately.
Documents
Upload files like PDFs, Word documents, spreadsheets or training materials (PDF, DOCX, XLSX, CSV or TXT, up to 25 MB each), or add them from Google Drive or OneDrive. Marblism extracts the text automatically. Only the text is read: charts and images inside a document aren't.
Once uploaded, you see an excerpt of the extracted text, and you can download the original file. The text can't be edited in the Brain: to change it, edit the file and upload it again. A file from Google Drive or OneDrive can be updated with Resync from drive.
Good documents to upload:
Training materials or SOPs for specific tasks
Product catalogues or service descriptions
Brand guidelines or tone of voice documents
FAQ documents or common customer questions
Controlling Which Agents See What
Not every piece of knowledge is relevant to every agent. When you add any type of knowledge, you can choose which agents have access to it.
For example:
A social media training document should only be visible to Sonny
Your pricing information might be relevant to all agents
A cold outreach guide should only go to Stan
You can configure visibility when you first add the knowledge, and change it later at any time.
Managing Your Knowledge
You can manage everything you've added to the Brain from one place:
Edit: Change a memory's text, or rename any entry. When you save a memory, your agents use the new version.
Delete: Remove individual items you no longer need
Bulk delete: Select multiple items and delete them at once
Search: Find specific knowledge by file name or title
Your knowledge is organised by type (Memories, Images, Web Pages, Documents) so it's easy to find what you're looking for.
Best Practices
Start with the basics. Add your pricing, services, and brand voice as memories. Upload your key web pages.
Be specific with memories. "Handle complaints politely" is vague. "When a customer complains about delivery times, apologise, offer a 10% discount, and escalate to me if they're still unhappy" is actionable.
Keep it current. If your pricing changes or you update your services, update the Brain too. Your agents will only know what you've told them.
Use visibility settings. Don't overload agents with irrelevant information. Give each agent only what they need to do their job well.
Review and refine. If an agent isn't getting something right, check the Brain first. Adding or updating a memory is often the quickest fix.
If you have any questions, reach out to our support team. We're always happy to help.