@aws-amplify/graphql-generation-transformer

中文文档
1.2.9发布于 2026/10/01Apache-2.0TypeScriptCommonJS近 30 天下载 5.2万

放大图QL@ 生成变压器

中文使用文档
文档目录7 节
  1. 安装
  2. 指令定义
  3. 特征
  4. 实例
  5. 基本用途
  6. 高级配置
  7. 限制

放大图形QL 生成变换器

AWS AppSync API内部的 Amplify GraphQL 世代变换器是一个工具,可以快速而轻松地创建AI-power Crowth 路由. 这个变压器可以通过使用 @generation 指令配置生成内容的AI模型和系统提示.

安装

npm install @aws-amplify/graphql-generation-transformer

指令定义

这个 @generation 指令的定义如下:

directive @generation(aiModel: String!, systemPrompt: String!, inferenceConfiguration: GenerationInferenceConfiguration) on FIELD_DEFINITION

特征

  1. AI模型集成:指定用于生成的AI模型.
  2. 系统快取配置:定义一个系统快取来指导AI的输出.
  3. 推论配置:微调生成参数,如最大符号,温度,和上-p.
  4. 与 @auth 指令:支持IAM,API密钥等现有认证模式,以及Amazon Cognitto用户池.
  5. 解析器创建:生成基于Query字段返回类型的工具定义的解析器与指定的AI模型进行交互.
  6. Bedrock HTTP Data Source Create:为Bedrock创建了AppSync HTTP Data Source,用于与指定的AI模型交互.

实例

基本用途

Scalar 类型生成

type Query {
  generateStory(topic: String!): String
    @generation(
      aiModel: "anthropic.claude-3-haiku-20240307-v1:0"
      systemPrompt: "You are a creative storyteller. Generate a short story based on the given topic."
    )
}

复杂类型生成

type Recipe {
  name: String!
  ingredients: [String!]!
  instructions: [String!]!
  prepTime: Int!
  cookTime: Int!
  servings: Int!
  difficulty: String!
}

type Query {
  generateRecipe(cuisine: String!, dietaryRestrictions: [String]): Recipe
    @generation(
      aiModel: "anthropic.claude-3-haiku-20240307-v1:0"
      systemPrompt: "You are a professional chef specializing in creating recipes. Generate a detailed recipe based on the given cuisine and dietary restrictions."
    )
}

高级配置

type Query {
  generateCode(description: String!): String
    @generation(
      aiModel: "anthropic.claude-3-haiku-20240307-v1:0"
      systemPrompt: "You are an expert programmer. Generate code based on the given description."
      inferenceConfiguration: { maxTokens: 500, temperature: 0.7, topP: 0.9 }
    )
}

限制

  • 这个 @generation 指令只能用于查询字段.
  • 规定的AI模式必须:
    • 由 Amazon Bedrock 的 / 逆向 API 支持
    • 支持工具的使用
  • 目前不支持一些AppSync scalar类型.

版本与发布记录

@aws-amplify/graphql-generation-transformer 共发布 45 个版本,首次发布于 2024/08/16;过去 12 个月发布了 5 个版本。

版本发布日期距今
1.2.9latest2026/10/011 个月前
1.2.82026/07/143 个月前
1.2.72026/07/014 个月前
1.2.62026/03/247 个月前
1.2.52026/02/069 个月前
1.2.42025/06/101.4 年前

其他发布通道:raven → 0.1.1-raven.7,async-lambda → 0.2.1-async-lambda.0,gen2-migration-0930 → 0.2.2-gen2-migration-0930.0,ai → 0.2.2-ai.3,gen2-migration-1015 → 0.2.4-gen2-migration-1015.0,ai-streaming → 0.2.6-ai-streaming.0。

关于 @aws-amplify/graphql-generation-transformer 的常见问题

@aws-amplify/graphql-generation-transformer 是什么?

放大图QL@ 生成变压器

如何安装 @aws-amplify/graphql-generation-transformer?

在项目目录运行 npm install @aws-amplify/graphql-generation-transformer,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:constructs(^10.3.0)、aws-cdk-lib(^2.224.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@aws-amplify/graphql-generation-transformer 支持 TypeScript 吗?

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

@aws-amplify/graphql-generation-transformer 支持 ESM 还是 CommonJS?

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

@aws-amplify/graphql-generation-transformer 可以商用吗?

@aws-amplify/graphql-generation-transformer 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@aws-amplify/graphql-generation-transformer 的下载量有多少?

根据 npm 官方下载统计,@aws-amplify/graphql-generation-transformer 在 2026/10/07 – 2026/11/05 这 30 天内被下载 52,442 次,日均约 1,748 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@aws-amplify/graphql-generation-transformer 还在维护吗?

最新版本 1.2.9 发布于 2026/10/01(1 个月前);至今共发布 45 个版本,其中过去 12 个月发布了 5 个;首次发布于 2024/08/16。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。