メイン コンテンツをスキップする 補完的コンテンツへスキップ
Qlik リソース

ビジュアライゼーション数式での Anthropic (Amazon Bedrock) 接続の使用

ロード スクリプトを使用してアプリのデータ モデルに Anthropic の質問と回答を追加するだけでなく、分析モードのアプリのチャートで直接これらの操作を実行することもできます。単一項目のデータは、ユーザーと Anthropic 間で行ったり来たりします。

多くの場合、ロード スクリプト接続に使用されるコードは、いくつかの相違点はあるものの、チャートで再利用することができます。

使用例がユーザー入力に基づくものである場合は、チャートの数式で分析接続および対応するサーバーサイド拡張構文を使用して、モデルのエンドポイントから受信したデータを視覚化するインタラクティブ チャートを作成できます。

データ リクエスト ボリュームに関する注意事項

Anthropic (Amazon Bedrock) 接続は、データ行が 1 行または少数のチャートの数式でのみ使用することをお勧めします。チャートの数式を使用して Anthropic に大量のデータを送信することは推奨されていません。

各リクエストで送信する行数を把握しておくことが重要です。チャートの数式での接続の設定に誤りがあると、想定外の大きいリクエストが発生する可能性があります (例: チャートでのデータモデルの使用が不適切なため、同じ質問で同じ行が表示される)。サードパーティのプラットフォームとやり取りする前に、チャートの数式の計算で使用される項目と、データ モデルにおけるそれらの位置づけが、サードパーティとの財務契約や請求の取り決めにどのような影響を与えるかを必ず認識してください。外部プラットフォームの使用量が増えると、発生するコストも高くなる可能性があります。

次のガイドラインに従って、リクエストのサイズを軽減および制限してください。

  • [テキストと画像] チャートの数式でのみ接続を使用します。特に 1 つ以上の軸がすでに追加されているテーブルに式を追加する場合は、テーブル オブジェクトで Anthropic (Amazon Bedrock) 接続を使用しないことを強く推奨します。

  • チャートの数式がアプリのデータ モデルにリンクされている場合、アプリで 1 つの選択が行われたときだけチャートを計算するように、式の中で if 文を使用します。これにより、チャートが Anthropic に送信するリクエストの行数を大幅に減らすことができます。

  • Anthropic (Amazon Bedrock) 接続を使用して大きなリクエストを送信する場合、チャートの数式ではなくロード スクリプトで接続を使用し、データがデータ モデルに事前にロードされるようにします。

プロンプト エンジニアリング

生成 AI モデルに送信するリクエスト (プロンプトとも呼ばれる) を記述するときは、対話しているプラットフォームに固有のガイドラインに従ってください。プロンプト エンジニアリングの詳細と、Amazon Bedrock コネクタのプロンプトを構成する方法に関するガイドラインについては、「プロンプト エンジニアリングのガイドライン」を参照してください。

Anthropic - Claude 構成のプロンプトの作成

このコネクタの Anthropic - Claude 構成を使用して、次のレガシー モデルに接続できます。

  • Claude 2.1

  • Claude 2

  • Claude Instant 1.2

この構成用に作成されたプロンプトでは、完了を正常に返すために特定の構文が必要です。要件は次のとおりです。

  • 各プロンプトには、テキスト Human: をプレフィックスとして付ける必要があります

  • 各プロンプトには、テキスト Assistant: をサフィックスとして付ける必要があります

  • Human: のプレフィックスの前には、2 つのキャリッジ リターンが必要です。これは、式のプレフィックスの前に chr(10) & chr(10) を追加することで実現されます。

  • Assistant: のプレフィックスの前には、2 つのキャリッジ リターンが必要です。これは、式のサフィックスの前に chr(10) & chr(10) を追加することで実現されます。

Claude プロンプトの構造とフォーマットの方法については、「Constructing a prompt」を参照してください。

例については、「簡単な例」を参照してください。

Anthropic - Claude (Messages API) 構成のプロンプトの作成

Anthropic - Claude (Messages API) 構成はメッセージ API に接続します。この構成を使用して、次の Claude モデルにアクセスできます。

  • Claude 3 Sonnet

  • Claude 3 Haiku

  • Claude 2.1

  • Claude 2

  • Claude Instant 1.2

これらのモデルのプロンプトには、特定の構文は必要ありません。例については、「簡単な例」を参照してください。

チャートの数式の作成

次の手順を実行します。

  1. ビジュアライゼーションを編集する際は、 [数式] をクリックして数式エディタに入ります。

  2. 数式エディタでは、数式項目に数式を入力します。数式は、サーバーサイド拡張構文を使用して作成する必要があります。

簡単な例

ここでは、Anthropic (Amazon Bedrock) コネクタを使い始めるときに使用できるサンプル式を見つけることができます。次の詳細を考慮してください。

  • 式は [テキストと画像] オブジェクトでのみ使用します。

  • if ステートメントを式に追加して、チャートが再計算されるタイミングを制御し、アプリでのユーザーの選択に応じて更新することを検討します。

  • 式が機能するには、connectionname 値と項目名を独自の接続とアプリに一致するように置き換える必要があります。

  • このコネクタの構成ごとに、異なる構文要件があります。「プロンプト エンジニアリング」を参照してください。

Anthropic (Amazon Bedrock) 分析コネクタのチャートの数式の例
コネクタの構成 式 概要
Anthropic - Claude endpoints.ScriptAggrStr('{"RequestType":"endpoint", "endpoint":{"connectionname":"Anthropic_(Amazon_Bedrock)","column":"completion"}}', chr(10) & chr(10) & 'Human:' & 'Translate this text from English to Spanish: The sun was rising over the new tomorrow with a tinge of excitement.' & chr(10) & chr(10) & 'Assistant:')

このステートメントは、式に入力された 1 つの質問に対する Anthropic の応答を返します。

警告メモ

この式は if ステートメントを使用しないため、データ モデルの項目に関連付けられている場合は使用を推奨しません。これは、ハードコードされた値を含む単一の入力セルを含むスタンドアロン式での使用にのみ適しています。
Anthropic - Claude if(vQuestion <> '', endpoints.scriptAggrStr('{"RequestType":"endpoint", "endpoint":{"connectionname":"Anthropic_(Amazon_Bedrock)","column":"completion"}}', chr(10) & chr(10) & 'Human:' & vQuestion & chr(10) & chr(10) & ' Assistant:'))

これは、変数入力コントロールにリンクされた [テキストと画像] オブジェクトで使用できるステートメントです。チャートに入力された場合にのみ計算されます。ユーザーがオブジェクトに入力して Enter キーを押すと、その入力に対するモデルの応答がチャートに表示されます。

Anthropic プロンプト要件を考慮すると、ユーザーはプレフィックスとサフィックスを手動で入力する必要があることに注意してください。

別のコネクタを使用した同様の手順については、「演習:  変数を使用してテキスト入力ボックスを作成する」を参照してください。
Anthropic - Claude if(count(distinct [BusinessTopic]) = 1, endpoints.ScriptAggrStr('{"RequestType":"endpoint", "endpoint":{"connectionname":"Anthropic_(Amazon_Bedrock)","column":"completion"}}', chr(10) & chr(10) & 'Human: write me a sample response from a technical support department for a customer complaint about ' & [BusinessTopic] & chr(10) & chr(10) & ' Assistant:')) この例では、アプリのデータ モデルの項目 IssueCategory から 1 つの個別の値が選択された場合にのみチャートが計算されます。一般的な種類の問題についてテクニカル サポート部門からのサンプル応答を求めるリクエストがモデルに送信されます。そのリストは IssueCategory 項目に含まれています。 チャートはユーザーが選択した値に応じて更新されます。
Anthropic - Claude (Messages API) endpoints.ScriptAggrStr('{"RequestType":"endpoint", "endpoint":{"connectionname":"Anthropic_(Amazon_Bedrock)","column":"text"}}', 'Translate this text from English to Spanish: The sun was rising over the new tomorrow with a tinge of excitement.')

このステートメントは、式に入力された 1 つの質問に対する Anthropic の応答を返します。

警告メモ

この式は if ステートメントを使用しないため、データ モデルの項目に関連付けられている場合は使用を推奨しません。これは、ハードコードされた値を含む単一の入力セルを含むスタンドアロン式での使用にのみ適しています。
Anthropic - Claude (Messages API) if(vQuestion <> '', endpoints.scriptAggrStr('{"RequestType":"endpoint", "endpoint":{"connectionname":"Anthropic_(Amazon_Bedrock)","column":"text"}}',vQuestion))

これは、変数入力コントロールにリンクされた [テキストと画像] オブジェクトで使用できるステートメントです。チャートに入力された場合にのみ計算されます。ユーザーがオブジェクトに入力して Enter キーを押すと、その入力に対するモデルの応答がチャートに表示されます。

Anthropic プロンプト要件を考慮すると、ユーザーはプレフィックスとサフィックスを手動で入力する必要があることに注意してください。

別のコネクタを使用した同様の手順については、「演習:  変数を使用してテキスト入力ボックスを作成する」を参照してください。
Anthropic - Claude (Messages API) if(count(distinct [IssueCategory]) = 1, endpoints.ScriptAggrStr('{"RequestType":"endpoint", "endpoint":{"connectionname":"Anthropic_(Amazon_Bedrock)","column":"text"}}', 'Write me a sample response from a technical support department for a customer complaint about ' & [IssueCategory]')) この例では、アプリのデータ モデルの項目 IssueCategory から 1 つの個別の値が選択された場合にのみチャートが計算されます。一般的な種類の問題についてテクニカル サポート部門からのサンプル応答を求めるリクエストがモデルに送信されます。そのリストは IssueCategory 項目に含まれています。 チャートはユーザーが選択した値に応じて更新されます。

このページは役に立ちましたか?

このページまたはコンテンツに、タイポ、ステップの省略、技術的エラーなどの問題が見つかった場合は、お知らせください。改善に役立たせていただきます。

こちらにフィードバックをお寄せください