工作階段實體

工作階段代表 Dialogflow 代理程式和使用者之間的對話。您可以在工作階段中建立特殊實體，稱為「工作階段實體」。工作階段實體可延伸或取代自訂實體類型，且只會在建立工作階段時存在。所有工作階段資料 (包括工作階段實體) 都會由 Dialogflow 儲存 20 分鐘。

舉例來說，如果您的代理程式具有包含「梨」和「葡萄」的 @fruit 實體類型，則代理程式會根據從使用者收集到的資訊，決定是否要將實體類型更新為包含「蘋果」或「橘子」。更新後的實體類型在後續工作階段中，會納入「apple」或「orange」實體項目。

使用執行要求建立工作階段實體

您可以使用執行服務建立工作階段實體。WebhookResponse 類型包含名為 sessionEntityTypes 的欄位，用於設定工作階段實體。

以下範例說明如何將 fruit 實體類型的實體項目設為目前工作階段的 apple 和 orange。

WebhookResponse 範例：

{
  "fulfillmentMessages": [
    {
      "text": {
        "text": [
          "Choose apple or orange"
        ]
      }
    }
  ],
  "sessionEntityTypes":[
    {
      "name":"projects/project-id/agent/sessions/session-id/entityTypes/fruit",
      "entities":[
        {
          "value":"APPLE_KEY",
          "synonyms":[
            "apple",
            "green apple",
            "crabapple"
          ]
        },
        {
          "value":"ORANGE_KEY",
          "synonyms":[
            "orange"
          ]
        }
      ],
      "entityOverrideMode":"ENTITY_OVERRIDE_MODE_OVERRIDE"
    }
  ]
}

使用 Actions on Google 用戶端程式庫的範例：

如果您使用的是 Actions on Google 用戶端程式庫，可以使用會話實體外掛程式。

程式碼會類似以下內容：

const { sessionEntitiesHelper } = require('actions-on-google-dialogflow-session-entities-plugin')

const app = dialogflow()
    .use(sessionEntitiesHelper())

app.intent('input.welcome', (conv) => {
  conv.ask('make your choice: apple or orange?');
  // Set the fruit session entity values to 'apple' and 'orange'.
  conv.sessionEntities.add({
    name: 'fruit',
    entities: [{
      value: 'APPLE_KEY',
      synonyms: [
        'apple', 'green apple', 'crabapple'
      ]
    }, {
      value: 'ORANGE_KEY',
      synonyms: ['orange']
    }]
  });
  conv.sessionEntities.send();
});

使用 API 建立工作階段實體

注意： 會話實體 API 方法無法與 Google 助理整合。使用 Google 助理整合的服務選項。

您可使用 SessionEntityTypes 類型建立、管理及更新工作階段實體。