このページでは、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.11 から 3.15 がサポートされます。 Python 3.10 は、Python 1.24 においてはサポートもテストも行われませんが、パッケージ メタデータでは引き続きインストールが許可されます。 Python 3.11 以降を使用し、python --versionを実行してアクティブなインタープリターを確認してください。
Python 3.14 および 3.15 では、宣言型 Power Fx 式は評価されません。 Python 3.15 では、RedisVL には以前のPython バージョンが必要であるため、pip install agent-frameworkは Redis を省略します。 Hyperlight 0.8、AG-UI A2UI extra、および DuckDB 2.x は Python 3.15 をサポートします。 統合で解決できない場合は、そのRequires-Python範囲を確認し、互換性のあるインタープリターを使用してください。
詳細については、Python 2026 の重要な変更ガイドを参照してください。
Go 1.26 以降を使用していることを確認します。
go versionを実行して、インストールされているバージョンを確認します。 依存関係の解決に失敗した場合は、 go mod tidy を実行し、モジュールが現在の SDK に存在するパッケージ github.com/microsoft/agent-framework-go インポートすることを確認します。
ヘルプの取得
ここで解決策が見つからない場合は、コミュニティ サポートのために GitHub ディスカッション にアクセスしてください。