Ask

Sends a question to Answer Server and returns appropriate answers.

You specify the question in plain text in the Text parameter.

Answer Server parses the question, and attempts to retrieve associated answers from all your configured answer systems (fact banks and answer banks). If you have multiple systems configured, Answer Server finds any available answers in all of them. You can optionally set the SystemNames parameter to specify the configured systems to attempt to retrieve answers from.

Example

http://12.3.4.56:12000/action=Ask&Text=What is the largest city in Norway?

This action requests an answer to the question What is the largest city in Norway.

Required Parameters

The following action parameters are required.

Parameter Description
Text The plain text question that you want to answer.

Optional Parameters

This action accepts the following optional parameters.

Parameter Description
Context A question context ID to use to limit the scope of the question.
CustomizationData A JSON object that specifies additional information to use in the query.
FirstResult The number of the first result to return.
MaxResults The maximum number of answers to return.
MinScore The minimum score that an answer can have
Sort The method to use to sort the answers.
SystemNames The systems and system groups that you want to request answers from.
Timeout The maximum length of time to process the action for.
TotalResults Whether to return the total number of available answers.

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.