ms365-copilot-use

name: ms365-copilot-use description: Microsoft 365 Copilot Chat（m365.cloud.microsoft）を Playwright で操作し回答を Markdown/JSON で取得する。「M365 Copilot に聞いて」「Microsoft 365 Copilot に質問」「M365 Copilot で検索」「M365 Copilot の回答を保存」「M365 Copilot の履歴」で発動。 metadata: version: 0.1.0 tier: experimental category: integration tags: - microsoft-365 - copilot - playwright - browser-automation - sso

playwright CLI で導入した Chromium を Python から駆動し、Microsoft 365 Copilot Chat（https://m365.cloud.microsoft/chat）にプロンプトを送って回答を取得する。社内ネットワーク上の Entra ID SSO が効く環境を前提とし、永続プロファイル（user-data-dir）にセッションを保持して 2 回目以降はサインイン不要にする。

セットアップ手順: references/setup-guide.md UI が変わったときの調整方法: references/selectors.md

前提条件

pip install playwright
playwright install chromium

playwright CLI（pip 同梱）で Chromium バイナリを取得する。
既定の永続プロファイル: ~/.ms365_copilot_profile（--user-data-dir で変更可）。
社内 PC（Entra ID 参加）でブラウザを開くとサインインなしに Copilot が利用できる環境であること。SSO が効かない場合は初回のみ headed 起動で手動サインインする。

基本ワークフロー

Step 1: 初回サインイン（headed 起動）

社内 SSO が自動で通る環境ならスキップしてよい。明示的にサインインしたい場合は --login で headed を強制する:

python scripts/ask_copilot.py --login

ブラウザが開いたら、Copilot Chat の入力欄が表示されることを確認して閉じる。~/.ms365_copilot_profile にセッションが永続化される。

Step 2: 質問を送って回答を取得

# 最小: 標準出力に Markdown で出力
python scripts/ask_copilot.py --prompt "今期の社内通達を要約して"

# Markdown と JSON に同時保存（JSON は会話履歴形式）
python scripts/ask_copilot.py \
    --prompt "セキュリティポリシーの更新点を教えて" \
    --output-md ./answer.md \
    --output-json ./conversation.json

# ファイルからプロンプトを読み込む
python scripts/ask_copilot.py --prompt-file ./question.txt --output-md ./answer.md

# 標準入力からプロンプトを読み込む
echo "週次レポートのテンプレを作って" | python scripts/ask_copilot.py --output-md ./answer.md

# 初回サインイン時など UI を確認したい場合は headed で実行
python scripts/ask_copilot.py --prompt "..." --headed

# タイムアウトを延長（既定: 応答待ち 180 秒、UI 描画待ち 60 秒）
python scripts/ask_copilot.py --prompt "..." --response-timeout 300

Step 3: 出力を活用

--output-md: 最終回答を Markdown として保存。CodeBlock / 表 / リスト構造は DOM の見出し・list 要素から再構成する。
--output-json: 1 ターン分の会話履歴を JSON で保存。引用 (citations) があれば citations: [{title, url}] として含める。
何も指定しなければ最終回答を標準出力に Markdown で書き出す。

オプション一覧（`ask_copilot.py`）

オプション	既定	説明
`--prompt TEXT`	—	送信するプロンプト。未指定時は `--prompt-file` か標準入力から読む
`--prompt-file PATH`	—	プロンプトをファイルから読む
`--url URL`	`https://m365.cloud.microsoft/chat`	Copilot Chat の URL
`--user-data-dir PATH`	`~/.ms365_copilot_profile`	永続プロファイルの場所
`--output-md PATH`	—	回答 Markdown の保存先
`--output-json PATH`	—	会話 JSON の保存先
`--headed`	False	headed モードで起動（既定は headless）
`--login`	False	サインイン用に headed で開いて、入力欄が現れるまで待って終了する
`--response-timeout SEC`	180	応答完了まで待つ最大秒数
`--ui-timeout SEC`	60	入力欄の出現を待つ最大秒数
`--stable-seconds SEC`	3	応答テキストが変化しない時間がこの値を超えたら完了とみなす
`--channel msedge\|chromium`	`chromium`	Playwright で使うブラウザチャンネル。社内ポリシーで Edge が必要なら `msedge`
`--screenshot PATH`	—	回答画面のスクリーンショットを保存

出力フォーマット

Markdown（`--output-md`）

# Microsoft 365 Copilot 回答

- 日時: 2026-05-20T12:34:56+09:00
- プロンプト: 今期の社内通達を要約して

## 回答

…回答本文（DOM から再構成した Markdown）…

## 引用

1. [タイトル](https://...)
2. [タイトル](https://...)

JSON（`--output-json`）

{
  "url": "https://m365.cloud.microsoft/chat",
  "timestamp": "2026-05-20T12:34:56+09:00",
  "messages": [
    {"role": "user", "text": "今期の社内通達を要約して"},
    {
      "role": "assistant",
      "text": "…",
      "markdown": "…",
      "citations": [
        {"title": "...", "url": "https://..."}
      ]
    }
  ]
}

進め方の判断フロー

依頼 → サインイン済みか？
  ├─ No → `--login` で headed 起動して SSO 完了を確認
  └─ Yes → `--prompt` で質問を送る
              ├─ 応答が崩れる / セレクタが変わった
              │     → `references/selectors.md` を見て調整
              │     → `--headed --screenshot` で UI を確認
              └─ 正常 → `--output-md` / `--output-json` で保存

エラー対処

エラー / 症状	対処
`playwright` が無い	`pip install playwright && playwright install chromium`
サインイン画面で止まる	`--login --headed` でサインインして再実行。多要素認証要件はブラウザ画面で対応
入力欄が見つからない (`ui-timeout`)	UI 変更の可能性。`--headed --screenshot` で確認し `references/selectors.md` のセレクタ候補を更新
応答が途中で切れる	`--response-timeout` と `--stable-seconds` を増やす
Chromium ではなく Edge が必要	`--channel msedge` を指定
別セッションのロック	同じ `--user-data-dir` を複数プロセスで開かない。`--user-data-dir` を分ける
社内プロキシで起動しない	環境変数 `HTTPS_PROXY` / `HTTP_PROXY` を設定する

スクリプト構成

scripts/
└── ask_copilot.py       ← 質問送信・応答取得・Markdown/JSON 出力
references/
├── setup-guide.md       ← Playwright CLI 導入と SSO 動作確認
└── selectors.md         ← Copilot UI のセレクタと調整方法

制限事項

Copilot の UI は不定期に変わるため、セレクタが破綻したら references/selectors.md を更新する。
ストリーミング中の中間出力は捨て、最終確定の回答だけを Markdown 化する。
ファイル添付・画像生成・プラグイン呼び出しはこのスキルの対象外。
アカウントを跨ぐ場合は --user-data-dir を分ける。

ms365-copilot-use