Pemecahan Masalah Framework Agen

Halaman ini membantu Anda mendiagnosis dan menyelesaikan masalah umum saat menggunakan Agent Framework.

Di halaman ini:

Penginstalan dan Penyiapan

Masalah Umum: Kegagalan penginstalan, error impor, masalah autentikasi API.

Periksa:

  • Versi Python & pip
  • Integritas & jalur file .whl
  • Konfigurasi file .env (kunci API, detail project)
  • Penyiapan gcloud auth (untuk Vertex AI)
  • Penginstalan dependensi (requirements.txt)
  • Aktivasi lingkungan virtual

Masalah Definisi Agen

Masalah Umum: Agen tidak berperilaku seperti yang diharapkan, alat tidak dipanggil, error di agent.py.

Periksa:

  • Sintaksis kode agent.py (linting)
  • Kejelasan dan kebenaran instruction agen
  • Definisi alat (nama, deskripsi, parameter)
  • Atribut agen (name, model, tools, flow) - kesalahan ketik, validitas
  • Logika kode dalam agent.py - gunakan pernyataan cetak untuk proses debug

Masalah Eksekusi

Masalah Umum: Perintah CLI gagal (af run, af web, af test), error UI Web, masalah server API.

Periksa:

  • Sintaksis dan argumen perintah CLI (--help)
  • Direktori kerja (root project agen)
  • Pesan error terminal (salin error lengkap)
  • Konflik port (untuk Server UI/API Web - coba port lain)
  • Kompatibilitas browser (untuk UI Web)
  • Error konsol browser (untuk UI Web)

Masalah Evaluasi

Masalah Umum: Kegagalan pengujian, hasil evaluasi yang tidak terduga.

Periksa:

  • Sintaksis file *.test.json (JSON yang valid)
  • Menguji konten file (kueri, akurasi expected_tool_use, reference)
  • Jalur file dalam perintah af test atau kode pytest
  • Kriteria evaluasi di test_config.json (jika digunakan)
  • Menjalankan pengujian di UI Web untuk mendapatkan masukan visual

Pesan Error Umum

  • Masalah penginstalan
  • Masalah kunci API atau autentikasi
  • Atribut model salah
  • Konflik port di server web/API

Tips Pemecahan Masalah Umum:

  • Sederhanakan dan Isolasi: Mulai dengan sederhana, tambahkan kompleksitas secara bertahap.
  • Periksa Log: Terminal, Cloud Logging, Konsol Browser.
  • Lihat Dokumentasi: Baca ulang bagian yang relevan.
  • Telusuri Online: Stack Overflow, forum.
  • Berikan Info Mendetail Saat Meminta Bantuan: Kode, error, langkah, lingkungan.