Need to configure your backend?See Build a Backend →
生成
AI生成ルートは、AIモデルから構造化された出力を生成するために使用されるリクエスト・レスポンスAPIです。生成ルートの例には、以下が含まれます：
- 非構造化入力から生成された構造化データ
- 要約
内部的には、生成ルートはAWSAppSyncクエリであり、AIモデルがルート用に定義されたレスポンスタイプで応答することを保証します。
型指定されたオブジェクトの生成
Schema Definition
const schema = a.schema({ generateRecipe: a.generation({ aiModel: a.ai.model('Claude 3.5 Haiku'), systemPrompt: 'You are a helpful assistant that generates recipes.', }) .arguments({ description: a.string() }) .returns( a.customType({ name: a.string(), ingredients: a.string().array(), instructions: a.string(), }) ) .authorization((allow) => allow.authenticated())});スカラー型の生成
Schema Definition
const schema = ({ summarize: a.generation({ aiModel: a.ai.model('Claude 3.5 Haiku'), systemPrompt: 'Provide an accurate, clear, and concise summary of the input provided' }) .arguments({ input: a.string() }) .returns(a.string()) .authorization((allow) => allow.guest()),});Data Client Request
const { data: summary, errors } = await client.generations .summarize({ input })推論パラメータの設定
AIモデルの推論パラメータを設定することで、レスポンス生成に影響を与えることができます。 レスポンスのランダム性と多様性を制御するこの機能は、ニーズに合わせたレスポンスを生成するのに役立ちます。
Inference Parameters
const schema = a.schema({ generateHaiku: a.generation({ aiModel: a.ai.model('Claude 3.5 Haiku'), systemPrompt: 'You are a helpful assistant that generates haikus.', inferenceConfiguration: { maxTokens: 1000, temperature: 0.5, topP: 0.9, } }),});制限事項
1. 生成ルートはモデルの参照をサポートしていません
たとえば、以下のスキーマはRecipeモデルを定義していますが、このモデルを生成ルートの戻り値の型として使用することはできません。
Invalid Model Reference
const schema = a.schema({ Recipe: a.model({ name: a.string(), ingredients: a.string().array(), instructions: a.string(), }), generateRecipe: a.generation({ aiModel: a.ai.model('Claude 3.5 Haiku'), systemPrompt: 'You are a helpful assistant that generates recipes.', }) .arguments({ description: a.string() }) .returns(a.ref('Recipe')) // ❌ Invalid .authorization((allow) => allow.authenticated()),});ただし、カスタム型は参照できます。生成ルートの戻り値の型として使用できるカスタム型の例を次に示します。
Valid Custom Type Reference
const schema = a.schema({ Recipe: a.customType({ name: a.string(), ingredients: a.string().array(), instructions: a.string(), }), generateRecipe: a.generation({ aiModel: a.ai.model('Claude 3.5 Haiku'), systemPrompt: 'You are a helpful assistant that generates recipes.', }) .arguments({ description: a.string() }) .returns(a.ref('Recipe')) // ✅ Valid .authorization((allow) => allow.authenticated()),});2. 生成ルートは一部の必須型をサポートしていません。
以下のAppSyncスカラー型は、レスポンス型の必須フィールドとしてサポートされていません：
AWSEmailAWSDateAWSTimeAWSDateTimeAWSTimestampAWSPhoneAWSURLAWSIPAddress
Unsupported Required Type
const schema = a.schema({ generateUser: a.generation({ aiModel: a.ai.model('Claude 3.5 Haiku'), systemPrompt: 'You are a helpful assistant that generates users.', }) .arguments({ description: a.string() }) .returns( a.customType({ name: a.string(), email: a.email().required(), // ❌ Required field with unsupported type dateOfBirth: a.date().required(), // ❌ Required field with unsupported type }) ) .authorization((allow) => allow.authenticated()),});