WordPress.org

Taiwan 正體中文

取得 WordPress
WordPress.org

Plugin Directory

OZY AI Agent

OZY AI Agent

由 Danish Rangaiz 開發
下載

外掛說明

OZY AI Agent (formerly OZY Chat Assistant) puts a smart AI agent and chatbot on your WordPress site. It automatically reads your pages, posts, products, and menus — then behaves as the dedicated AI agent for your business. Visitors get accurate, context-aware answers about your services without you lifting a finger.

Drop it anywhere with a drag-and-drop block for Gutenberg, Elementor, Divi, Avada and WPBakery, keep the floating chat widget in the corner, or do both.

Why OZY AI Agent is different

Most AI chat plugins require expensive SaaS subscriptions or are locked to one AI provider. OZY AI Agent:

  • Learns your website automatically — scans your WordPress content and uses it to answer visitor questions accurately
  • Supports 5 AI providers — OpenAI, Claude, Groq, Gemini, Mistral — with configurable priority and automatic fallback
  • Model IDs are free text — when a provider ships a new model, type its ID and use it the same day; no plugin update needed
  • Free tiers available — Groq, Gemini, and Mistral all offer free API keys
  • Drag and drop anywhere — a native element for Gutenberg, Elementor, Divi, Avada (Fusion), WPBakery, and classic widget areas
  • Everything from the dashboard — colours, agent identity, placement, limits and analytics, no code required

Core Features

  • Multi-provider AI — OpenAI, Claude, Groq, Gemini and Mistral, each with its own editable model ID
  • Configurable priority — choose which provider is tried first and in what fallback order
  • Connection tester — verify any API key from the dashboard and see the provider’s own error message if it fails
  • Website content reader — indexes your WordPress pages, posts, products, and menus, and lists exactly what was indexed
  • Business knowledge base — add custom descriptions, services, FAQs, and policies
  • Analytics dashboard — conversation totals, daily and monthly counts, average response time, success rate, provider usage and most-asked questions
  • Rate limiting — per-visitor requests per minute plus optional daily and monthly caps for the whole site
  • Three placement modes — inline chat panel, a button that opens the popup, or a loader for the floating widget
  • Page builder elements — Gutenberg block, Elementor widget, Divi module, Fusion/Avada element, WPBakery element, classic sidebar widget
  • Full colour control — accent, panel background, text, visitor bubble and launcher colours, plus corner radius and screen offsets, with a live preview
  • Light and dark base themes
  • Agent icon uploader — pick an image from the media library, or leave it blank for the animated OZY orbit icon
  • Quick questions — tappable suggestion chips shown before the first message
  • Streaming responses — words appear in real time
  • Voice input — Groq Whisper transcribes voice messages
  • Text-to-speech — the agent reads replies aloud after voice input
  • Floating launcher + popup modal — each independently togglable, with an optional launcher label
  • Time-aware greeting — greets visitors based on their local time
  • Re-engagement — prompts idle visitors after 50 seconds
  • Chat history — persists the last 30 messages across page loads
  • Lightweight — no jQuery dependency on the front end, vanilla JS, minimal CSS

Setup in 5 Minutes

  1. Install and activate the plugin
  2. Go to OZY AI Agent AI Provider and add at least one API key (Groq is free and recommended), plus the model ID you want
  3. Describe your business in AI Agent
  4. Run the scan in URL Index
  5. Pick your colours and placement in Widget Settings

Free API Keys

  • Groq — https://console.groq.com (free, fast, recommended)
  • Gemini — https://aistudio.google.com (free tier)
  • Mistral — https://console.mistral.ai (free tier)
  • OpenAI — https://platform.openai.com/api-keys (paid)
  • Claude — https://console.anthropic.com (paid)

Placing the agent

Search for OZY AI Agent in Gutenberg, Elementor, Divi, Avada/Fusion, WPBakery, or the Widgets screen. Every element offers the same three modes and renders identical markup, so the design matches everywhere.

Shortcode

[oozzy_ai_agent] — inline chat panel
[oozzy_ai_agent mode="button" label="Chat with us"] — button that opens the popup
[oozzy_ai_agent mode="loader"] — load the floating widget on this page only

Attributes: mode, height, title, label, quick (questions separated by |).

Or enable Load on every page in Widget Settings to show the floating launcher site-wide without a shortcode.

External Services

This plugin connects to third-party AI services to generate chat responses. The plugin only contacts a provider if you have entered an API key for that provider in OZY AI Agent AI Provider. No data is sent to any provider whose key is empty.

What is sent: the visitor’s chat message text, the prior conversation (up to the last 20 messages from the same browser session), and a system prompt containing your configured business info and a snapshot of public WordPress content (page/post titles and excerpts) you have configured the plugin to read.

When is it sent: every time a visitor submits a message in the chat widget on your site.

Providers used (only the ones with configured API keys are called):

  • Groq — https://groq.com/ — terms: https://groq.com/terms-of-use/ — privacy: https://groq.com/privacy-policy/
  • Google Gemini — https://ai.google.dev/ — terms: https://ai.google.dev/gemini-api/terms — privacy: https://policies.google.com/privacy
  • Mistral AI — https://mistral.ai/ — terms: https://legal.mistral.ai/terms — privacy: https://legal.mistral.ai/terms/privacy-policy
  • OpenAI — https://openai.com/ — terms: https://openai.com/policies/terms-of-use/ — privacy: https://openai.com/policies/privacy-policy/
  • Anthropic (Claude) — https://www.anthropic.com/ — terms: https://www.anthropic.com/legal/consumer-terms — privacy: https://www.anthropic.com/legal/privacy

Voice transcription (only if the visitor uses the microphone button and a Groq API key is configured): the audio recording is sent directly to the Groq Whisper API endpoint (https://api.groq.com/openai/v1/audio/transcriptions) over an HTTP request. The audio is not stored on your WordPress server.

Full chat history is kept only in the visitor’s own browser via localStorage and is cleared when the visitor clears their browser data. Nothing is sent to the plugin author or to any OZY server.

Local analytics (optional, on by default): the plugin records one row per chat request in a table in your own WordPress database — timestamp, the provider and model that answered, the response time, whether it succeeded, and the visitor’s last message truncated to 300 characters. This data never leaves your server, is capped at the most recent 1,000 rows, can be deleted at any time from Analytics Delete all analytics data, and can be switched off entirely under URL Index Record conversation analytics. Uninstalling the plugin drops the table.

Site owners are responsible for disclosing this third-party data processing to their visitors in their site’s privacy policy.

螢幕擷圖

Dashboard — setup progress, live conversation stats and a preview of the widget.
Dashboard — setup progress, live conversation stats and a preview of the widget.
AI Provider — API keys, editable model IDs, connection testing and fallback order.
AI Provider — API keys, editable model IDs, connection testing and fallback order.
Widget Settings — colour presets, every colour editable, with a live preview.
Widget Settings — colour presets, every colour editable, with a live preview.
Analytics — daily volume, provider usage, response times and most-asked questions.
Analytics — daily volume, provider usage, response times and most-asked questions.

適用於區塊編輯器

這個外掛提供 1 個可供區塊編輯器使用的區塊。

  • OZY AI Agent

安裝方式

  1. Upload the ozy-chat-assistant folder to /wp-content/plugins/
  2. Activate the plugin through Plugins Installed Plugins
  3. Configure at OZY AI Agent in the admin sidebar

常見問題集

The plugin used to be called OZY Chat Assistant — is this the same plugin?

Yes. Version 3.0.0 renamed it to OZY AI Agent. The directory URL and folder name stay ozy-chat-assistant because WordPress.org slugs are permanent, so updates arrive normally and your settings carry over untouched.

Which page builders are supported?

Gutenberg, Elementor, Divi, Avada (Fusion Builder), WPBakery, and classic widget areas each get a native OZY AI Agent element. They all render the same markup, so the design is identical no matter where you drop it. Any other builder can use the shortcode.

What is the difference between the inline chat and the popup?

The inline mode embeds a full chat panel directly in the page flow, so visitors talk to the agent right there without anything opening over the content. The popup and floating launcher are separate and keep working as before.

My provider released a new model. Do I have to wait for a plugin update?

No. Model IDs are plain text fields. Copy the new ID from your provider’s model list and paste it in — it works immediately.

Do I need all five API keys?

No. You only need one working API key. The agent tries them in your configured priority order and falls back automatically if one fails. Groq is the recommended starting point — it’s free and fast.

Will it conflict with my theme or other plugins?

The widget uses fixed positioning and scoped CSS custom properties. It does not inject styles into the page flow. Conflicts are very rare.

Can I use it on a client’s website?

Yes. Each installation is independent. Configure the business info, agent name, and contact details for each site separately.

Does streaming work on shared hosting?

Streaming requires ob_flush() / flush() support. This works on most hosts. If streaming fails, the widget automatically falls back to non-streaming mode.

How does the website reader work?

The plugin reads your WordPress pages, posts, WooCommerce products, custom post types, and navigation menus using built-in WordPress functions — no external HTTP requests. The content is cached (default: 6 hours) and injected into the AI’s system prompt.

Who built this plugin?

Built and maintained by idanishrangaiz. See the plugin author link in your WordPress plugins page for support and contact details.

使用者評論

這個外掛目前沒有任何使用者評論。

參與者及開發者

以下人員參與了開源軟體〈OZY AI Agent〉的開發相關工作。

參與者

將〈OZY AI Agent〉外掛本地化為台灣繁體中文版

對開發相關資訊感興趣？

任何人均可瀏覽程式碼、查看 SVN 存放庫，或透過 RSS 訂閱開發記錄。

變更記錄

3.0.1

  • Fixed: the microphone and send buttons could pick up the active theme’s button hover colours (Elementor and similar). Their colours are now painted from the plugin’s own variables in every state.

3.0.0

  • Renamed: the plugin is now OZY AI Agent. The directory slug, folder name and text domain remain ozy-chat-assistant, so this is a normal update and all settings are preserved.
  • Added: drag-and-drop elements for Gutenberg, Elementor, Divi, Avada (Fusion Builder), WPBakery and classic widget areas — all rendering identical markup.
  • Added: inline chat mode. The agent can now be embedded directly in the page flow instead of only opening as a popup; the popup and floating launcher are unchanged and still independent.
  • Added: mode, height, title, label and quick attributes on the [oozzy_ai_agent] shortcode.
  • Changed: model selection is now a free-text field for every provider instead of a fixed dropdown, so new model releases work without waiting for a plugin update. Keys and model IDs sit together on one screen.
  • Added: multi-screen dashboard — Dashboard, AI Provider, AI Agent, Widget Settings, URL Index, Analytics and Help & Setup — with a redesigned interface and a new sidebar icon.
  • Added: Analytics screen with total, daily and monthly conversation counts, average response time, success rate, per-provider usage, a 14-day chart, most-asked questions and recent conversations. All data is stored locally and can be deleted or switched off.
  • Added: connection tester for each provider that surfaces the provider’s own error message.
  • Added: rate limiting controls — requests per minute per visitor, plus optional daily and monthly caps for the whole site.
  • Added: media-library uploader for the agent icon, replacing the URL-only field (pasting a URL still works).
  • Added: full colour control — accent, panel background, text, visitor bubble and launcher colours, corner radius, screen offsets, light/dark base theme and six presets, with a live preview that updates as you edit.
  • Added: URL Index screen listing exactly what was indexed, with per-entry source links and character counts.
  • Added: quick-question chips, a custom welcome message, an agent role subtitle, an optional launcher label, and a hide-on-mobile option.
  • Added: max reply length and creativity controls.
  • Improved: streaming now reports which provider answered, and failed requests surface the provider’s HTTP error in the log.
  • Improved: the front-end widget markup and stylesheet were rebuilt so the panel, popup and inline embed share one design system.
  • Removed: the automatic visibility “repair” routine, which prevented administrators from turning every display mode off on purpose.

2.0.8

  • Fixed: the “Powered by OZY” credit no longer appears on the front-end chat widget by default. As required by the WordPress.org plugin guidelines, attribution on user-facing interfaces is now strictly opt-in.
  • Added: a “Show ‘Powered by OZY’ Credit” toggle (off by default) in the Appearance tab. Site administrators must intentionally enable it for the credit to display.

2.0.7

  • Changed: renamed the plugin to “OZY Chat Assistant” with the slug ozy-chat-assistant; the text domain now matches the slug.
  • Changed: replaced all short ozy/OZY_ code prefixes with the unique oozzy/OOZZY_ prefix on functions, classes, options, transients, nonces, AJAX actions, and the shortcode (now [oozzy_ai_agent]).
  • Changed: all upstream AI and voice requests now use the WordPress HTTP API (wp_remote_post()) exclusively; removed all direct cURL calls.
  • Changed: voice transcription now uploads audio via a multipart HTTP request instead of writing a temporary file to disk.
  • Removed: load_plugin_textdomain() call — WordPress.org loads translations automatically since WP 4.6.
  • Fixed: corrected the Mistral terms/privacy URLs to the working Legal Center links.

2.0.5

  • Fixed: replaced direct <style> tag output with wp_add_inline_style() for the accent color CSS variables, as required by WordPress.org guidelines.
  • Fixed: updated Contributors field to correct WordPress.org username idanishrangaiz.
  • Fixed: updated broken Mistral terms/privacy URLs in readme.txt.

2.0.4

  • Fixed: replaced heredoc (<<<EOT) string syntax in the system-prompt builder with standard string concatenation, to satisfy the WordPress.org Plugin Check (PluginCheck.CodeAnalysis.Heredoc.NotAllowed).
  • Fixed: bumped “Tested up to” header to 7.0 to match the current WordPress release (“Armstrong”).
  • Fixed: added the missing languages/ directory (with a ozy-chat-assistant.pot translation template) so the Domain Path: /languages header in the plugin file now resolves to an existing folder.

2.0.3

  • Removed: developer-promotion text that was injected into the AI system prompt. The AI no longer mentions the plugin author to your visitors.
  • Removed: “Allow External Suggestions” setting (no longer needed). Setting default changed to off for any existing installs.
  • Changed: chat widget footer simplified to “Powered by OZY” (brand only, no link, no full plugin name).
  • Removed: developer bio and “Contact” CTA button from the admin Guide tab. Author info is available via the plugin page on WordPress.org instead.
  • Removed: unused standalone/ folder (Vercel/Node.js demo code unrelated to the WordPress plugin).
  • Improved: added an “External Services” section to readme that fully discloses every third-party endpoint contacted and exactly what data is transmitted.
  • Improved: added an inline reviewer-facing comment in class-ozy-api.php explaining why cURL is used in the SSE streaming path (WP HTTP API does not support response streaming).
  • Improved: reduced readme tags to 5 (WP.org limit) and bumped “Tested up to” to 6.8.

2.0.2

  • Fixed: popup modal background appeared transparent on some themes — CSS variables now resolve correctly for the modal.
  • Fixed: voice (mic) button no longer shows an oversized dark hover background; hover now only changes the icon color.
  • Improved: chat input field is taller and wider with better padding for easier typing on both desktop and mobile.
  • Improved: voice mic button is more compact (28px), giving the text input more room.
  • Improved: input row uses center alignment and tighter spacing for a more polished look.
  • Fixed: admin settings tab links now point to the correct top-level admin URL (admin.php instead of options-general.php).
  • Fixed: resolved leftover merge artifacts in CSS that were breaking widget styling in certain browsers.

2.0.1

  • Fixed: saving settings on one tab (e.g. AI Providers) no longer resets toggles from other tabs (floating enable, popup enable, site-wide, auto-open).
  • Added: auto-repair that restores visibility settings if all three are found to be off simultaneously.
  • Improved: nonce verification now uses check_ajax_referer() for AJAX handlers.
  • Improved: basic per-IP rate limiting (30 req/min for chat, 10 req/min for voice).
  • Improved: MIME type validation and audio size check for voice transcription.
  • Improved: removed all error-suppressor (@) operators; output buffering checked before flushing.
  • Improved: user message bubble now renders in solid black bold text for better readability.
  • Security: escHtml() now escapes double and single quotes to prevent attribute injection.

2.0.0

  • Added OpenAI (GPT-4o Mini, GPT-4o, GPT-3.5 Turbo) support
  • Added Claude (Haiku, Sonnet, Opus) support
  • Added configurable provider priority order
  • Added automatic website content reader (pages, posts, products, menus)
  • Redesigned dashboard with aesthetic card-based UI
  • Added dual widget modes: floating button and popup modal, each independently togglable
  • Added business knowledge base field
  • Added external suggestions toggle
  • Added agent icon URL field
  • Removed contact form auto-fill (now pure AI conversation agent)
  • Streaming support for all providers
  • Improved system prompt with site context injection
  • Updated to GPL-2.0-or-later license

1.0.0

  • Initial release

中繼資料

評分

這個項目尚無任何評論記錄。

撰寫評分

查看全部使用者評論

技術支援

使用者可在技術支援論壇提出意見反應或使用問題。

檢視技術支援論壇