Sprawdzone metody wycofywania

Ten przewodnik zawiera informacje na temat komunikacji z użytkownikami i ścieżek migracji związanych z działaniami konwersacyjnymi, które zostaną wycofane 13 czerwca 2023 r. Obejmują one następujące obszary:

  • Etapy wycofywania: jak działają działania po premierze.
  • Polecane wiadomości: sugerowane powiadomienia, które możesz dodać do akcji.
  • Potencjalne ścieżki migracji: opcje utrzymania użytkowników po zachodzie słońca.

Aktywne posty na blogu (opcjonalnie)

Każde działanie, agencja i firma są inne. Oprócz uzupełnienia działań za pomocą komunikatów zalecanych w tym przewodniku możesz też opublikować posta na blogu, który rozwieje te częste wątpliwości użytkowników:

  • Co się dzieje?
  • Kiedy się zmieni?
  • Jak mogę nadal korzystać z podobnych funkcji?

Zalecamy uwzględnienie opcji ścieżki migracji wraz z ogłoszeniami o wycofaniu wszystkich funkcji. Twój post można udostępnić przez e-mail, newsletter lub media społecznościowe.

Etapy wycofywania

W tabeli poniżej znajdziesz informacje o tym, jak zachowują się czynności powodujące konwersacje, jak będą się one zmieniać po dacie wyłączenia usługi oraz o zalecanych aktualizacjach, które możesz przekazać użytkownikom.

Przed datą wycofania usługi (13 czerwca 2023 r.) Po wycofaniu
Działanie Istniejące działanie Wywołanie działania jest wyłączone
Zalecane aktualizacje dla deweloperów Dodaj powiadomienie o zachodzie słońca do działań (rekomendacje) Nie dotyczy
Aktualizacje Google dotyczące UX W wywołaniu Google może wyświetlić powiadomienie o zamianie tekstu na mowę, które informuje, że po dacie wyłączenia funkcja nie będzie już dostępna. W wywołaniu Google udostępnia zamianę tekstu na mowę informującą użytkownika, że to działanie nie jest już dostępne.

Jeśli nie zdecydujesz się na wyłączenie działania przed datą wycofania, użytkownicy, którzy ją wywołają, otrzymają powiadomienie TTS udostępnione przez Google. Dokładny tekst tego powiadomienia jest wciąż zdefiniowany, ale ostateczna treść nie będzie zawierać informacji o migracji użytkowników.

Polecane wiadomości

Najlepszym sposobem na poinformowanie użytkowników o nadchodzącym zachodzie jest powiadomienie ich za każdym razem, gdy wywołają działanie. W ten sposób możesz też przedstawić im ścieżki migracji do podobnych funkcji.

  • Cel wiadomości: powiadomienie użytkowników o nadchodzącej zmianie i dostępnych opcjach migracji.

  • Okres wysyłania wiadomości: zacznij powiadamiać użytkowników co najmniej 30 dni przed wycofaniem (13 maja – 13 czerwca 2022 r.).

Obsługa zapytań o zachód słońca

Aby móc odpowiadać na pytania użytkowników dotyczące wycofania interfejsu API, utwórz nową globalną intencję niestandardową, która korzysta z tego sugerowanego sformułowania:

  • date wyłączymy Action Name. Więcej informacji znajdziesz w sekcji short link | migration path message”.

Obszar interaktywny

Inteligentny ekran z banerem powiadomień.

Jeśli akcja używa interaktywnego obszaru roboczego, dodaj baner powiadomień na stronie wczytywania obszaru roboczego z tym przykładowym tekstem:

  • Action Name wyłączy się date. Szczegółowe informacje znajdziesz na shortlink url”.
  • „Aplikacja Action Name zostanie wyłączona date, migration path message”.

Informacje opcjonalne

Istnieją też inne sposoby na aktualizowanie istniejących działań, aby powiadamiać użytkowników o nadchodzącej zmianie. Rozważ dodanie do istniejących już wiadomości zachęcających do działania tych powiadomień:

  • existing message. Przypominamy też, że Action Name (wyłączy | wyłączy) date”.
  • existing message. Action Name informuje też, że date (migration path) zostanie wyłączone (wyłączone)”.

Możesz też dodać powiadomienia o funkcjach specjalnych, które może zastosować Twoja akcja:

  • Wywołania precyzyjnych linków: wyświetlaj informacyjną kartę podstawową (przykład).

  • Wiadomości Last prompt: możesz dodać wiadomość last prompt (przykładową) do dowolnego z tych typów komunikatów:

    • Wbudowane intencje (BII). Dotyczy BIG, opowiadania historii i edukacji.
    • Sugestie rutyn.
    • Komunikaty powitalne.
  • Komunikaty wyjściowe: możesz też dodać specjalny komunikat last prompt (przykład) do próśb o zakończenie. (actions.intent.CANCEL).

  • Powiadomienia push – do tych powiadomień push, które korzystają z kreatora działań lub Dialogflow, dodaj sugerowany tekst:

    • „Przypomnienie: firma Action Name zostanie wyłączona date, szczegóły znajdziesz na stronie shortlink url”.
    • „Przypomnienie: Action Name zostanie wyłączone date (migration path message).

Potencjalne ścieżki migracji

Chociaż może nie istnieć analogiczna ścieżka migracji z działania konwersacyjnego, weź pod uwagę poniższe opcje w zależności od potrzeb użytkownika i dostępnych zasobów dla programistów.

Treści multimedialne

Działania związane z multimediami umożliwiają użytkownikom odkrywanie Twoich treści w Asystencie Google i rozpoczęcie odtwarzania treści bezpośrednio w aplikacji. Możesz pomóc użytkownikom przejść na działania multimedialne za pomocą tego przykładowego komunikatu:

  • „W każdej chwili możesz nas znaleźć, mówiąc: „OK Google, zagraj w Media Brand Name”.
  • „W każdej chwili możesz nas znaleźć, mówiąc: OK Google, posłuchaj „utworu” w usłudze Media Brand Name”.

Działania związane z multimediami różnią się od działań konwersacyjnych:

  • Działania związane z multimediami (ang. Media Actions) nie dają interakcji bezpośrednio z osobami trzecimi, ale za pomocą Asystenta i firmy zewnętrznej.
  • Działania związane z multimediami nie są konwersacyjne, obsługują tylko zapytania typu „pojedyncze ujęcie”.

Aplikacje na Androida

Akcje w Asystencie to funkcja Androida, która umożliwia użytkownikom uruchamianie i sterowanie aplikacjami na Androida za pomocą Asystenta. Za pomocą tego przykładowego komunikatu możesz poinformować użytkowników o działaniach w aplikacji:

  • „W każdej chwili możesz nas znaleźć, mówiąc „OK Google, otwórz App Name”.
  • „Aby otworzyć naszą aplikację na Androida, powiedz „OK Google, BII w aplikacji App Name”.
  • „Aby zainstalować naszą aplikację na Androida, powiedz „OK Google, otwórz App Name”.

Akcje w aplikacji różnią się od działań konwersacyjnych:

  • Interfejsy API BBI App oferują ograniczoną obsługę języka i regionu.
  • Do uruchamiania działań w aplikacji wymagana jest aplikacja na Androida.
  • Inteligentne ekrany nie obsługują działań w aplikacji.
  • Akcje w aplikacji nie są konwersacyjne, obsługują tylko zapytania typu „pojedyncze ujęcie”.

Sprzęt

Inteligentny dom Google umożliwia programistom włączanie urządzeń głosowych za pomocą Asystenta. Za pomocą tego przykładowego przekazu możesz poinformować użytkowników o inteligentnych działaniach w domu:

  • „W każdej chwili możesz porozmawiać z nami, korzystając z device name dostępnego na stronie store
  • „Możesz porozmawiać z nami przez aplikację device name w aplikacji Google Home”

Inteligentne funkcje na stronie głównej różnią się od działań konwersacyjnych:

  • Inteligentny dom można dodawać tylko na zgodnych urządzeniach.
  • Inteligentny dom nie obsługuje konwersacji, obsługuje tylko zapytania typu „pojedyncze ujęcie”.

Agenty czatu

W oknie oknie wymiany wiadomości z użytkownikami czatu są dostępne te usługi:

  • Dialogflow CX udostępnia zaawansowany typ agenta w przypadku dużych i złożonych agentów. Integracja obejmuje bramę telefoniczną Dialogflow CX, Dialogflow Messenger, Messengera z Facebooka i LINE. Zobacz pełną listę integracji.
  • Dialogflow EX udostępnia standardowy typ agenta odpowiedni dla mniejszych, prostszych agentów. Integracja obejmuje narzędzia Slack, Telegram, LINE, Messenger z Facebooka oraz Workplace from Meta i nie tylko. Zobacz pełną listę integracji.

Aby poinformować użytkowników o agentach czatu, użyj tych przykładowych wiadomości:

  • „Aby uzyskać pomoc w przyszłości, zadzwoń pod numer support number”.
  • Aby skorzystać z przyszłej pomocy, odwiedź naszą stronę: short link url”.
  • „Aby poznać nowe opinie, porozmawiaj z nami na kanale Company Name Slack”.

Usługi agentów czatu różnią się od działań konwersacyjnych:

  • Agenty nie są obsługiwane na inteligentnych ekranach.
  • Agenty nie mogą integrować się z Asystentem.

Obsługa klienta

Rozmawiaj szybciej z klientami dzięki czatbotom, botom głosowym i punktom pomocy telefonicznej, które są wbudowane w usługi Contact Center AI, takie jak Agent Assist i CCAI Insights. Aby edukować użytkowników na temat opcji obsługi klienta, skorzystaj z tego przykładu:

  • Aby uzyskać pomoc w przyszłości, zadzwoń pod numer support number”.
  • Aby skorzystać z przyszłej pomocy, odwiedź naszą stronę: short link url”.
  • Aby w przyszłości przesyłać opinie, porozmawiaj z nami na kanale „Nazwa firmy” na Slacku”.

Opcje obsługi klienta różnią się od działań konwersacyjnych:

  • Nie są one obsługiwane na inteligentnych ekranach.
  • Nie mogą przeprowadzić integracji z Asystentem.

Witryny

Możesz kierować użytkowników do funkcji oferowanych przez Twoją witrynę. Za pomocą tego przykładowego komunikatu możesz poinformować użytkowników o dostępnych opcjach internetowych:

  • „Aby uzyskać pomoc w przyszłości, odwiedź naszą stronę: short link url”.

Witryny różnią się od działań konwersacyjnych:

  • Inteligentne ekrany nie obsługują witryn.
  • Witryny nie mogą zostać zintegrowane bezpośrednio z Asystentem

Przykładowe fragmenty kodu

Wykorzystaj te przykładowe fragmenty kodu, aby utworzyć odpowiedzi dotyczące zachodzącego słońca dla czynności konwersacyjnych.

Przykład karty podstawowej

YAML

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: 
    

JSON

{
  "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": ""
            }
          }
        }
      }
    }
  ]
}
      

Node.js

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: '',
        },
    })
  }));
});
    

JSON

{
  "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 ."
      }
    }
  }
}
      

Przykład ostatniego monitu

YAML

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 

JSON

{
  "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 "
          }
        ]
      }
    }
  ]
}

Node.js

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 '
  }));
});

JSON

{
  "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 "
      }
    }
  }
}

Przykład ostatniego monitu (zakończenia/anulowania)

YAML

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.

JSON

{
  "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."
          }
        ]
      }
    }
  ]
}

Node.js

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.'
  }));
});

JSON

{
  "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."
      }
    }
  }
}