FAQs
Q: What is “Knowledge” in MagicBlocks?
Knowledge is the information your AI Agent uses to answer questions accurately. It can include website pages, articles, Q&As, PDFs, or documents you upload to MagicBlocks.
Q: How is Knowledge different from the Sales Playbook?
- Knowledge = what your AI knows (facts, details, product info).
- Sales Playbook = how your AI sells (tone, benefits, objection handling, CTAs).
Both work together to make your Agent sound smart and persuasive.
Q: Can I use the same Knowledge for multiple Agents?
Yes. You can reuse the same Knowledge Collections across multiple Agents — saving time and ensuring consistency.
Collections & Organization
Q: What is a “Collection”?
A Collection is like a library or folder that stores related knowledge items — such as a product’s documents, pricing info, or company FAQs.
Q: How can I organize my Collections?
Use clear, descriptive names (e.g., “Mortgage FAQs” or “Pricing Docs”) and add tags to categorize Collections by client, product, or use case.
Q: What’s the difference between “Used” and “Unused” Collections?
Used: Already connected to one or more AI Agents.
Unused: Not yet linked — great for cleanup or review.
Q: How often should I refresh my Collections?
If your Collection includes website URLs, refresh them whenever your site content changes. MagicBlocks will re-crawl and update automatically.
Uploading Knowledge
Q: What file types can I upload?
You can upload PDF, DOC, DOCX, TXT, CSV, or Excel files (max 10MB each).
Q: Can I upload multiple files at once?
Yes. Use the bulk upload option or drag-and-drop multiple files into a Collection.
Q: How does “Q&A Detection” work?
When enabled, MagicBlocks scans your file or website for natural Q&A patterns and automatically structures them as question–answer pairs for better search and response quality.
Q: Can I upload files from Google Drive?
Yes! Connect your Google Drive in Library → Connections → Google Drive, then choose Upload → From Google Drive when adding Knowledge.
Q: What if I upload the wrong file?
You can delete individual Knowledge items or entire Collections anytime. Deleted items are permanently removed from your Agent’s brain.
Using Knowledge in Agents
Q: What’s the difference between Agent-level and Block-level Knowledge?
Agent-level Knowledge: Applies across your entire AI Agent.
Block-level Knowledge: Used only inside a specific Journey block (e.g., Pitch or Objection Handling).
Block-level Knowledge overrides Agent-level data when both are present.
Q: How do I activate a Knowledge Collection for an Agent?
Open your Agent → Go to Brain → Select the Knowledge Collection → Click Activate.
A green brain icon confirms it’s live.
Q: Can I deactivate a Knowledge Collection without deleting it?
Yes. You can set the status to Inactive to temporarily remove it from your AI’s active data.
Missing Knowledge
Q: What is “Missing Knowledge”?
It shows you which questions your AI couldn’t answer or where it gave incomplete responses.
You can review these and add new Q&As or documents to improve accuracy.
Q: How often should I check Missing Knowledge?
Weekly is ideal — especially after new campaigns or major content changes. This keeps your AI learning and improving over time.
Troubleshooting
Q: My AI isn’t using my uploaded Knowledge. What should I do?
Check that the Knowledge Collection is activated.
Make sure your file or URL isn’t in “Inactive” status.
Verify the content is relevant and formatted correctly.
If needed, re-upload and refresh.
Q: Why did my Knowledge import fail?
The file size exceeded 10MB.
The format wasn’t supported.
The link or sitemap was invalid.
The upload timed out — try again or split the content.
Q: Does MagicBlocks automatically update web-based Knowledge?
Yes — just click Refresh to re-crawl any connected website sources.
Quick Tip
The more structured your Knowledge, the better your AI performs.
Use short, clear sentences and consistent formatting in Q&A or article uploads.