Skip to main content
The Merchandizing Agent is an AI-powered assistant that helps merchandisers efficiently manage product content, generate descriptions, and optimize SEO across your Kibo Commerce catalog.

​
Table of Contents

  1. Overview
  2. Accessing the Merchandizing Agent
  3. Getting Started
  4. Types of Requests
  5. Content Generation
  6. How Changes Are Applied
  7. Best Practices
  8. Example Conversations
  9. Troubleshooting

​
Overview

​
What is the Merchandizing Agent?

The Merchandizing Agent is a conversational AI assistant designed specifically for merchandizing tasks. Instead of navigating through multiple screens and forms, you can simply describe what you want to do in plain English, and the agent will:
  • Retrieve product information
  • Generate or update product descriptions
  • Create SEO-optimized content
  • Update product metadata across locales
  • Search your catalog using natural language

​
Key Benefits

BenefitDescription
SpeedUpdate product content in seconds instead of minutes
ConsistencyGenerate descriptions that follow your brand voice
Multi-localeManage content across different languages and regions
SEO OptimizationCreate search-engine-friendly titles, descriptions, and keywords
Natural LanguageNo need to learn complex interfaces - just describe what you need

​
Accessing the Merchandizing Agent

​
Where to Find It

The Merchandizing Agent is accessed through the Kibo Agent Admin interface:
  1. Navigate to your Kibo Agent Admin URL (provided by your administrator)
  2. Log in with your credentials
  3. From the Dashboard, click Manage Agents
  4. Select the Catalog Agent (or agent configured for merchandizing)
  5. Click Agent Testing in the sidebar to start a conversation
Dashboard > Agents > [Catalog Agent] > Agent Testing

​
Required Permissions

To use the Merchandizing Agent, you need:
  • Access to the Kibo Agent Admin application
  • Product catalog management permissions in your Kibo tenant
  • Appropriate site/locale permissions for the content you want to manage

​
Getting Started

​
Starting a New Session

  1. Navigate to Agent Testing for your Catalog Agent
  2. Configure your session settings:
    • Site: Select the brand/site context for your products
    • Language: Choose your preferred language (default: English)
    • Session Timeout: How long before the session expires (default: 30 minutes)
  3. Type your request in the message box
  4. Press Enter or click Send

​
Session Configuration

SettingDescriptionDefault
Site ContextWhich brand/site’s products to work withPrimary site
Language CodeLanguage for the conversationen (English)
Max Message LengthCharacter limit per message2000
Session TimeoutMinutes before session expires30

​
Your First Request

When you open a product in the Kibo Admin and click the Agentic button, you’ll see the Merchandizing Agent panel with quick action buttons: Merchandizing Agent welcome panel showing quick action buttons You can click one of the quick action buttons or type a custom request. Try a simple request to get started: 
Show me the product details for product code ABC123
The agent will retrieve the product information and display it, allowing you to then request updates.

​
Types of Requests

The Merchandizing Agent understands various types of requests. Here are the main categories:

​
1. Product Information Retrieval

Get details about products in your catalog. Example requests:
  • “Show me the details for product SKU-12345”
  • “What is the current description for the Blue Running Shoes?”
  • “Get the SEO metadata for product ABC123 in English”
  • “List the content for product XYZ in Spanish locale”
Find products using natural language queries. Example requests:
  • “Find all red dresses under $100”
  • “Search for running shoes in size 10”
  • “Show me products with ‘organic’ in the name”
  • “Find winter jackets on sale”

​
3. Content Updates

Update product descriptions and names. Example requests:
  • “Update the short description for product ABC123 to highlight its waterproof feature”
  • “Change the product name for SKU-456 to ‘Premium Leather Wallet’”
  • “Set the full description for product XYZ to describe its eco-friendly materials”
  • “Update the Spanish description for product ABC123”

​
4. SEO Optimization

Manage SEO-related content for products. Navigate to the SEO tab to see current metadata: Product SEO tab showing empty metadata fields Click Optimize SEO metadata to have the agent generate meta titles, descriptions, and keywords: Merchandizing Agent optimizing SEO metadata Example requests:
  • “Update the meta title for product ABC123 to ‘Best Running Shoes 2025’”
  • “Set the meta description to highlight free shipping”
  • “Add keywords ‘sustainable, eco-friendly, organic’ to product XYZ”
  • “Update the URL slug for this product to ‘premium-leather-wallet‘“

​
5. Multi-Locale Management

Manage content across different locales. Click Translate Descriptions to translate product content into other languages supported by your catalog: Merchandizing Agent translating descriptions to German After confirming, the translations are applied to the product in the selected locale: German translations applied to product Example requests:
  • “Show me the French content for product ABC123”
  • “Update the German product description for SKU-456”
  • “Set the Spanish meta description for this product”
  • “Copy the English description to Spanish for product XYZ”

​
Content Generation

​
What Content Can Be Generated?

The Merchandizing Agent can help you create and update:
Content TypeDescriptionCharacter Limits
Product NameThe display name of the productTypically 100-200 chars
Short DescriptionBrief product summary for listingsTypically 150-300 chars
Full DescriptionDetailed product descriptionTypically 1000-5000 chars
Meta TitleSEO page titleRecommended 50-60 chars
Meta DescriptionSEO page descriptionRecommended 150-160 chars
Meta KeywordsSEO keywordsComma-separated list
URL SlugSEO-friendly URL pathLowercase, hyphenated

​
Generating New Descriptions

Click Generate Descriptions or ask the agent to create content based on product attributes. The agent will analyze the product and generate both short and long descriptions: Merchandizing Agent generating product descriptions Example: 
Generate a compelling product description for ABC123 that highlights
its premium materials and lifetime warranty
Example with specific tone: 
Write a fun, casual short description for the Summer Beach Towel
product that appeals to young adults

​
Improving Existing Content

Request improvements to current descriptions: Example: 
Improve the SEO for product ABC123 by updating the meta title
and description to include relevant keywords

​
Locale-Specific Content

Generate content for specific locales: Example: 
Create a French product description for ABC123 based on the
English version but adapted for the French market

​
How Changes Are Applied

​
Immediate Application

When you confirm a content update, changes are applied immediately to your Kibo Commerce catalog. The agent uses the Kibo Product Admin API to update product records directly.

​
Update Flow

1. You request a change
   |
2. Agent retrieves current product data
   |
3. Agent shows you the proposed change
   |
4. You confirm the update
   |
5. Agent applies the change via API
   |
6. Product is updated in Kibo Commerce
   |
7. Agent confirms success

​
What Gets Updated

When you update product content, the following fields may be modified:
FieldAPI FieldNotes
Product NameproductNamePer-locale content
Short DescriptionproductShortDescriptionPer-locale content
Full DescriptionproductFullDescriptionPer-locale content
Meta TitlemetaTagTitlePer-locale SEO
Meta DescriptionmetaTagDescriptionPer-locale SEO
Meta KeywordsmetaTagKeywordsPer-locale SEO
URL SlugseoFriendlyUrlPer-locale SEO

​
Verification

After an update, you can verify the change by:
  1. Asking the agent to show the updated product details
  2. Checking the product in Kibo Admin
  3. Viewing the product on your storefront (may require cache refresh)

​
Example Conversations

​
Example 1: Updating a Product Description

You: Show me the current description for product SHOE-001

Agent: Here's the current content for product SHOE-001:
       Product Name: Running Shoe
       Short Description: A comfortable running shoe
       Full Description: Our running shoe is designed for comfort...
       Locale: en-US

You: Update the short description to "Lightweight running shoe with
     advanced cushioning technology for maximum comfort on long runs"

Agent: I'll update the short description for product SHOE-001.

       Current: "A comfortable running shoe"
       New: "Lightweight running shoe with advanced cushioning
            technology for maximum comfort on long runs"

       [Updating product...]

       Success! The short description has been updated for product
       SHOE-001 in the en-US locale.

​
Example 2: SEO Optimization

You: I need to improve the SEO for product JACKET-002

Agent: Let me get the current SEO content for product JACKET-002.

       Current SEO Content:
       - Meta Title: Winter Jacket
       - Meta Description: (empty)
       - Meta Keywords: (empty)

       Would you like me to suggest improvements?

You: Yes, please suggest better SEO content for this winter jacket

Agent: Based on the product details, here are my suggestions:

       Meta Title: "Premium Waterproof Winter Jacket | Stay Warm & Dry"
       Meta Description: "Shop our insulated winter jacket with
         waterproof shell and thermal lining. Perfect for cold
         weather. Free shipping on orders over $50."
       Meta Keywords: "winter jacket, waterproof jacket, insulated
         jacket, cold weather gear, thermal jacket"

       Would you like me to apply these updates?

You: Yes, apply all of those

Agent: [Updating SEO content...]

       Success! SEO content has been updated for product JACKET-002:
       - Meta Title: Updated
       - Meta Description: Updated
       - Meta Keywords: Updated

​
Example 3: Multi-Locale Content

You: Get the product content for DRESS-003 in Spanish

Agent: Here's the Spanish (es) content for product DRESS-003:

       Product Name: Vestido de Verano
       Short Description: (empty)
       Full Description: (empty)

       The Spanish content appears incomplete. Would you like me
       to help create descriptions?

You: Yes, create a short description based on the English version

Agent: The English short description is: "Elegant summer dress with
       floral print, perfect for beach weddings and garden parties"

       Suggested Spanish translation:
       "Elegante vestido de verano con estampado floral, perfecto
       para bodas en la playa y fiestas en el jardin"

       Would you like me to apply this?

You: Yes, apply it

Agent: [Updating Spanish content...]

       Success! Spanish short description has been updated for
       product DRESS-003.

​
Example 4: Product Search and Bulk Review

You: Find all products in the "Running Shoes" category under $100

Agent: Found 8 products matching your criteria:

       1. SHOE-001 - Lightweight Runner ($79.99)
       2. SHOE-002 - Trail Blazer ($89.99)
       3. SHOE-003 - Speed Elite ($99.99)
       4. SHOE-004 - Daily Jogger ($59.99)
       5. SHOE-005 - Marathon Pro ($94.99)
       ...

       Would you like to see details for any of these products?

You: Show me SHOE-004

Agent: Product Details for SHOE-004:
       Name: Daily Jogger
       Price: $59.99
       Short Description: "Basic running shoe"
       Full Description: "A simple running shoe for everyday use..."

       The descriptions seem basic. Would you like me to suggest
       improvements?

​
Quick Reference

​
Supported Content Fields

FieldCan ReadCan Update
Product NameYesYes
Short DescriptionYesYes
Full DescriptionYesYes
Meta TitleYesYes
Meta DescriptionYesYes
Meta KeywordsYesYes
URL SlugYesYes
Product CodeYesNo
PriceYesNo
ImagesYesNo

​
Common Commands Cheat Sheet

# Get product info
"Show me product [CODE]"
"Get details for [CODE]"
"What is the description for [CODE]?"

# Search products
"Find products with [QUERY]"
"Search for [QUERY] under $[PRICE]"
"Show me [CATEGORY] products"

# Update descriptions
"Update the short description for [CODE] to [NEW TEXT]"
"Change the product name for [CODE] to [NEW NAME]"
"Set the full description for [CODE]"

# SEO updates
"Update the meta title for [CODE] to [NEW TITLE]"
"Set the meta description for [CODE]"
"Add keywords [KEYWORDS] to [CODE]"
"Change the URL slug for [CODE] to [NEW SLUG]"

# Multi-locale
"Show me [CODE] in [LANGUAGE]"
"Update the [LANGUAGE] description for [CODE]"
"Get the SEO content for [CODE] in [LOCALE]"