アプリケーションで使用するためのワークフローの作成および有効化
エージェント・アプリケーションは、ワークフロー・タイプのエージェント・チームを使用して構築されます。 これらのエージェント・チームは、エージェント・アプリケーションが表示、アクション、コミュニケーション、サマリー・テキスト、サブタイトル・テキストまたはユーザー問合せ回答を要求したときにレスポンスを提供します。 推奨される方法は、エージェント・チームがOraMessageHint Webフック変数を使用してエージェント・アプリケーションからリクエストを受信することです。 Webフック・メッセージを受信するエージェント・チーム構造を作成し、ワークフローを分岐してから、必要な出力をエージェント・アプリケーションに提供します。
エージェント・アプリケーションでワークフローを使用するには、まずAI Agent Studioからワークフロー・エージェント・チームを有効にする必要があります。
- AI Agent Studioに移動し、「エージェント・チーム」タブを開きます。
- エージェント・アプリケーションで使用するワークフロー・エージェント・チームを編集します。
- 「詳細」タブで、「エージェント・アプリケーションに公開」を選択します。
- 変更を保存します。
OraMessageHint変数
OraMessageHintはアプリケーション対応のプライマリ・ワークフロー変数であり、その値は式$context.$app.$OraMessageHintを使用して取得できます。 これは、アプリがなぜそれを呼び出しているのかをワークフローに伝えます。 プロンプト・テンプレートでは、{{ $context.$app.$OraMessageHint }}などの式を使用します。 コード・ノードでは、値を$context.$app.$OraMessageHintとして使用します。
次に、OraMessageHintの一般的な値を示します。
| 値 | 説明 |
|---|---|
Summary |
アプリケーションがサマリー・テキストを要求していることを示します。 エージェントの拠出金の短い要約テキストを返します。 |
InitSubtitle |
アプリケーションが動的サブタイトルを要求していることを示します。 字幕テキスト自体を返します。 |
InitDisplay |
アプリケーションが起動表示を要求していることを示します。 1つ以上のoraInfoDisplayブロックを返し、起動エクスペリエンスを向上させるアクションおよび通信の提案が含まれる場合もあります。 |
InitActions |
アプリケーションが起動アクションを要求していることを示します。 ゼロ個以上のアクション提案を返します。 |
InitCommunications |
アプリケーションがスタートアップ通信の提案を求めていることを示します。 0個以上のoraCommsブロックを返します。 |
Query |
ユーザーがアプリケーションを介して何かを尋ねたことを示します。 入力メッセージを使用して、ユーザーに回答します。 この応答には、必要に応じて表示、アクションおよびコミュニケーションを含めることもできます。 |
InvokeAction |
UI処理がワークフローに作業を戻したことを示します。 これは、ウィジェット・コマンドがエージェントにコマンドを送信するアクション・パスをトリガーした後のフォローアップ処理に使用します。 |
AdditionalContent |
アプリケーションがフォーカスされたエージェントの下に追加のパネルをロードしていることを示します。 OraPanelNameを使用して、リクエストされているパネルを指定します。 |
FillParameters |
アプリケーションが、生成または送信前に1つ以上のエージェントに通信パラメータを入力するよう求めていることを示します。 |
SendCommunication |
アプリケーションが通信フローを送信または完了するようにターゲット・ワークフローを依頼していることを示します。 |