====== Search Intelligence — LLM Provider User Guide ======

===== Related overview =====

For a shopper-friendly overview of features and setup, see the [[https://toweringmedia.com/magento-2-search-intelligence-llm-provider-user-guide|Magento 2 Search Intelligence LLM Provider User Guide]] on the storefront. This wiki page remains the full technical documentation.

===== Extension context =====

This is a Toweringmedia Magento 2 extension guide for the current admin extension catalog.

===== Product page =====

  * [[https://toweringmedia.com/search-intelligence-llm-provider|Search Intelligence — LLM Provider]] (SKU ''tm-search-intelligence-llm'')

===== Overview =====

This module is the language-model layer for Search Intelligence. It packages store data into budgeted prompt packets, supports dry-run execution, and validates the proposals that come back. Proposals it produces are advisory only — they enter Core's approval queue and are never applied to the store automatically.

===== What this extension does =====

  * Builds budgeted prompt packets from store data.
  * Dry-run mode for testing without committing spend or proposals.
  * Advisory-only validation of returned proposals.
  * Connector screen for checking provider status.

===== Requirements =====

  * Magento 2.4.x (Open Source or Adobe Commerce).
  * PHP: ^8.1 || ^8.2 || ^8.3 || ^8.4 (as declared by the published package).
  * A current Toweringmedia license and Composer credentials for ''https://composer.toweringmedia.com/''.
  * Requires ''toweringmedia/module-ai-core'' and ''toweringmedia/module-search-intelligence-core'' — Composer installs both automatically.
  * This module is part of the Search Intelligence suite. Search Intelligence Core must be installed and working first — the connectors and appliers plug into Core's dashboard, advisory queue, and change-set workflow.

===== Installation =====

Install and validate in a staging environment before production rollout.

<code bash>
cd /path/to/magento
composer require toweringmedia/module-search-intelligence-llm

bin/magento module:enable Toweringmedia_SearchIntelligenceLlm
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy -f
bin/magento cache:flush
</code>

Currently published versions at the time of writing:

  * ''toweringmedia/module-search-intelligence-llm'' — 1.1.0

Toweringmedia packages are served from the licensed Composer repository ''https://composer.toweringmedia.com/''. If Composer reports that the package could not be found, your credentials are missing or the license does not cover this package yet. Retrieve your keys from **My Account** on toweringmedia.com, or contact [[mailto:support@toweringmedia.com|support@toweringmedia.com]].

General installation notes that apply to every Toweringmedia extension are in the [[https://toweringmedia.com/installation|installation guide]].

===== Configuration =====

  * Stores > Configuration > Towering Media > **AI Core Settings** > **Search Intelligence LLM Connector** (config group ''search_intelligence_llm'' inside config section ''toweringmedia_ai_core''). Note this module adds a group to the AI Core section rather than creating its own section.
  * Admin screen: Intelligence SEO Suite > Connectors > **LLM Provider**.

===== Basic usage and what to expect =====

  - Configure the AI provider in AI Core Settings first, then review the Search Intelligence LLM Connector group in that same section.
  - Use dry-run mode for the first few runs to see what would be proposed before committing spend.
  - Approve or reject the resulting proposals from Core's Advisory Queue.

===== Notes and limitations =====

  * Proposals from this module are advisory. Nothing reaches the storefront without an approved change set in Search Intelligence Core.

===== Validation checklist =====

  * ''bin/magento module:status'' shows the module(s) as enabled.
  * Extension configuration saves without errors in Admin.
  * The admin screens listed above are reachable and load without error.
  * Expected storefront/admin behavior is present after a cache flush.
  * No critical PHP/JS errors appear in ''var/log/'' during the primary test flow.

===== Troubleshooting =====

  * **Composer cannot find the package**: confirm the ''https://composer.toweringmedia.com/'' repository and your credentials are present in ''auth.json'', and that your license covers this package.
  * **Feature not visible**: verify module status, flush cache, and redeploy static content.
  * **Admin setting not applying**: clear cache and confirm the config scope (default / website / store view).
  * **Unexpected behavior**: retest with only the required related modules enabled.

===== Support =====

  * [[mailto:support@toweringmedia.com|support@toweringmedia.com]]
  * [[https://toweringmedia.com/magento-maintenance-support|Magento maintenance and support]]

===== Related Magento 2 docs =====

  * [[magento2:extensions:start|Magento 2 extension index]]
  * [[start|Global docs home]]