Agents

An agents rule provides configuration information for the agents listed in the rule, including the trigger or wake-up interval or schedule, the activities that the agents execute, and the way that the agent queue is handled. Each agent in the list performs one request (for example, sending generated correspondence or processing assignments) by running the associated agent activity.

The name of an agents rule is the name of a ruleset, and there can be only one agents rule defined for each ruleset and version in a Pega 7 Platform system. When the Agent Manager master agent notices a newly added agents rule, it generates agent schedule data instances for each node in your Pega 7 Platform application.

Note: Rule-Agent-Queue instances can be created in tenants. However, tenant-specific agents should not be created.

Access

Use the Records Explorer to list all the agents rules that are available to you by selecting SysAdmin > Agents. The list includes the standard agents rules. You cannot add background processing activities to the standard agents; instead, create new agents rules that run your agent activities.

Category

Agents rules are instances of the Rule-Agent-Queue class. They are part of the SysAdmin category.

Agent implementation

Agents are implemented through two facilities:

• Agents rules — instances of Rule-Agent-Queue that specify the agents defined for one ruleset, the activity that each agent runs, how the agent handles the queue, and the interval at which the agent runs.

• Agent schedule data instances — instances of Data-Agent-Queue that determine whether an agent runs.

When you need to modify the behavior of an agent listed in an agents rule in a locked ruleset (for example, any of the standard Pega 7 Platform agents rules), edit one or more of the generated agent schedule data instances.

Standard agents

The Pega 7 Platform includes the following standard agents rules, which cannot be modified.

Note: Additional standard agents might be present if you have add-on features or components installed.

Agents rule	Purpose
Pega-AutoTest	Run test suites periodically. See Pega-AutoTest agents and Unit Test Suites.
Pega-DecisionEngine	Perform periodic computations to evolve adaptive models, defined through Adaptive Model rules. See Pega-DecisionEngine agents.
Pega-EndUserUI	Perform periodic purging of tags from database table pr_data_tag that are tags defined in the system but not used in the tag cloud. See Pega-EndUserUI agent.
Pega-ImportExport	Supports the Purge/Archive wizard and support certain one-time post-upgrade processing. See Pega-ImportExport agent.
Pega-IntSvcs	Process queued service requests. See Pega-IntSvcs agents.
Pega-ProcessEngine	Supports calculations defined in case type rules. See More about Case Type rules and Pega-ProcessEngine agent.
Pega-ProCom	Process email, service-level agreements and assignments, and so on. See Pega-ProCom agents.
Pega-RuleRefactoring	Support the Ruleset Maintenance wizard for queued tasks such as copying, moving, merging, and renaming rulesets. See Pega-RuleRefactoring agent.
Pega-RULES	Perform general system housecleaning and periodic system pulse processing. See Pega-RULES agents.
Pega-RulesEngine	Support event processing, the Property Optimization tool, and report statistics. See Pega-RulesEngine agent.
Pega-SecurityVA	Obsolete. Do not enable this agent.

‘Master agents

Master agents are background processes operating on each Pega 7 Platform node that are not defined by agents rules.

Master-for-Requestors

The Master-for-Requestors master agent monitors idle requestor sessions to enforce automatic timeouts.

By default, this operation occurs every 60 seconds. This value can be updated in the prconfig.xml file setting:

where NNN is in seconds.

Master-for-Agent

The Manager-for-Agent (also known as the Agent Master) master agent starts and monitors agents defined through agents rules and agent schedule data instances.

By default, this operation occurs every 10 minutes. This value can be updated in the prconfig.xml file setting:

where NNN is in seconds.

‘=