Learning Timeline
Key Insights
Konsep Teras Agent Development Kit (ADK)
Untuk membina agent dengan ADK, anda perlu faham beberapa komponen utama:
- **Agent**: Logik utama aplikasi anda. ADK menyediakan pelbagai jenis agent, yang paling asas ialah 'LLM Agent'.
- **Tools**: Memberikan 'kemahiran' kepada agent anda, seperti mengakses API luaran atau fungsi custom.
- **Runner**: Komponen yang menyatukan semua bahagian (agent, tools) dan menguruskan sesi interaksi.
- **Session**: Menyimpan sejarah perbualan, membolehkan agent 'mengingati' interaksi sebelumnya.
Pilihan Integrasi Claude dengan ADK
Terdapat dua cara utama untuk menggunakan model Claude dengan ADK:
1. **Melalui LiteLLM**: Cara standard jika anda sudah biasa dengan ekosistem LiteLLM.
2. **Melalui LLM Registry Vertex**: Integrasi pra-bina yang disediakan oleh pasukan Vertex AI. Ia menawarkan cara yang lebih kemas untuk menyambungkan model dengan agent anda, seperti yang ditunjukkan dalam tutorial ini.
Step by Step
Menyediakan Struktur Fail untuk Agent Anda
- Dalam direktori projek anda, cipta satu fail Python bernama `agent.py`. Fail ini akan mengandungi logik utama agent anda.
- Cipta satu fail untuk 'environment variables' (contohnya, `.env`). Fail ini akan menyimpan konfigurasi dan kunci API.
- Cipta satu fail kosong bernama `__init__.py`. Ini menjadikan direktori anda sebagai 'Python package' yang boleh dikenali oleh ADK.
Mentakrifkan Agent Asas dalam Fail agent.py
- Buka fail `agent.py` anda.
- Import kelas `LLMAgent` dan kelas model yang anda ingin gunakan (contohnya, `Claude`) dari library ADK.
- Cipta 'instance' untuk kelas `LLMAgent` untuk mula mentakrifkan agent anda.
- Di dalam kurungan `LLMAgent`, tetapkan parameter berikut:
- - `name`: Beri nama unik kepada agent anda (cth: 'birthday-planner').
- - `model`: Nyatakan model LLM yang akan digunakan (cth: `Claude(model: 'claude-3-sonnet@20240229')`).
- - `description`: Tulis penerangan ringkas tentang fungsi agent anda.
- - `instructions`: Beri arahan atau 'system prompt' yang terperinci tentang cara agent harus berkelakuan.
Menjalankan dan Berinteraksi dengan Agent Anda
- Buka aplikasi terminal atau 'command prompt' anda.
- Navigasi ke direktori root projek agent anda.
- Laksanakan command `adk run <nama_agent>`, sebagai contoh: `adk run birthday-planner`.
- Sistem akan memulakan sesi interaktif di terminal.
- Anda kini boleh mula 'berbual' atau memberi arahan kepada agent anda secara terus untuk menguji fungsinya.
