Vysvětlení stažených přepisů konverzací z Power Apps

Přepisy interakcí zákazníků s vaším agentem můžete zobrazit, exportovat a stáhnout v Power Apps i Copilot Studiu. Informace, které každá aplikace exportuje, se mírně liší.

Important

Tvůrci s rolí Tvůrce prostředí nemají automaticky přístup k přepisům.

Tento článek se zabývá stahováním přepisů konverzací v Power Apps a jejich používáním k vytváření sestav v Power BI. Pokud chcete stáhnout přepisy přímo v Copilot Studiu, viz Stáhnout přepisy konverzací v Copilot Studiu.

Ve výchozím nastavení Power Apps stahuje přepisy konverzací z posledních 30 dnů. Doby uchovávání můžete změnit.

Note

Odpovědi agenta, které používají SharePoint jako zdroj znalostí a používají dokumenty, které obsahují citlivá data, nejsou součástí přepisu konverzace.

Přepisy konverzací nejsou psány pro:

  • Microsoft Dataverse pro prostředí Teams
  • Prostředí pro vývojáře Dataverse
  • Agenti Microsoft 365 Copilot

Předpoklad

Zobrazení a export přepisů konverzací z portálu Power Apps

  1. Přihlaste se ke službě Power Apps.

  2. V postranním podokně vyberte Tabulky a pak vyberte Vše.

    Screenshot uzlu tabulek s vybraným všechny.

  3. Do pole Vyhledávání zadejte „konverzace“.

  4. Vyberte tabulku ConversationTranscript.

    Otevře se stránka pro tabulku ConversationTranscript.

  5. V horní nabídce vyberte Export>Export dat.

    Kompilace dat pro export trvá několik minut.

    Snímek obrazovky zobrazující nabídku Export s možností Exportovat data.

  6. Počkejte několik minut, než Power Apps připraví data pro export, a pak vyberte Načíst exportovaná data.

    Soubor se uloží jako archiv ZIP do výchozího umístění pro stahování ve vašem prohlížeči.

Principy přepisů konverzací

Přepis konverzace existuje jako tabulka v Dataverse, kterou si můžete stáhnout jako CSV (hodnoty oddělené čárkou). Logika, která určuje, kdy a jak systém zaznamenává informace do přepisů konverzací, je:

  • Systém uloží konverzaci do záznamu přepisu po 30 minutách nečinnosti. Pokud konverzace pokračuje po době nečinnosti, systém uloží nové aktivity do nového záznamu se Name stejnou hodnotou, ale s novou ConversationStartTime hodnotou.
  • U agentů nasazených na kanálu Telephony vyprší konverzace po třech minutách od události Konec konverzace.
  • Každý záznam má limit 1 MB pro přepis (Content sloupec). Když je přepis větší než tento limit, systém jej rozdělí na více záznamů, všechny mají NameConversationStartTime stejné hodnoty, ale jiné Metadata.BatchId hodnoty.
  • Pro sloučení přepisů vezměte všechny záznamy se Name stejnými hodnotami a ConversationStartTime poté je seřaďte podle .BatchId

Následující tabulka popisuje nejdůležitější pole, která najdete v přepisech konverzací.

Pole Description Example
Content Celý přepis ve formátu JSON Viz Pole obsahu
ConversationStartTime Čas zahájení konverzace (nikoli čas, kdy došlo k zápisu záznamu přepisu do úložiště dat) 2021-04-19T20:39:09Z
ConversationTranscript Jedinečný identifikátor řádku v tabulce Dataverse 28eccb77-xxxx-4a63-985f-ffaaadd6f391
Metadata JSON, který zahrnuje ID agenta, ID tenanta, jméno agenta a batch ID {"BotId": "aaaabbbb-0000-cccc-1111-dddd2222eeee", "AADTenantId": "bbbbcccc-1111-dddd-2222-eeee3333ffff", "BotName": "Test Bot", "BatchId":2}
Name Název vlastního řádku vytvořeného z ConversationId, po kterém následuje BotId 8YYe8iif49ZKkycZLe7HUO_198eca5f-1145-4ae6-8c08-835d884a8688
Bot_ConversationTranscript ID agenta aaaabbbb-0000-cccc-1111-dddd2222eeee
Created on Datum a čas vytvoření záznamu přepisu 2021-04-20T02:40:13Z

Pole obsahu

Pole Content je nezpracovaný protokol všech aktivit, které uživatelé s agentem prováděli. Mezi běžné typy aktivit patří zpráva a událost:

  • Aktivity typu Zpráva představují obsah zobrazený v konverzaci. Zprávy mohou obsahovat text, řeč, interaktivní karty a binární nebo neznámé přílohy.
  • Aktivity událostí sdělují agentovi programové informace od klienta nebo z kanálu.

Další informace o typech aktivit naleznete v dokumentu Schéma Bot Framework Activity.

Následující tabulka popisuje některá klíčová pole v kódu JSON obsahu:

Key Description
ID Jedinečný identifikátor GUID pro identifikaci objektu aktivity
valueType Typ hodnoty uložené v aktivitě; určuje, jaké informace aktivita poskytuje (Běžné typy hodnot aktivity)
timestamp Časové razítko, kdy byla aktivita vygenerována, ve formátu Epoch (počet sekund od půlnoci UTC 1. ledna 1970)
type Typ aktivity, například message, event nebo trace
replyToId ID aktivity, na kterou aktuální aktivita odpovídá
from Obsahuje pole id a role:
  • id – ID volajícího prvku
  • role – 0 nebo 1
    • 0 – aktivita pochází od agenta
    • 1 – aktivita pochází přichází od uživatele interagujícího s agentem
Poznámky:
id lze použít k výpočtu počtu aktivních uživatelů, kteří interagují s agentem, pokud plátno předává jedinečné ID uživatele. Pokud plátno nepředá ID, je předáno jedinečné ID pro každou konverzaci.
Pro bezpečnost a soukromí systém před zápisem ID do výpisu hashuje.
channelId ID kanálu, odkud aktivita pochází, např. directline, msteams nebo facebook
textFormat Formát textu, například plain nebo markdown
attachments Dynamická bohatá data přidružená k aktivitě; například AdaptiveCards, HeroCards nebo Carousel data
text Text pro aktivity message
value Pole specifická pro aktivitu na základě typu hodnoty, v tomto poli se nachází většina užitečných informací
channeldata Obsahuje data kanálu:
  • pro zprávy:
    • DialogTraceDetail
    • DialogErrorDetail
    • VariableDetail (obsahuje hodnotu přiřazenou proměnné)
    • CurrentMessageDetail
  • pro události:
    • cci_trace_id
    • traceHistory
    • enableDiagnostics
    • clientTimestamp
    • clientActivityId
name Název aktivity události, například SetPVAContext

Běžné typy hodnot aktivity

Typ hodnoty aktivity Description
ConversationInfo Jestli je konverzace z testovacího podokna Copilot Studia (isDesignMode) a národního prostředí konverzace
CSATSurveyRequest Uživateli se zobrazí průzkum spokojenosti zákazníků (CSAT)
CSATSurveyResponse Uživatel odpoví na průzkum CSAT
DialogRedirect Uživatel je přesměrován na jiné téma
ImpliedSuccess Uživatel dosáhl uzlu otázky v tématu, kde jedna z podmínek ukazuje na systémové téma CSAT Potvrzený úspěch (pouze klasičtí roboti) nebo volá systémové téma Konec konverzace.
IntentRecognition Uživatel spustil téma
PRRSurveyRequest Uživatel byl dotázán, zda téma odpovědělo na jeho otázku z tématu Konec konverzace
PRRSurveyResponse Odpověď uživatele na to, zda téma odpovědělo na jeho otázku z tématu Konec konverzace
SessionInfo Typ (unengaged nebo engaged), výsledek (Escalated, Resolved, ), Abandončas začátku a konce seance (startTimeUtc, endTimeUtc), a počet tahů během sezení
VariableAssignment Hodnota je přiřazena do proměnné

Vylepšené přepisy

Můžete nastavit agenty tak, aby generovali rozšířené přepisy obsahující data na úrovni uzlů. Tato data pomáhají sledovat tok konverzace v rámci tématu. Například v tématu správa objednávek si uživatelé mohou vybrat mezi odesláním nové objednávky nebo načtením existující. Data na úrovni uzlů umožňují analýzu chování uživatelů napříč těmito možnostmi.

Zapnutí rozšířených přepisů

  1. Otevřete svého agenta.

  2. Přejděte na Nastavení>Rozšířené.

  3. Vyberte Vylepšit přepisy a poté zapněte Zahrnout detaily na úrovni uzlů do přepisů.

Snímek obrazovky zobrazující stránku nastavení rozšířených přepisů.

Data na úrovni uzlu

Když zapnete rozšířené přepisy, přepis obsahuje nodeTraceData typ aktivity pro každý uzel, který téma vyvolá. Následující tabulka popisuje klíčová pole v hodnotě aktivity nodeTraceData.

Key Description
nodeID Identifikátor uzlu
nodeType Typ uzlu, např. SendActivity nebo SearchAndSummarizeContent
startTime Časové razítko, kdy byl uzel vyvolán
endTime Časové razítko, kdy uzel dokončil provádění
topicDisplayName Téma vyvolávající uzel

Vlastní analýza

Některé scénáře, jako je filtrování konverzací na základě vlastní proměnné, vyžadují vlastní přístup k analýze. Pokud chcete vytvářet vlastní analytická řešení, můžou zákazníci ingestovat nezpracované přepisy do svých datových kanálů nebo použít doplněk, například sadu Copilot Studio Kit.

Řešení Conversation KPIs v sadě Copilot Studio Kit automaticky parsuje přepisy a vkládá agregovaná data do tabulek Dataverse.

Změna výchozí doby uchovávání

Úloha hromadného odstranění Power Apps automaticky odebere přepisy agenta, které jsou starší než 30 dnů. Chcete-li přepisy uchovávat déle, zrušte stávající úlohu a vytvořte novou, která bude probíhat podle jiného plánu.

Note

Pokud změníte výchozí dobu uchovávání dat, ovlivní to jenom vlastní analýzy. Doba uchovávání pro stránku Analýza v Copilot Studio nemá vliv.

Zrušení stávající úlohy hromadného odstranění

  1. V Power Apps vyberte Nastavení>Pokročilá nastavení.

    Portál Dynamics 365 se otevře na nové kartě.

    Screenshot nabídky nastavení Power Apps se zvýrazněnou možností Upřesnit nastavení.

  2. Vyberte kurzor vedle Nastavení. V části System vyberte Správa dat.

    Screenshot nabídky Nastavení se zvýrazněnou možností Správa dat.

  3. Zvolte Hromadné odstranění záznamů.

  4. V seznamu Zobrazení vyberte Opakující se systémové úlohy hromadného odstraňováná.

    Snímek obrazovky Opakující se systémové úlohy hromadného odstraňování.

  5. Vyberte úlohu Hromadné odstranění záznamů přepisu konverzace starších než 1 měsíc.

    Screenshot seznamu úloh hromadného odstranění se zvýrazněnou první úlohou.

  6. V seznamu Více akcí vyberte Zrušit.

    Screenshot seznamu Další akce se zvýrazněnou možností Zrušit.

Vytvoření nové úlohy hromadného odstranění

  1. Vyberte Nové pro spuštění Průvodce hromadným mazáním. V průvodci vyberte Další.

  2. Nastavte následující kritéria vyhledávání:

    • V seznamu Hledat vyberte ConversationTranscripts.
    • Vyberte ConversationStartTime, vyberte Starší než X měsíců a zadejte „12“.
      Toto nastavení uchovává přepisy po dobu 12 měsíců. Vyberte si jiné srovnání a hodnotu, pokud chcete.
    • Vyberte SchemaType, ponechte equals a zadejte "PowerVirtualAgents".

    Screenshot nastavení kritérií pro hromadné vyhledávání zaměstnání.

  3. Vyberte Další.

  4. Zadejte název úlohy, vyberte možnost Spustit tuto úlohu každých a zadejte 1. Pokud nechcete, aby úloha běžela každý den, zvolte jiný plán.

    Screenshot nastavení názvu úlohy hromadného odstranění a spuštění.

  5. Zvolte Další a pak vyberte Odeslat.

Proč se mi v tabulce Power Apps ConversationTranscript nezobrazují přepisy konverzací?

Správci mohou zakázat ukládání přepisů do Dataverse. Pro více informací o tom, jak se výpisy ukládají a jak spravovat přístup, viz Kontrola přístupu k přepisům.

Important

Přepisy nejsou ukládány pro agenty nasazené ve vývojových prostředích.

Tipy, jak z přepisů konverzací vytěžit maximum

Používejte proměnné k ukládání dat relevantních pro obsah vašeho agenta nebo uživatele agenta. Analýzou proměnné a její hodnoty z přepisu konverzace můžete data filtrovat nebo řezat podle této proměnné.

Přepisy konverzací mohou odkazovat na obsah pouze podle ID. Například v uzlu Přesměrování se na cílové téma odkazuje pouze podle jeho ID. Pokud chcete získat název tohoto tématu, vyhledejte jeho ID v obsahu agenta.

  • Last updated on