Udostępnij za pośrednictwem


Zbiorcze pobieranie transkrypcji konwersacji w Power Apps

Możesz wyświetlać, eksportować i pobierać transkrypcje interakcji klientów z agentem w obu Power Apps miejscach Copilot Studio. Informacje eksportowane przez każdą aplikację są nieco inne.

Ważne

Twórcy z rolą twórcy środowiska nie mają automatycznie dostępu do transkrypcji.

W tym artykule omówiono pobieranie transkrypcji konwersacji w usłudze Power Apps i używanie ich do tworzenia raportów w usłudze Power BI. Aby pobrać transkrypcje bezpośrednio w programie Copilot Studio, zobacz Pobieranie transkrypcji konwersacji w Copilot Studio.

Domyślnie usługa Power Apps pobiera transkrypcje konwersacji z ostatnich 30 dni. Możesz zmienić domyślny okres przechowywania.

Notatka

Odpowiedzi agentów, które używają SharePoint jako źródła wiedzy, nie są uwzględniane w transkrypcjach konwersacji.

Transkrypcje konwersacji nie są pisane dla:

  • Środowiska: Microsoft Dataverse for Teams
  • Środowiska programistyczne Dataverse
  • Agenci funkcji Microsoft 365 Copilot

Warunek wstępny

Wyświetlanie i eksportowanie zapisów konwersacji botów z portalu Power Apps

  1. Zaloguj się w Power Apps.

  2. W bocznym okienku nawigacji wybierz kolejno pozycje Dane i Tabele.

    Zrzut ekranu przedstawiający opcję Wszystkie zaznaczone w węźle Tabele.

  3. Wpisz „konwersacja” w polu Wyszukaj.

  4. Wybierz tabelę ConversationTranscript.

    Zostanie otwarta strona tabeli ConversationTranscript.

  5. Na górnym pasku menu wybierz Eksportuj>Eksportuj dane.

    Dane, które mają zostać skompilowane na podstawie danych eksportowanych, muszą zostać skompilowane w ciągu kilku minut.

    Zrzut ekranu przedstawiający menu Eksportuj z opcją Eksportuj dane.

  6. Poczekaj kilka minut, aż aplikacja Power Apps przygotuje dane do eksportu, a następnie wybierz opcję Pobierz wyeksportowane dane.

    Plik jest zapisywany jako archiwum ZIP w domyślnej lokalizacji pobierania przeglądarki.

Zrozumienie transkrypcji konwersacji

Transkrypcja rozmowy to plik CSV (wartości rozdzielane przecinkami). W poniższej tabeli opisano najważniejsze pola transkrypcji konwersacji.

Pole Podpis Przykład
Content Cała transkrypcja w formacie JSON Zobacz Pola treści
ConversationStartTime Rzeczywista godzina rozpoczęcia konwersacji (nie godzina zapisania jej w magazynie danych) 2021-04-19T20:39:09Z
ConversationTranscript Unikatowy identyfikator wiersza danych w tabeli Dataverse 28eccb77-xxxx-4a63-985f-ffaaadd6f391
Metadata JSON zawierający identyfikator agenta, identyfikator dzierżawy i nazwę agenta {"BotId": "aaaabbbb-0000-cccc-1111-dddd2222eeee", "AADTenantId": "bbbbcccc-1111-dddd-2222-eeee3333ffff", "BotName": "Test Bot"}
Name Nazwa wiersza niestandardowego, który jest tworzony na podstawie, ConversationId, a po nim BotId, nastepnie batch number. Numer partii wskazuje kolejność, gdy dla rozmowy odbywa się wiele sesji analitycznych. Klasyczny gry nie zawierają numeru wsadowego. 8YYe8iif49ZKkycZLe7HUO-o_198eca5f-xxxx-4ae6-8c08-835d884a8688_0
Bot_ConversationTranscript Identyfikator agenta aaaabbbb-0000-cccc-1111-dddd2222eeee
Created on Data i godzina utworzenia rekordu transkrypcji 2021-04-20T02:40:13Z

Pola treści

Pole Content to nieprzetworzony dziennik wszystkich działań, które użytkownicy odbyli z agentem. Typowe działania obejmują komunikat i zdarzenie:

  • Komunikat oznacza treści wyświetlane w rozmowie. Komunikat może zawierać tekst, mowę, karty interaktywne oraz binarne lub nieznane załączniki.
  • Wydarzenie komunikuje informacje programowe od klienta lub kanału do agenta.

Aby uzyskać więcej informacji dotyczących typów działań, zobacz schemat działania Bot Framework.

W poniższej tabeli opisano niektóre kluczowe pola w kodzie JSON zawartości:

Key Podpis
ID Unikatowy identyfikator GUID dla obiektu działania
valueType Typ wartości przechowywanej w działaniu; określa informacje dostarczane przez działanie (Typy wspólnych wartości działań)
timestamp Sygnatura czasowa wygenerowania aktywności w formacie Epoka (liczba sekund od północy UTC 1 stycznia 1970 r.)
type Typ działania: np. message, event lub trace
replyToId Identyfikator działania, na które odpowiada bieżące działanie
from Zawiera pola id i role:
  • id— Identyfikator wywołującego
  • role— zawiera 0 lub 1
    • 0 — działanie pochodzi od agenta
    • 1 — działanie użytkownika z interakcji z agentem
Można użyć
id do obliczenia liczby aktywnych użytkowników prowadzących interakcje z agentem, jeśli kanwa przekazuje unikatowy identyfikator użytkownika. Jeśli kanwa nie przekaże identyfikatora, na każdą rozmowę jest przekazywany unikatowy identyfikator.
Ze względów bezpieczeństwa i prywatności identyfikator jest haszowany przed zapisaniem go w transkrypcji.
channelId Identyfikator kanału, z którego pochodzi działanie (np. directline, msteams, facebook)
textFormat Format tekstu: np. plain lub markdown
attachments Dynamiczne, bogate dane skojarzone z działaniem, na przykład AdaptiveCards, HeroCards lub Carousel data
text Tekst działań message
value Pole specyficzne dla działania na podstawie typu wartości. To pole zawiera większość użytecznych informacji
channeldata Zawiera dane kanału:
  • komunikaty:
    • DialogTraceDetail
    • DialogErrorDetail
    • VariableDetail (zawiera wartość przypisaną do zmiennej)
    • CurrentMessageDetail
  • dla zdarzeń:
    • cci_trace_id
    • traceHistory
    • enableDiagnostics
    • clientTimestamp
    • clientActivityId
name Nazwa działania dotyczącego zdarzenia, np. SetPVAContext

Typy powszechnych wartości działań

Typ wartości działań Podpis
ConversationInfo Czy konwersacja pochodzi z okienka testowego Copilot Studio (isDesignMode) oraz ustawienia regionalne konwersacji
CSATSurveyRequest Użytkownik otrzymuje ankietę dotyczącą zadowolenia klienta (CSAT)
CSATSurveyResponse Użytkownik odpowiada na ankietę CSAT
DialogRedirect Użytkownik jest przekierowywany do innego tematu
ImpliedSuccess Użytkownik dotarł do węzła pytania w temacie, w którym jeden z warunków wskazuje na temat systemowy Potwierdzony sukces CSAT (tylko klasyczne boty) lub wywołuje temat systemowy Koniec rozmowy
IntentRecognition Użytkownik uruchomił temat
PRRSurveyRequest Użytkownik został zapytany, czy temat odpowiedział na jego pytanie z tematu Koniec konwersacji
PRRSurveyResponse Odpowiedź użytkownika, czy temat odpowiedział na jego pytanie na stronie Koniec konwersacji
SessionInfo Typ (unengaged lub engaged), wynik (Escalated, Resolved, Abandon) oraz liczba tur sesji
VariableAssignment Wartość przypisano do zmiennej

Transkrypcje rozszerzone

Agentów można skonfigurować do generowania rozszerzonych transkrypcji, które zawierają dane na poziomie węzła. Te dane pomagają śledzić przebieg konwersacji w ramach danego tematu. Na przykład w temacie dotyczącym zarządzania zamówieniami użytkownicy mogą wybrać między przesłaniem nowego zamówienia a pobraniem istniejącego. Dane na poziomie węzła umożliwiają analizę zachowań użytkowników w ramach tych opcji.

Włączanie rozszerzonych transkrypcji

  1. Otwórz agenta.

  2. Przejdź do obszaru Ustawienia>Zaawansowane.

  3. Wybierz pozycję Rozszerz transkrypcje, a następnie włącz opcję Uwzględnij szczegóły na poziomie węzła w transkrypcjach.

Zrzut ekranu przedstawiający stronę ustawień rozszerzonej transkrypcji.

Dane na poziomie węzła

Gdy transkrypcje rozszerzone są włączone, typ działania nodeTraceData jest wyświetlany w transkrypcji dla każdego węzła, który został wywołany przez temat. Wprowadź wartości dla pól zgodnie z opisem w nodeTraceData.

Key Podpis
nodeID Identyfikator węzła
nodeType Typ węzła, na przykład SendActivity lub SearchAndSummarizeContent
startTime Czas wywołania węzła
endTime Sygnatura czasowa zakończenia przeprowadzania węzła
topicDisplayName Temat wywołujący węzeł

Analizy niestandardowe

Niektóre scenariusze, takie jak filtrowanie konwersacji na podstawie zmiennej niestandardowej, wymagają niestandardowego podejścia do analizy. Klienci tworzący niestandardowe rozwiązania analityczne mogą pozyskiwać nieprzetworzone transkrypcje do swoich potoków danych lub używać dodatku, takiego jak Copilot Studio zestaw

Rozwiązanie Wskaźnik KPI konwersacji w Copilot Studio zestawie automatycznie analizuje transkrypcje i wypełnia zagregowane dane w Dataverse tabelach.

Zmień domyślny okres przechowywania

Rozważ skonfigurowanie zadania usuwania zbiorczego Power Apps w celu automatycznego usuwania wygenerowanych przez usługę Copilot transkrypcji agentów starszych niż 30 dni. Aby zachować dłuższy zapis, należy anulować istniejące zadanie i utworzyć nowe, które będzie przebiegać zgodnie z innym harmonogramem.

Anulowanie istniejącego zadania usuwania zbiorczego

  1. Wybierz w Power Apps Ustawienia>Ustawienia zaawansowane.

    Zrzut ekranu przedstawiający menu Ustawienia Power Apps z wyróżnionym Ustawienia zaawansowane.

    Portal usługi Dynamics 365 zostanie otwarty na nowej karcie.

  2. Na pasku nawigacji zaznacz Ustawienia, a następnie w obszarze System wybierz pozycję Zarządzanie danymi.

    Zrzut ekranu menu Ustawienia z podświetlonym zarządzaniem danymi.

  3. Wybierz pozycję Zbiorcze usuwanie rekordów.

  4. Na liście Widok wybierz System powtarzających się masowych usunięć zadań.

    Zrzut ekranu listy cyklicznych zadań usuwania zbiorczego.

  5. Wybierz zadanie Zbiorcze usuwanie rekordów zapisów rozmów dla konwersacji starsze niż 1 miesiąc.

    Zrzut ekranu listy zadań usuwania zbiorczego z wyróżnionym pierwszym zadaniem.

  6. Z listy Więcej akcji wybierz pozycję Anuluj.

    Zrzut ekranu przedstawiający listę Więcej akcji i wyróżniony przycisk Anuluj.

Utwórz nowe zadanie usuwania zbiorczego

  1. Aby uruchomić Kreatora usuwania zbiorczego, wybierz pozycję Nowy , a następnie w kreatorze wybierz pozycję Dalej.

  2. Ustaw następujące kryteria wyszukiwania:

    • Z listy Wyszukaj wybierz ConversationTranscripts.
    • Wybierz ConversationStartTime, wybierz Starsze niż X miesięcy i wpisz „12”.
      To ustawienie przechowuje transkrypcje przez 12 miesięcy. Wybierz inne porównanie i wartość.
    • Wybierz opcję SchemaType, pozostaw wartość Równa się i wprowadź „powervirtualagents”.

    Zrzut ekranu ustawień kryteriów wyszukiwania zadań usuwania zbiorczego.

  3. Wybierz Dalej.

  4. Wprowadź nazwę dla zadania i wybierz Uruchamiaj to zadanie co i wpisz 1. Jeśli nie chcesz codziennie uruchamiać zadania, wybierz inny harmonogram.

    Zrzut ekranu zbiorczego usuwania nazwy zadania i ustawień uruchamiania.

  5. Wybierz Dalej, a następnie wybierz Prześlij.

Dlaczego nie widzę transkrypcji konwersacji w tabeli ConversationTranscript Power Apps ?

Administratorzy mogą uniemożliwić zapisywanie transkrypcji w Dataverse. Aby uzyskać więcej informacji na temat zapisywania transkrypcji i zarządzania dostępem, zobacz Kontrola dostępu do transkrypcji.

Ważne

Transkrypcje nie są przechowywane dla agentów wdrożonych w środowiskach deweloperskich.

Porady dotyczące maksymalnego wykorzystania transkrypcji

Zmienne mogą służyć do przechowywania danych ważnych dla treści agenta lub dla użytkownika. Analizując zmienną i jej wartość w transkrypcie rozmowy, można filtrować lub fragmentować dane według zmiennej.

Transkrypcje rozmowy odwołują się do treści według jej identyfikatora. Na przykład w węźle przekierowania temat docelowy jest określany tylko przez jego ID. Aby uzyskać nazwę tego tematu, wyszukaj jego identyfikator w zawartości agenta.