Qwen-Agent

Deskripsi

Qwen-Agent adalah kerangka kerja sumber terbuka yang kuat yang dirancang untuk pengembangan aplikasi Large Language Model (LLM) yang canggih. Dibangun di atas kemampuan model Qwen versi 3.0 dan yang lebih baru, ini menyediakan fondasi yang kuat untuk menciptakan agen cerdas yang dapat memahami instruksi, memanfaatkan alat, merencanakan tugas-tugas kompleks, dan mempertahankan memori di seluruh interaksi. Kerangka kerja ini direkayasa agar modular, menawarkan komponen atomik seperti LLM dengan pemanggilan fungsi, dan Alat serbaguna yang dapat diperluas. Komponen tingkat tinggi seperti Agen, yang berasal dari kelas dasar, memungkinkan pengembang untuk membangun implementasi agen kustom.

Fitur utama Qwen-Agent meliputi dukungan untuk Pemanggilan Fungsi, yang memungkinkan agen berinteraksi dengan layanan dan API eksternal. Ini juga mengintegrasikan Interpreter Kode, yang memungkinkan agen untuk menjalankan kode dengan aman di dalam lingkungan sandbox berbasis Docker, memproses data, dan mengembalikan hasil. Retrieval-Augmented Generation (RAG) didukung, meningkatkan kemampuan agen untuk mengakses dan mensintesis informasi dari kumpulan dokumen besar. Kerangka kerja ini juga menampilkan dukungan Multi-turn Conversation Protocol (MCP), memfasilitasi alur dialog yang lebih alami dan kompleks. Contoh aplikasi seperti Browser Assistant, Code Interpreter, dan Custom Assistant disediakan, yang menunjukkan keserbagunaan kerangka kerja.

Qwen-Agent secara aktif digunakan sebagai backend untuk Qwen Chat, menunjukkan kemampuannya di dunia nyata. Kerangka kerja ini dirancang untuk pengembang yang ingin membangun aplikasi AI canggih, mulai dari chatbot sederhana hingga sistem kompleks yang memerlukan integrasi alat dan penalaran. Ekstensibilitasnya memungkinkan pembuatan alat dan perilaku agen kustom, yang melayani berbagai kasus penggunaan. Proyek ini juga menyediakan dokumentasi dan contoh yang komprehensif untuk memfasilitasi adopsi dan pengembangan.

Proses instalasi mudah, dengan opsi untuk menginstal dari PyPI dengan set fitur tertentu seperti GUI, RAG, atau Code Interpreter, atau untuk menginstal langsung dari sumber untuk versi pengembangan terbaru. Pengguna dapat memanfaatkan layanan model dari DashScope Alibaba Cloud atau menerapkan layanan model mereka sendiri menggunakan model Qwen sumber terbuka. Fleksibilitas kerangka kerja meluas ke konfigurasi parameter LLM dan integrasi dengan berbagai metode penerapan, termasuk vLLM untuk penerapan GPU throughput tinggi dan Ollama untuk penerapan CPU/GPU lokal.

Fitur Inti Qwen-Agent

• Kerangka kerja Agen untuk aplikasi LLM

• Dibangun di atas model Qwen>=3.0

• Mendukung Pemanggilan Fungsi (Pemanggilan Alat)

• Termasuk Interpreter Kode dengan sandbox Docker

• Terintegrasi Retrieval-Augmented Generation (RAG)

• Mendukung Multi-turn Conversation Protocol (MCP)

• Menyediakan contoh aplikasi (Browser Assistant, Custom Assistant)

• Komponen modular untuk LLM dan Alat

• Memungkinkan implementasi agen kustom

• Menawarkan antarmuka GUI berbasis Gradio

• Mendukung pemanggilan alat paralel dan multi-langkah

• Menangani tanya jawab dokumen konteks panjang

Memulai dengan Qwen-Agent

1. 1

   Kloning repositori: Dapatkan kode Qwen-Agent dari GitHub.

2. 2

   Instal dependensi: Gunakan pip untuk menginstal paket dengan fitur yang diinginkan (misalnya, `pip install -U "qwen-agent[gui,rag,code_interpreter,mcp]"`).

3. 3

   Konfigurasi layanan model: Siapkan kunci API DashScope atau terapkan layanan model lokal.

4. 4

   Kembangkan agen: Buat agen kustom dengan mewarisi dari `Agent` atau gunakan implementasi bawaan seperti `Assistant`.

5. 5

   Integrasikan alat: Definisikan dan daftarkan alat kustom atau gunakan alat bawaan seperti `code_interpreter`.

6. 6

   Jalankan agen: Eksekusi agen secara terprogram atau luncurkan GUI Gradio.

7. 7

   Berinteraksi: Kirim kueri ke agen dan terima respons.

Kasus Penggunaan Qwen-Agent

• Pengembangan Asisten Kustom
• Eksekusi dan Analisis Kode
• Tanya Jawab Dokumen
• Otomatisasi Peramban
• Integrasi Alat
• Perencanaan Tugas Kompleks
• Backend Chatbot AI

FAQ dari Qwen-Agent

• Apa itu Qwen-Agent?

  Qwen-Agent adalah kerangka kerja sumber terbuka untuk membangun aplikasi LLM, memanfaatkan model Qwen untuk kemampuan seperti pemanggilan fungsi, interpretasi kode, dan RAG.

• Apa saja fitur utama Qwen-Agent?

  Fitur utama meliputi pemanggilan fungsi, interpreter kode, RAG, dukungan MCP, integrasi alat kustom, dan contoh aplikasi seperti Browser Assistant.

• Bagaimana cara menginstal Qwen-Agent?

  Anda dapat menginstal Qwen-Agent menggunakan pip: `pip install -U "qwen-agent[gui,rag,code_interpreter,mcp]"` atau instal dari sumber.

• Bisakah Qwen-Agent menggunakan alat kustom?

  Ya, Qwen-Agent memungkinkan pengembang untuk mendefinisikan dan mendaftarkan alat kustom dengan mewarisi dari `BaseTool`.

• Bagaimana cara kerja alat Interpreter Kode?

  Alat Interpreter Kode diimplementasikan menggunakan kontainer Docker lokal untuk eksekusi kode yang aman di dalam lingkungan sandbox yang terisolasi.

• Model LLM apa yang didukung oleh Qwen-Agent?

  Qwen-Agent dibangun di atas model Qwen versi 3.0 dan yang lebih baru, dan juga dapat berintegrasi dengan layanan model yang kompatibel dengan API OpenAI.

• Bagaimana cara menggunakan Qwen-Agent untuk tanya jawab atas dokumen panjang?

  Qwen-Agent menawarkan solusi RAG yang cepat dan agen yang kompetitif untuk tanya jawab atas dokumen super panjang, mengungguli model konteks panjang asli.

• Apakah Qwen-Agent mendukung pemanggilan fungsi?

  Ya, Qwen-Agent menyediakan kemampuan pemanggilan fungsi, dan kelas agennya dibangun di atas fungsionalitas ini, mendukung pemanggilan fungsi paralel.

• Bagaimana cara mengkonfigurasi LLM untuk Qwen-Agent?

  Konfigurasi LLM dilakukan melalui kamus (`llm_cfg`) yang menentukan nama model, jenis, kunci API, dan hyperparameter generasi opsional.

• Apa itu MCP dalam konteks Qwen-Agent?

  MCP adalah singkatan dari Multi-turn Conversation Protocol, yang didukung oleh Qwen-Agent untuk memfasilitasi alur dialog yang lebih kompleks dan alami.

• Apakah ada GUI yang tersedia untuk Qwen-Agent?

  Ya, Qwen-Agent menyediakan antarmuka GUI yang nyaman menggunakan Gradio, memungkinkan penerapan demo agen yang cepat.

• Apa saja dependensi untuk menggunakan MCP?

  Dependensi untuk MCP meliputi Node.js, uv 0.4.18+, Git, dan SQLite. Instruksi instalasi disediakan untuk macOS dan Windows.