AI アクションは、AI モデルとプロンプトを指定し、AI モデルに指示や質問をして、AI モデルからのレスポンスを、次のチャネルに送信します。
ここでは、AI アクションの CONFIG について説明します。そのほかの項目については、アクションリファレンスの 新しいアクションを作成画面 を参照してください。
AI モデルの種類や AI モデルへの入力データなどを設定します。
項目 | 説明 |
---|
| AI モデルを選択します。選択した AI モデルによって、 と の利用可否が異なります。 AI モデル | | |
---|
Azure OpenAI (GPT-4.1) | ✓ | - | Azure OpenAI (GPT-4.1-mini) | ✓ | - | Azure OpenAI (GPT-4.1-nano) | ✓ | - | Azure OpenAI (GPT-4o) | ✓ | - | Azure OpenAI (GPT-4o mini) | ✓ | - | OpenAI (GPT-4.1) (*1) | ✓ | - | OpenAI (GPT-4.1-mini) (*1) | ✓ | - | OpenAI (GPT-4.1-nano) (*1) | ✓ | - | OpenAI (GPT-4o) (*1) | ✓ | - | OpenAI (GPT-4o mini) (*1) | ✓ | - | Amazon Bedrock - Amazon Nova Micro | - | - | Amazon Bedrock - Amazon Nova Lite | ✓ | ✓ | Amazon Bedrock - Amazon Nova Pro | ✓ | ✓ | Amazon Bedrock - Anthropic Claude Sonnet 4 | ✓ | - | Amazon Bedrock - Anthropic Claude Opus 4 | ✓ | - | Amazon Bedrock - Anthropic Claude 3.7 Sonnet | ✓ | - | Amazon Bedrock - Anthropic Claude 3.5 Haiku | - | - | Amazon Bedrock - Anthropic Claude 3.5 Sonnet | ✓ | - | Amazon Bedrock - Anthropic Claude 3 Haiku | ✓ | - | Amazon Bedrock - Anthropic Claude 3 Opus | ✓ | - | Google Gemini 2.5 Flash | ✓ | ✓ | Google Gemini 2.5 Pro | ✓ | ✓ | Google Gemini 2.0 Flash-Lite | ✓ | ✓ | Google Gemini 2.0 Flash | ✓ | ✓ | Google Gemini 1.5 Flash | ✓ | - | Google Gemini 1.5 Pro | ✓ | - |
- (*1) この AI モデルは、クレジットを消費しません。ただし、お客様の OpenAI API キーが必要です。 で OpenAI API キーを登録した認証情報を選択してください。また、クレジットについては、SORACOM Flux の料金プラン を参照してください。
AI モデルによって決められたクレジットを消費します- AI モデルによって決められた数のクレジットを消費します。たとえば、Amazon Bedrock - Anthropic Claude 3 Haiku では 1 リクエストごとに 10 クレジットを消費します。Azure OpenAI (GPT-4o) では 1 リクエストごとに 86 クレジットを消費します。
- クレジットが 0 になると、クレジットを消費する AI モデルは利用できません。その場合は、お客様の OpenAI API キーを使用する AI モデル (クレジットを消費しない AI モデル) を利用してください。
- クレジットの詳細は、SORACOM Flux の料金プラン を参照してください。
|
| の表で (*1) が記載されている AI モデル (「OpenAI (GPT-4o mini)」など) を選択した場合は、お客様の OpenAI API キーを登録した認証情報を選択します。 お客様の OpenAI API キーを認証情報ストアに登録してくださいあらかじめお客様の OpenAI API キーを、SORACOM ユーザーコンソールに登録します。 具体的には、認証情報ストアの「認証情報を登録」画面で以下のように登録します。この画面の表示方法については、認証情報を登録する を参照してください。 項目 | 説明 |
---|
| 認証情報を識別するために任意の名前を入力します。例: OpenAI-API-Key | | 「API トークン認証情報」を選択します。 | | OpenAI API キーを入力します。 |
|
| AI モデルに送信する指示や質問を入力します。 - この入力欄では、Flux アプリが起動するトリガーに関するデータを表す式 (例:
${event.payload.temp} ) や、アクションを追加したチャネルに関するデータを表す式 (例: ${payload.temp} ) を入力できます。入力できる式について詳しくは、アクション、コンディションの記法 を参照してください。
|
| AI モデルからの返答を JSON 形式に制限する場合は、チェックを入れます。チェックを入れた場合は、 に「JSON で返却する」旨の指示を含めてください。 |
、 | AI モデルに静止画や動画を送信する場合は、チェックを入れて、ファイルの URL を指定します。たとえば、この Flux アプリで SORACOM Harvest Files イベントソースを利用する場合は、${event.payload.presignedUrls.get} を指定すると、SORACOM Harvest Files にアップロードしたファイルが生成 AI に送信されます。 - この入力欄では、Flux アプリが起動するトリガーに関するデータを表す式 (例:
${event.payload.temp} ) や、アクションを追加したチャネルに関するデータを表す式 (例: ${payload.temp} ) を入力できます。入力できる式について詳しくは、アクション、コンディションの記法 を参照してください。
- AI モデルに動画を送信する場合、追加でクレジットを消費します。クレジットの詳細は、SORACOM Flux の料金プラン を参照してください。
- 動画形式は MPEG-4 をサポートしています。
- 動画の長さの上限は 60 秒です。60 秒を超える動画はエラーとなります。
Amazon Bedrock - Amazon Nova Lite、Amazon Bedrock - Amazon Nova Pro で以下のエラーが発生する場合は、動画を含めたリクエストのサイズが AI モデルの制限 (ペイロード制限) を超えている可能性があります。動画の解像度やビットレートを下げて、ファイルサイズを小さくしてください。 An error occurred (ValidationException) when calling the Converse operation: Input is too long for requested model.
制限の詳細は、Amazon Nova のマルチモーダルサポートを参照してください。 |
→ | 「システムプロンプト」を入力します。 - この入力欄では、Flux アプリが起動するトリガーに関するデータを表す式 (例:
${event.payload.temp} ) や、アクションを追加したチャネルに関するデータを表す式 (例: ${payload.temp} ) を入力できます。入力できる式について詳しくは、アクション、コンディションの記法 を参照してください。
|
AI アクションの出力データは以下のとおりです。
例:
{
"output": {
<AIモデルからのレスポンス>
},
"usage": {
"completion_tokens": 10,
"prompt_tokens": 300,
"total_tokens": 310,
"model": "gpt-4o",
"byol": false,
"credit": 10
}
}
項目 | 説明 |
---|
outout | AI モデルからのレスポンス。たとえば、 を有効化した場合は、次のチャネルからこの AI モデルからのレスポンスを ${payload.output.xxx} で取得できます。 |
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 | 消費したクレジット。 |