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 four 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.
Let's go through each one.
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 plans are monthly at $44, quarterly at $99, and yearly at $288")
Brand voice guidelines ("Keep the tone friendly and conversational, never corporate")
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.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.
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, or training materials. Marblism will extract the text content automatically. You don't need to worry about formatting or file types.
Once uploaded, the extracted content appears as editable text. You can review it, make changes, or delete it at any time.
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 — Update any memory or document and republish it
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. This gives your agents a solid foundation.
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.