Pemecahan Masalah

Halaman ini mencakup masalah dan solusi umum saat bekerja dengan Agent Framework.

Nota

Halaman ini sedang direstrukturisasi. Skenario pemecahan masalah umum akan ditambahkan.

Masalah Umum

Kesalahan Autentikasi

Pastikan Anda memiliki kredensial yang benar yang dikonfigurasi untuk penyedia AI Anda. Untuk Azure OpenAI, verifikasi:

• Azure CLI diinstal dan diautentikasi (az login)
• Pengguna memiliki Cognitive Services OpenAI User peran atau Cognitive Services OpenAI Contributor

Masalah Penginstalan Paket

Pastikan Anda menggunakan .NET 8.0 SDK atau yang lebih baru. Jalankan dotnet --version untuk memeriksa versi yang terinstal.

Agent Framework mendukung Python 3.11 hingga 3.15. Python 3.10 tidak lagi didukung atau diuji dalam Python 1.24, meskipun metadata paket masih mengizinkan penginstalan. Gunakan Python 3.11 atau yang lebih baru, dan jalankan python --version untuk memverifikasi interpreter aktif.

Pada Python 3.14 dan 3.15, ekspresi Deklaratif Power Fx tidak dievaluasi. Pada Python 3.15, pip install agent-framework tidak menyertakan Redis karena RedisVL memerlukan versi Python yang lebih lama. Hyperlight 0.8, ekstra AG-UI A2UI, dan DuckDB 2.x mendukung Python 3.15. Jika integrasi gagal di-resolve, periksa range Requires-Python-nya dan gunakan interpreter yang kompatibel. Untuk detailnya, lihat panduan perubahan signifikan Python 2026.

Pastikan Anda menggunakan Go 1.26 atau yang lebih baru. Jalankan go version untuk memeriksa versi yang terinstal. Jika dependensi gagal diurai, jalankan go mod tidy dan pastikan modul Anda mengimpor paket github.com/microsoft/agent-framework-go yang tersedia di SDK saat ini.

Mendapatkan Bantuan

Jika Anda tidak dapat menemukan solusi di sini, kunjungi Diskusi GitHub kami untuk dukungan komunitas.

Langkah berikutnya

FAQ