AI アクションは、AI モデルとプロンプトを指定し、AI モデルに指示や質問をして、AI モデルからのレスポンスを、次のチャネルに送信します。
AI アクションの設定
CONDITION
では、イベントやメッセージの値 (チャネルに送信された MESSAGE や CONTEXT) を使ってアクションを実行する条件を指定できます。入力できる式について詳しくは、アクション、コンディションの記法 を参照してください。
CONFIG
AI モデルの種類や AI モデルへの入力データなどを設定します。
| 項目 | 説明 | ||||||||
|---|---|---|---|---|---|---|---|---|---|
AI モデルを選択します。2024 年 7 月時点で利用できる AI モデルは以下のとおりです。
AI モデルによって決められたクレジットを消費します
| |||||||||
で「OpenAI (GPT-4o mini)」または「OpenAI (GPT-4o)」を選択した場合は、お客様の OpenAI API キーを登録した認証情報を選択します。 お客様の OpenAI API キーを認証情報ストアに登録してくださいあらかじめお客様の OpenAI API キーを、ユーザーコンソールの 認証情報ストアに 登録します。認証情報ストアの「認証情報を登録」画面の表示方法については、認証情報を登録する を参照してください。 認証情報は、以下のように登録します。
| |||||||||
AI モデルに送信する指示や質問を入力します。 4096 文字まで入力できます。
| |||||||||
| AI モデルからの返答を JSON 形式に制限する場合は、チェックを入れます。チェックを入れた場合は、 に「JSON で返却する」旨の指示を含めてください。 | |||||||||
AI モデルに静止画を送信する場合は、チェックを入れて、静止画の URL を指定します。たとえば、この Flux アプリで SORACOM Harvest Files イベントソースを利用する場合は、${event.payload.presignedUrls.get} を指定すると、SORACOM Harvest Files にアップロードしたファイルが生成 AI に送信されます。 | |||||||||
| → | GPT-4o シリーズで利用可能な「システムプロンプト」を入力します。 システムプロンプトは、 で「Azure OpenAI (GPT-4o)」、「OpenAI (GPT-4o mini)」、または「OpenAI (GPT-4o)」のいずれかを指定した場合だけ使用できます。 |
OUTPUT
アクションの出力データの取り扱いを設定します。
| 項目 | 説明 |
|---|---|
| 「有効」にすると、アクションの出力データを別のチャネルに送信できます。 | |
|
AI アクションの出力データ
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.byol | お客様の OpenAI API キーの指定の有無。 |
usage.credit | 消費したクレジット。 |