aws-cdk-lib.aws_kendra.CfnIndex.RelevanceProperty

interface RelevanceProperty

LanguageType name
.NETAmazon.CDK.AWS.Kendra.CfnIndex.RelevanceProperty
Gogithub.com/aws/aws-cdk-go/awscdk/v2/awskendra#CfnIndex_RelevanceProperty
Javasoftware.amazon.awscdk.services.kendra.CfnIndex.RelevanceProperty
Pythonaws_cdk.aws_kendra.CfnIndex.RelevanceProperty
TypeScript aws-cdk-lib » aws_kendra » CfnIndex » RelevanceProperty

Provides information for tuning the relevance of a field in a search.

When a query includes terms that match the field, the results are given a boost in the response based on these tuning parameters.

Example

// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { aws_kendra as kendra } from 'aws-cdk-lib';
const relevanceProperty: kendra.CfnIndex.RelevanceProperty = {
  duration: 'duration',
  freshness: false,
  importance: 123,
  rankOrder: 'rankOrder',
  valueImportanceItems: [{
    key: 'key',
    value: 123,
  }],
};

Properties

NameTypeDescription
duration?stringSpecifies the time period that the boost applies to.
freshness?boolean | IResolvableIndicates that this field determines how "fresh" a document is.
importance?numberThe relative importance of the field in the search.
rankOrder?stringDetermines how values should be interpreted.
valueImportanceItems?IResolvable | IResolvable | ValueImportanceItemProperty[]An array of key-value pairs for different boosts when they appear in the search result list.

duration?

Type: string (optional)

Specifies the time period that the boost applies to.

For example, to make the boost apply to documents with the field value within the last month, you would use "2628000s". Once the field value is beyond the specified range, the effect of the boost drops off. The higher the importance, the faster the effect drops off. If you don't specify a value, the default is 3 months. The value of the field is a numeric string followed by the character "s", for example "86400s" for one day, or "604800s" for one week.

Only applies to DATE fields.


freshness?

Type: boolean | IResolvable (optional)

Indicates that this field determines how "fresh" a document is.

For example, if document 1 was created on November 5, and document 2 was created on October 31, document 1 is "fresher" than document 2. You can only set the Freshness field on one DATE type field. Only applies to DATE fields.


importance?

Type: number (optional)

The relative importance of the field in the search.

Larger numbers provide more of a boost than smaller numbers.


rankOrder?

Type: string (optional)

Determines how values should be interpreted.

When the RankOrder field is ASCENDING , higher numbers are better. For example, a document with a rating score of 10 is higher ranking than a document with a rating score of 1.

When the RankOrder field is DESCENDING , lower numbers are better. For example, in a task tracking application, a priority 1 task is more important than a priority 5 task.

Only applies to LONG and DOUBLE fields.


valueImportanceItems?

Type: IResolvable | IResolvable | ValueImportanceItemProperty[] (optional)

An array of key-value pairs for different boosts when they appear in the search result list.

For example, if you want to boost query terms that match the "department" field in the result, query terms that match this field are boosted in the result. You can add entries from the department field to boost documents with those values higher.

For example, you can add entries to the map with names of departments. If you add "HR", 5 and "Legal",3 those departments are given special attention when they appear in the metadata of a document.