{"id":356040,"date":"2026-09-11T13:52:13","date_gmt":"2026-09-11T13:52:13","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/ai-site-agent\/"},"modified":"2026-09-11T13:53:11","modified_gmt":"2026-09-11T13:53:11","slug":"kethu-site-chat-assistant","status":"publish","type":"plugin","link":"https:\/\/ku.wordpress.org\/plugins\/kethu-site-chat-assistant\/","author":18795267,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.2.0","stable_tag":"1.2.0","tested":"7.1","requires":"7.0","requires_php":"8.0","requires_plugins":null,"header_name":"Kethu Site Chat Assistant","header_author":"Kethu","header_description":"Site chat assistant for WordPress using the WordPress AI Client, Connectors, and Abilities API.","assets_banners_color":"","last_updated":"2026-09-11 13:53:11","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"","rating":0,"author_block_rating":0,"active_installs":0,"downloads":52,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.2.0":{"tag":"1.2.0","author":"vivek28042000","date":"2026-09-11 13:53:11","revision":3691501}},"upgrade_notice":[],"ratings":[],"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":{"kethu-site-chat-assistant\/chat":{"name":"kethu-site-chat-assistant\/chat","title":"Chat"}},"tagged_versions":["1.2.0"],"block_files":[],"assets_screenshots":[],"screenshots":[]},"plugin_section":[],"plugin_tags":[251511,2353,1320,2364,1104],"plugin_category":[],"plugin_contributors":[280240],"plugin_business_model":[],"class_list":["post-356040","plugin","type-plugin","status-publish","hentry","plugin_tags-abilities","plugin_tags-ai","plugin_tags-assistant","plugin_tags-chatbot","plugin_tags-support","plugin_contributors-vivek28042000","plugin_committers-vivek28042000"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/kethu-site-chat-assistant.svg","icon_2x":false,"generated":true},"screenshots":[],"raw_content":"\n

Kethu Site Chat Assistant adds an AI assistant to your WordPress website. Visitors can ask questions, search public site content, perform safe calculations, and more through a lightweight chat interface.<\/p>\n\n

This plugin uses the WordPress AI Client<\/strong> (wp_ai_client_prompt()<\/code>). It does not<\/strong> call third-party AI provider hosts directly. Provider credentials are managed in Settings \u2192 Connectors<\/strong>.<\/p>\n\n

Chat tools are registered through the WordPress Abilities API<\/strong> and executed only when the administrator enables them.<\/p>\n\n

How it works<\/h4>\n\n

Visitor \u2192 Chat UI \u2192 WordPress REST API \u2192 Agent \u2192 WordPress AI Client \u2192 Connected provider \u2192 Abilities\/tools \u2192 Final response<\/p>\n\n

The AI does not<\/strong> have unrestricted access to WordPress. It can only use explicitly registered abilities that the administrator enables.<\/p>\n\n

Features<\/h3>\n\n
    \n
  • WordPress AI Client integration (no direct provider HTTP client in plugin code)<\/li>\n
  • Provider credentials via Settings \u2192 Connectors<\/li>\n
  • Tools registered as WordPress Abilities<\/li>\n
  • Admin settings under Kethu Site Chat Assistant<\/li>\n
  • Frontend shortcode: [kethu_site_chat_assistant]<\/code> (legacy aliases: [ai_site_agent]<\/code>, [helvora_site_chat]<\/code>)<\/li>\n
  • Optional floating chat widget<\/li>\n
  • Lightweight Gutenberg block<\/li>\n
  • Conversation memory using transients<\/li>\n
  • Rate limiting for anonymous users<\/li>\n
  • Admin test interface with safe trace output<\/li>\n
  • Privacy notice and local usage statistics<\/li>\n
  • Graceful failure when AI is unavailable<\/li>\n<\/ul>\n\n

    Configuration<\/h3>\n\n
      \n
    1. Configure an AI provider under Settings \u2192 Connectors<\/strong><\/li>\n
    2. Enable the agent in Kethu Site Chat Assistant settings<\/li>\n
    3. Optionally set a preferred model name<\/li>\n
    4. Customize the agent name, welcome message, and system instructions<\/li>\n
    5. Enable the tools you want the assistant to use<\/li>\n
    6. Configure rate limits and logging as needed<\/li>\n
    7. Click Test AI Connection<\/strong><\/li>\n<\/ol>\n\n

      Using the Chat Assistant<\/h3>\n\n

      Use the shortcode:<\/p>\n\n

      [kethu_site_chat_assistant]\n<\/code><\/pre>\n\n
      Or enable the floating widget in settings to show a site-wide chat button.<\/p>\n\n
      Available Tools (Abilities)<\/h3>\n\n
        \n
      • Calculator<\/strong> \u2014 safe math without code execution<\/li>\n
      • Site Search<\/strong> \u2014 search public posts and pages<\/li>\n
      • Post Search<\/strong> \u2014 search public blog posts<\/li>\n
      • Page Search<\/strong> \u2014 search public pages<\/li>\n
      • Site Information<\/strong> \u2014 safe public site metadata<\/li>\n
      • Contact Tool<\/strong> \u2014 controlled contact submission with explicit confirmation<\/li>\n<\/ul>\n\n
        External services<\/h3>\n\n
        Kethu Site Chat Assistant does not hard-code third-party AI endpoints. Requests are sent through the WordPress AI Client to whichever AI provider the site owner connects under Settings \u2192 Connectors<\/strong>.<\/p>\n\n
        If you connect OpenAI (or another provider) through Connectors:<\/p>\n\n
          \n
        • User messages may be sent to that provider<\/li>\n
        • Public website content may be sent when search tools are used<\/li>\n
        • Retention and privacy are governed by that provider and by WordPress Connectors<\/li>\n
        • Review the provider\u2019s current terms and privacy policy before enabling AI<\/li>\n<\/ul>\n\n
          This plugin is not affiliated with or endorsed by OpenAI or other AI providers.<\/p>\n\n
          Privacy<\/h3>\n\n
          Local WordPress retention<\/h4>\n\n
            \n
          • Conversation transcripts and conversation IDs are stored locally<\/strong> as WordPress transients for up to 24 hours<\/strong>.<\/li>\n
          • Local transients are used for session isolation, conversation continuity, optional admin traces, and privacy export\/erase.<\/li>\n
          • Logging is optional and disabled by default. Optional logs stay in the WordPress database until cleared or the plugin is uninstalled.<\/li>\n
          • The plugin does not sell user data.<\/li>\n
          • The plugin does not phone home or send analytics to the plugin author.<\/li>\n<\/ul>\n\n
            Provider retention<\/h4>\n\n
              \n
            • User messages may be sent to the connected AI provider through the WordPress AI Client.<\/li>\n
            • Deleting a local WordPress transient does not<\/strong> delete data already sent to a provider.<\/li>\n
            • Configure your site privacy policy accordingly. Site owners remain responsible for privacy, consent, and legal compliance.<\/li>\n<\/ul>\n\n
              Security<\/h3>\n\n
                \n
              • Provider API keys are managed by WordPress Connectors, not stored by this plugin<\/li>\n
              • REST endpoints use nonces and permission callbacks<\/li>\n
              • Input validation, sanitization, and output escaping throughout<\/li>\n
              • No arbitrary code execution<\/li>\n
              • Retrieved website content is treated as untrusted data<\/li>\n
              • Rate limiting helps prevent abuse<\/li>\n<\/ul>\n\n
                Troubleshooting<\/h3>\n\n
                  \n
                • Confirm WordPress 7.0+ and that wp_ai_client_prompt()<\/code> is available<\/li>\n
                • Open Settings \u2192 Connectors<\/strong> and verify a provider is connected<\/li>\n
                • Use Test AI Connection<\/strong> in Kethu Site Chat Assistant settings<\/li>\n
                • Check that the agent is enabled<\/li>\n
                • Confirm your hosting allows outbound HTTPS for the connected provider<\/li>\n<\/ul>\n\n
                  Developer Documentation<\/h3>\n\n
                  REST namespace: kethu-site-chat-assistant\/v1<\/code><\/p>\n\n
                  Endpoints:<\/p>\n\n
                    \n
                  • POST \/wp-json\/kethu-site-chat-assistant\/v1\/chat<\/code><\/li>\n
                  • POST \/wp-json\/kethu-site-chat-assistant\/v1\/clear-conversation<\/code><\/li>\n
                  • GET \/wp-json\/kethu-site-chat-assistant\/v1\/status<\/code><\/li>\n<\/ul>\n\n
                    Abilities namespace: kethu-site-chat-assistant\/*<\/code><\/p>\n\n\n
                      \n
                    1. Upload the plugin ZIP via Plugins \u2192 Add New \u2192 Upload Plugin<\/strong><\/li>\n
                    2. Activate Kethu Site Chat Assistant<\/strong><\/li>\n
                    3. Open Settings \u2192 Connectors<\/strong> and configure an AI provider (for example OpenAI)<\/li>\n
                    4. Go to Kethu Site Chat Assistant \u2192 Settings<\/strong><\/li>\n
                    5. Enable the agent and configure tools<\/li>\n
                    6. Add [kethu_site_chat_assistant]<\/code> to a page or enable the floating widget<\/li>\n<\/ol>\n\n\n
                      \n
                      Does this store my OpenAI API key?<\/h3><\/dt>\n
                      No. Configure providers under Settings \u2192 Connectors<\/strong>. Kethu Site Chat Assistant uses the WordPress AI Client.<\/p><\/dd>\n
                      Can the AI access my entire WordPress admin?<\/h3><\/dt>\n
                      No. It can only use the abilities\/tools you enable.<\/p><\/dd>\n
                      What happens if AI is unavailable?<\/h3><\/dt>\n
                      Visitors see a friendly error message. Your site continues to function normally.<\/p><\/dd>\n\n<\/dl>\n\n\n
                      1.2.0<\/h4>\n\n
                        \n
                      • Distinctive branding: Kethu Site Chat Assistant<\/strong><\/li>\n
                      • WordPress.org slug \/ text domain: kethu-site-chat-assistant<\/code><\/li>\n
                      • Code prefixes: ksca_<\/code> \/ KSCA_<\/code><\/li>\n
                      • WordPress AI Client + Connectors + Abilities API (no direct provider HTTP client)<\/li>\n
                      • Requires WordPress 7.0+, Tested up to 7.1<\/li>\n<\/ul>\n\n
                        1.1.1<\/h4>\n\n
                          \n
                        • Interim revision during review (superseded)<\/li>\n<\/ul>\n\n
                          1.1.0<\/h4>\n\n
                            \n
                          • Interim Helvora branding revision (superseded)<\/li>\n<\/ul>\n\n
                            1.0.3<\/h4>\n\n
                              \n
                            • Legacy AI Site Agent release (superseded)<\/li>\n<\/ul>\n\n
                              1.0.2<\/h4>\n\n
                                \n
                              • Plugin Check fixes and uninstall transient cleanup (legacy)<\/li>\n<\/ul>\n\n
                                1.0.1<\/h4>\n\n
                                  \n
                                • Conversation\/session security and privacy hardening (legacy)<\/li>\n<\/ul>\n\n
                                  1.0.0<\/h4>\n\n
                                    \n
                                  • Initial release (legacy AI Site Agent)<\/li>\n<\/ul>","raw_excerpt":"Site chat assistant for WordPress using the WordPress AI Client, Connectors, and Abilities API.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/ku.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/356040","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ku.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/ku.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/ku.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=356040"}],"author":[{"embeddable":true,"href":"https:\/\/ku.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/vivek28042000"}],"wp:attachment":[{"href":"https:\/\/ku.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=356040"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/ku.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=356040"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/ku.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=356040"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/ku.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=356040"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/ku.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=356040"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/ku.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=356040"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}