ManageResources

Updates resources in an answer bank or conversation system.

For an answer bank system, you can use this action to add, modify, and delete questions and question equivalence classes. You can also use it to add and update the state of a question.

For a conversation system, you can use this action to add and delete conversation sessions.

You can also use this action to add and delete question contexts. A context is an entity that limits the scope of a question. For example, you might define a context to specify that a user is asking questions about Cambridge, UK, rather than Cambridge, Massachusetts or Ontario. In this case, ManageResources returns an ID that you can use in subsequent Ask actions.

NOTE:

Conversation sessions and question contexts use licensed conversation slots. ManageResources returns an error if you do not have enough capacity. In this case, you must wait until a conversation session or question context expires, or delete one before you can create another.

This action requires a JSON object that specifies the update to request, and most updates also require a system name. You can use the GetResources action to retrieve the JSON schemas that you need to use to make each kind of update.

You update the system by sending a POST request with the JSON update.

For more information, refer to the Answer Server Administration Guide.

NOTE:

You must use a POST request method.

Examples

action=ManageResources&SystemName=MyAnswerBank
Data={
   "operation": "add",
   "type":"question",
   "questions":[
      {"text":"Where do I sign up for the monthly newsletter?"}
   ]
}

This action adds the question Where do I sign up for the monthly newsletter? to the MyAnswerBank system.

action=ManageResources&SystemName=MyConversation
Data={
   "operation": "add",
   "type":"conversation_session"
}

This action adds a conversation session to the MyConversation system.

action=ManageResources
Data={ "type": "context", "operation": "add", "context": [{ "system_name": "factbank1", "data": [{ "code_type": "entity", "name": "Cambridge", "codes": ["Q350"] }] }] }

This action creates a context to use with Ask actions.

Required Parameters

The following action parameters are required.

Parameter Description
Data A JSON object that describes the update that you want to make.

Depending on the type of update that you want to make, the following action parameter might also be required.

Parameter Description
SystemName The name of the system that you want to update.

Optional Parameters

This action accepts the following standard ACI action parameters.

Parameter Description
ActionID A string to use to identify an ACI action.
EncryptResponse 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.

Response

You can retrieve the full response XSD by sending the GetResources action with Type set to XSD.


_FT_HTML5_bannerTitle.htm