AI assistants: the parts, in plain words

37 parts and 15 phrases. Apps in this area include Shopify Sidekick, Shopify Magic, Klaviyo AI, Gorgias AI Agent, Rep AI, Octane AI.

Admin assistantai.adminShowThe chat assistant staff use inside the admin, the model behind it and the rules on what it may change.

Assistant chatai.admin.chatShowThe chat window and the store data the assistant reads to answer.

How to extend

Assistant toolMany side by sidegetStoreSnapshotgetOrderSummarysearchProductsA plugin adds a read tool, and the assistant calls it alongside the built-in ones.

Part	Litestore today	How to extend
Admin chat`ai.admin.chat.window`The admin chat is a conversation panel where staff type questions or requests and the assistant replies.	Core`modules/assistant/chat/ai-chat.tsx`	Assistant tool · many
Read tool`ai.admin.chat.read_tool`A read tool is a named function the assistant calls to fetch store data, such as recent orders, revenue, low stock or a customer, checked against the staff member's permissions.	Core`modules/assistant/agent-tools.ts`	Assistant tool · many
Store snapshot`ai.admin.chat.store_snapshot`A store snapshot is a short read-only summary of what needs attention now, such as queue sizes and stock risk, that the assistant fetches with a tool.	Core`modules/assistant/store-context.ts`	Assistant tool · many
Guardrails`ai.admin.chat.guardrails`Guardrails check incoming text for prompt-injection attempts, mask customer email addresses in tool results and set hard limits on what one action may do.	Core`modules/assistant/guardrails.ts`	Assistant tool · many
Assistant home`ai.admin.chat.home_queue`The assistant home is the admin start page that shows pending proposals and open work next to the chat box.	Core`modules/assistant/assistant-home.tsx`	Assistant tool · many
Voice input`ai.admin.chat.voice`Voice input turns spoken questions into chat messages for the assistant.	Plugin	Assistant tool · many

Assistant actionsai.admin.actionShowWhat the assistant may change, and the approval step in front of money and stock changes.

How to extend

Assistant toolMany side by sideproposeRefundproposeCouponproposeInventoryAdjustmentA plugin adds a propose tool whose stored parameters run only after an operator approves them.

Part	Litestore today	How to extend
Propose and approve`ai.admin.action.propose_approve`A proposal stores the tool name and parameters the assistant suggests, such as a refund or a price change, and runs them once when an operator approves it.	Core`modules/assistant/agent-runs.ts`	Assistant tool · many
Approval card`ai.admin.action.approval_card`An approval card shows a pending proposal with its exact values and buttons to approve or reject it.	Core`modules/assistant/chat/agent-approval-card.tsx`	Assistant tool · many
Content write tool`ai.admin.action.content_write`A content write tool saves storefront content the assistant wrote, such as a page, product copy, search text or a theme choice.	Core`modules/assistant/agent-tools.ts`	Assistant tool · many
Undo an assistant change`ai.admin.action.undo`An undo restores the content an assistant tool changed to the version before the change.	Planned	Assistant tool · many
Batch content job`ai.admin.action.batch_content`Batch enrichment runs one content task, such as writing descriptions, across many products in a single job.	Planned	Assistant tool · many
Assistant workflow`ai.admin.action.workflow`An assistant workflow is a saved series of tool steps that runs on a schedule or after a store event.	Planned	Assistant tool · many

Model and spendai.admin.modelShowWhich language model answers, what happens when it fails and how much it may cost.

How to extend

ProviderOne per storeAI model providerOne model provider is active at a time, with others as fallbacks.

Part	Litestore today	How to extend
Model provider`ai.admin.model.provider`The model provider setting picks which company's language model answers, such as Anthropic, Google or OpenAI, from the keys that are configured.	Core`modules/assistant/model.ts`	Provider · one
Model fallback`ai.admin.model.fallback`A model fallback retries a failed request with the next configured model.	Core`modules/assistant/model.ts`	Provider · one
Monthly spend cap`ai.admin.model.spend_cap`A spend cap records the cost of each model call and stops new calls once the month's total reaches a set budget.	Core`modules/assistant/spend.ts`	Provider · one
Hidden without a model`ai.admin.model.hidden_when_off`Every AI button and panel is hidden when no model provider is configured.	Core`modules/assistant/ai-status-provider.tsx`	Provider · one

Shopper-facing assistantsai.shopperShowAI features a shopper meets on the storefront.

Shopping assistantai.shopper.assistShowChat and answers for shoppers on the storefront.

How to extend

SlotOne per storestorefront.slot.global.floatingA shopping assistant renders as one chat widget in a storefront slot.

Part	Litestore today	How to extend
Storefront chat assistant`ai.shopper.assist.chat`A storefront chat assistant answers shopper questions about products, orders and policies from the store's catalog and help pages.	Plugin	Slot · one
Product question answer`ai.shopper.assist.product_answer`A product answer replies to a question on a product page with text taken from that product's details and reviews.	Plugin	Slot · one
Review summary`ai.shopper.assist.review_summary`A review summary is a short paragraph a model writes from a product's reviews, shown above the review list.	Plugin	Slot · one
Hand-off to staff`ai.shopper.assist.human_handoff`A hand-off passes a shopper conversation from the AI assistant to the store's inbox when it cannot answer.	Plugin	Slot · one

Questions and matchingai.shopper.guideShowQuizzes and search that match a shopper's answers or words to products.

How to extend

SectionMany side by sideA quiz is a storefront section a plugin provides.
ProviderOne per storesearch providerAI search replaces the store's search as one provider.

Part	Litestore today	How to extend
Product quiz`ai.shopper.guide.quiz`A product quiz asks the shopper a few questions and shows the products whose attributes match the answers.	Plugin	Section · manyProvider · one
Quiz answers on profile`ai.shopper.guide.quiz_answers_to_profile`Quiz answers are stored on the customer's profile as fields that segments and emails can use.	Plugin	Section · manyProvider · one
Search by meaning`ai.shopper.guide.meaning_search`Search by meaning matches a shopper's plain-language query to products by meaning, using text embeddings, rather than by exact words.	Plugin	Section · manyProvider · one

Generated contentai.contentShowCopy and data a model writes into a form or a draft for a person to check and save.

How to extend

ProviderMany side by sidecontent generatorFurther generators, such as image or alt text tools, fill form fields the same way and persist only on save.

Part	Litestore today	How to extend
Product fill`ai.content.product_fill`Product fill writes a product's description, specifications, tags and search text from the name, category and options entered, into the open form.	Core`modules/assistant/fill-product.ts`	Provider · many
Grounding check`ai.content.grounding_check`A grounding check compares every number in generated copy with the facts entered and holds back any number that does not appear in them.	Core`modules/assistant/grounding.ts`	Provider · many
Generated search text`ai.content.seo_meta`Generated search text is a meta title and meta description written by the model for a product, collection or page.	Core`modules/assistant/fill-product.ts`	Provider · many
Generated page`ai.content.page_copy`A generated page is storefront page HTML the assistant writes and saves on request.	Core`modules/assistant/agent-tools.ts`	Provider · many
Drafted customer message`ai.content.customer_message`A drafted customer message is a reply or email the assistant writes for staff to review before it is sent.	Core`modules/assistant/agent-tools.ts`	Provider · many
Product data from a URL`ai.content.extract_from_url`URL extraction reads a product web page and returns its name, price, description and images as structured product fields.	Core`modules/assistant/extract-product.ts`	Provider · many
Generated alt text`ai.content.alt_text`Generated alt text is a short description of an image written by a model for screen readers and search engines.	Plugin	Provider · many
Generated email copy`ai.content.email_copy`Generated email copy is a subject line and body for a marketing email written by a model from a short brief.	Plugin	Provider · many
Image generation`ai.content.image_generation`Image generation creates a new product or lifestyle image from a text prompt or an existing photo.	Plugin	Provider · many
Background removal`ai.content.background_removal`Background removal cuts the product out of a photo and replaces the background with a plain colour or a new scene.	Plugin	Provider · many

Outside agents buyingai.external_agentShowEndpoints that let outside AI agents find products, build a cart and send a shopper to pay.

How to extend

Assistant toolMany side by sidesearch_productsadd_to_cartget_checkout_urlThe storefront MCP server lists its tools, and a plugin adds a tool to it.

Part	Litestore today	How to extend
Storefront tool server`ai.external_agent.tool_server`A storefront tool server, using the Model Context Protocol, lets an outside AI agent search products, read details, build a cart, get a checkout link and look up an order.	Core`app/api/mcp/route.ts`	Assistant tool · many
Discovery manifest`ai.external_agent.discovery_manifest`A discovery manifest is a file at a well-known URL that lists the store's name and the API endpoints an agent may call.	Core`app/.well-known/ucp/route.ts`	Assistant tool · many
Agent checkout by API`ai.external_agent.api_checkout`Agent checkout by API lets an outside agent create a cart and complete payment through API calls, as in the Universal Commerce Protocol, without a browser.	Planned	Assistant tool · many
In-chat checkout with delegated payment`ai.external_agent.in_chat_checkout`In-chat checkout lets a shopper buy inside a chat app with payment passed as a delegated token, as in the Agentic Commerce Protocol.	Plugin	Assistant tool · many

Phrase	Made of
AI assistant for merchants	ai.admin.chat.window ai.admin.chat.read_tool ai.admin.action.propose_approve
human in the loop	ai.admin.action.propose_approve ai.admin.action.approval_card
AI product descriptions	ai.content.product_fill ai.content.grounding_check
AI SEO	ai.content.seo_meta
AI alt text	ai.content.alt_text
AI subject lines	ai.content.email_copy
AI background remover	ai.content.background_removal
AI image generator	ai.content.image_generation
shopping assistant	ai.shopper.assist.chat ai.shopper.assist.human_handoff
AI agent for support	ai.shopper.assist.chat ai.shopper.assist.human_handoff
product quiz	ai.shopper.guide.quiz ai.shopper.guide.quiz_answers_to_profile
AI review summaries	ai.shopper.assist.review_summary
agentic commerce	ai.external_agent.discovery_manifest ai.external_agent.tool_server ai.external_agent.api_checkout
Universal Commerce Protocol	ai.external_agent.discovery_manifest ai.external_agent.api_checkout
Agentic Commerce Protocol	ai.external_agent.in_chat_checkout

AI assistants

What the phrases mean

Phrases left out

Sources