このページでは、Agent Framework を使用するときの一般的な問題と解決策について説明します。
Note
このページは再構築中です。 一般的なトラブルシューティング シナリオが追加されます。
一般的な問題
認証エラー
AI プロバイダー用に正しい資格情報が構成されていることを確認します。 Azure OpenAI の場合は、次のことを確認します。
- Azure CLI がインストールされ、認証される (
az login) - ユーザーが
Cognitive Services OpenAI UserまたはCognitive Services OpenAI Contributorロールを持っている
パッケージのインストールに関する問題
.NET 8.0 SDK 以降を使用していることを確認します。
dotnet --versionを実行して、インストールされているバージョンを確認します。
Agent Framework は、Python 3.10～3.15 をサポートしています。 Python 3.10 はこのリリースで引き続きサポートされますが、アップストリーム Python 3.10 の有効期間が終了したため、ソフト非推奨です。 新しい環境には Python 3.11 以降を使用し、python --versionを実行してアクティブなインタープリターを確認してください。
Python 3.14 および 3.15 では、宣言型 Power Fx 式は評価されません。 Python 3.15 では、pip install agent-frameworkは縮小された機能セットで動作し、Redis と Hyperlight はインストールされず、AG-UI A2UI エクストラは使用できません。 統合で解決できない場合は、その Requires-Python 範囲を確認し、互換性のあるインタープリターを使用してください。 詳細については、Python 2026 の重要な変更ガイドを参照してください。
Go 1.25 以降を使用していることを確認します。
go versionを実行して、インストールされているバージョンを確認します。 依存関係の解決に失敗した場合は、 go mod tidy を実行し、モジュールが現在の SDK に存在するパッケージ github.com/microsoft/agent-framework-go インポートすることを確認します。
ヘルプの取得
ここで解決策が見つからない場合は、コミュニティ サポートのために GitHub ディスカッション にアクセスしてください。