Рекомендации по прекращению поддержки

В этом руководстве представлены способы обмена сообщениями с пользователями и пути перехода для диалоговых действий, поддержка которых будет прекращена 13 июня 2023 г. Оно охватывает следующие области:

• Фазы устаревания : как действия действуют сегодня и после прекращения поддержки.
• Рекомендуемые сообщения : рекомендуемые уведомления для добавления в ваши действия.
• Потенциальные пути миграции : варианты сохранения пользователей после закрытия.

Проактивные публикации в блоге (необязательно)

Каждое действие, агентство и бизнес уникальны. Помимо обновления ваших действий с помощью сообщений, рекомендованных в этом руководстве, рассмотрите возможность публикации сообщения в блоге, которое активно отвечает на следующие распространенные проблемы пользователей:

• Что происходит?
• Когда мой опыт изменится?
• Как я могу продолжать получать аналогичную функциональность?

Мы рекомендуем включать варианты пути миграции в любые объявления об устаревании. Вашим постом можно поделиться по электронной почте, в новостной рассылке и в социальных сетях.

Фазы устаревания

В следующей таблице описано, как ведут себя диалоговые действия сегодня, как они изменятся после даты прекращения действия, а также рекомендуемые обновления, которые вы можете внести, чтобы информировать своих пользователей.

Если вы решите не отключать свое действие заранее до даты прекращения поддержки, пользователи, вызвавшие его, получат уведомление TTS от Google. Точная формулировка этого уведомления еще не определена, но окончательная формулировка не будет содержать информацию о миграции для ваших пользователей.

Рекомендуемые сообщения

Лучший способ сообщить пользователям о предстоящем закате — уведомлять их всякий раз, когда они вызывают ваше действие. Вы также можете использовать эту возможность, чтобы рассказать им о путях перехода к аналогичным функциям.

• Цель сообщения: уведомить пользователей о предстоящих изменениях и проинформировать их о доступных вариантах миграции.

• Сроки обмена сообщениями: начните уведомлять пользователей как минимум за 30 дней до прекращения поддержки (13 мая 2022 г. – 13 июня 2022 г.).

Обработка запросов о закате

Чтобы конкретно ответить на вопросы пользователей об устаревании, создайте новое глобальное пользовательское намерение , в котором используется предложенный набор слов:

• «Мы отключаем Action Name на date . Для получения подробной информации перейдите short link | migration path message ».

Интерактивный холст

Если в вашем действии используется интерактивный холст , добавьте на страницу загрузки холста баннер уведомления со следующим примером формулировки:

• « Action Name будет отключено в указанную date . Подробную информацию можно найти по shortlink url ».
• « Action Name будет отключено в указанный date , migration path message ».

Дополнительные коммуникации

Существуют дополнительные способы обновления существующих действий, чтобы уведомить пользователей о предстоящих изменениях. Рассмотрите возможность добавления уведомлений об устаревании к существующим сообщениям о действиях:

• « existing message . Кроме того, просто напоминаю вам, что Action Name будет (выключение | отключение) в date ».
• « existing message . Кроме того, просто сообщаю вам, что Action Name будет (выключение | отключение) по date , migration path ».

Вы также можете добавить уведомления о любых специальных функциях, которые может реализовать ваше действие:

• Вызовы глубоких ссылок : отображение информационной базовой карты ( образец ).

• Last prompt . Вы можете добавить last prompt ( образец ) к любому из следующих типов подсказок:

  • Встроенные намерения (BII). Применимо к BII Play Game, Storytelling и Education.
  • Обычные предложения.
  • Приветственные подсказки.

• Подсказки о выходе . Вы также можете добавить специальное last prompt ( образец ) к подсказкам о выходе ( actions.intent.CANCEL ).

• Push-уведомления . Добавьте следующую предложенную формулировку ко всем push-уведомлениям, созданным с помощью Action Builder или Dialogflow:

  • «Напоминание: Action Name будет прекращено в date . Для получения подробной информации перейдите по shortlink url ».
  • «Напоминание: Action Name будет отключено в указанную date , migration path message .

Потенциальные пути миграции

Хотя аналогичный путь миграции из вашего диалогового действия может отсутствовать, рассмотрите следующие варианты, исходя из потребностей вашего пользователя и доступных ресурсов разработчика.

Примеры кода

Используйте эти примеры кода для создания ответов, связанных с закатом солнца, для ваших диалоговых действий.

Пример базовой карты

candidates:
  - first_simple:
    variants:
    - speech: >-
      We are turning off  on . For more details check out 
    text: >-
      We are turning off  on . For more details check out 
    content:
      card:
        title: Turning Off 
        subtitle: 
        text: >-
          `We are turning off  on . For more details check out .`
        button:
          name: Learn more
          open:
            url: 
    

{
  "candidates": [
    {
      "first_simple": {
        "variants": [
          {
            "speech": "We are turning off  on . For details, check out .",
            "text": "We are turning off  on . For details, check out ."
          }
        ]
      },
      "content": {
        "card": {
          "title": "Turning Off ",
          "subtitle": "",
          "text": "`We are turning off  on . For details, check out .`",
          "button": {
            "name": "Learn more",
            "open": {
              "url": ""
            }
          }
        }
      }
    }
  ]
}
      

app.handle('Card', conv => {
  conv.add('We are turning off  on . For details, check out .');
  conv.add(new Card({
    "title": "Turning Off ",
    "subtitle": "",
    "text": "Card Content",
    "button": new Link({
      name: 'Learn more',
      open: {
          url: '',
        },
    })
  }));
});
    

{
  "responseJson": {
    "session": {
      "id": "session_id",
      "params": {}
    },
    "prompt": {
      "override": false,
      "content": {
        "card": {
          "title": "Turning Off ",
          "subtitle": "",
          "text": "We are turning off  on . For, details check out .",
          "button": {
            "name": "Learn more",
            "open": {
              "url": ""
            }
          }
        }
      },
      "firstSimple": {
        "speech": "We are turning off  on . For details, check out .",
        "text": "We are turning off  on . For details, check out ."
      }
    }
  }
}
      

Последний пример подсказки

candidates:
  - first_simple:
      variants:
        - speech: 
          text: 
    last_simple:
      variants:
        - speech: Also, just reminding you that  will be turning off on 
          text: Also, just reminding you that  will be turning off on 

{
  "candidates": [
    {
      "first_simple": {
        "variants": [
          {
            "speech": "",
            "text": ""
          }
        ]
      },
      "last_simple": {
        "variants": [
          {
            "speech": "Also, just reminding you that  will be turning off on ",
            "text": "Also, just reminding you that  will be turning off on "
          }
        ]
      }
    }
  ]
}

app.handle('Simple', conv => {
  conv.add(new Simple({
    speech: '',
    text: ''
  }));
  conv.add(new Simple({
    speech: 'Also, just reminding you that  will be turning off on ',
    text: 'Also, just reminding you that  will be turning off on '
  }));
});

{
  "responseJson": {
    "session": {
      "id": "session_id",
      "params": {}
    },
    "prompt": {
      "override": false,
      "firstSimple": {
        "speech": "",
        "text": ""
      },
      "lastSimple": {
        "speech": "Also, just reminding you that  will be turning off on ",
        "text": "Also, just reminding you that  will be turning off on "
      }
    }
  }
}

Пример последнего запроса (Выход/Отмена)

candidates:
  - first_simple:
      variants:
        - speech: 
          text: 
    last_simple:
      variants:
        - speech: Also, just reminding you that  will be turning off on . Bye.
          text: Also, just reminding you that  will be turning off on . Bye.

{
  "candidates": [
    {
      "first_simple": {
        "variants": [
          {
            "speech": "",
            "text": ""
          }
        ]
      },
      "last_simple": {
        "variants": [
          {
            "speech": "Also, just reminding you that  will be turning off on . Bye.",
            "text": "Also, just reminding you that  will be turning off on . Bye."
          }
        ]
      }
    }
  ]
}

app.handle('Simple', conv => {
  conv.add(new Simple({
    speech: '',
    text: ''
  }));
  conv.add(new Simple({
    speech: 'Also, just reminding you that  will be turning off on . Bye.',
    text: 'Also, just reminding you that  will be turning off on . Bye.'
  }));
});

{
  "responseJson": {
    "session": {
      "id": "session_id",
      "params": {}
    },
    "prompt": {
      "override": false,
      "firstSimple": {
        "speech": "",
        "text": ""
      },
      "lastSimple": {
        "speech": "Also, just reminding you that  will be turning off on . Bye.",
        "text": "Also, just reminding you that  will be turning off on . Bye."
      }
    }
  }
}