Documentation Index
Fetch the complete documentation index at: https://docs.kibocommerce.com/llms.txt
Use this file to discover all available pages before exploring further.
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
- Overview
- Accessing the Merchandizing Agent
- Getting Started
- Types of Requests
- Content Generation
- How Changes Are Applied
- Best Practices
- Example Conversations
- 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
| Benefit | Description |
|---|
| Speed | Update product content in seconds instead of minutes |
| Consistency | Generate descriptions that follow your brand voice |
| Multi-locale | Manage content across different languages and regions |
| SEO Optimization | Create search-engine-friendly titles, descriptions, and keywords |
| Natural Language | No 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:
- Navigate to your Kibo Agent Admin URL (provided by your administrator)
- Log in with your credentials
- From the Dashboard, click Manage Agents
- Select the Catalog Agent (or agent configured for merchandizing)
- Click Agent Testing in the sidebar to start a conversation
Navigation Path
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
- Navigate to Agent Testing for your Catalog Agent
- 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)
- Type your request in the message box
- Press Enter or click Send
Session Configuration
| Setting | Description | Default |
|---|
| Site Context | Which brand/site’s products to work with | Primary site |
| Language Code | Language for the conversation | en (English) |
| Max Message Length | Character limit per message | 2000 |
| Session Timeout | Minutes before session expires | 30 |
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:
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
Types of Requests
The Merchandizing Agent understands various types of requests. Here are the main categories:
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”
2. Product Search
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:
Click Optimize SEO metadata to have the agent generate meta titles, descriptions, and keywords:
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:
After confirming, the translations are applied to the product in the selected locale:
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 Type | Description | Character Limits |
|---|
| Product Name | The display name of the product | Typically 100-200 chars |
| Short Description | Brief product summary for listings | Typically 150-300 chars |
| Full Description | Detailed product description | Typically 1000-5000 chars |
| Meta Title | SEO page title | Recommended 50-60 chars |
| Meta Description | SEO page description | Recommended 150-160 chars |
| Meta Keywords | SEO keywords | Comma-separated list |
| URL Slug | SEO-friendly URL path | Lowercase, 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:
Example:
Generate a compelling product description for ABC123 that highlights
its premium materials and lifetime warranty
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
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:
| Field | API Field | Notes |
|---|
| Product Name | productName | Per-locale content |
| Short Description | productShortDescription | Per-locale content |
| Full Description | productFullDescription | Per-locale content |
| Meta Title | metaTagTitle | Per-locale SEO |
| Meta Description | metaTagDescription | Per-locale SEO |
| Meta Keywords | metaTagKeywords | Per-locale SEO |
| URL Slug | seoFriendlyUrl | Per-locale SEO |
Verification
After an update, you can verify the change by:
- Asking the agent to show the updated product details
- Checking the product in Kibo Admin
- 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
| Field | Can Read | Can Update |
|---|
| Product Name | Yes | Yes |
| Short Description | Yes | Yes |
| Full Description | Yes | Yes |
| Meta Title | Yes | Yes |
| Meta Description | Yes | Yes |
| Meta Keywords | Yes | Yes |
| URL Slug | Yes | Yes |
| Product Code | Yes | No |
| Price | Yes | No |
| Images | Yes | No |
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]"
