Welcome back to the MiocAI documentation series. In our previous guide, we introduced you to the encyclopedia of your universe: the Lorebook System. We taught you how to store vast amounts of worldbuilding data and summon it into your character's brain using keywords.

But let's be honest. If you are building a massive, sprawling fantasy universe with 200 different locations, factions, and history entries, manually typing out primary and secondary keywords for every single one is a nightmare. Furthermore, what happens if your character talks about an "ancient oxidized blade," but your keyword was set to rusty sword? Your entry never triggers, the AI forgets the lore, and the illusion breaks.

Enter our newest Beta feature: Smart Matching.

In this guide, we are going to break down what Smart Matching is, how it fundamentally changes your worldbuilding workflow, and when you should use it instead of the traditional keyword system.

---

1) Keywords vs. Concepts

To understand why Smart Matching is a game-changer, we have to look at the flaw of the traditional method.

The Old Way: Exact Keywords

Standard lorebooks are literal. They are like a search engine from the 1990s. If you have a lorebook entry about a haunted forest and your trigger keyword is Darkwoods, the AI will only pull that entry if you or the bot specifically type the word "Darkwoods."

If you say, "Let's go into that creepy, shadowy tree line," the system sees no keyword. It grabs nothing. The bot wanders in blind.

The New Way: Smart Matching

Smart Matching doesn't look for exact words; it looks for meaning.

When you enable Smart Matching on a Lorebook, our system uses an advanced backend model to actually read your recent chat messages (specifically, the last few things you and the bot just said). It understands the context, the tone, and the subjects being discussed. Then, it quietly scans your entire Lorebook and pulls out the entries that are conceptually relevant to the current scene.

If you say, "I draw my weapon and prepare to cast a fireball," Smart Matching understands the concept of combat and magic. It might automatically pull your lorebook entries for "Fire Magic Rules" and "Standard Combat Tactics," even if you never explicitly typed those words!

---

2) The Simplified Interface

When you open a Lorebook's Overview tab and toggle Smart Matching on, you will immediately notice something happen to the Entries tab: Half the settings disappear.

This is by design.

Because the AI is handling the heavy lifting of figuring out when an entry is relevant, you no longer need to micromanage it. * No more Primary Keywords. * No more Secondary Keywords. * No more Selective Logic (and_any, not_all). * No more Case Sensitivity or Regex toggles. * No more Inclusion Groups or complex scoring weights.

What You Actually Need to Write

With Smart Matching enabled, creating an entry becomes blissfully simple. You only need two things:

1. A Descriptive Title: The system uses the title heavily to figure out what the entry is about. "The Kingdom of Eldoria" or "Rules of Blood Magic."
2. The Content: The actual lore you want to inject into the AI's brain.

That's it. You write the lore, and the system handles the rest automatically.

---

3) Under the Hood: How It Triggers

While we won't bore you with the linear algebra and vector math making this possible, it helps to understand the basic rhythm of how Smart Matching decides what to include.

• The 3-Message Window: The system primarily looks at the last 3 messages sent in the chat. It uses this recent context to figure out what the current scene is about.
• The Token Budget: Just like standard Lorebooks, Smart Matching respects your Token Budget. Even if 50 entries match the "vibe" of your current scene, the system will only inject the most highly relevant ones until it hits your set budget, preventing the AI from getting bogged down.
• No Delays or Cooldowns: Because Smart Matching is contextual, it fluidly brings entries in and out of the AI's memory as the conversation shifts. You don't need to manually tell it to "cool down" for 10 messages. When the topic changes, the old entries are automatically dropped in favor of new ones.

---

4) When to Use Which?

Because Smart Matching is a toggle per Lorebook, you don't have to choose just one method for your entire chat. You can attach multiple Lorebooks to a single conversation!

Here is the golden rule for organizing your world:

Use Smart Matching for:

• Broad World Lore: History, political climates, and cultural norms.
• Atmosphere & Locations: Descriptions of cities, taverns, or landscapes that the AI should casually reference when the scene shifts.
• Massive Encyclopedias: If you are importing a massive 300-entry world, turn on Smart Matching. Do not waste your weekend writing 1,500 keywords.

Use Classic Keywords for:

• Hard Mechanics: If you have an RPG system where typing [Inventory] must ALWAYS pull up the item list, use keywords.
• Specific Spells or Items: If an item only matters when its exact name is invoked, keywords prevent it from accidentally bleeding into unrelated scenes.
• Strict Narrative Triggers: If you want an entry to trigger only when a highly specific event occurs (e.g., using Regex to trigger an entry only when the word "dies" is used).

Go get em tiger!