The Tools tab in StoreAgent settings is the place to go when something on the chat side isn’t behaving — products aren’t being referenced, the setup notice keeps reappearing, or AI Memory looks out of sync. This article documents what each tool does, when to use it, and what to avoid. The tools are powerful and a couple of them are destructive, so read each section before clicking.
Opening the Tools page
Go to StoreAgent → Settings → Tools in your WordPress admin. The page is one of the four top-level tabs on the StoreAgent AI Settings screen, alongside AI Content Tools, AI Chat, and Connection.
At the top of the Tools page is a yellow Important callout: “Only use these tools when the chat is not referencing the posts in the chat sessions. These operations can disrupt ongoing chat functionality.” Treat that warning seriously — running either tool during peak chat hours can cause shoppers to see “no answer” responses for a few minutes while the index rebuilds.
Recreate AI Memory
What it does: Deletes your entire AI Memory index on StoreAgent.ai and rebuilds it from scratch using your current store data. Every enabled post type is queued for re-upload from zero.
When to use:
- The chat consistently answers from stale or wrong data even after manual syncs.
- You’ve migrated content or made bulk changes and want a clean rebuild instead of incremental updates.
- The AI Memory column on the products list shows many Failed statuses you can’t recover individually.
To use it:
- Click Recreate AI Memory.
- In the confirmation modal, click Yes, Recreate. The button changes to Recreating… while the request is processed.
- Once the page shows the success notification, the existing index is gone and rebuild has started. Watch progress on the AI Memory column on the products list and the indexing fraction in Settings → AI Chat → Post Types.
Plan for rebuild time. On a small catalog (under 200 products) it’s minutes; on a 5,000-product catalog it can take an hour or more because the rebuild is rate-limited to avoid hammering the StoreAgent.ai service.
Clear Post Data Hashes
What it does: Clears the per-post hash that StoreAgent stores in WordPress meta to detect “has this product changed since the last sync?” Clearing the hashes forces every product to be re-uploaded on the next sync, regardless of whether the content actually changed.
When to use:
- The AI Memory setup notice in WordPress admin keeps reappearing even after you’ve completed setup.
- You suspect the existing hashes are corrupted (e.g. after a botched plugin migration).
- You want the next sync to re-upload everything without recreating the index from scratch.
This tool is lighter than Recreate AI Memory — it doesn’t delete the StoreAgent.ai-side index, it just forces a full re-upload to refresh it. Usually the right starting point for “something looks off, but I’m not sure what.”
To use it:
- Click Clear Post Hashes.
- Confirm in the modal by clicking Yes, Clear Hashes.
- The hashes are wiped immediately. The next time the sync scheduler runs (or you trigger a manual sync), all posts are treated as changed and re-uploaded.
You can also follow this with a manual sync from Settings → AI Chat → Post Types (the sync icon on each post type) to start the re-upload immediately instead of waiting for the scheduler.
Which one should I use?
Start with Clear Post Data Hashes and a follow-up manual sync. It fixes most “index looks off” symptoms with no downtime.
Reach for Recreate AI Memory only when:
- Clear Post Data Hashes didn’t fix the problem.
- Or you need the StoreAgent.ai-side index itself reset (rare — usually only if you’re chasing a support ticket where StoreAgent has asked you to do it).
Don’t run Recreate AI Memory casually. It’s destructive in the sense that the chat is non-functional until the rebuild completes — which on a large catalog is not instant.
Troubleshooting
“Failed to recreate AI memory” error
Confirm StoreAgent is connected to your StoreAgent.ai account at StoreAgent → Settings → Connection. The Recreate tool calls the StoreAgent.ai service — if the connection is broken, the rebuild can’t proceed. If the connection is healthy and the error persists, file a support ticket with your WordPress error log entry.
“Failed to clear post hashes” error
This is rare — clearing hashes is a local database write that doesn’t need StoreAgent.ai connectivity. If you see it, the WordPress database itself is having issues (table locked, disk full, etc.). Check your host’s error logs or contact your host.
The setup notice keeps reappearing
This is the canonical case for Clear Post Data Hashes. Click Clear Post Hashes, then Recreate AI Memory. After the rebuild completes, the notice should disappear and stay gone.
Need help?
If you have a question or run into any issues, we’re here to help.
- Premium users: Open a support ticket
- Free users: Visit our community forum
