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í a dokumenty obsahující citlivá data, nejsou zahrnuty v přepisu konverzace.

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.

    Screenshot uzlu Tables s vybráným Všem.

  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 pár minut, až Power Apps připraví data 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 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ů zveřejněných na Telephony kanálu vyprší konverzace tři minuty po 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 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 následuje ConversationIdBotId 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.
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 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 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.

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. Pro tvorbu vlastních analytických řešení mohou zákazníci importovat surové přepisy do svých datových pipeline 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í

Hromadné mazání v Power Apps automaticky odstraní přepisy agentů 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í.

    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 sekci 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. Vyberte Nové pro spuštění Hromadného mazání. V čarodějce 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, udržujte 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č nevidím přepisy konverzací v tabulce ConversationTranscript v Power Apps?

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.

Důležité

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