Truvio.Commerce.BuyingAssistant 0.2.0-beta

Truvio Buying Assistant for Dynamicweb 10

An AI buying assistant for Dynamicweb 10 storefronts, shipped as a Dynamicweb App Store app.

A shopper describes what they need in plain language ("everything to open a 20,000 gallon pool", "1,800 sq ft gable roof, full tear-off, two pipe penetrations", "replacement union set for a 1 HP pump", "same as my last order but for 32 squares"). The assistant searches the live catalog, sizes the job with the rules you give it, prices every line at that customer's own prices with quantity breaks, checks stock per location and returns a cart-ready proposal: a live activity feed while it works, the reasoning per line, editable quantities, remove and restore per line (every edit re-priced live), one "Add all to cart" button. Follow-up questions refine the same, edited proposal. Everything the model proposes is re-priced by Dynamicweb before it reaches the cart.

• Package: Truvio.Commerce.BuyingAssistant on nuget.org (Dynamicweb App Store: Apps > Appstore > Available apps)
• Requires Dynamicweb 10.27 or newer, an Anthropic API key (the Dynamo key is reused when present), and a host restart after installation
• License: MIT

Install and set up in three steps

1. Install from the App Store (Apps > Appstore > Available apps > Truvio Buying Assistant) and restart the solution. On first start the app installs its item type, its Swift 2 paragraph layout and a Dynamo skill, and writes a status file.

2. Open Dynamo (the backend AI assistant panel) and type:

   /truvio-buying-assistant-setup
   

   Dynamo checks the installation, reads your catalog and pages, drafts the business instructions and skills for your products, places the assistant on the product details page and on an "Ask" landing page, walks you through the one manual step when needed (the Anthropic API key under Settings > Apps > Buying Assistant) and verifies the first storefront run with you. Every write is shown as an approval card before it happens.

3. Test on the storefront: sign in as a customer, open a product, type a request, click the button, then "Add all to cart".

Without Dynamo, the same setup takes ten minutes by hand: docs/getting-started.md.

What is in the box

Documentation

• Getting started: install paths, Dynamo setup, manual configuration, placing the paragraph, logging and diagnostics
• Configuration reference: every setting and paragraph field, the status file
• Instructions and skills: how to brief the assistant for your business
• MCP connection: modes, allowlist, write guard
• Architecture: request flow, tools, model settings, packaging, source layout
• Publishing and releasing: for maintainers

For partners

• The app is generic: nothing in it is specific to one shop. Everything shop specific lives in the instructions and skills (text fields) and can be authored by Dynamo from the customer's own catalog.
• Prices, stock, assortments and customer agreements come from Dynamicweb's own services (PriceManager, stock locations, the signed-in user's context), so what the assistant quotes is what the cart charges.
• The paragraph layout is a normal Razor file under the design folder; customise it freely, the app never overwrites an edited copy.
• Log lines per request (user, tokens, cache reads, lines, total, seconds) go to Files/System/Log/Truvio.BuyingAssistant/.
• Issues and feature requests: https://github.com/justdynamics/Truvio.Commerce.BuyingAssistant/issues

Building from source

dotnet test tests\Truvio.Commerce.BuyingAssistant.Tests
dotnet pack src\Truvio.Commerce.BuyingAssistant\Truvio.Commerce.BuyingAssistant.csproj -c Release -p:DynamicwebVersion=10.27.9 --output artifacts

Always build against the Dynamicweb floor version (10.27.9); a DLL compiled against a newer Dynamicweb version loads on older hosts but its types are skipped silently. scripts\deploy-local.ps1 -HostProject <Dynamicweb.Host.Suite folder> -Restart drops a development build into a local host.