こんにちは、Power Platform サポートチームの竹内です。
本記事では Copilot Studio (旧称 Power Virtual Agents) 関連のお問い合わせの際に、調査のために必要となる情報について、その取得手順をご案内致します。
概要
弊社サポートではお問合せを頂いた際のトラブルシューティングにおいてお問い合わせの内容をもとに調査方針を立てております。
発生している事象の把握のため、直面されている事象の切り分けや情報提供をお願いすることがあります。
Copilot Studio (旧称 Power Virtual Agents) に関するサポートサービスへお問合せの際の情報取得手順について以下のとおりご案内いたします。
情報取得手順詳細
1. 事象の発生状況
エラーや意図しない状況がどのような状況下で発生するかお知らせください。
事象の発生条件を特定することで、問題の特定だけではなく弊社環境での再現調査においても有用な情報が得られます。
以下の情報をお知らせいただくことでより明確に事象を把握することができます。
2. 事象発生時のエラーメッセージや画面キャプチャ・動画
エラーの内容を具体的に表すメッセージや画面キャプチャなどの情報をお寄せください。
事象再現時の動画がありますと事象の発生状況をより正確に把握することができます。
エラーメッセージや画面キャプチャ
エラーの内容が分かるよう画面キャプチャをご取得ください。
エラーメッセージ内にタイムスタンプやエラーコードが記載されている場合はそれらの情報を テキスト形式 でご取得ください。
動画
以下のいずれかの方法で事象発生時の動画をご取得ください。
重要
事象発生の事前に取得開始し、事象発生後に採取を行う必要がございます。
- Windows ゲーム バーでの画面収録
ゲーム バーを使用して PC にゲーム クリップを記録する - PowerPoint での画面収録
PowerPoint で画面を記録する - Microsoft Teams での画面収録
Microsoft Teamsで会議を記録する
3. 環境ID
以下の手順で環境 ID を取得し、ご提供ください。
必要に応じて URL をそのままご提供ください。
- Copilot Studio ポータルを開きます。開いている環境が対象の環境であることを確認してください
- URL 内の environments/ の直後にある ID が環境 ID です。
- URL をテキストファイル、あるいは文字列としてメール等に張り付けてご提供ください。
4. Bot ID
以下の手順で環境 ID を取得し、ご提供ください。
必要に応じて URL をそのままご提供ください。
- Copilot Studio ポータル>（対象の環境選択）＞カスタムコパイロット＞対象のコパイロットを開きます。
- URL 内の bots/ の直後にある ID が Bot ID です。
- URL をテキストファイル、あるいは文字列としてメール等に張り付けてご提供ください。
5. Conversation ID
以下の手順で Conversation ID を取得し、ご提供ください。
- Copilot Studio ポータル>（対象の環境選択）＞カスタムコパイロット＞対象のコパイロットを開きます。
- 対象のコパイロットとのチャットウィンドウに ‘/debug conversationid’ とご入力ください。
- 得られた応答をテキストファイルとしてご提供ください。また、下画像と同様のスクリーンショットをご提供ください。
6. 事象再現時のスナップショット zip ファイル
以下の手順でスナップショット zip ファイルを取得し、ご提供ください。
- Copilot Studio ポータル>（対象の環境選択）＞カスタムコパイロット＞対象のコパイロットを開きます。
- 対象のコパイロットとのチャットウィンドウ右上の三点リーダーより、「スナップショットの保存」を選択します。
- 得られた zip ファイルをご提供ください。
7. ナレッジの有効化状態
以下の手順でスクリーンショット画像ファイルを取得し、ご提供ください。
- Copilot Studio ポータル>（対象の環境選択）＞カスタムコパイロット＞対象のコパイロットを開きます。
- 対象のコパイロットの「ナレッジ」セクションで「有効」のトグルボタンがオンであるかを確認します。
- 確認した際の、下画像と同様のスクリーンショットをご提供ください。
8. 会話入出力
以下の手順でスクリーンショット画像ファイルを取得し、ご提供ください。
- Copilot Studio ポータル>（対象の環境選択）＞カスタムコパイロット＞対象のコパイロットを開きます。
- 対象のコパイロットとのチャットウィンドウでコパイロットと会話を行ってください。
- その会話画面について、下画像と同様のスクリーンショットをご提供ください。
9. トピック画面
以下の手順でスクリーンショット画像ファイルを取得し、ご提供ください。
- Copilot Studio ポータル>（対象の環境選択）＞カスタムコパイロット＞対象のコパイロット＞トピックタブを開きます。
- 事象に応じて対象のトピックの全体像や、対象のノードのプロパティなどを表示してください。
- その画面について、下画像のようにスクリーンショットを撮影してご提供ください。
10. 会話トランスクリプションテーブルデータ
下記公開情報にてご案内している方法で、会話トランスクリプションテーブルのデータを取得してください。
取得した zip ファイルをご提供ください。
https://learn.microsoft.com/ja-jp/microsoft-copilot-studio/analytics-sessions-transcripts#export-conversation-transcripts
11. Web ブラウザのネットワーク トレース・コンソール ログ
カスタム Copilot 編集中、あるいは実行中に Copilot Studio サービスへ送信する HTTP リクエストや Copilot Studio サービスから受信する HTTP レスポンスの内容を確認することで通信上の問題を特定します。
重要
事象発生の事前に取得開始し、事象発生後に採取を行う必要がございます。
Note
事象の内容により、netsh trace コマンドやサードパーティ製のツール「Fiddler」によるネットワーク キャプチャの取得をお願いする場合があります。
ブラウザネットワークトレース
ご取得方法は以下公開情報をご参照ください。
ブラウザーでネットワーク トレースを収集する (ブラウザーベースのアプリのみ)
重要
ご取得の際は「ログの保持」「キャッシュを無効にする」にチェックを有効にしご取得ください。
コンソールログ
Console タブをクリックし、ログ領域を右クリックし 「名前を付けて保存」 にて保存いたします。
補足
本手順は執筆時点でのユーザー インターフェイスを基に紹介しています。バージョンアップによって若干の UI の遷移など異なる場合があります。その場合は画面の指示に従って進めてください。
※本情報の内容（添付文書、リンク先などを含む）は、作成日時点でのものであり、予告なく変更される場合があります。