IBM Cloud Docs
概要: アクションの編集

概要: アクションの編集

AIアシスタント・ビルダーのドキュメントをお探しの場合は、AIアシスタントの構築 をご覧ください。

人間のパーソナル・アシスタントのように、あなたが構築したアシスタントは、顧客がタスクを完了し、質問に答えるのを助ける。 アクションを定義して、アシスタントを作成します。

アクションは、ユーザーのリクエストに応じてアシスタントに達成させたい個別の結果を表します。 アクションは、特定の質問または要求に関する顧客とアシスタントの間の対話で構成されます。 このインタラクションは、アクションを開始するユーザー入力から始まる(たとえば、 I want to withdraw money )。その後、アシスタントがより多くの情報を収集するためにより多くのやりとりが含まれるかもしれません。そして、アシスタントがリクエストを実行するか、顧客の質問に答えるときに終了します。

アクションの作成と編集

アクションの仕組みと、アクションの作成方法を確認するために、例を見てみましょう。

ゼロから新しいアクションを作成すると、 watsonx Assistant、アクションを開始する顧客入力の例を求めるプロンプトが表示されます。 このテキストは、アクションのデフォルト名としても使用されますが、このアクション名は後から編集できます。 また、各アクションには固有の名前が必要です。そのため、既存のアクション名と重複する例を追加しないようにしてください。

「新規アクション」
「新規アクション」

I want to withdraw money と入力し、**「保存」**をクリックしてアクションを作成します。

最初は、アクションを開始する典型的なユーザー入力の例を1つだけ指定する必要があります。 後でユーザー入力の例を追加できます。 詳しくは、 ユーザーの質問または要求について を参照してください。

アクションの流れを可視化する

アクションを作成した後、 「編集」 タブと 「視覚化」 タブを切り替えることができます。 視覚化タブを選択すると、アクションのフローチャートを表示できます。

「エディター」
「エディター」

アクションのフローチャートを表示しているときに、キャンバスをズームしてパンすることができます。

「視覚化」
「視覚化」

アクション・エディターの使用

アクションを作成すると、アクション・エディターが開きます。

新しく作成されたアクション
アクション・エディターが表示されているアクション・エディター

エディター・ウィンドウにアクションが部分部分で表示されます。

  • 表示名 :曖昧さ回避のボタンテキストとして表示されるアクションタイトルを上書きする表示名を設定します。 曖昧さ解消を可能にするには、「 明確な質問をする 」を参照してください。

  • フレーズの例を追加します:顧客がこのアクションを開始するために使用する可能性のあるフレーズを入力します。 より多くのフレーズを入力すればするほど、アシスタントは顧客が何を求めているのかを認識しやすくなる。

  • **「会話ステップ (Conversation steps)」**の下に、アクションを構成するステップが表示されます。 ステップはアシスタントと顧客の間の対話です。ステップは最初から最後まで順番に実行されます。 リストにおいてステップをクリックしてドラッグすることで、アクションにおけるステップを並べ替えることができます。

  • **「プレビュー」**ボタンをクリックすると、アシスタントが顧客入力にどのように応答するのかを示すペインが開きます。 アシスタントはいつでもプレビューすることができ、あなたが加えた変更の効果を確認することができます。

  • 「アクション・ノート」 アイコンを使用すると、説明、文書、コメント、またはその他の注釈を追加できる領域が開きます。これらの注釈は、アクションの作成時に作業を追跡するのに役立ちます。

アクション・エディターは基本的な Markdown 構文をサポートします。

ステップ

アクションは 1 つ以上の_ステップ_で構成されます。 アクションにおけるステップは、そのアクションをトリガーした最初の顧客入力に続く会話ターンを定義します。 単純なケースでは、ステップは、顧客からの質問に対する直接の回答で構成されることがあります。例えば、顧客が What are your business hours? と質問すると、1 ステップのアクションにより We are open Monday through Friday from 9 AM to 5 PM. で応答が返される可能性があります。

しかし、より一般的なのは、顧客の要求を完全に理解するために、アクションが複数のステップを必要とすることである。 I want to withdraw money の例では、詳細情報が必要です。

  • どの口座からお金を引き出せばいいですか?
  • 引き出し金額はいくらですか?

これらのフォローアップの各質問は、アクションにおける 1 つのステップを表します。

ステップの編集

1 つのステップ内で以下のことを定義します。

  • ステップの機能を説明するステップ・タイトル。 ステップ・タイトルはオプションです。
  • ステップが実行時に処理されるかどうかを決定するすべての条件。 (デフォルトでは、ユーザー入力が一致すれば、ステップは常に処理される)
  • ステップの処理時にアシスタントが顧客に伝える内容。
  • アシスタントが伝える内容に顧客がどのように応答できるのかに関するルール (応答が予期される場合)。
  • ステップの終了後にすべきこと。

ステップの一部を表示するアクション・エディター
ステップ

ステップ 1 を編集して、顧客がお金を引き出す口座を確認します。

  1. 「ステップ・タイトルの編集」 アイコンをクリックし、 「アカウントの判別」 というタイトルを入力します。

  2. Is taken フィールドでは、デフォルト値の without conditionsを使用する。 このステップは、すべての引き出しに必ず必要です。

  3. **「アシスタントが伝える内容 (Assistant says)」**フィールドに Withdraw from which account? と入力します。

  4. **「顧客の回答の定義 (Define customer response)」**をクリックします。

    ステップの顧客応答の定義
    顧客応答の定義

    事前定義された選択項目をリストから選択するようにユーザーに要求するため、**「オプション」**をクリックします。 「応答の編集」ウィンドウが開きます。

  5. **「オプション 1」**フィールドに Savings と入力します。 オプション1に値を入力するとすぐに、オプション2のフィールドが表示される。

    「オプション」の回答の編集
    「回答の編集」

    「オプション 2」 をクリックし、 Checking と入力します。

    **「適用」**をクリックして、顧客応答を保存します。

  6. これでステップが期待通りに動くかどうかチェックできる。 **「プレビュー」**をクリックして「プレビュー」ペインを開き、I want to withdraw money と入力します。

    1 つのステップ「
    プレビュー
    」を使用したプレビュー・アクション

    予期したとおり、アシスタントは、お金を引き出す口座を選択するように要求します。

ステップの複製

変数設定とカスタマイズを再作成する必要がないようにステップを複製できます。 ステップを複製することは、前のステップに似ているが多少の変更が必要となるステップを追加しなければならない場合に役立ちます。

ステップを複製するには、以下の手順を実行します。

  1. 複製するステップ上の**「複製」**アイコンをクリックします。

    ステップの「複製」ボタン
    「複製」アイコン

    複製したステップの直後にステップが表示されます。 このステップは複製されたステップと同一です。ステップが重複していることを示す青い円が右上に表示されます。

    「複製されたステップ」
    「複製されたステップ」

  2. 必要に応じて、新しいステップにおける情報を編集します。

条件付きステップの追加

銀行が当座預金口座からの引き出しに手数料を課しており、顧客の理解を確認する必要があるとします。 私たちのアクションは、顧客がどの種類のアカウントを選択するかによって、わずかに異なる動作をする必要があります。 これは、ステップ条件を使用して処理できます。

ステップでユーザーに情報が要求される場合、ユーザーの応答は_アクション変数_として保管されます。 以前のステップで保管されたアクション変数を参照することにより、顧客の以前の応答に基づいてステップ条件を構成できます。

  1. **「新規ステップ (New step)」**をクリックします。

  2. **「ステップ 2 の実行 (Step 2 is taken)」フィールドで「条件付き (with conditions)」**を選択します。 **「条件」**セクションが展開されます。

    アクション・エディター: 条件
    条件の指定

  3. デフォルトでは、前のステップ(Withdraw from which account? )で格納されたアクション変数に基づいて、条件が自動的に作成される。しかし、デフォルトでは、 Savings の値をチェックします。 代わりに値フィールドをクリックして Checking を選択します。

    「条件の編集」
    をチェックする値として「チェック」を選択するための条件の編集

  4. **「アシスタントが伝える内容 (Assistant says)」**フィールドに Withdrawals from checking accounts might incur a fee. Do you want to continue? と入力します。

  5. 「顧客応答の定義」 をクリックし、 「確認」 を選択します。これには、 YesNo の選択肢があります。

    **「適用」**をクリックして、顧客応答を保存します。

  6. お客様が常に明示的に同意することを確認するため、 「設定」 アイコンをクリックして 「お客様の応答設定」 を開き、 「以前のメッセージに関係なく、常にこの情報を確認する」 を選択します。

    「顧客応答設定」
    「顧客応答設定」

ここで、顧客が続行しないことを決定した状況を処理するために、もう1つの条件ステップが必要になる。

  1. **「新規ステップ (New step)」**をクリックします。

  2. **「ステップ 3 の実行 (Step 3 is taken)」フィールドで「条件付き (with conditions)」**を選択します。

  3. ステップ2に対する顧客の返答が No であることをチェックするように、条件を編集する。

    アクション・エディター: 条件の指定
    条件の編集

  4. **「アシスタントが伝える内容 (Assistant says)」**フィールドに Canceling transaction. と入力します。

  5. **「処理 (And then)」フィールドで「アクションの終了」**を選択します。 このステップが実行された場合(顧客が続行しないことを決定したことを意味する)、アクションの後続ステップは実行されない。

ステップ2で、 Yes という応答を処理するための条件付きステップは必要ない。なぜなら、そのような状況では、処理は通常通り続けられるからだ。

金額の取得

顧客の要求を完了するには情報がもう 1 つ必要です。それは、引き出す金額です。

  1. **「新規ステップ (New step)」**をクリックします。

  2. **「アシスタントが伝える内容 (Assistant says)」**フィールドに How much do you want to withdraw? と入力します。

  3. **「顧客の回答の定義 (Define customer response)」**をクリックします。 顧客が金額を指定する必要があるので、「 通貨 」を選択します。

アクションの終了

これで必要な情報はすべて揃った。 この例では、出金するための実際のロジックを実装するつもりはないが、今やっていることをまとめるために最後のメッセージを送ることができる。

この要約を行うには、アクション変数(以前のステップからの顧客の応答を表す)をレスポンスに挿入する必要があります。 実行時に、これらのアクション変数は顧客から供給された実際の値に置き換えられる。

  1. **「新規ステップ (New step)」**をクリックします。

  2. 次に、「OK、amountaccount_type アカウントから引き出します (OK, we will withdraw amount from your account_type account)」という確認メッセージを作成する必要があります。

    この応答を作成するには、「アシスタントが伝える内容 (Assistant says)」フィールドにメッセージのテキストを入力しますが、変数値の代わりに「変数の挿入」 アクション変数アイコン アイコンをクリックして、アクション変数への参照を挿入します。

    • amount に関しては、**「4. いくら引き出しますか? (4. How much do you want to withdraw?)」**を選択します。
    • account_type に関しては、**「1. どの口座から引き出しますか? (1. Withdraw from which account?)」**を選択します。

    アクション・エディター: 変数参照を含むメッセージ

  3. これはアクションにおける最後のステップであるため、顧客応答を指定する必要はありません。

ステップが不要になったと判断した場合は、そのステップをアクションから削除できます。 ステップを削除するには、ステップのタイル上の**「削除」** ステップ削除アイコン アイコンをクリックします。

アクションのテスト

これで、アクションをテストして動作することを確認できます。 **「プレビュー」**をクリックして「プレビュー」ペインを開きます。 以前のテストのテキストがまだ表示される場合は、プレビュー を更新![]更新 アイコンをクリックして会話を再開します。

I want to withdraw money と入力して開始します。 さまざまな入力を試して、アシスタントの動作をテストします。

  • SavingsChecking の両方を選択してみてください。 Checking を選択した場合、アシスタントは料金の発生について警告し、続行するかどうかを尋ねますが、 Savings を選択した場合は警告なしで処理が続行されることを確認します。

  • Checking を選択した場合は、続行するかどうかをアシスタントから尋ねられたときに両方の応答を試してください。 No を選択した場合にアクションが終了することを確認します。

  • 最初のメッセージに追加情報を入れてみてください。 例えば、I want to withdraw $50 from my savings account と入力してみてください。 既に指定した情報を指定するようにアシスタントから再度要求されないことを確認します。

これで完了です。 あなたは、複数のステップを含むシンプルなアクションを作成し、アクション変数として保存する情報を収集し、顧客が選択した内容に基づいてレスポンスを設定します。 アクションではほかにも多くのことが可能ですが、そのすべてがこの基本パターンに基づいて作成されています。

アクション名の変更

アクションの名前を変更したい場合は、以下の手順を実行してください:

  1. 名前を変更したいアクションの Overflow メニュー Overflow アイコンを クリックし、 Rename を選択します。

  2. アクションタイトルフィールドをクリックして、表示されるアクションタイトルを変更します。

  3. 表示名(オプション) フィールドをクリックして、ユーザーに表示されるアクションタイトルを変更します。

検索とフィルタリング・アクション

アクションを検索したい場合は、以下の手順を実行する:

  1. アクションページの検索バーをクリックし、アクション名を入力します。

  2. フィルタアイコンを クリックして、 サブアクション拡張子、または変数でフィルタします。

  3. 「適用」をクリックします。

アクションの制限

作成できるアクション、ステップ、および変数の数は、 watsonx Assistant プラン・タイプによって異なります。

計画の詳細
プラン アクション ステップ 変数
ライト 100 1,000 2,000
トライアル 100 1,000 2,000
プラス 2,000 5,000 8,000
Enterprise 2,000 5,000 8,000
データ分離機能を備えたエンタープライズ 2,000 5,000 8,000