Soracom

Users

ドキュメント
Home ドキュメント SORACOM Flux アクションリファレンス

AI アクション

AI アクションは、AI モデルとプロンプトを指定し、AI モデルに指示や質問をして、AI モデルからのレスポンスを、次のチャネルに送信します。

チャネルにアクションを追加する手順については、チャネルにアクションを追加する (処理を分岐する) を参照してください。

AI アクションの設定

ここでは、AI アクションの CONFIG について説明します。そのほかの項目については、アクションリファレンスの 新しいアクションを作成画面 を参照してください。

CONFIG

AI モデルの種類や AI モデルへの入力データなどを設定します。

項目説明
[AI モデル]

AI モデルを選択します。選択した AI モデルによって、[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 の料金プラン を参照してください。
[認証情報]

[AI モデル] の表で (*1) が記載されている AI モデル (「OpenAI (GPT-4o mini)」など) を選択した場合は、お客様の OpenAI API キーを登録した認証情報を選択します。

お客様の OpenAI API キーを認証情報ストアに登録してください

あらかじめお客様の OpenAI API キーを、SORACOM ユーザーコンソールに登録します。

具体的には、認証情報ストアの「認証情報を登録」画面で以下のように登録します。この画面の表示方法については、認証情報を登録する を参照してください。

項目説明
[認証情報 ID]認証情報を識別するために任意の名前を入力します。例: OpenAI-API-Key
[種別]「API トークン認証情報」を選択します。
[API トークン]OpenAI API キーを入力します。
[プロンプト]

AI モデルに送信する指示や質問を入力します。

  • この入力欄では、Flux アプリが起動するトリガーに関するデータを表す式 (例: ${event.payload.temp}) や、アクションを追加したチャネルに関するデータを表す式 (例: ${payload.temp}) を入力できます。入力できる式について詳しくは、アクション、コンディションの記法 を参照してください。

4096 文字まで入力できます。

[AI からの返答を JSON 形式にする]AI モデルからの返答を JSON 形式に制限する場合は、チェックを入れます。チェックを入れた場合は、[プロンプト] に「JSON で返却する」旨の指示を含めてください。

[AI に画像を読み込ませる]

[AI に動画を読み込ませる]

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 アクションの出力データ

AI アクションの出力データは以下のとおりです。

例:

{
  "output": {
    <AIモデルからのレスポンス>
  },
  "usage": {
    "completion_tokens": 10,
    "prompt_tokens": 300,
    "total_tokens": 310,
    "model": "gpt-4o",
    "byol": false,
    "credit": 10
  }
}
項目説明
outoutAI モデルからのレスポンス。たとえば、[アクションのアウトプットを別のチャネルに送信する] を有効化した場合は、次のチャネルからこの AI モデルからのレスポンスを ${payload.output.xxx} で取得できます。
usageAI モデルの使用量に関するデータ。
usage.completion_tokensAI モデルが生成したトークン数。
usage.prompt_tokensAI モデルにプロンプトとして送信したトークン数。
usage.total_tokensusage.completion_tokensusage.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消費したクレジット。