AI アクションは、AI モデルとプロンプトを指定し、AI モデルに指示や質問をして、AI モデルからのレスポンスを、次のチャネルに送信します。
チャネルにアクションを追加する手順については、チャネルにアクションを追加する (処理を分岐する) を参照してください。
AI アクションの設定
ここでは、AI アクションの CONFIG について説明します。そのほかの項目については、アクションリファレンスの 新しいアクションを作成画面 を参照してください。
CONFIG
AI モデルの種類や AI モデルへの入力データなどを設定します。
項目 | 説明 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
AI モデルを選択します。選択した AI モデルによって、 と の利用可否が異なります。
AI モデルによって決められたクレジットを消費します
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
の表で (*1) が記載されている AI モデル (「OpenAI (GPT-4o mini)」など) を選択し、かつ を選択した場合は、お客様の OpenAI API キーを登録した認証情報を選択します。 お客様の OpenAI API キーを認証情報ストアに登録してくださいあらかじめお客様の OpenAI API キーを、SORACOM ユーザーコンソールに登録します。 具体的には、認証情報ストアの「認証情報を登録」画面で以下のように登録します。この画面の表示方法については、認証情報を登録する を参照してください。
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
AI モデルに送信する指示や質問を入力します。
4096 文字まで入力できます。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
AI モデルからの返答を JSON 形式に制限する場合は、チェックを入れます。チェックを入れた場合は、 | に「JSON で返却する」旨の指示を含めてください。||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
、 | AI モデルに静止画や動画を送信する場合は、チェックを入れて、ファイルの URL を指定します。たとえば、この Flux アプリで SORACOM Harvest Files イベントソースを利用する場合は、
Amazon Bedrock - Amazon Nova Lite、Amazon Bedrock - Amazon Nova Pro で以下のエラーが発生する場合は、動画を含めたリクエストのサイズが AI モデルの制限 (ペイロード制限) を超えている可能性があります。動画の解像度やビットレートを下げて、ファイルサイズを小さくしてください。
制限の詳細は、Amazon Nova のマルチモーダルサポートを参照してください。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
→ | 「システムプロンプト」を入力します。
|
AI アクションの出力データ
AI アクションの出力データは以下のとおりです。
例:
{
"output": {
<AIモデルからのレスポンス>
},
"usage": {
"completion_tokens": 10,
"prompt_tokens": 300,
"total_tokens": 310,
"model": "gpt-4o",
"byol": false,
"credit": 10
}
}
項目 | 説明 |
---|---|
outout | AI モデルからのレスポンス。たとえば、${payload.output.xxx} で取得できます。 | を有効化した場合は、次のチャネルからこの AI モデルからのレスポンスを
usage | AI モデルの使用量に関するデータ。 |
usage.completion_tokens | AI モデルが生成したトークン数。 |
usage.prompt_tokens | AI モデルにプロンプトとして送信したトークン数。 |
usage.total_tokens | usage.completion_tokens と usage.prompt_tokens の合計。 |
usage.model | 利用した AI モデル。 |
usage.model_id | 利用した AI モデルのモデル ID。 Amazon Bedrock のモデルの場合のみ、モデル ID が出力されます。たとえば、モデル Claude 3.5 Sonnet v2 の場合、モデル ID として anthropic.claude-3-5-sonnet-20241022-v2:0 が返ります。詳細は Amazon Bedrock model IDs を確認してください。 |
usage.byol | お客様の OpenAI API キーの指定の有無。 |
usage.credit | 消費したクレジット。 |