For the complete documentation index, see llms.txt. This page is also available as Markdown.

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

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:

  1. One agent fetches product data from an ERP system.

  2. A second agent analyzes that data for compliance or profitability.

  3. 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.

1

Choose to create an agent

In the Management Dashboard, go to the Agentic AI -> AI Agents. Choose Add new agent to start creating. Each field in the configuration is important to ensure that the agent behaves as expected and integrates seamlessly into your workflows.

2

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.

Creating custom agent
Creating custom agent
3

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.

Enabling the helper agent for generating a JSON schema response

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

Generating output format schema
Generating output format schema

The agent transforms the requirements into a valid JSON schema.

Output format schema
JSON schema definition of the agent's response
4

Define the agent visibility

To improve the agent's visibility and searchability among other agents, you can add:

  • Tags – Choose one or more tags that fit the agent's functionality.

  • Icon – Select an icon associated with the agent.

Agent tags and icon
Agent tags and icon
5

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.

    • 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.0 to 1.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, and ANTHROPIC.

  • 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.

Configuring LLM model for custom agent
Configuring LLM model for custom agent
6

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_own scope to invoke the agent.

    • Employee – A user requires the ai-execution_manage scope to invoke the agent.

    • Integration – An external integration, such as an ERP or CRM system, requires the ai-execution_manage scope 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.

Configuring trigger for custom agent
Configuring trigger for custom agent
7

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 AND or OR operators.

  • 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.

Configuring trigger constraints for custom agent
Configuring trigger constraints for custom agent
JSON representation of complex constraints for custom agent
JSON representation of complex constraints for custom agent

Review the conditions, modify the JSON directly if needed, and choose Apply to save the constraints.

8

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.

Attaching AI tools to custom agent
Attaching AI tools to custom agent
9

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.

Connecting collaboration agents
Connecting collaboration agents
10

Save the agent

Once ready, confirm your agent definition with Save.

As a result, the agent is available on the My Agents list.

Last updated

Was this helpful?