Skip to main content
The Order Routing Agent is an AI-powered assistant that helps users understand order routing decisions, providing transparency into why orders were assigned to specific fulfillment locations and how routing logic was applied.

Overview

What is the Order Routing Agent?

The Order Routing Agent (also known as OR-Explain Agent) is a conversational AI assistant designed to help business users understand order routing decisions. Routing setups for Kibo clients can be complex with multiple business rules and pathways evaluated before Order Routing recommends the optimal fulfillment location(s). Instead of manually reviewing logs and configuration, you can simply ask questions in plain English, and the agent will:
  • Explain why an order was assigned to a specific fulfillment location
  • Show which routing rules were triggered for an order
  • Identify alternative locations that were considered and why they were rejected
  • Clarify why orders were split into multiple shipments
  • Provide audit trails of routing decisions
By asking questions, users can gain a comprehensive understanding of the “why” behind each routing decision, identify areas for improvement, troubleshoot issues, and ultimately build trust in the automated order routing system. Providing clear, auditable answers to these questions is key for any robust order routing solution. Order Routing Agent explaining routing criteria for an order

Accessing the Order Routing Agent

Where to Find It

The Order Routing 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 Order Routing Agent (or agent configured for OR explanations)
  5. Click Agentic in the sidebar to start a conversation

Required Permissions

To use the Order Routing Agent, you need:
  • Access to the Kibo Agent Admin application
  • Order management permissions in your Kibo tenant
  • Access to order routing logs and suggestion data

Getting Started

Starting a New Session

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

Session Configuration

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

Your First Question

Try a simple question to get started:
Why was shipment #12345 assigned to the Dallas warehouse?
The agent will retrieve the routing decision log and explain the factors that led to that fulfillment location being selected. The agent breaks down the routing decision into clear steps: the initial request, inventory check, location prioritization, and final assignment with the reasoning behind each.

Types of Questions

The Order Routing Agent understands various types of questions. Here are the main categories:

1. Order Assignment and Location Questions

Understand why orders were assigned to specific fulfillment locations. Example questions:
  • “Why was shipment #12345 assigned to the Dallas warehouse?”
  • “Why did this order go to Dallas instead of Houston?”
  • “What location was selected for order ORD-98765?”
  • “Which warehouse is fulfilling shipment SHP-11111?”
Follow-up questions:
  • “What criteria determined the primary fulfillment location?”
  • “Was proximity to the customer a factor?”
  • “How did inventory availability influence this decision?“

2. Alternative Location Questions

Learn why other fulfillment options were not selected. Example questions:
  • “Were there alternative locations considered for this order?”
  • “Why wasn’t the Chicago warehouse chosen for shipment #12345?”
  • “What other options were evaluated before selecting Dallas?”
  • “Why was Houston rejected as a fulfillment location?”
Follow-up questions:
  • “What were the rejection reasons for each alternative?”
  • “Was any location out of stock?”
  • “Were there capacity constraints at other locations?“

3. Routing Logic and Rules Questions

Understand which business rules influenced the routing decision. Example questions:
  • “What routing rules were applied to this order?”
  • “Which rule triggered the split of this order into two shipments?”
  • “What was the sequence of rules evaluated for order ORD-98765?”
  • “Were any custom rules applied to this shipment?”
Follow-up questions:
  • “Can you show me the decision path for this order?”
  • “What data inputs were considered at each step?”
  • “Were there any rule conflicts?“

4. Order Splitting Questions

Understand why orders were divided into multiple shipments. Example questions:
  • “Why was this order split into multiple shipments?”
  • “What caused order ORD-98765 to be split into three packages?”
  • “Why are these items shipping separately?”
  • “What criteria determined the shipment groupings?”
Follow-up questions:
  • “Were items in different warehouses?”
  • “Did product type affect the split?”
  • “Were shipping speed requirements a factor?“

5. Consolidation Questions

Learn why items were grouped together. Example questions:
  • “Why were these items consolidated into a single shipment?”
  • “What criteria allowed these products to ship together?”
  • “Could this shipment have been consolidated with others?”
Follow-up questions:
  • “Were all items at the same fulfillment location?”
  • “Did they share the same shipping method?”
  • “Was there a consolidation rule applied?“

6. Troubleshooting Questions

Investigate routing errors or unexpected behavior. Example questions:
  • “Why did this order encounter a routing error?”
  • “What caused the routing delay for shipment #12345?”
  • “Why was no fulfillment location found for this order?”
  • “What exception occurred during routing?”
Follow-up questions:
  • “What was the specific error message?”
  • “How can this issue be resolved?”
  • “Were there system issues at the time of routing?“

7. Audit and Data Questions

Access detailed logs and audit trails. Example questions:
  • “Show me the audit trail for order ORD-98765”
  • “What data inputs were used for this routing decision?”
  • “Can I see the detailed log for this shipment?”
  • “What timestamps are recorded for this routing process?”

Data Sources

Suggestion Log

The primary data source for routing explanations is the Suggestion Log, which captures:
  • All routing decisions made by the system
  • Rules evaluated and their outcomes
  • Alternative locations considered
  • Rejection reasons for non-selected options
  • Timestamps for each step in the process

Supported Identifiers

Identifier TypeFormat ExampleUsage
Order NumberORD-12345, #12345Full order queries
Shipment NumberSHP-12345, Shipment #12345Specific shipment queries
Customer IDCUST-789All orders for a customer
Location CodeDAL, HOU, CHILocation-specific queries