Sdílet prostřednictvím

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

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

Důležité

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

Tento článek popisuje stahování přepisů konverzací v Power Apps a jejich použití k vytváření sestav v Power BI. Pokud chcete přepisy stáhnout přímo v Copilot Studio, přečtěte si téma Stažení přepisů konverzací v Copilot Studio.

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

Poznámka:

Odpovědi agentů, které používají SharePoint jako zdroj znalostí, nejsou zahrnuty v přepisech konverzací.

Přepisy konverzací nejsou psány pro:

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

Požadavek

Zobrazte a exportujte přepisy konverzací z portálu Power Apps

  1. Přihlaste se k Power Apps.

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

    Snímek obrazovky zobrazující vybranou položku Vše v uzlu Tabulky.

  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 data připraví k exportu, a pak vyberte Stáhnout 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 Dataverse a lze jej stáhnout jako soubor CSV (hodnoty oddělené čárkou). Následující popisuje logiku, která určuje, kdy a jak jsou informace zaznamenány do přepisů konverzací:

  • Konverzace se uloží do záznamu o přepisu po 30 minutách nečinnosti. Pokud konverzace pokračuje po uplynutí nečinnosti, nové aktivity se uloží do nového záznamu se stejnou Name hodnotou, ale s novou ConversationStartTime hodnotou.
  • Každý záznam má limit 1MB pro přepis (Content sloupec). Když je přepis větší než tento limit, přepis je rozdělen na více záznamů, všechny mají stejné Name hodnoty a ConversationStartTime hodnoty, ale s různými Metadata.BatchId hodnotami.
  • Pro sloučení přepisů byste měli vzít všechny záznamy se stejnými Name hodnotami a ConversationStartTime pak je seřadit podle .BatchId

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

Pole Popis Příklad
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 následovaného 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:

Klíč Popis
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.
ID je před zapsáním do přepisu hashováno z důvodu zabezpečení a ochrany soukromí.
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 Popis
ConversationInfo Zda konverzace pochází z testovacího podokna aplikace Copilot Studio (isDesignMode) a národní 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 zahájení a ukončení relace (startTimeUtc, endTimeUtc) a počet změn stavu relace
VariableAssignment Hodnota je přiřazena do proměnné

Vylepšené přepisy

Agenty je možné nakonfigurovat tak, aby generovali rozšířené přepisy, které zahrnují data na úrovni uzlu. 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 zapněte Zahrnout do přepisů podrobnosti na úrovni uzlu.

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

Data na úrovni uzlu

Když jsou zapnuté rozšířené přepisy, zobrazí se v přepisu typ aktivity nodeTraceData pro každý uzel, který byl vyvolán tématem. Následující tabulka popisuje klíčová pole v hodnotě aktivity nodeTraceData.

Klíč Popis
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. Zákazníci, kteří vytvářejí vlastní analytická řešení, mohou surové přepisy načítat do svých datových řetězců nebo použít doplňky, jako je Copilot Studio Kit.

Řešení Conversation KPI v Copilot Studio Kit automaticky analyzuje přepisy a vyplňuje 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.

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

  1. V Power Apps vyberte Nastavení>Rozšířená nastavení.

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

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

  2. Vyberte kurzor vedle Nastavení a v části Systém 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. Pokud chcete spustit Průvodce hromadným odstraněním, vyberte Nový a pak 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ů. Pokud chcete, zvolte jiné srovnání a hodnotu.
    • Vyberte SchemaType, ponechte je rovno 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č nevidím přepisy konverzací v tabulce ConversationTranscript v Power Apps?

Správci mohou zakázat ukládání přepisů do Dataverse. Další podrobnosti, jak jsou přepisy ukládány a jak spravovat přístup, najdete v tématu Řízení přístupu k přepisům.

Důležité

Přepisy se neukládají pro agenty nasazené ve vývojářských prostředích.

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

K ukládání dat relevantních pro obsah vašeho agenta nebo uživatele agenta lze použít proměnné. Analýza proměnné a její hodnoty z přepisu konverzace vám umožní filtrovat nebo rozdělit data podle 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