# @cdklabs/generative-ai-cdk-constructs 中文文档

规范地址：https://npmcn.com/package/%40cdklabs/generative-ai-cdk-constructs/

版本：0\.1\.320
npm 元数据更新时间：2026-09-01T23:57:50.742Z
中文译文更新时间：2026-11-09T06:18:13.159Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40cdklabs/generative-ai-cdk-constructs
原文对照：https://npmcn.com/package/%40cdklabs/generative-ai-cdk-constructs/?lang=original
项目主页：https://github.com/awslabs/generative-ai-cdk-constructs#readme
源码仓库：https://github.com/awslabs/generative-ai-cdk-constructs

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：17.5 MB，326 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- Node.js 要求：\>= 20\.x \<= 25\.x
- 运行依赖：3 个
- peer 依赖：aws-cdk-lib ^2\.267\.0，constructs ^10\.6\.0
- 首次发布：2023-11-27T20:14:04.562Z
- 最新版本发布：2026-09-01T23:57:50.449Z
- 近 30 天下载量：69100（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：343（近 12 个月 8 个）

## 中文简介

AWS Generative AI CDK Constructures是保存完好的基因化AI图案的库.

## 安装

```sh
npm install @cdklabs/generative-ai-cdk-constructs
```

也可以使用：`pnpm add @cdklabs/generative-ai-cdk-constructs`、`yarn add @cdklabs/generative-ai-cdk-constructs`、`bun add @cdklabs/generative-ai-cdk-constructs`

## README

# AWS 基因AI CDK 构造

![Stability: Experimental](https://img.shields.io/badge/stability-Experimental-important.svg?style=for-the-badge)

> 所有类别都在积极开发中,在任何类别中都需进行非后向相容修改或去除 未来版本. 这些限制不受《公约》的约束 [语义版本](https://semver.org/) 型号. 这意味着虽然您可能使用它们,但在升级到此软件包的更新版本时可能需要更新您的源代码.

* * *

[![View on Construct Hub](https://constructs.dev/badge?package=generative-ai-cdk-constructs)](https://constructs.dev/packages/@cdklabs/generative-ai-cdk-constructs)

[![PyPI version](https://img.shields.io/pypi/v/cdklabs.generative-ai-cdk-constructs)](https://pypi.org/project/cdklabs.generative-ai-cdk-constructs/) [![npm version](https://img.shields.io/npm/v/@cdklabs/generative-ai-cdk-constructs)](https://www.npmjs.com/package/@cdklabs/generative-ai-cdk-constructs) [![NuGet Version](https://img.shields.io/nuget/v/Cdklabs.GenerativeAiCdkConstructs)](https://nuget.info/packages/Cdklabs.GenerativeAiCdkConstructs) [![Maven Central Version](https://img.shields.io/maven-central/v/io.github.cdklabs/generative-ai-cdk-constructs)](https://central.sonatype.com/artifact/io.github.cdklabs/generative-ai-cdk-constructs) [![Go Version](https://img.shields.io/github/v/tag/awslabs/generative-ai-cdk-constructs?label=go&color=orange)](https://pkg.go.dev/github.com/cdklabs/generative-ai-cdk-constructs-go/generativeaicdkconstructs)

[![Terraform Amazon Bedrock Module](https://img.shields.io/badge/Terraform-7B42BC?style=flat&logo=terraform&label=bedrock%20module)](https://registry.terraform.io/modules/aws-ia/bedrock/aws/latest) [![Terraform Amazon OpenSearch Serverless Module](https://img.shields.io/badge/Terraform-7B42BC?style=flat&logo=terraform&label=opensearchserverless%20module)](https://registry.terraform.io/modules/aws-ia/opensearch-serverless/aws/latest) [![Terraform Amazon SageMaker Endpoint Module](https://img.shields.io/badge/Terraform-7B42BC?style=flat&logo=terraform&label=sagemaker%20endpoint%20module)](https://registry.terraform.io/modules/aws-ia/sagemaker-endpoint/aws/latest) [![Terraform Streamlit Module](https://img.shields.io/badge/Terraform-7B42BC?style=flat&logo=terraform&label=streamlit%20module)](https://registry.terraform.io/modules/aws-ia/serverless-streamlit-app/aws/latest)

## 目录

-   [导言](https://npmcn.com/package/%40cdklabs/generative-ai-cdk-constructs/#readme-introduction)
-   [CDK 版本](https://npmcn.com/package/%40cdklabs/generative-ai-cdk-constructs/#readme-cdk-versions)
-   [捐款](https://npmcn.com/package/%40cdklabs/generative-ai-cdk-constructs/#readme-contributing)
-   [设计准则和发展指南](https://npmcn.com/package/%40cdklabs/generative-ai-cdk-constructs/#readme-design-guidelines-and-development-guide)
-   [开始](https://npmcn.com/package/%40cdklabs/generative-ai-cdk-constructs/#readme-getting-started)
-   [目录](https://npmcn.com/package/%40cdklabs/generative-ai-cdk-constructs/#readme-catalog)
-   [样本使用例](https://npmcn.com/package/%40cdklabs/generative-ai-cdk-constructs/#readme-sample-use-cases)
-   [额外资源](https://npmcn.com/package/%40cdklabs/generative-ai-cdk-constructs/#readme-additional-resources)
-   [贡献者](https://npmcn.com/package/%40cdklabs/generative-ai-cdk-constructs/#readme-contributors)
-   [实用计量采集](https://npmcn.com/package/%40cdklabs/generative-ai-cdk-constructs/#readme-operational-metrics-collection)
-   [路线图](https://npmcn.com/package/%40cdklabs/generative-ai-cdk-constructs/#readme-roadmap)
-   [折旧](https://npmcn.com/package/%40cdklabs/generative-ai-cdk-constructs/#readme-deprecation)
-   [许可证](https://npmcn.com/package/%40cdklabs/generative-ai-cdk-constructs/#readme-license)
-   [法律免责声明](https://npmcn.com/package/%40cdklabs/generative-ai-cdk-constructs/#readme-legal-disclaimer)

## 导言

AWS Generative AI Constructions 库是一个开源扩展 [AWS 云开发工具包(AWS CDK)](https://docs.aws.amazon.com/cdk/v2/guide/home.html) 提供多种服务、质量良好的模式,以迅速在代码中界定解决方案,从而建立可预测和可重复的基础设施 [构造](https://docs.aws.amazon.com/cdk/v2/guide/constructs.html). AWS Generative AI CDK Constructions的目标是帮助开发者使用基于图案定义的架构构建基因AI解决方案.

AWS Generative AI CDK Constructions中定义的图案是AWS CDK构造的高水平,多服务抽象,其默认配置基于良好架构的最佳做法. 库被组织成逻辑模块,使用面向对象的技术来创建每个建筑模式模型.

## CDK 版本

AWS Generative AI CDK Constructions和AWS CDK是独立的团队,有不同的发布时间表. AWS Generative AI CDK Constructions的每个发行都是针对AWS CDK的特定版本而构建的. 这个 [变动情况](https://npmcn.com/package/%40cdklabs/generative-ai-cdk-constructs/CHANGELOG.md) 文件列出每个AWS Generative AI Constructions发布时相关的CDK版本. 例如,AWS Generative AI CDK Constructions v0.0.0是针对AWS CDK v2.962. 这意味着要使用AWS Generative AI CDK Constructions v0.0.0,您的应用程序必须包括AWS CDK v2.96.2或更后. 您可以继续使用最新的 AWS CDK 版本,并在新版本可用时升级您的 AWS Generative AI CDK Constructions 版本.

## 捐款

欢迎各种捐款! 看看我们 [贡献指南](https://npmcn.com/package/%40cdklabs/generative-ai-cdk-constructs/CONTRIBUTING.md)

## 设计准则和发展指南

如果你想在图书馆里添加一个新的构件,请检查我们 [设计准则](https://npmcn.com/package/%40cdklabs/generative-ai-cdk-constructs/DESIGN_GUIDELINES.md),然后跟随 [发展指南](https://npmcn.com/package/%40cdklabs/generative-ai-cdk-constructs/DEVELOPER_GUIDE.md)

## 开始

_类型脚本_

-   在 TypeScript 中创建或使用已有的 CDK 应用程序.
    -   `cdk init app --language typescript`
-   运行 `npm install @cdklabs/generative-ai-cdk-constructs`
-   包裹应该添加到你的包裹中. json.
-   导入库 :
    -   `import * as genai from '@cdklabs/generative-ai-cdk-constructs';`

_蟒_

-   在 Python 中创建或使用已有的 CDK 应用程序
    -   `cdk init app --language python`
-   安装软件包 :
    -   `pip install cdklabs.generative-ai-cdk-constructs`
-   导入库 :
    -   `import cdklabs.generative_ai_cdk_constructs`

_新建_

-   在 Python 中创建或使用已有的 CDK 应用程序
    -   `cdk init app --language csharp`
-   在 Visual Studio 项目中安装软件包 :
    -   `dotnet add package CdkLabs.GenerativeAICdkConstructs`
-   使用命名空间 :
    -   `using Cdklabs.GenerativeAiCdkConstructs;`

_走开_

-   在 Python 中创建或使用已有的 CDK 应用程序
    -   `cdk init app --language go`
-   获取模块 :
    -   `go get github.com/cdklabs/generative-ai-cdk-constructs-go/generativeaicdkconstructs`
-   导入库 :
    -   `import "github.com/cdklabs/generative-ai-cdk-constructs-go/generativeaicdkconstructs"`

_注: [去分发仓库](https://github.com/cdklabs/generative-ai-cdk-constructs-go),从 [源寄存器](https://github.awslabs/generative-ai-cdk-constructs)_

_爪哇语_

-   在 Java 创建或使用已有的 CDK 应用程序
    -   `cdk init app --language java`
-   将依赖添加到 `pom.xml`

```
<dependency>
    <groupId>io.github.cdklabs</groupId>
    <artifactId>generative-ai-cdk-constructs</artifactId>
    <version>Get the latest version and insert it here</version>
</dependency>
```

参见关于某一特定构件的补充指导意见的文件: [目录](https://npmcn.com/package/%40cdklabs/generative-ai-cdk-constructs/#readme-catalog)

## 目录

图书馆可提供下列构件:

### L3 组件

| **构造** | 说明 | AWS 服务 |
| :-- | :-- | :-- |
| [SageMaker模型部署(跳动)](https://npmcn.com/package/%40cdklabs/generative-ai-cdk-constructs/src/patterns/gen-ai/aws-model-deployment-sagemaker/README.md) | 从亚马逊SageMaker JumpStart到亚马逊SageMaker端点部署一个地基模型. | 亚马逊SageMaker |
| [SageMaker模型部署( Hugging Face)](https://npmcn.com/package/%40cdklabs/generative-ai-cdk-constructs/src/patterns/gen-ai/aws-model-deployment-sagemaker/README.md) | 从Hugging Face到Amazon SageMaker端点部署一个基础模型. | 亚马逊SageMaker |
| [SageMaker模型部署(海关)](https://npmcn.com/package/%40cdklabs/generative-ai-cdk-constructs/src/patterns/gen-ai/aws-model-deployment-sagemaker/README.md) | 从S3位置到Amazon SageMaker端点部署一个地基模型. | 亚马逊SageMaker |
| [亚马逊贝德洛克监测(Amazon Cloud Watch Dashboard)](https://npmcn.com/package/%40cdklabs/generative-ai-cdk-constructs/src/patterns/gen-ai/aws-bedrock-cw-dashboard/README.md) | Amazon Cloud Watch仪表板用于监控Amazon Bedrock的模型使用. | 亚马逊云表 |
| [Bedrock 数据自动化](https://npmcn.com/package/%40cdklabs/generative-ai-cdk-constructs/src/patterns/gen-ai/aws-bedrock-data-automation/README.md) | 使用亚马逊基岩数据自动化客户端来构建和管理智能文档处理,媒体分析,以及其他多模式以数据为中心的自动化解决方案 | AWS Lambda, 亚马逊 S3 桶 |
| [Bedrock 批次步骤函数](https://npmcn.com/package/%40cdklabs/generative-ai-cdk-constructs/src/patterns/gen-ai/aws-bedrock-batch-stepfn/README.md) | 在 AWS Step 函数状态机器中管理 Bedrock 模型引用任务( 批引) | AWS 步函数, AWS Lambda, AWS事件 Bridge, 亚马逊 Bedrock, AWS IAM |

### L2 构造

> \[尖叫声\] 重要:亚马逊Bedrock L2构造正在向AWS CDK核心寄存器过渡. 您现在可以找到这些构造 : [https://github.com/aws/aws-cdk/tree/main/packages/%40aws-cdk/aws-bedrock-alpha 页面存档备份,存于互联网档案馆](https://github.com/aws/aws-cdk/tree/main/packages/%40aws-cdk/aws-bedrock-alpha)。 。 。 . 请迁移到 Alpha 软件包, 因为此寄存器中的 Bedrock L2 构造现在已贬值, 将不再接受更新 .

| **构造** | 说明 | AWS 服务 |
| :-- | :-- | :-- |
| [亚马逊贝德洛克](https://npmcn.com/package/%40cdklabs/generative-ai-cdk-constructs/src/cdk-lib/bedrock/README.md) | CDK L2 亚马逊贝德洛克的构造. | 亚马逊 Bedrock, 亚马逊 OpenSearch Serverles, AWS Lambda |
| [Amazon OpenSearch 无服务器矢量收藏](https://npmcn.com/package/%40cdklabs/generative-ai-cdk-constructs/src/cdk-lib/opensearchserverless/README.md) | CDK L2 构造以创建向量收藏. | 亚马逊 OpenSearch 矢量索引 |
| [亚马逊 OpenSearch 矢量索引](https://npmcn.com/package/%40cdklabs/generative-ai-cdk-constructs/src/cdk-lib/opensearch-vectorindex/README.md) | CDK L1 自定义资源创建向量索引. | 亚马逊 OpenSearch 无服务器, AWS Lambda |
| [亚马逊·奥罗拉 DSQL](https://npmcn.com/package/%40cdklabs/generative-ai-cdk-constructs/src/cdk-lib/aurora-dsql/README.md) | CDK L2 亚马逊Aurora的构造 DSQL. | 亚马逊·奥罗拉 DSQL |
| [亚马逊 S3 矢量](https://npmcn.com/package/%40cdklabs/generative-ai-cdk-constructs/src/cdk-lib/s3vectors/README.md) | CDK L2 为亚马逊 S3 向量构造. | 亚马逊 S3 矢量 |

## 样本使用例

官员 [样本存储库](https://github.com/aws-samples/generative-ai-cdk-constructs-samples) 包括功能用例执行集合,以显示AWS Generative AI CDK Constructions的用法. 这些可以和建筑图案一样使用,也可以被概念化为这些图案的额外"更高级"抽象. 这些模式(结构)共同组成 [堆栈](https://docs.aws.amazon.com/cdk/latest/guide/stacks.html),形成"CDK应用程序".

## 额外资源

| 资源 | 类型 | 说明 |
| :-- | :-- | :-- |
| [AWS re: Invent 2023 - 与Werner Vogels博士的基调](https://youtu.be/UTRBVPvzt9w?t=6252) | 主旨 | Werner Vogels博士, Amazon.com的VP和CTO在其AWS re:Invent 2023主题曲中宣布了AWS Generative AI CDK Constructions. |
| [讲习班 -- -- 用CDK在AWS上建立基因AI应用程序](https://catalog.workshops.aws/building-genai-apps) | 讲习班 | 在这个研讨会上,您将探索如何使用CDK和Generative AI CDK Constructions在AWS上构建一个基因化的AI应用样本. |
| [讲习班 - 手放在 AWS CDK 基因AI 构造上](https://catalog.us-east-1.prod.workshops.aws/workshops/84c00416-19b6-44c3-8d18-cc172361af41/en-US) | 讲习班 | 在此工作坊中, 您将部署使用此库的 CDK 构造的项目 。 项目来自 [亚马逊-贝德洛克-样本](https://github.com/aws-samples/amazon-bedrock-samples/tree/main) Github 仓库. |
| [与 Amazon Titan Text Primier, Amazon Bedrock 和 AWS CDK 一起构建基因AI应用程序](https://aws.amazon.com/blogs/machine-learning/build-generative-ai-applications-with-amazon-titan-text-premier-amazon-bedrock-and-aws-cdk/) | 博客文章+ 代码样本 | 使用Generative AI CDK架构. |
| [aws-cdk-stack-buildinger-tool (英语:aws-cdk-stack-buildinger-tool) (英语)](https://github.com/aws-samples/aws-cdk-stack-builder-tool) | 代码样本 | AWS CDK Builder是一个以浏览器为基础的工具,旨在用AWS Cloud Development Kit(CDK)来简化将基础设施作为代码(IaC)项目的靴子陷阱. |
| [CDK现场直播! 利用 AWS CDK Constructions 构建基因AI应用和架构!](https://www.youtube.com/watch?v=NI1F4Xxqyr8) | 视频 | CDK Live! 剧集专注于使用AWS云发展工具包(CDK)和AWS Generative AI CDK Constructions在AWS上构建和部署基因AI应用和架构. |
| [宣布 AWS 基因AI CDK 构造 !](https://aws.amazon.com/blogs/devops/announcing-generative-ai-cdk-constructs/) | 博客文章 | 博客文章宣布发布AWS Generative AI CDK Constructions. |
| [使用亚马逊 Bedrock 简化保险承保程序](https://aws.amazon.com/blogs/machine-learning/streamline-insurance-underwriting-with-generative-ai-using-amazon-bedrock-part-1/) | 博客文章+ 代码样本 | 讨论如何使用亚马逊-贝德罗克等AWS基因人工智能(AI)解决方案. |
| [阿斯-格奈-尔姆-恰特博特](https://github.com/aws-samples/aws-genai-llm-chatbot/tree/main) | 代码样本 | 多模式和多RAG Powered Chatbot在 AWS 上使用 AWS CDK 允许您在自己的 AWS 账户中尝试多种大语言模型和多模式语言模型,设置和提示. |
| [基礎-克勞德-聊天](https://github.com/aws-samples/bedrock-claude-chat) | 代码样本 | 使用 Bedrock + Claude(+Mistral) 的 AWS 本地聊天器. |
| [亚马逊-贝德洛克-布克](https://github.com/aws-samples/amazon-bedrock-rag) | 代码样本 | 为亚马逊·贝德罗克使用知识库进行全管理RAG解决方案. |
| [亚马逊贝德洛克多模式搜索](https://github.com/aws-samples/amazon-bedrock-titan-multimodal-search) | 代码样本 | 使用亚马逊泰坦多式嵌入模型构建的多式产品搜索应用. |
| [亚马逊 Bedrock 有私人数据的知识库](https://blog.serverlessadvocate.com/amazon-bedrock-knowledge-bases-with-private-data-7685d04ef396) | 博客文章+ 代码样本 | 博客文章和相关代码样本演示如何将"知识基础"整合到亚马逊贝德罗克,以提供基础模型,提供来自私人数据来源的背景数据. |
| [使用 Amazon Bedrock 代理和 AI 自动任务](https://blog.serverlessadvocate.com/automating-tasks-using-amazon-bedrock-agents-and-ai-4b6fb8856589) | 博客文章+ 代码样本 | 说明如何透过酒店及温泉使用案例. |
| [Amazon Bedrock的代理商 - AWS Lambda(Python)的动力工具](https://docs.powertools.aws.dev/lambda/python/latest/core/event_handler/bedrock_agents/#using-aws-cloud-developer-kit-cdk) | 代码样本 | 使用事件处理器和自动生成OpenAPI schemas为亚马逊贝德罗克创建代理. |
| [文本到 SQL 贝德洛克代理](https://github.com/aws-samples/amazon-bedrock-samples/tree/main/agents-for-bedrock/use-case-examples/text-2-sql-agent-cdk-enhanced) | 代码样本 | 利用自然语言处理的力量,"Text to SQL Bedrock Agent"促进了自然语言问题的自动转换为可执行的SQL查询. |
| [使用 Amazon Bedrock 代理设备为企业工作量提供动态文本到 SQL](https://github.com/aws-samples/sample-Dynamic-Text-to-SQL-with-Amazon-Bedrock-Agent) | 代码样本 | 用端到端的代理文本到SQL溶液提升您的数据分析,基于AWS,用于企业规模的适应性和复原力. 金融服务中发现欺诈等复杂情况的理想. |

## 贡献者

[![contributors](https://contrib.rocks/image?repo=awslabs/generative-ai-cdk-constructs&max=2000)](https://github.com/awslabs/generative-ai-cdk-constructs/graphs/contributors)

## 实用计量采集

遗传性 AI CDK 建筑可以收集匿名的操作指标,包括:已部署的建筑所在区域、已部署建筑的名称和版本以及相关信息。 我们可以使用衡量尺度来维持、提供、发展和改进建筑和AWS服务.

## 路线图

路线图可通过 [GitHub 项目](https://github.com/orgs/awslabs/projects/136)

## 折旧

为了了解我们的贬值过程,请参考专注 [文档](https://npmcn.com/package/%40cdklabs/generative-ai-cdk-constructs/DEPRECATION_PROCESS.md)

## 许可证

阿帕奇 - 2.0

## 法律免责声明

您应当考虑在使用此图书馆中的内容进行制作前进行自己的独立评估. 这可能包括(除其他外)测试、保障和优化本库提供的CDK构件和其他内容,以您的具体质量控制做法和标准为基础.

* * *

• Amazon.com版权有限公司或其附属公司。 所有权利保留.

## 常见问题

### @cdklabs/generative-ai-cdk-constructs 是什么？

AWS Generative AI CDK Constructures是保存完好的基因化AI图案的库\.

### 如何安装 @cdklabs/generative-ai-cdk-constructs？

在项目目录运行 npm install @cdklabs/generative-ai-cdk-constructs，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：aws-cdk-lib（^2\.267\.0）、constructs（^10\.6\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @cdklabs/generative-ai-cdk-constructs 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @cdklabs/generative-ai-cdk-constructs 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @cdklabs/generative-ai-cdk-constructs 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>= 20\.x \<= 25\.x。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @cdklabs/generative-ai-cdk-constructs 可以商用吗？

@cdklabs/generative-ai-cdk-constructs 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @cdklabs/generative-ai-cdk-constructs 的下载量有多少？

根据 npm 官方下载统计，@cdklabs/generative-ai-cdk-constructs 在 2026/10/10 – 2026/11/08 这 30 天内被下载 69,100 次，日均约 2,303 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @cdklabs/generative-ai-cdk-constructs 还在维护吗？

最新版本 0\.1\.320 发布于 2026/09/02（2 个月前）；至今共发布 343 个版本，其中过去 12 个月发布了 8 个；首次发布于 2023/11/28。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。