Power Apps での会話トランスクリプトのダウンロード

2025-04-22

Power Apps と Copilot Studio の両方で、お客様とエージェントとのやり取りのトランスクリプトを表示、エクスポート、ダウンロードすることができます。各アプリがエクスポートする情報はわずかに異なります。

重要

環境作成者 ロールを持つ作成者は、トランスクリプトに自動的にアクセスすることはできません。

この記事では、Power Apps で会話トランスクリプトをダウンロードし、それらを使用して Power BI でレポートを作成する方法について説明します。トランスクリプトを Copilot Studio で直接ダウンロードするには、会話のトランスクリプトを Copilot Studio でダウンロードするをご覧ください。

既定では、Power Apps 過去 30 日間の会話トランスクリプトをダウンロードします。保持期間は変更できます。

注意

SharePoint をナレッジソースとして使用するエージェントの応答は、会話のトランスクリプトには含まれません。

会話トランスクリプトは、次の目的では作成されません。

Microsoft Dataverse for Teams 環境
Dataverse 開発環境
Microsoft 365 Copilot エージェント

前提条件

会話のトランスクリプトを表示するには、トランスクリプトビューアーのセキュリティロールが必要です。管理者のみがトランスクリプト閲覧者のセキュリティロールを付与できます。

Power Apps ポータルからボットの会話のトランスクリプトを表示してエクスポートする

Power Apps にサインインします。
サイドペインで、テーブル を選択し、すべて を選択します。
検索ボックスに、「会話」と入力します。
会話トランスクリプト テーブルを選択します。

会話トランスクリプト テーブルのページが開きます。
上部にあるメニューバーで、エクスポート>データのエクスポートを選択します。

データがエクスポート用にコンパイルされるまで数分かかります。
Power Apps でエクスポート用のデータを準備するのに数分かかるのを待ってから、エクスポートされたデータをダウンロードする を選択します。

ファイルはブラウザの既定のダウンロード場所に ZIP アーカイブとして保存されます。

会話トランスクリプトを理解する

会話トランスクリプトは、CSV (カンマ区切り値) ファイルです。以下の表は、会話トランスクリプトでの最も重要なフィールドを示します。

Field	プロパティ	例
`Content`	JSON 形式のトランスクリプト全体	コンテンツフィールドを参照してください
`ConversationStartTime`	会話が開始した時刻 (データストアに書き込まれたトランスクリプトレコードの時刻ではない)	`2021-04-19T20:39:09Z`
`ConversationTranscript`	Dataverse テーブルの行の一意の識別子	`28eccb77-xxxx-4a63-985f-ffaaadd6f391`
`Metadata`	エージェントID、テナントID、エージェント名を含むJSON	`{"BotId": "aaaabbbb-0000-cccc-1111-dddd2222eeee", "AADTenantId": "bbbbcccc-1111-dddd-2222-eeee3333ffff", "BotName": "Test Bot"}`
`Name`	`ConversationId` の後に `BotId` を続け、その後に `batch number` を続けることで作成されるカスタム行の名前です。バッチ番号は、会話に複数の分析セッションがある場合の順序を示します。クラシックボットにはバッチ番号は含まれません。	`8YYe8iif49ZKkycZLe7HUO-o_198eca5f-xxxx-4ae6-8c08-835d884a8688_0`
`Bot_ConversationTranscript`	エージェントの ID	`aaaabbbb-0000-cccc-1111-dddd2222eeee`
`Created on`	トランスクリプトレコードが作成された日時	`2021-04-20T02:40:13Z`

コンテンツフィールド

Content フィールドは、ユーザーがエージェントと行ったすべてのアクティビティの生のログです。一般的な活動タイプには、メッセージとイベントがあります。

メッセージ活動は、会話内に表示されるコンテンツを表します。メッセージ活動には、テキスト、スピーチ、インタラクティブカード、バイナリまたは不明な添付ファイルが含まれる場合があります。
イベントアクティビティは、クライアントまたはチャネルからエージェントにプログラム情報を伝達します。

活動タイプの詳細については、Bot Framework 活動スキーマを参照してください。

次の表では、コンテンツ JSON でのいくつかの主要なフィールドについて説明します:

Key	プロパティ
`ID`	活動オブジェクトの一意の GUID
`valueType`	アクティビティに保存される値のタイプです。アクティビティが提供する情報を指定します (一般的なアクティビティ値のタイプ)
`timestamp`	活動がエポック形式で生成されたときのタイムスタンプ (UTC 時間で 1970 年 1 月 1 日午前 0 時からの秒数)
`type`	活動のタイプ; たとえば、`message`、`event`、または `trace`
`replyToId`	現在の活動が応答している活動の ID
`from`	フィールド `id` と `role` が含まれています: `id` - 呼び出し元の ID `role` - 0 または 1 を保持します 0 - 活動はエージェントから来ています 1 - 活動はエージェントと対話しているユーザーから来ています注: `id` は、キャンバスがユーザーの一意の ID を渡す場合、エージェントとインタラクトしているアクティブユーザーの数を計算するために使用できます。キャンバスが ID を渡さない場合、会話ごとに一意の ID が渡されます。セキュリティとプライバシーのため、ID はトランスクリプトに書き込まれる前にハッシュされます。
`channelId`	アクティビティの発生元となるチャネルのID。例: `directline`、 `msteams`、または `facebook`
`textFormat`	テキストのフォーマット; たとえば、`plain`、または `markdown`
`attachments`	活動に関連付けられた動的なリッチデータ; たとえば、`AdaptiveCards`、`HeroCards`、または `Carousel data`
`text`	`message` 活動のテキスト
`value`	値タイプに基づく活動に固有のフィールド; このフィールドには、ほとんどの有用な情報が存在します
`channeldata`	次のチャネルデータが含まれています: メッセージに対して: `DialogTraceDetail` `DialogErrorDetail` `VariableDetail` (変数に割り当てられた値が含まれます) `CurrentMessageDetail` イベントに対して: `cci_trace_id` `traceHistory` `enableDiagnostics` `clientTimestamp` `clientActivityId`
`name`	イベント活動の名前; 例えば、`SetPVAContext`

一般的な活動値タイプ

活動値のタイプ	プロパティ
`ConversationInfo`	Copilot Studio テストウィンドウ (`isDesignMode`) および会話のロケールからの会話がからのものであるかどうか
`CSATSurveyRequest`	ユーザーには、顧客満足度 (CSAT) 調査が表示されます
`CSATSurveyResponse`	ユーザーは CSAT 調査に回答します
`DialogRedirect`	ユーザーは別のトピックにリダイレクトされます
`ImpliedSuccess`	ユーザーがトピックの質問ノードに到達しました。ここで、条件の 1 つが "確認済みの成功" CSAT システムトピック (クラシックボットのみ) を指しているか、会話の終了システムトピックを呼び出しています
`IntentRecognition`	ユーザーがトピックをトリガーしました
`PRRSurveyRequest`	ユーザーは、トピックが会話の終わりトピックからの質問に回答したかどうかを尋ねられました
`PRRSurveyResponse`	トピックが会話の終わりトピックからの質問に回答したかどうかに対するユーザーの応答
`SessionInfo`	タイプ (`unengaged` または `engaged`)、結果 (`Escalated`、`Resolved`、`Abandon`)、セッションのターンカウント
`VariableAssignment`	値が変数に割り当てられます

拡張トランスクリプト

エージェントは、ノードレベルのデータを含む拡張トランスクリプトを生成するように設定できます。このデータは、トピック内の会話の流れを追跡するのに役立ちます。例えば、注文の管理 トピックでは、ユーザーは新しい注文を送信するか、既存の注文を取得するかを選択できます。ノードレベルのデータにより、これらのオプション全体でユーザーの行動を分析できます。

拡張トランスクリプトをオンにする

エージェントを開きます。
設定>詳細に移動します。
トランスクリプトを拡張する を選択し、次に トランスクリプトにノードレベルの詳細を含める をオンにします。

拡張トランスクリプト設定ページを示すスクリーンショット。

ノードレベルのデータ

拡張トランスクリプトをオンにすると、トピックによって呼び出された各ノードのトランスクリプトに nodeTraceData アクティビティの種類が表示されます。次の表で、nodeTraceData アクティビティ値の主要フィールドを説明します。

Key	プロパティ
`nodeID`	ノード識別子
`nodeType`	ノードの種類 (例えば、`SendActivity`、または `SearchAndSummarizeContent`)
`startTime`	ノードが呼び出されたときのタイム・スタンプ
`endTime`	ノードの実行が完了したときのタイムスタンプ
`topicDisplayName`	ノードを呼び出すトピック

カスタム分析

カスタム変数に基づいて会話をフィルター処理するなど、一部のシナリオでは分析にカスタムアプローチが必要です。カスタム分析ソリューションを構築する顧客は、生のトランスクリプトをデータパイプラインに取り込むか、 Copilot Studio Kit などのアドオンを使用できます

Copilot Studio Kit 内の会話 KPI ソリューションは、トランスクリプトを自動的に解析し、集計データを Dataverse テーブルに入力します。

既定の保持期間の変更

Power Apps の一括削除ジョブは、30 日以上前のエージェントのトランスクリプトを自動的に削除します。トランスクリプトをより長く保持するには、既存のジョブをキャンセルして、別のスケジュールで実行される新しいジョブを作成します。

既存の一括削除ジョブをキャンセルする

Power Apps で設定>高度な設定 を選択します。

Dynamics 365 ポータルが新しいタブで開きます。
設定の横にあるキャレットを選択してから、システムの下で、データ管理を選択します。
レコードの一括削除を選択します。
ビュー リストで、定期的な一括削除システムジョブを選択します。
1 か月以上前の会話のトランスクリプトレコードを一括削除するジョブを選択します。
その他のアクション リストで、キャンセルを選択します。

新しい一括削除ジョブの作成

一括削除ウィザードを開始するには、新規を選択し、ウィザードで次へを選択します。
次の検索条件を設定します。
- 検索リストで、ConversationTranscripts を選択します。
- ConversationStartTime を X か月以上前に設定して「12」にします。
  この設定により、12 か月間トランスクリプトが維持されます。必要に応じて、別の比較と値を選択してください。
- SchemaType を選択し、equals のままにして、「powervirtualagents」と入力します。
次へを選択します。
ジョブの名前を入力し、毎回このジョブを実行するを選択して 1 と入力します。ジョブを毎日実行したくない場合は、別のスケジュールを選択してください。
次へを選択し、続いて送信を選択します。

ConversationTranscript Power Apps テーブルに自分の会話記録が表示されないのはなぜですか？

管理者は、トランスクリプトの保存を Dataverse に設定することができます。トランスクリプトの保存方法やアクセス管理の詳細については、トランスクリプトへのアクセスを管理するをご覧ください。

重要

トランスクリプトは、開発者環境にデプロイされたエージェントには保存されません。

会話の記録を最大限に活用するためのヒント

変数を使用して、エージェントコンテンツまたはエージェントユーザーに関連するデータを保存できます。会話トランスクリプトから変数とその値を解析すると、変数でデータをフィルタリングまたはスライスできます。

会話のトランスクリプトは、ID のみでコンテンツを参照することができます。たとえば、Redirect ノードでは、宛先トピックは ID によってのみ参照されます。このトピックの名前を取得するには、エージェントコンテンツでその ID を検索します。