Open topic with navigation

# CategoryFindRelevantSentences

Return the most relevant sentences in a document, a file, or a piece of text, based on training about which documents are relevant and which are irrelevant.

In most cases, you train two categories (one with relevant data and one with irrelevant data), and build the categories by using the CategoryBuild action with the Relevance parameter. If you create only one Relevance category, `CategoryFindRelevantSentences` returns all sentences. If you create more than two categories, you must use the RelevantCat parameter for the CategorySetDetails action to mark one of the categories as the relevant category, and all other categories are treated as irrelevant. The `CategoryFindRelevantSentences` action requires one of the child categories to be set as the RelevantCat.

Like Simple categories, you create groups of Relevance categories by creating them under different parent categories. When you send the `CategoryFindRelevantSentences` action, you must specify the parent ID to determine which set of Relevance categories to use.

You can specify secure documents for this action. Use the SecurityInfo parameter to specify the security string to use.

NOTE:

This is an administrative action that can be sent only by users that belong to an authorization role that allows the `Admin` standard role, or which enables the action explicitly. See Authorization Roles Configuration Parameters.

## Example

    http://12.3.4.56:9000/action=CategoryFindRelevantSentences&Parent=123&DocID=456

This action uses port `9000` to instruct IDOL Server, which is located on a machine with the IP address `12.3.4.56`, to find relevant sentences within the document with the ID `456`, based on the relevance categories contained within the parent category `123`.

## Parameters

Parameter | Description | Required
--- | --- | ---
DatabaseMatch | Databases where documents are stored from which relevant sentences are found. |
DocID | The document IDs of documents to find relevant sentences in. | See Comments
DocRef | The references of documents to find relevant sentences in. | See Comments
Language | The language of the query text. |
NumResults | The number of relevant sentences to return. |
Parent | The parent of the Relevance categories. | Yes
QueryFile | The file to find relevant sentences from. |
QueryText | The text to find relevant sentences from. | See Comments
SecurityInfo | Security details for the user that sends the action. |

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.

## Comments

You must specify one of the following parameters:

- DocID

- DocRef

- QueryText

© 2017 Hewlett Packard Enterprise Development LP | Send documentation feedback to HPE Close Send documentation feedback To open the configured email client on this computer, open an email window. Otherwise, copy the information below to a web mail client, and send this email to AutonomyTPFeedback@hpe.com. We appreciate your feedback! Product: Topic Title: Help Topic: Feedback:

_HP_HTML5_bannerTitle.htm