Allows you to edit agent details.

You can use AgentEdit to modify agent fields or training. If you add new training by using AgentEdit to retrain the agent, IDOL Community Component adds the new terms and weights without adjusting the existing training. You can also retrain the agent with the AgentRetrain action, in which case IDOL Community Component scales down the weights of existing terms for the agent and then adds the new training.


This action uses port 9000 to change the training of the Administrator user's Global Warming agent to More Factors affecting global warming. The action also changes the value of the Color field (which is associated with the agent) to green. The IDOL Community Component that contains the agent is situated on a machine with the IP address


Parameter Description Required
AddSetToReadDocuments Whether to add agent results to the list of recently viewed documents.  
AgentName The name of the agent to edit. see Comments
AID The agent ID of the agent to edit. see Comments
AppendTrainingText Whether to append the new training text to the existing text.  
BooleanRestriction A Boolean restriction for the agent.  
ClearTraining Removes the agent’s training.  
DeferLogin Use another system for user authentication.  
DREQueryParameter Add TermGetBest or TermGetInfo action parameters.  
EmailAddress The e-mail address of the user.  
ExcludeReadDocuments Whether to exclude read documents from results returned to the user.  
FieldFieldName A field for the new agent.  
FieldTextRestriction A FieldText restriction for the agent.  
InputEncoding The encoding of the AgentName, Training and UserName values.  
Mode The type of value listed in the PositiveDocs parameter.  
NewAgentName The agent’s new name.  
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.  
TermTerm Sets the weight of a term in the agent’s training.  
Training Text to train the agent.  
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: