Agent Configuration

Modified on Tue, 26 May at 12:32 PM

AI Agents are configured in a guided process so you can define where they run, which items they affect, and what action they perform.


All agents are created in four steps. In the Actions step, you choose the type of action or agent you want to use.


Creation


To create your first agent:

  1. Open Agents from the left-hand menu.
  2. Click New Agent or Create Agent.



Step 1: Trigger


In the Trigger tab, choose the table where the agent will work. The available options are:

  • Products
  • Categories
  • Variants
  • Custom Entities


Then choose when the agent should run.



After selecting the table where the agent will work, you can choose the agent’s type of execution.


The available options are:

  • Manual: the agent only runs when you start it manually from the agent menu.
  • Run on Changes: the agent runs automatically when a compatible item is created.



The Run on Changes option is useful when you want the agent to act without having to run it manually. Instead of waiting for a scheduled execution or starting the process from the dashboard, Sales Layer detects the creation of the item and runs the agent in the background.


This helps automate repetitive tasks, keep workflows more up to date, and reduce manual intervention. Because the process only runs when a compatible change happens, resources are used only when needed.


i

Note: For the Run on Changes option to be available, the feature must be enabled separately.

!

Important: Currently, Run on Changes is only available for items in the Products table and only runs when new items are created. Events are generated when products are created manually, through manual CSV or Excel import, or through import channels using PHP API. At the moment, the creation operation from API 2.0 does not generate this event.


Step 2: Conditions


In the Conditions tab, choose which items the agent should act on.


You can define this selection based on the current state of items in the PIM. You can also add more filters by clicking Add filter.



At the moment, only one status can be selected at a time. If you need the agent to act on multiple statuses, you must create an additional agent and configure it separately.


You can also filter items using the fields available in the form for that table. For example, you could create a filter so the agent only works with items that contain a specific tag.



In this example, the agent has been filtered to work only with items that contain the tag demo.



Step 3: Actions


In the Actions tab, click Add action and choose the type of action you want the agent to perform.


The available options are:

  • Translation agent
  • Text enhancement agent
  • Content creation agent
  • Smart business rules agent



Step 4: Details and summary


In the final step, enter:

  • A name for the agent
  • A short description so it is easy to identify later in the dashboard



You can also enable the option to review changes before applying them to production. This is recommended if you want to check the results before confirming them.



Once the configuration is complete, review the summary and click Create Agent.



The agent will then appear in the control panel, where you can activate or deactivate it.



At the moment, because only manual execution is available, activating the agent does not run it automatically. It simply makes the agent available for manual use.


Glossary settings for translations


If you want to define specific terms before running a translation agent, you can create a glossary.


To do this:

  1. Open the menu in the upper-right corner.
  2. Go to Settings.
  3. Open Glossary.
  4. Select the languages.
  5. Add terms using Add term.
  6. Click Save.


This glossary will help control how certain words are translated.



Agent activation


To run an agent manually:

  1. Open the menu for the agent.
  2. Select Run.



The process will start immediately.


You can track its progress in the Agent processes section. 



This area shows both active and completed processes.



There are three possible statuses:

  • Running: the process is currently in progress.
  • To review: the review option was enabled, so changes must be checked before they are applied.
  • Completed: the process has finished.



Review


If the agent was configured to require review, you can check its results before applying them.


To review changes:

  1. Go back to the control panel.
  2. Click Review changes on the agent.



In this section, you can see the changes made by the agent according to the selected configuration.



You can:

  • Approve changes one by one



  • Discard changes one by one
  • Select multiple items and approve or discard them in bulk



To process several items at once, tick their checkboxes and choose the action from the top menu.


You can also open the details on the right side to verify the prompt and glossary used during translation.




You can also edit the result manually. To do this, click directly on the highlighted result in the New Value column. A pop-up window will open where you can edit the text before saving and applying the change.




Once the result is correct, you can accept individual changes from the row actions or apply the reviewed changes by clicking on Apply changes.



Before confirming, the system will show a message indicating:

  • How many items will be modified
  • How many items will remain unchanged if some changes were discarded



After applying the changes, the status in Agent processes will change to Completed.



After the changes are applied, you can also track which agent performed the action from the product item. To do this, open the product and use the Show editors option. If the change was made by an AI agent, the agent will appear in the editing history as the source of the action.



i

Note: Credits are calculated based on the number of processed attributes. This means processed changes count toward credit consumption even if you later discard them during review.


Credit consumption


To check credit usage:

  1. Open Usage & Billing.
  2. Review consumption by agent and date.


If you have more than one agent, you can use the filter in the upper-right corner to filter the data by month and by agent.


Your available credit balance appears in the lower-left corner.




Specifications


  • A credit is the basic unit of service consumption.
  • 1 credit = 100 attributes processed in items by an AI agent in a single execution.
  • Credits are sold in prepaid packages.
  • Additional packages can be purchased at any time.
  • Credits expire annually.
  • To run an AI agent process, you must have enough available credits.
  • If you do not have sufficient credits, the system will notify you before the process starts.
  • The feature needs to be linked to the client’s own OpenAI account.
  • To test the functionality, Sales Layer offers an initial package of 500 credits connected to Sales Layer’s OpenAI setup.
  • To activate the feature on your account, contact Support or your Customer Success Manager.
  • If you already have your own OpenAI account, you can test it by entering your credentials in Settings.



Best practices


When creating your first agents, start with a narrow set of conditions so you can confirm the output is correct before using broader filters. It is also a good idea to enable the review option during your first tests, especially when the agent will modify important catalog content.

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article