AI Agents
AI Agents can transform ecommerce operations by enabling intelligent automation.
Emporix Agentic AI introduces AI-powered agents as a new way of working, transforming ecommerce operations by enabling intelligent automation. These agents are designed to take on business processes, simplify operations, and unlock greater efficiency for merchants.
Instead of relying on manual effort for repetitive or time-consuming tasks, involve these intelligent agents to react to events happening in the system and carry out some actions automatically. This approach not only saves time but also creates opportunities to scale business operations without adding complexity.
There are two primary types of agents within the Emporix Agentic AI:
Predefined agents
Ready-to-use solutions provided by Emporix for common ecommerce needs. They are designed to run in the background, seamlessly integrating into business workflows. Emporix offers an AI Agents Library as an expandable catalogue of these prebuilt solutions to make their adoption easier.
Predefined agents
Emporix provides ready-to-use agents for common ecommerce scenarios — for example, complaint handling, fraud detection, customer support, translations, and storefront guidance. Browse the AI Agents Library to see available templates and learn how to enable them in your tenant.
When you create an agent from a library template, a read-only Template Prompt field shows the predefined workflow. You can use it as a reference when building your own custom agents.
Custom AI Agents
Example use cases where custom agents come in handy:
Connecting through a managed provider or AI gateway – Custom agents can be configured to use your own enterprise provider setup, including the AI gateway, for GDPR-compliant production environments. This allows you to use enterprise-approved model access without sending traffic directly to a public provider endpoint.
Integrating with external business systems – Agents can be granted access to external MCP servers to securely interact with systems like ERP (Enterprise Resource Planning), CRM (Customer Relationship Management), or other specialized services. This enables agents to:
Fetch product availability directly from an ERP system.
Process purchase orders by communicating with your ERP system.
Managing credentials for third-party services – Custom agents can manage credentials for various other third-party services or integrations, ensuring secure communication and automation across your entire digital landscape.
Custom agents don’t have to work in isolation. The platform allows you to create multiple agents and connect them, enabling them to operate as a team. This teamwork approach is especially powerful when solving complex business goals that require multiple steps or domain-specific expertise.
The example custom agents chain might look as follows:
One agent fetches product data from an ERP system.
A second agent analyzes that data for compliance or profitability.
A third agent updates the ecommerce catalog accordingly.
Working together, the agents form a coordinated workflow that is more effective than any single agent working on its own.
The Custom Agents feature makes Emporix not just a platform with AI capabilities, but a truly extensible agentic ecosystem. By combining predefined agents with custom-built ones, merchants can automate, adapt, and innovate with precision — building agent teams that reflect the way your business really works.
Creating a custom agent
Prerequisites
Before starting the agent creation process, prepare what the agent is supposed to use:
Follow these steps to create and configure a custom AI agent for specific tasks.
Provide agent details
In the General tab, configure the agent's identity and capabilities:
ID – The unique identifier of the agent. This ID is critical, as it is used whenever the agent is triggered through an API endpoint.
Agent Name – A human-readable display name for the agent.
Description – A text field where you can describe the agent’s purpose and what tasks it is designed to handle.
User Prompt – The core of your agent’s intelligence. Define how the agent should operate.
User Prompt
A well-written and designed prompt guides the agent’s reasoning, behavior, and tone. We recommend the prompt engineering best practices to ensure your agent performs consistently and effectively.

Define the response output
Use Output Format when you want the agent to return a fixed set of fields or objects, respond with structured JSON instead of natural language, or provide data that can be passed directly to another service or frontend component.
When a schema is provided, the agent is guided to return responses in the specified contract-like format instead of free-form text. This is especially useful when the response is consumed by applications, workflows, or other systems that require predictable, machine-readable data:
Enforces a consistent response structure
Reduces parsing errors in downstream systems
Makes agent responses easier to use in automations and UI components
Improves reliability for integrations with business applications
You can define JSON schema on your own or use the Generate JSON Schema option. This triggers a one-time prompt to enable the helper agent, which creates a valid JSON Schema definition based on your natural-language requirements.
Enabling the helper agent — the Agentic JSON Schema Assistant — is a one-off operation. Once enabled, the agent remains available in the Agents Library.

Provide natural-language instructions on what you expect in the response.

The agent transforms the requirements into a valid JSON schema.

Configure AI model
Each agent can be powered by a different language model (LLM). This gives you the flexibility to choose the best option for your specific use case. The Model tab includes configuration of the following options:
Provider – Choose the provider that powers the agent:
Emporix OpenAI – For testing purposes only. This option lets you get started quickly without creating an external account.
The Emporix OpenAI must not be used for production. For production, use your own enterprise license or custom model to remain GDPR compliant. Note that there is a limited number of tokens available per tenant: * input tokens: 2 000 000 * output tokens: 500 000
Anthropic
Google
OpenAI
Self-hosted Ollama
Self-hosted vLLM
Token – Select a previously configured token (from the AI Tokens view) to be used for communication with the LLM provider.
Models – Each LLM provider offers multiple models (for instance, OpenAI GPT-4, Claude Sonnet 4.5, Gemini 2.5 Flash, and more). Specify the model you want to use with your agent. You can choose between Standard models offered by the LLM providers or add a Custom model identifier as supported by your provider.
Max Tokens – Set the maximum length of responses the agent can generate, based on the particular model's specification and your use case.
Enable Memory – Toggle the memory option on if you want the agent to keep the conversational data within the session. It is useful for chatbots or collaboration agents that need to remember previous queries and answers to be able to make logical references and adequate data matching. The memory is kept within one
session-id.Temperature – Define the level of randomness and creativity of your agent. Values range from
0.0to1.0.Lower values (for example,
0.1) → More predictable, rule-following outputs.Higher values (for example,
0.8) → More creative, useful for tasks like product description generation.
Recursion Limit – Define how many iterations the agent is allowed to perform before it stops the execution. This parameter prevents infinite loops and ensures safety and stability of the agent.
Self-hosted URL – (For self-hosted models only) Enter the URL of the chosen model.
Base Provider – (For self-hosted models only; optional) Select the cloud LLM provider that the self-hosted API endpoint is compatible with. Possible options are
OPENAI,GOOGLE, andANTHROPIC.Authorization Header Name – (For self-hosted models only; optional) Enter the authorization header name if you want to restrict LLM access.
Authorization Token – (For self-hosted models only; optional) Enter the authorization token corresponding to the authorization header name if you want to restrict LLM access.
For self-hosted AI models, you can enable OAuth authentication to protect the data and meet security standards. Toggle on Use OAuth authentication and select the relevant OAuth configuration. For configuration details, see AI OAuth-Based Gateway.

Define activation rules
In the Trigger & Constraints tab, define when and how the agent is triggered.
Required scopes – Optional. Restrict which users or integrations can trigger the agent by selecting one or more scopes. If you leave this empty, no scope-based restriction is applied.
Anonymous – Anyone can trigger the agent; no scope is required.
Customer – A user requires the
ai-execution_manage_ownscope to invoke the agent.Employee – A user requires the
ai-execution_managescope to invoke the agent.Integration – An external integration, such as an ERP or CRM system, requires the
ai-execution_managescope to trigger the agent.
Trigger Type – Define how the agent is activated:
API – Call the Emporix endpoints to trigger the agent. This is useful when you want to start an agent with specific content or data passed through an API invocation. You can also use this option to include the agent in a Value Stream.
Commerce Event – Make the agent listen to specific commerce-related events happening in the system (for example,
order-created) and act immediately when those events occur. Select the ones to act upon from the available commerce events list.Slack – This option is available only when creating or configuring a Support Agent instance from the library, not for custom agents created from scratch.

Optional: Define constraints for commerce event triggers
Complete this step only when Commerce Event is selected as the trigger type in the previous step.
The Commerce Event trigger type allows you to define specific rules for when the agent should act. You can constrain the agent to specific conditions occurring in the system.
You can combine several conditions using
ANDorORoperators.Add a condition manually by specifying a relevant payload path and its value. Select the appropriate operator to define the value. The conditions you build are immediately reflected in the JSON output.
For your convenience, you can choose Generate Condition – this option helps you enable the Agentic Filters Creator Assistant. Prompt the agent in natural language to create a set of conditions for you. If the conditions are more complex, only the JSON output is visible.


Review the conditions, modify the JSON directly if needed, and choose Apply to save the constraints.
Attach tools
The agent can be equipped with additional tools it can use in the background to retrieve and process information, or to access different resources within or outside the system.
In the Tools tab, select the tools required to enable the agent to execute its tasks:
Select built-in domain tools (for example, product, order, or customer). For more information about Emporix MCP domains, see the Emporix MCP Server.
Native Tools – Extend the agent with additional capabilities, such as Slack integration or RAG capabilities (including Product, Order, or custom-entity RAG). For example, the agent can use the Slack tool to collaborate with humans in context-aware Slack channels, or an Orders RAG tool for semantic order search. Prepare tools upfront in the AI Tools view.
Custom MCP – Add external servers configured by yourself (for example, ERP or CRM). Define custom MCP in the AI MCP view before you attach them to your agent.

Configure agent collaboration
The agent might need assistance from other agents to correctly and smoothly process information, or to hand over its task to another agent when its job is complete. Connect one or multiple agents together, allowing them to operate as a team. In the Prompt, define when and how the agent hands over an action to another agent. You can attach as many agents as you need to create multi-step, collaborative workflows.

Last updated
Was this helpful?


