> **Experimental**
>
> `@aws-cdk/aws-bedrock-alpha` is an [**experimental**](/stability) (alpha) package: its API may change in any release, without a major version bump.
# KnowledgeBaseProps

Properties for a knowledge base.

Extends: KnowledgeBaseProps
Used as props by: KnowledgeBase

- Stability: [Experimental](/cdk/api/stability.html)
- Source: [`bedrock/knowledge-bases/knowledge-base.ts`](https://github.com/aws/aws-cdk/blob/v2.274.0-alpha.0/packages/@aws-cdk/aws-bedrock-alpha/bedrock/knowledge-bases/knowledge-base.ts#L73)
- Type last changed: v2.274.0-alpha.0 · 21 Oct 2026

## Example

```ts
declare const collection: opensearchserverless.ICollectionRef;

const knowledgeBase = new bedrock.KnowledgeBase(this, 'KnowledgeBase', {
  type: bedrock.KnowledgeBaseType.vector({
    embeddingsModel: bedrock.BedrockFoundationModel.TITAN_EMBED_TEXT_V2_1024,
    vectorStore: bedrock.VectorStore.openSearchServerless({
      collection,
      vectorIndexName: 'bedrock-knowledge-base-default-index',
      vectorField: 'bedrock-knowledge-base-default-vector',
      textField: 'AMAZON_BEDROCK_TEXT_CHUNK',
      metadataField: 'AMAZON_BEDROCK_METADATA',
    }),
  }),
});
```

## Properties

- `description`: string — A description of the knowledge base.

  **Default:** no description

  Must be 1-200 characters.

- `knowledgeBaseName`: string — The name of the knowledge base.

  **Default:** a unique name is generated

  Must be 1-100 characters of letters, digits, hyphens and underscores, and
  must not contain consecutive hyphens or underscores.

- `role`: any — The service role that Amazon Bedrock assumes to operate the knowledge base.

  **Default:** a new role is created, trusted by `bedrock.amazonaws.com` and scoped to knowledge bases in this account

  The permissions the knowledge base needs to reach its data store and
  models are granted to this role.

- `tags`: { [key: string]: string } — Tags to apply to the knowledge base.

  **Default:** no tags

- `type`: [KnowledgeBaseType](/cdk/api/v2/docs/@aws-cdk_aws-bedrock-alpha.KnowledgeBaseType.html) (required) — The type of the knowledge base and its type-specific configuration.