About
Once you've configured an agent with a desired trigger and actions, you can activate or run the agent. This article will guide you through the process of activating or running a Kaltura agent, depending on the type of trigger your chose for your workflow.
- Agents with automatic triggers (for example, when media is uploaded or when media enters a category) need to be activated. Once activated, they run automatically whenever the trigger condition is met.
- Agents with the run on-demand trigger must be started manually each time you want them to run.
Looking for more information about this feature? Feel free to contact your Kaltura representative.
Before you start
- Your account must have Agents enabled
- If you want to use REACH-based actions (such as captions, moderation, audio description, summary & chapters and metadata enrichment), your account must have an active REACH profile and be configured with the relevant catalog item(s).
Access the Agents screen
In the KMC, select Agents from the top navigation bar.

The AI Agents screen displays. The agents you've created are listed below the Create new agent button.

Activate an agent with an automatic trigger
For agents with automatic triggers, such as when media is uploaded or when media enters a category:
- Click on the agent you would like to activate.
- Click the Activate button at the top.
- Click Activate to confirm.

The agent page displays with the Overview tab open.


A confirmation dialog appears with details about when the agent will run and how to monitor it.

Once activated:
- When media is uploaded, the agent runs automatically every time an entry finishes processing and reaches 'Ready' status.
- When media enters a category, the agent runs automatically every time an entry is added to the selected category.
After activation, the Activate button in the Overview tab updates to Deactivate (red), showing that the agent is currently active. You can click this button at any time to deactivate the agent.

Run an agent with an on-demand trigger
For agents with the run on-demand trigger:
- Access the agents screen and click on the agent you would like to run. The agent page displays with the Overview tab open.
- Click the Run button at the top.
- Select one or more entries by checking the boxes.
- Click Run now at the bottom right to start the agent (the Run now button becomes active once at least one entry is selected).
The media selection page displays showing entries you have permission to run the agent on.
Only video and audio entries are supported.

You can use filters or the search bar to find entries.

After running, you return to the Activity tab, where you can monitor the agent’s progress.
On-demand agents don’t need to be activated or deactivated. The Run button always stays enabled, so you can run the agent again whenever you choose.

To learn about monitoring your agents, check out our article Monitor agent activity.
Kaltura does not use customer data to train its AI models. To learn more, see Kaltura's Artificial Intelligence Principles.