# ChunkingConfigurationProperty

Details about how to chunk the documents in the data source.

A chunk refers to an excerpt from a data source that is returned when the knowledge base that it belongs to is queried.

- Source: Generated code
- Type last changed: v2.172.0 · 7 Dec 2024

## Example

```ts
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { aws_wisdom as wisdom } from 'aws-cdk-lib';
const chunkingConfigurationProperty: wisdom.CfnKnowledgeBase.ChunkingConfigurationProperty = {
  chunkingStrategy: 'chunkingStrategy',

  // the properties below are optional
  fixedSizeChunkingConfiguration: {
    maxTokens: 123,
    overlapPercentage: 123,
  },
  hierarchicalChunkingConfiguration: {
    levelConfigurations: [{
      maxTokens: 123,
    }],
    overlapTokens: 123,
  },
  semanticChunkingConfiguration: {
    breakpointPercentileThreshold: 123,
    bufferSize: 123,
    maxTokens: 123,
  },
};
```

## Properties

- `chunkingStrategy`: string (required) — Knowledge base can split your source data into chunks.

  A chunk refers to an excerpt from a data source that is returned when the knowledge base that it belongs to is queried. You have the following options for chunking your data. If you opt for `NONE` , then you may want to pre-process your files by splitting them up such that each file corresponds to a chunk.

- `fixedSizeChunkingConfiguration`: [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [CfnKnowledgeBase.FixedSizeChunkingConfigurationProperty](/cdk/api/v2/docs/aws-cdk-lib.aws_wisdom.CfnKnowledgeBase.FixedSizeChunkingConfigurationProperty.html) — Configurations for when you choose fixed-size chunking.

  If you set the `chunkingStrategy` as `NONE` , exclude this field.

- `hierarchicalChunkingConfiguration`: [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [CfnKnowledgeBase.HierarchicalChunkingConfigurationProperty](/cdk/api/v2/docs/aws-cdk-lib.aws_wisdom.CfnKnowledgeBase.HierarchicalChunkingConfigurationProperty.html) — Settings for hierarchical document chunking for a data source.

  Hierarchical chunking splits documents into layers of chunks where the first layer contains large chunks, and the second layer contains smaller chunks derived from the first layer.

- `semanticChunkingConfiguration`: [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [CfnKnowledgeBase.SemanticChunkingConfigurationProperty](/cdk/api/v2/docs/aws-cdk-lib.aws_wisdom.CfnKnowledgeBase.SemanticChunkingConfigurationProperty.html) — Settings for semantic document chunking for a data source.

  Semantic chunking splits a document into smaller documents based on groups of similar content derived from the text with natural language processing.