翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
Amazon Nova マルチモーダル理解モデルは、Invoke API (InvokeModel、InvokeModelWithResponseStream) および Converse API (Converse および ConverseStream) を通じて推論に使用できます。会話アプリケーションを作成するには、「会話 API オペレーションとの会話を実行する」を参照してください。両方の API メソッド (呼び出しと会話) は、以下で説明するように非常に類似したリクエストパターンに従います。
Invoke API と Converse API の主な違いは次のとおりです。
-
topK などの推論パラメータは Converse ではサポートされていないため
additionalModelRequestFields
、 で渡す必要があります。Invoke API では、推論パラメータで直接渡すことができます。 -
ドキュメントサポートは Converse API のみに制限されており、Invoke API ではサポートされていません。
-
レスポンス解析形式は、Invoke API コンストラクトと Convserse API コンストラクトで異なります。
-
レスポンスストリーミングは
ConverseStream
と で異なりますInvokeModelWithStreaming
。
Messages API overview
Amazon Nova Understanding モデルは Messages API を使用します。これにより、テキスト、画像、動画、ドキュメントを含む入力メッセージの構造化リストを送信できます。次に、モデルは会話で次のメッセージを生成します。Messages API は、単一クエリとステートレスマルチターン会話の両方をサポートしているため、チャットボットと仮想アシスタントアプリケーションを作成できます。API は、ユーザーと Amazon Nova モデル (アシスタント) 間の会話交換を管理します。
Amazon Nova モデルは、ユーザーとアシスタントの会話ターンを交互に操作するようにトレーニングされています。新しいメッセージを作成するときは、メッセージパラメータを使用して以前の会話ターンを指定します。次に、モデルは会話で次のメッセージを生成します。
各入力メッセージは、ロールとコンテンツを含むオブジェクトである必要があります。ユーザーは、ユーザーロールで 1 つのメッセージを指定するか、ユーザーロールとアシスタントロールの両方に複数のメッセージを含めることができます。ただし、最初のメッセージは常に ユーザーロールを使用する必要があります。Amazon Nova からのレスポンスを事前入力する手法が使用されている場合 (アシスタントロールに最終メッセージを含める)、モデルは提供されたコンテンツからのレスポンスを続行します。このアプローチでは、アシスタントロールでレスポンスが返されます。
以下は、単一のユーザーメッセージを表します。
[{
"role": "user",
"content": [{"text":"Hello, Nova"}]
}]
会話ターンが複数ある例を次に示します。
[
{"role": "user", "content": [{"text": "Hello there."}]},
{"role": "assistant", "content": [{"text": "Hi, I'm Chatbot trained to answer your questions. How can I help you?"}]},
{"role": "user", "content": [{"text": "Can you explain LLMs in plain English?"}]}
]
Amazon Nova からのレスポンスが部分的に入力されている例を次に示します。
[
{"role": "user", "content": [{"text":"Please describe yourself using only JSON"}]},
{"role": "assistant", "content": [{"text":"Here is my JSON description:\n{"}]}
]
Amazon Nova モデルのプロンプトの作成については、「」を参照してくださいベストプラクティスを促すテキストの理解。
システムプロンプトの使用
リクエストにシステムプロンプトを含めることができます。システムプロンプトを使用すると、特定の目標やロールの指定など、Amazon Nova にコンテキストと手順を提供できます。次の例に示すように、 system
フィールドにシステムプロンプトを指定します。
[
{"text": "You are an expert SaS analyst......"}
]