Agent001 - Support Assistant for WooCommerce
| 开发者 | agent001ai |
|---|---|
| 更新时间 | 2026年5月14日 00:25 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 6.9 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
- Sends a snapshot of your products (title, description, price, stock, SKU, categories, variations) to agent001 so the assistant can answer product questions.
- Re-syncs automatically whenever a product is created, updated or deleted, so the assistant always sees the current catalog. Per-product updates are queued through Action Scheduler and processed in the background.
- Adds the agent001 chat widget to your storefront (a single <script> tag in the footer) once you select an agent in the settings.
- Exposes a privacy-protected REST endpoint at
/wp-json/agent001/v1/orders/{number}that the chat widget calls from the visitor's browser to look up an order. The endpoint requires a matching customer email, so it cannot be enumerated.
wc_get_order, wc_get_products) to read existing data and forward it to agent001. Order data is read on demand only when a chat user asks about a specific order with the matching email.
Features
- One-click Connect / Disconnect — no manual API key copy-paste.
- Pick which agent in your agent001 account this store feeds (drop-down in the settings).
- Optional category filter — sync only products from the categories you choose.
- Realtime per-product sync on create / update / delete via Action Scheduler.
- Manual "Sync now" button for bulk imports or to recover from a failed event.
- Last sync status and error messages visible in the admin.
- Order status lookup — the chat widget asks the visitor for their order number and email, then queries the store directly via the REST endpoint (browser → store, never our backend → store), so it works behind Cloudflare or any other WAF without configuration.
- Fully removable — uninstall cleans up every option, transient, and scheduled action created by the plugin.
安装:
- Upload the
agent001folder to/wp-content/plugins/(or install via the WordPress admin uploader). - Activate the plugin through the Plugins menu.
- Go to WooCommerce → Settings → Support Assistant and click Connect. You are redirected to agent001 to authorise — no API keys to copy.
- After the redirect back, pick which agent should receive product data from this store and click Save changes.
- The chat widget will appear on your storefront and product changes will sync automatically. Use the Sync now button to push the full catalog after a bulk import.
屏幕截图:
常见问题:
Is WooCommerce required?
Yes. The plugin refuses to boot without WooCommerce active and shows an admin notice instead. It is built around WooCommerce data (products, taxonomies, orders) and has nothing useful to do on a plain WordPress install.
How does sync stay in sync without a recurring schedule?
Every product create, update or delete event in WooCommerce queues a single per-product sync through Action Scheduler. The job runs in the background on the next request after each change, so the catalog on agent001 mirrors your store within seconds. Use Sync now for bulk imports or to recover from a failed background job.
How does order lookup work without a server-to-server call from agent001?
The chat widget runs in the visitor's browser and calls your store's REST endpoint directly. From the store's point of view it's just another browser request from the same visitor that loaded the widget — Cloudflare and other WAFs let it through without any allowlist. The agent001 backend never touches your store directly.
What stops someone from enumerating orders by guessing numbers?
The lookup endpoint requires both the order number AND the email used at checkout, and returns 404 if either is missing or doesn't match. Plus a per-IP rate limit (10 requests / minute) makes brute-force impractical.
Can I hard-code the API key in wp-config.php instead of storing it in the database?
Yes. Define AGENT001_API_KEY in wp-config.php (e.g. define( 'AGENT001_API_KEY', 'your-key-here' );) and the plugin will read the key from that constant instead of from the database. Connect / Disconnect / Reconnect buttons in the admin become disabled in this mode (the key is read-only). This is the recommended setup for staging environments where you want the key out of the database backup.
Can I uninstall cleanly?
Yes. Uninstall removes every option (agent001_settings, agent001_last_sync_result, agent001_sync_progress), every transient (agent001_last_sync_status, agent001_sync_running, agent001_agents_cache, plus the connect-state, rate-limiter and kick-throttle transients prefixed with agent001_), and unschedules any pending agent001_sync_product jobs in Action Scheduler. Nothing is left behind.
更新日志:
- Initial release.