DailyAzureUpdatesGenerator

Azure Updates 自動要約

English version

English Version is here

概要

Azure Updates の自動要約が updates ディレクトリに保存されています。 自動要約機能は、GitHub Actions の repository_dispatch（daily-update）で起動され、直近の Azure Updates 情報を収集して日本語要約を生成します。

免責事項

自動要約レポートは、RSS フィードから取得した情報を元に生成されており、正確性や完全性を保証するものではありません。利用者は、提供された情報を自己責任で使用してください。 もし興味がある内容があれば、レポート中に含まれるリンクを参照して、元の情報を確認することをお勧めします。

Azure Updates RSS フィード処理アプリケーション

このアプリケーションは、Azure Updates の RSS フィードを読み込み、指定した時間以内に更新があった Azure の Update 情報を Azure OpenAI（Chat Completions）で日本語に要約し、マークダウン形式でファイルに出力します。

機能

• 堅牢な RSS フィード取得: 複数の URL を試行して確実にフィードを取得
• 詳細モード: Azure Updates API から詳細情報を取得（--details オプション）
• バックフィルモード: 期間指定で日次レポートを再生成（--backfill-* オプション）
• 指定時間内の新しい更新のフィルタリング
• Azure OpenAI を使用した日本語要約生成
• マークダウン形式での詳細レポート出力
• 包括的なエラーハンドリングとリトライ機能
• 詳細なログ出力とモニタリング
• テストモード: フィード取得のテスト機能

必要な環境変数（DefaultAzureCredential 認証版）

アプリケーションを実行する前に、以下の環境変数を設定してください：

• AOAI_ENDPOINT: Azure OpenAI エンドポイント URL
• DEPLOYMENT: Azure OpenAI デプロイメント名
• API_VER: Azure OpenAI API バージョン（デフォルト: 2025-01-01-preview）
• CHECK_HOURS: チェック対象時間（時間単位、デフォルト: 24）
• AZURE_TENANT_ID: Azure AD テナント ID（オプション）
• AZURE_CLIENT_ID: クライアント ID（オプション）
• AZURE_CLIENT_SECRET: クライアントシークレット（サービスプリンシパル認証時に使用）
• ENABLE_AZURE_SDK_LOG: Azure SDK ログを有効化（オプション、true/1/on/yes で有効。未設定時は抑制）

認証方式は DefaultAzureCredential で自動判定されます。

• AZURE_TENANT_ID + AZURE_CLIENT_ID + AZURE_CLIENT_SECRET: サービスプリンシパル認証
• AZURE_TENANT_ID + AZURE_CLIENT_ID（+ OIDC コンテキストが有効）: OIDC / Workload Identity 認証
• AZURE_TENANT_ID + AZURE_CLIENT_ID（+ マネージド ID 有効環境）: マネージド ID 認証
• ローカル開発: az login 済みの Azure CLI 認証

インストール

1. 必要なパッケージをインストール：

pip install -r requirements.txt

1. RSS フィードのテスト：

test_feed.bat

または

python getlatestupdate_mid.py --test-feed --verbose

使用方法

テスト実行（推奨：最初に実行）

# RSS フィードのテスト取得
python getlatestupdate_mid.py --test-feed --verbose

# バッチファイルでのテスト実行
test_feed.bat

基本的な使用方法

python getlatestupdate_mid.py

オプション付きの実行

# 過去12時間の更新をチェック
python getlatestupdate_mid.py --hours 12

# 詳細モード（Azure Updates APIから詳細情報を取得）
python getlatestupdate_mid.py --details

# 出力ディレクトリを指定
python getlatestupdate_mid.py --output-dir reports

# 詳細ログを出力
python getlatestupdate_mid.py --verbose

# RSSフィードのテストのみ実行
python getlatestupdate_mid.py --test-feed

# 複数のオプションを組み合わせ（詳細モード + 詳細ログ + 72時間）
python getlatestupdate_mid.py --details --verbose --hours 72

# 過去7日分を再生成（既存ファイルはスキップ）
python getlatestupdate_mid.py --details --backfill-days 7

# 期間指定で再生成（開始日〜終了日）
python getlatestupdate_mid.py --details --backfill-startdate 2026-02-01 --backfill-enddate 2026-02-07

# 既存ファイルを強制上書き
python getlatestupdate_mid.py --details --backfill-days 3 --force

詳細モードの使用方法

詳細モード（--details）では、RSS フィードの情報に加えて Azure Updates API から詳細な情報を取得します：

# 詳細モードで実行
python getlatestupdate_mid.py --details

# 詳細モードを含む実行例バッチファイル
run_details_example.bat

詳細モードの特徴：

• Azure Updates API から各記事の詳細情報を取得
• より正確で完全な記事タイトルと本文を使用
• API から取得した情報をレポートに表示
• 詳細な情報源の追跡とログ出力

環境変数の設定例（Windows）

set AOAI_ENDPOINT=https://your-openai-resource.openai.azure.com
set DEPLOYMENT=gpt-4-mini
set API_VER=2025-01-01-preview
set CHECK_HOURS=24
set AZURE_TENANT_ID=your-tenant-id
set AZURE_CLIENT_ID=your-client-id
set AZURE_CLIENT_SECRET=your-client-secret

トラブルシューティング

RSS フィード取得エラー

1. テストモードで確認:

   python getlatestupdate_mid.py --test-feed --verbose
   

2. ログファイルを確認: azure_updates.log

3. ネットワーク接続確認: インターネット接続とプロキシ設定

4. 複数 URL 試行: アプリケーションは自動で複数の RSS URL を試行します

詳細モード関連のトラブルシューティング

1. 詳細モードのテスト:

   python test_details.py
   

2. API アクセスエラー: Azure Updates API が一時的に利用できない場合、標準モードで処理を続行

3. アップデート ID 抽出失敗: 一部の記事で ID が抽出できない場合は RSS 情報を使用

一般的なエラーと対処法

• “フィードにエントリがありません”: RSS URL が変更された可能性があります
• “not well-formed (invalid token)”: XML パースエラー。別の URL を試行中です
• HTTP 接続エラー: ネットワーク設定やファイアウォールを確認してください

出力

アプリケーションは以下を生成します：

1. マークダウンレポート: updates/azure-updates-YYYY-MM-DD.md
2. ログファイル: azure_updates.log

レポートの内容

標準モード

• 生成日時と対象期間
• 更新件数の概要
• 各更新の詳細：
  • タイトル（RSS フィードから）
  • 公開日時
  • リンク
  • カテゴリ
  • AI 生成の日本語要約
  • 元の詳細説明（RSS フィードから）

詳細モード（--details）

上記に加えて：

• アップデート ID: 個別記事の識別子
• 情報源: Azure Updates API 使用の明示
• 強化されたタイトル: API から取得したより正確なタイトル
• 詳細な本文: API から取得した完全な記事内容
• 改善された要約: より詳細で正確な情報に基づく要約

エラーハンドリング

• 複数 RSS URL: 主要 URL が失敗した場合の自動フォールバック
• ネットワークエラー: 自動リトライとタイムアウト設定
• XML パースエラー: 軽微なエラーは無視して処理継続
• API レート制限: 適切な待機時間の設定
• 詳細ログ: トラブルシューティング用の包括的なログ

セキュリティ考慮事項

• API キーは環境変数から取得
• HTTPS 通信の使用
• 適切なタイムアウト設定
• セッション管理とリソースクリーンアップ
• User-Agent の適切な設定

制限事項

• Azure OpenAI のレート制限に依存
• RSS フィードの可用性に依存
• 日付パースの精度はフィードの形式に依存

This site is open source. Improve this page.