ynitto ms365-copilot-use
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
playwrightCLI（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を分ける。