外掛說明
ApiroSite Assistant adds a configurable chat widget to your WordPress site. It can crawl published pages and posts into a local knowledge base and answer visitor questions locally. An administrator can explicitly enable external AI processing to use OpenAI, Pollinations.AI, or OVHcloud AI Endpoints.
Features:
- Crawl pages and posts into a local knowledge base.
- Add custom facts or Q&A entries manually.
- Train a site summary from the knowledge base.
- Optional OpenAI embeddings for semantic search.
- Optional OpenAI API key with encrypted storage.
- AI modes: Free only, OpenAI with free fallback, or OpenAI only.
- Explicit opt-in before visitor messages or site knowledge are sent to an external AI provider.
- Free online fallback providers when external processing is enabled and no API key is configured or the primary provider fails.
- Configurable widget design, placement, visibility, tone, language, and content rules.
- Response caching with scheduled cleanup.
- Public chat endpoint with IP-based rate limiting.
- Optional attribution control, disabled by default.
Note: Crawled page content is injected into AI context. Only crawl content you trust, because adversarial text in site content can influence model behavior.
External AI processing is disabled by default. When it is enabled, the plugin may send visitor messages, up to ten recent conversation messages, the generated system prompt, and relevant excerpts from the local knowledge base to an external provider. Do not place secrets or sensitive personal data in the knowledge base. Site owners should explain this processing in their privacy policy and obtain any consent required in their jurisdiction.
External Services
The plugin can communicate with the following external services only after an administrator enables external AI processing in AI Chat > AI Configuration.
OpenAI API
Used when an OpenAI API key is configured. The plugin sends visitor messages, recent conversation context, the system prompt, and relevant site-knowledge excerpts to generate chat responses. During training, selected site-knowledge text may also be sent to create summaries and embeddings.
- Service: https://openai.com/
- Business terms: https://openai.com/policies/business-terms/
- Privacy policy: https://openai.com/policies/privacy-policy/
Pollinations.AI
Used as the first free provider in Free only mode and as a fallback in OpenAI with free fallback mode. The plugin sends visitor messages, recent conversation context, the system prompt, and relevant site-knowledge excerpts to generate a response. No Pollinations account is required by this plugin.
- Service: https://pollinations.ai/
- Terms: https://pollinations.ai/terms
- Privacy policy: https://pollinations.ai/privacy
OVHcloud AI Endpoints
Used as the second free fallback if Pollinations.AI is unavailable. The plugin sends visitor messages, recent conversation context, the system prompt, and relevant site-knowledge excerpts to generate a response. No OVHcloud account is required by this plugin for this fallback endpoint.
- Service: https://www.ovhcloud.com/en/public-cloud/ai-endpoints/
- Terms and conditions: https://www.ovhcloud.com/en/terms-and-conditions/
- Privacy policy: https://www.ovhcloud.com/en/terms-and-conditions/privacy-policy/
螢幕擷圖
安裝方式
- Upload the
apirosite-assistantfolder to/wp-content/plugins/. - Activate ApiroSite Assistant from the Plugins screen.
- Open AI Chat > AI Configuration to configure provider behavior.
- Enable external AI processing only if you accept the listed services and data handling, or leave it disabled for local knowledge-base answers.
- Open AI Chat > Knowledge Base and run a crawl.
- Adjust widget design and placement as needed.
常見問題集
-
Do I need an API key?
-
No. The plugin can answer from its local knowledge base without an API key. If you explicitly enable external AI processing, it can use free online fallback providers. For more reliable responses, add an OpenAI API key in AI Chat > AI Configuration.
-
Is the API key exposed to visitors?
-
No. API keys are stored server-side, encrypted at rest where OpenSSL is available, and are never sent to frontend JavaScript.
-
Does it crawl WooCommerce products?
-
No. Product crawling is intentionally excluded.
使用者評論
這個外掛目前沒有任何使用者評論。
參與者及開發者
變更記錄
1.0.1
- Updated plugin branding images and admin accent colors.
1.0.0
- Added explicit opt-in before external AI processing.
- Documented external providers, transmitted data, terms, and privacy policies.
- Added suggested privacy-policy text and updated WordPress compatibility metadata.
1.0.23
- Improved human handoff answers for visitors asking to talk to a real person, admin, owner, or support staff.
1.0.22
- Added Train Site workflow for AI-generated site summary.
- Added OpenAI embedding generation and semantic search retrieval.
- Added embeddings database table and streaming training progress.
1.0.21
- Improved fallback answer voice so local fallback speaks as the site instead of saying “Here is what I found.”
- Tightened fallback confidence checks and filtered job/salary snippets from pricing answers.
1.0.20
- Added explicit AI mode selection.
- Shared OpenAI-compatible provider request helper.
- Added prompt override knowledge placeholder support.
- Added cache normalization and knowledge-version cache invalidation.
- Added token-budgeted knowledge injection and prompt-injection notice.
- Added optional attribution setting.
1.0.19
- Hardened API key handling and admin settings responses.
- Added encrypted OpenAI key storage and masked admin display.
- Moved deterministic knowledge extractors behind AI provider attempts.
- Added provider circuit breaker, reduced HTTP timeouts, fallback testing, and opt-in failure logging.
- Added custom knowledge entries, knowledge caching, large table warning, and cache cleanup cron.
1.0.18
- Improved chat widget opening animation and mobile placement.
1.0.17
- Added optional OpenAI key flow and knowledge text cleanup.