会話型アクションのサポートは 2023 年 6 月 13 日に終了しました。詳細については、会話型アクションの廃止をご覧ください。

このページは Cloud Translation API によって翻訳されました。

ホームストレージ

Webhook 呼び出しでは、同じパラメータの複数のセッションにまたがるパラメータ値を保存できます。ホームグラフに基づくホームストレージ内の同じ世帯数。アクションで保存された値を後でプロンプトや条件で使用し特定の世帯の家庭用ストレージ内の値に、必要に応じてアクセスできます。

ホームストレージの状態は app.handle() リクエストで渡され、保存されます。 home オブジェクトで指定する必要があります。

制限事項

モバイルデバイスは家のメンバーではないため、ホームストレージは使用できませんグラフ。Webhook コードで、HOME_STORAGE デバイス機能を使用します。ユーザーのデバイスの機能に基づいてビジネスロジックを分岐させることができます。

ホームストレージを使用するには、オプトインする必要があります。

Actions Console で、[デプロイ] >ディレクトリ情報。
[その他の情報] セクションで、ホーム] のチェックボックスをオンにします。ストレージです。

で確認できます。

家庭内のデータの読み取りと書き込み

ホームストレージの値を更新または設定するには、params に値を割り当てます Webhook 呼び出しの home オブジェクトのフィールドを使用します。次の例をご覧ください。「exampleColor」を設定します「red」に変更ホームストレージ:

Node.js

// Assign color to home storage
app.handle('storeColor', conv => {
  let color = 'red';
  conv.home.params.exampleColor = color;
});

JSON

{
  "responseJson": {
    "session": {
      "id": "1234567890123456789",
      "params": {}
    },
    "prompt": {
      "override": false
    },
    "home": {
      "params": {
        "exampleColor": "red"
      }
    }
  }
}

ホームストレージに保存されているデータにアクセスするには、データを Webhook の変数に代入しますあります。次の例では、「exampleColor」から値を取得しています自宅 storage:

Node.js

// Retrieve color from home storage
app.handle('getStoredColor', conv => {
  let color = conv.home.params.exampleColor;
});

JSON

{
  "responseJson": {
    "session": {
      "id": "1234567890123456789",
      "params": {}
    },
    "prompt": {
      "override": false
    },
    "home": {
      "params": {
        "homeColor": "red"
      }
    }
  }
}

以前に保存した値を消去するには、Webhook 呼び出しで値を null に設定します。次の例では、「exampleColor」の値をクリアしていますホームストレージ:

Node.js

// Clear color from home storage
app.handle('clearStoredColor', conv => {
  conv.home.params.exampleColor = null;
});

JSON

{
  "responseJson": {
    "session": {
      "id": "1234567890123456789",
      "params": {}
    },
    "prompt": {
      "override": false
    },
    "home": {
      "params": {}
    }
  }
}

プロンプト内で格納値を参照する

ホームストレージに保存されている値をプロンプトで参照できます。参照値には $home.params.PARAMETER_NAME を使用します。ここで、PARAMETER_NAME は Webhook によって送信されます。

たとえば、色の値をホームストレージに保存していたのは、パラメータ exampleColor。プロンプトでその値にアクセスするには、 $home.params.exampleColor を使用する値:

JSON

{
  "candidates": [{
    "first_simple": {
      "variants": [{
        "speech": "Your favorite color is $home.params.exampleColor."
      }]
    }
  }]
}

条件内で格納された値を参照する

ホームストレージに保存されている値を条件で参照することもできます。宛先値を参照するには、home.params.PARAMETER_NAME を使用します。ここで、PARAMETER_NAME は Webhook によって送信されます。

たとえば、色の値をホームストレージに保存していたのは、パラメータ exampleColor を値「red」と照合します。あります。条件では、値を使用して格納された値を参照します。 home.params.exampleColor。条件式は次のようになります。これを次のように使用します。

条件の構文

home.params.exampleColor == "red"