Linux 软件免费装
Banner图

Creator Assistant Search

开发者 alessandrolioce
更新时间 2026年10月6日 00:07
PHP版本: 7.4 及以上
WordPress版本: 7.1
版权: GPL-2.0+
版权网址: 版权信息

标签

search ai openai artificial-intelligence semantic-search

下载

1.1.0 1.2.0 1.0.0

详情介绍:

Creator Assistant Search is an add-on for Creator Assistant - Hub that brings AI-powered search to your WordPress site. When a visitor performs a search, the plugin retrieves the most semantically relevant content from your Qdrant vector database and generates a concise AI Overview (displayed at the top of the search results page) using OpenAI's chat models. How it works
  1. When a search query is submitted, the plugin converts it into a vector embedding via the Hub and queries your Qdrant collection for the most relevant content chunks.
  2. The matching chunks are assembled into a prompt and sent to the OpenAI Chat API to generate a short, direct answer.
  3. The answer is streamed progressively to the browser and displayed as an AI Overview panel above your search results, in both block themes and classic themes. Subsequent searches for the same query return the cached result instantly.
Key features Requirements

安装:

  1. Install and configure Creator Assistant - Hub first. Make sure the OpenAI API key, Qdrant endpoint, and API key are saved and both connections show a green status.
  2. Upload the creator-assistant-search folder to the /wp-content/plugins/ directory, or install the plugin directly from the WordPress plugin screen.
  3. Activate the plugin through the Plugins screen in WordPress.
  4. The plugin activates the Hub's vectorizer automatically. Existing posts will be indexed by the Hub's hourly background cron; new and updated posts are vectorized on save.
  5. Perform a search on your site. An AI Overview panel will appear at the top of the results once at least some content has been vectorized.

屏幕截图:

  • The Customizer color scheme control for the AI Overview panel.
  • The AI Overview panel in dark mode.
  • The Search settings page: keep the default prompt, add your own instructions to it, or replace it entirely. The prompt actually in use is always shown, and the Display section turns the automatic insertion off in favour of the shortcode or the block.
  • The "AI Overview" block selected in the Search template in the Site Editor. The list view shows where it belongs, between the search form and the list of posts. That placement matters: the panel is built from the search query, so in a normal page or a page template it would show nothing at all.

升级注意事项:

1.2.0 Requires Creator Assistant - Hub 1.1.0 or higher (menu ordering). Update the Hub first. Your settings are migrated automatically to the new option names; a theme that overrides the panel CSS classes or custom properties must use the new creator-assistant-search-* names. 1.1.0 Requires Creator Assistant - Hub 1.0.2 or higher (the new tabbed settings page uses the tab renderer the Hub publishes starting in that version). Update the Hub first. 1.0.0 Initial release. No upgrade steps required.

常见问题:

Does this plugin work without Creator Assistant - Hub?

No. Creator Assistant Search is an add-on that requires Creator Assistant - Hub to be installed and configured. The Hub provides the OpenAI and Qdrant connections that this plugin relies on.

Which post types are included in the search?

By default, posts and pages are vectorized and included in search results. If you have Creator Assistant - Hub Pro, you can exclude specific post types from the Content tab in the Hub settings page.

Does the AI Overview appear for every search?

The AI Overview appears when the plugin finds at least one relevant content chunk for the search term. If no relevant content is found in your Qdrant collection, the standard search results are shown without the overview panel.

The AI Overview never appears: what should I check?

This usually means your content has not been vectorized yet. Vectorization is handled entirely by Creator Assistant - Hub: new and updated posts are vectorized on save, and existing posts are picked up by the Hub's hourly WP-Cron batch, which requires WP-Cron to be running on your site. See the "How do I check whether the service is properly configured?" question in the Creator Assistant - Hub readme for the Site Health check and WP-Cron troubleshooting steps.

How long does the AI Overview take to appear?

The overview is generated asynchronously via Server-Sent Events: the page loads with the standard search results immediately. The AI answer is then streamed progressively into the panel character by character (typically within a few seconds). If the answer for the same query was already cached, it appears almost instantly.

Does the plugin work with a page cache?

Yes, and it takes care of it on its own. A search page carrying an AI Overview is marked as not cacheable with the DONOTCACHEPAGE constant, which every major page cache plugin reads. It has to be: the panel embeds a minute-precision access token, and the endpoint that streams the answer rejects a token older than two minutes, so a search page served from a cache would show an empty panel and never load its answer. Search pages without an overview are not affected, and neither is the rest of your site. Most page caches already skip URLs with a query string, which is what a search URL is, so on many setups nothing changes. If your CDN caches HTML by itself, make sure it is not caching search URLs. The answer is cached anyway, separately and server side, so nothing is recomputed for a repeated search.

Is the AI Overview cached?

Yes. The generated answer is cached for one hour using WordPress transients. Repeated searches for the same query within that window return the cached result without any OpenAI API call. Administrators can bypass the cache for a specific search by appending ?creator_assistant_search_no_cache=1 to the search URL (e.g. https://example.com/?s=shoes&creator_assistant_search_no_cache=1). This forces a fresh OpenAI call and overwrites the cached result. The bypass is only available to users with the manage_options capability and has no effect for regular visitors.

Does the plugin modify my posts, pages, or theme files?

No. Creator Assistant Search is entirely non-destructive. It injects the AI Overview panel above search results using standard WordPress hooks (render_block_core/query for block themes, loop_start for classic themes). No theme files are ever touched. Your posts, pages, and all their content remain exactly as they are.

Are my visitors' search queries stored in the database?

Search queries are never stored in plain text in your database. The plugin uses an anonymous hash of the query as a transient cache key for the AI response. The cached answer expires automatically after one hour and is then deleted. No query logs, no user identifiers, no permanent records. The search term itself is sent to OpenAI to generate the AI answer (subject to OpenAI's privacy policy), but it is not stored persistently by this plugin.

Does the AI Overview replace my existing search results?

No. The AI Overview is an additional panel displayed above your standard search results. It does not remove, reorder, or replace any of them. If no relevant content is found in your Qdrant collection, the standard results are shown without any panel at all.

Can I customise the appearance of the AI Overview?

Yes, in two ways:

  1. Color scheme: go to Appearance → Customize → AI Overview and choose between automatic (follows the visitor's system preference), light, or dark mode. Changes are previewed live in the Customizer.
  2. Custom CSS: the panel uses CSS classes prefixed with creator-assistant-search__ai-overview that you can override in your theme stylesheet. The animated border and typed-text effect are provided by Creator Assistant - Hub's shared assets.

Can I place the AI Overview panel somewhere else?

Yes, but it has to go in whatever renders your search results page. The panel is built from the site's main search query, so it produces nothing anywhere else. Putting the block or the shortcode in a normal page or in a page template will show nothing at all. First, in Creator Assistant → Search, turn off "Insert the AI Overview automatically in search results". Leaving it on means two sources competing for the same panel: it is still shown at most once per page, but whichever renders first wins, so it may not appear where you placed it. Then place it, depending on your theme:

  • Block theme: go to Appearance → Editor → Templates → Search and insert the "AI Overview" block, usually right above the query loop that lists the results. If your theme has no Search template, use its Index template instead.
  • Classic theme: add the [creator_assistant_search_ai_overview] shortcode to search.php in your child theme.
Both render exactly the same panel. A custom "search page" built with a query loop on a normal page will not work: WordPress does not treat that as a search results page, so the panel has no query to answer.

Can I change what the AI is told to do?

Yes. In Creator Assistant → Search you can keep the default prompt, add your own instructions on top of it, or replace it completely. The page always shows the prompt currently in use, including the sections added by add-ons such as Creator Assistant - Search Pro. Adding instructions is usually the better choice: your text is appended to the default prompt, so you keep the improvements shipped with future plugin updates.

更新日志:

1.2.0 1.1.0 1.0.0