Guidelines
17-Nov-2026
Guide - Pricing Agent Prompts
Document Properties
Kbid
4A8787
Added to KB
17-Nov-2026
Status
online
Product
Intershop Commerce Platform
Last Modified
17-Nov-2026
Public Access
everyone
Doc Type
Guidelines
Product
Pricing Agent
Document Link
https://knowledge.intershop.com/kb/4A8787

Introduction

This guide shows how to ask the Pricing Agent about the most common pricing tasks. It explains the rules for every question. It also provides recommended wording for eight tasks, from the market price of a single product to the price history across portals.

This guide is intended for business users who set prices, such as category managers, pricing managers, and brand managers. The related business process is price setting for an existing assortment. You need a basic understanding of e-commerce pricing.

For information on how the agent works and where the market data comes from, seeConcept - Pricing Agent. For the complete scope of functions, seeFeature List - Pricing Agent (EN).

The agent analyzes the market and proposes prices. It does not change any price. You apply a price in your own systems.

References

Prerequisites

Before you start, verify that:

  • Your organization has booked the Pricing Agent

  • You have access to the Copilot for Merchants

  • The products you ask about have a European Article Number (EAN) or a Global Trade Item Number (GTIN)

  • The products you ask about are registered for continuous market monitoring

  • Your product data contains cost prices, for the two margin tasks

Pricing Agent Prompts

Three rules apply to every question in this guide:

  • Select the Pricing Agent in the agent bar before you type your question.

  • When you ask about a single product, identify it by its GTIN or EAN. You can ask questions about your whole assortment or about competing merchants without a GTIN or EAN.

  • Define a scope for every price recommendation. Valid scopes are a brand, a category, a list of GTINs, or a number of products. The phrase "all my products" is too broad for a recommendation, but works for the deviation tasks.

The questions in this guide use placeholders in angle brackets. Replace them before you ask:

Placeholder

Replace With

<GTIN>

A GTIN or EAN from your assortment

<brand>

A manufacturer in your assortment

<merchant>

The shop name of a competing merchant

<portal>

A connected market source

<N>

A number of products, for example, 10

The agent matches products by GTIN or EAN. A product without one of these identifiers returns no market offers.

Pricing Tasks

Each task below starts from the chat of the Copilot for Merchants with the Pricing Agent selected.

Check the Market Price for a Single Product

Use this task if you need a defensible market price for one product.

To check the market price of a single product, follow these steps:

  1. Ask for every offer for the product:

    Show me every offer for EAN <GTIN>
  2. Read the lowest, the median, and the highest offer in the answer.

  3. Ask for the gap between your own price and the market price:

    Analyze the cost of EAN <GTIN>

The offer list contains one row per merchant and portal, with the item price, the total price including shipping costs, the availability, and the time of the observation.
The second question compares your own price with the market price, despite the word cost in the wording. The answer states the gap in euros and as a percentage, along with the source and the time of the observation. These details make the figure verifiable.

Propose a Fair Market Price for a List of Products

Use this task if you want to price several products at once.

To get a price proposal for a list of products, follow these steps:

  1. Collect the GTINs of the products you want to price.

  2. Ask for a fair market price range. Include the GTINs in the same question:

    Propose a fair market price range for the EANs <GTIN>, <GTIN>, <GTIN>
  3. Compare the proposed price range with your own prices, product by product.

  4. Let the agent select the products when you lack a list:

    Give me a price recommendation for my <N> products with the largest price difference

The first answer gives the observed range from the lowest to the highest competitor price and adds a suggested fair price, which is the lowest price observed in the market. The range describes what the market charges. It is not a recommendation on its own.
The second answer is more compact. One table contains your price, the lowest, median, and highest competitor prices, and the recommendation.

Undercut the Market by a Fixed Percentage

Use this task if your pricing rule keeps you a fixed percentage below the cheapest offer.

To get price proposals that follow that rule, follow these steps:

  1. Choose a scope: a brand, a category, or a list of GTINs.

  2. Ask for prices for that scope and specify the undercut in percent, for example:

    Propose prices for my <brand> assortment with a 5 percent undercut
  3. Change the percentage.

  4. Ask the question again to compare the effect.

  5. Compare the result with your cost price before you apply the price in your own systems.

The agent calculates the proposals from the lowest observed offer and the percentage you specify. It returns a list of proposals. A follow-up question with another percentage recalculates the list, so you can discuss the rule easily with colleagues.

To protect your margin, use the next task, which creates proposals that stay above the cost price.

Propose a Price That Protects a Minimum Margin

Use this task if every price must stay above your cost price plus a minimum margin.

To get a proposal with a margin limit, follow these steps:

  1. Verify that your product data contains the cost price:

    What is my margin on EAN <GTIN>
  2. Ask for a competitive price and specify the minimum margin in percent:

    Propose a competitive price for EAN <GTIN>, <GTIN> that preserves at least a 10% margin
  3. Compare the proposed price with the minimum price in the answer.

The first answer states the gross margin in euros and the margin rate as a percentage. It also shows the selling price and the cost price that the agent used.
The second answer contains the cost price, the minimum price for the margin that you specify, the lowest competitor total price, and the proposed price. If the market price falls below the minimum price, the agent proposes the minimum price instead of the market price.

Products without a cost price return a market comparison only. The margin question works for a single product or a list of products only, not for the whole assortment.

Find the Overpriced Products in Your Assortment

Use this task to find the products that you price above the market price.

To find the overpriced products, follow these steps:

  1. Ask for the products that are priced above the market:

    Which of all my products are currently overpriced
  2. Narrow the list to a single brand if the result is too long:

    Which <brand> products are currently overpriced
  3. Sort the products in the answer by the size of the gap.

  4. Use the products with the largest gap as input for the task Propose a Fair Market Price for a List of Products.

The answer lists the product, the GTIN, your price, the lowest competitor price, the gap, and a proposed price. The phrase "all my products" covers only the products under continuous market monitoring, not your entire catalog. Offers that lie below half of your own price count as probable mismatches, because they usually belong to a different product. The agent excludes these offers from the comparison.

Identify the Merchants That Undercut You

Use this task to identify the merchants that offer single products below your price.

To identify the merchants that undercut you, follow these steps:

  1. Ask for the merchants that undercut you most often:

    Which merchants undercut us most often
  2. Ask for a ranking by average price gap if the size of the gap matters more than its frequency:

    Rank merchants by average price gap, with at least 10 shared products
  3. Select one merchant.

  4. Continue with the next task.

The answer lists the merchant, the number of shared products, the number of products with a lower price than yours, the share as a percentage, and the average price difference.

Always specify a minimum number of shared products when you rank by average price gap. Without it, merchants that share a single product reach the top of the list. A gap of minus 78 percent that is based on one product is unreliable.

Look at the Offers of a Single Merchant

Use this task if one merchant keeps appearing below your price.

To see what a single merchant charges, follow these steps:

  1. Specify the merchant and the GTINs that you want to compare:

    What prices does <merchant> charge for our articles <GTIN>, <GTIN>
  2. Narrow the question to a single portal if the merchant sells on several:

    What does <merchant> charge on <portal> for our articles
  3. Ask about distribution if the listing matters more than the price:

    Does <merchant> carry our <brand> articles and at what price

The answer lists the portal, the price type, the item price, the total price, and the availability for each product. It also lists the GTINs without a match. The list of unmatched GTINs makes the result transparent.

Follow the Price History of a Product

Use this task if a competitor price changes and you want to know whether the change lasts.

To follow the price history of a product, follow these steps:

  1. Ask for the price history and specify the GTIN and the portal:

    What can you tell me about the price history of EAN <GTIN> for <portal>
  2. Add a time window if you want a defined period:

    How did the price of EAN <GTIN> change on <portal> for the last 14 days
  3. Compare two portals if the price development differs between sources:

    Compare the price history of EAN <GTIN> on <portal> and on <portal>

The answer describes the price movement in text and shows a chart. The chart plots the price on the vertical axis and the date on the horizontal axis. Your own price appears as a second series, so a stable own price against a falling market becomes visible at once.

A price history exists for the products under continuous market monitoring. An ad hoc query for a product returns the current market, not a history.

Troubleshooting

The following table lists typical situations and the actions that resolve them:

Symptom

Action

Another agent answers the question.

Select the Pricing Agent in the agent bar before you type your question.

The agent asks a question instead of answering.

Specify a concrete object: a GTIN, a brand, a category, or a merchant.

A price recommendation returns a clarifying question.

Define a scope for the recommendation, for example, a brand or a number of products.

The answer reports no market offers for a product.

Check that the product has a GTIN or EAN and is registered for continuous market monitoring.

The merchant ranking shows extreme percentages.

Specify a minimum number of shared products in the question.

The answer omits the margin.

Add cost prices to your product data and ask the question again.

The interface appears in another language.

Set the browser language, because the Copilot for Merchants uses it for the interface.

Disclaimer

The information provided in the Knowledge Base may not be applicable to all systems and situations. Intershop Communications will not be liable to any party for any direct or indirect damages resulting from the use of the Customer Support section of the Intershop Corporate Website, including, without limitation, any lost profits, business interruption, loss of programs or other data on your information handling system.

Home
Knowledge Base
User Manuals
Product Releases
Log on to continue
This Knowledge Base document is reserved for registered customers.
Log on with your Intershop Entra ID to continue.
Write an email to supportadmin@intershop.de if you experience login issues,
or if you want to register as customer.