Allows you to retrain an agent. When you use AgentRetrain, IDOL Community Component scales down the weights of existing terms for the agent and then adds the new training.

You can also use the AgentEdit action to update the training. In this case, IDOL Community Component does not change the weights of existing terms. With AgentEdit, you can also optionally delete the existing training and retrain with the new training content.


This action uses port 9000 to retrain the Administrator user's Global Warming agent with the documents that have the IDs 534, 352 and 4534. The retraining documents are stored in IDOL Community Component, which is situated on a machine with the IP address


Parameter Description Required
AgentName The name of the agent to retrain. see Comments
AID The agent ID of the agent to retrain. see Comments
DREQueryParameter Add TermGetBest action parameters.  
EmailAddress The e-mail address of the user.  
FieldFieldName A field for the new agent.  
InputEncoding The encoding of the AgentName and UserName values.  
Mode The type of value listed in the PositiveDocs parameter.  
NegativeDocs The documents used to negatively train the agent.  
OutputEncoding Converts the encoding of the text that the action returns.  
PositiveDocs The documents to use as training for the agent.  
Security A field for the user to store the user’s security details.  
UID The ID of the user that the agent belongs to. see Comments
UserName The username of the user that the agent belongs to. see Comments

This action accepts the following standard ACI action parameters:

Parameter Description
ActionID A string to use to identify an ACI action.
EncryptResponse - Deprecated Encrypt the output.
FileName The file to write output to.
ForceTemplateRefresh Forces the server to load the template from disk.
Output Writes output to a file.
ResponseFormat The format of the action output.
Template The template to use for the action output.
TemplateParamCSVs A list of variables to use for the specified template.


You must set one of the following parameter combinations: