Bedah Repositori Qwen-Agent: Framework Ringkas untuk Membangun Autonomous Workflow di Lingkungan Lokal

qwen_agent/
├── agents/           # Logika orkestrasi: ReAct, FnCall, Assistant, Router
├── llm/              # Adapter interface: DashScope, OpenAI-compatible, vLLM, Ollama
├── tools/            # BaseTool & pustaka perkakas bawaan (code_interpreter, search, retrieval)
├── gui/              # Antarmuka Gradio opsional untuk prototyping cepat
└── utils/            # Utilitas tokenisasi, parsing JSON, dan caching

+-------------------------------------------------------------------+
|                        User / CLI Trigger                         |
+---------------------------------+---------------------------------+
                                  |
                                  v
+-------------------------------------------------------------------+
|                       Agent Loop(Assistant)                      |
|  - Membentuk system prompt & schema JSON                          |
|  - Mengelola riwayat percakapan(state buffer)                    |
+---------------------------------+---------------------------------+
                                  |
                                  v
+-------------------------------------------------------------------+
|                     LLM Adapter Interface                         |
|   (vLLM / Ollama Lokal  <--->  AiStudio.id / Cloud Gateway)       |
+---------------------------------+---------------------------------+
                                  |
            +---------------------+---------------------+
            | Respons Teks / Selesai                     | Panggilan Tool
            v                                           v
+-----------------------+                   +-----------------------+
| Return output ke CLI  |                   |     Tool Registry     |
+-----------------------+                   | - Validasi tipe data  |
                                            | - Eksekusi fungsi     |
                                            +-----------+-----------+
                                                        |
                                                        v
                                            +-----------------------+
                                            |  Observation String   |
                                            +-----------+-----------+
                                                        |
                                                        | (Looping kembali)
                                                        +-----> LLM Adapter

from qwen_agent.tools.base import BaseTool, register_tool

@register_tool('terminal_runner')
class TerminalRunner(BaseTool):
    description = 'Menjalankan perintah bash di lingkungan lokal untuk inspeksi repo.'
    parameters = [{
        'name': 'command',
        'type': 'string',
        'description': 'Perintah shell yang aman untuk dieksekusi',
        'required': True
    }]

    def call(self, params: str, **kwargs) -> str:
        import subprocess, json
        args = json.loads(params)
        cmd = args.get('command')
        try:
            res = subprocess.run(cmd, shell=True, capture_output=True, text=True, timeout=30)
            return res.stdout if res.returncode == 0 else f"Error: {res.stderr}"
        except Exception as e:
            return f"Gagal mengeksekusi perintah: {str(e)}"

+---------------------------------------------------------------------------------+
|                                 TERMINAL WORKFLOW                               |
|                                                                                 |
| 1. User Trigger  --> "Perbaiki AssertionError pada tests/test_payment.py"       |
| 2. Agent Action  --> ReadFileTool("tests/test_payment.py")                     |
| 3. Agent Action  --> ReadFileTool("services/payment.py")                        |
| 4. Agent Action  --> ApplyPatchTool("services/payment.py", new_code)            |
| 5. Agent Action  --> TerminalRunner("pytest tests/test_payment.py")             |
| 6. Observation   --> 3 passed, 0 failed                                         |
| 7. Output Selesai--> Memberikan penjelasan perubahan ke developer              |
+---------------------------------------------------------------------------------+

pip install -U qwen-agent

import os
from qwen_agent.tools.base import BaseTool, register_tool

@register_tool('read_file')
class ReadFileTool(BaseTool):
    description = 'Membaca seluruh isi berkas teks dari repositori lokal.'
    parameters = [{
        'name': 'file_path',
        'type': 'string',
        'description': 'Jalur relatif berkas yang ingin dibaca',
        'required': True
    }]

    def call(self, params: str, **kwargs) -> str:
        import json
        path = json.loads(params).get('file_path')
        if not os.path.exists(path):
            return f"Galat: Berkas {path} tidak ditemukan."
        with open(path, 'r', encoding='utf-8') as f:
            return f.read()

@register_tool('write_file')
class WriteFileTool(BaseTool):
    description = 'Menulis atau menimpa isi berkas pada direktori lokal.'
    parameters = [
        {
            'name': 'file_path',
            'type': 'string',
            'description': 'Jalur relatif berkas yang akan ditulis',
            'required': True
        },
        {
            'name': 'content',
            'type': 'string',
            'description': 'Konten kode lengkap yang baru',
            'required': True
        }
    ]

    def call(self, params: str, **kwargs) -> str:
        import json
        data = json.loads(params)
        path = data.get('file_path')
        content = data.get('content')
        os.makedirs(os.path.dirname(path), exist_ok=True) if os.path.dirname(path) else None
        with open(path, 'w', encoding='utf-8') as f:
            f.write(content)
        return f"Berhasil memperbarui {path}."

import sys
from qwen_agent.agents import Assistant
from agent_tools import ReadFileTool, WriteFileTool

def init_agent():
    # Konfigurasi LLM Adapter (Contoh implementasi hybrid fleksibel)
    llm_cfg = {
        'model': 'qwen2.5-72b-instruct',
        'model_server': 'https://api.aistudio.id/v1',  # Gerbang API komputasi tinggi
        'api_key': 'YOUR_AISTUDIO_API_KEY',           # Ganti dengan API Key Anda
        'generate_cfg': {
            'top_p': 0.8,
            'temperature': 0.2,                       # Nilai rendah untuk menjaga determinisme kode
            'max_input_tokens': 16000
        }
    }

    system_instruction = (
        "Anda adalah staf insinyur perangkat lunak senior di terminal lokal.\n"
        "Tugas Anda adalah membaca berkas kode, menemukan akar permasalahan galat, "
        "memperbaiki berkas tersebut menggunakan tool yang tersedia, dan memvalidasinya.\n"
        "Bekerjalah secara bertahap: Baca -> Analisis -> Tulis Perbaikan -> Konfirmasi."
    )

    bot = Assistant(
        llm=llm_cfg,
        system_message=system_instruction,
        function_list=['read_file', 'write_file', 'terminal_runner']
    )
    return bot

def main():
    if len(sys.argv) < 2:
        print("Penggunaan: python dev_agent.py '<instruksi perbaikan>'")
        sys.exit(1)

    user_query = sys.argv[1]
    bot = init_agent()

    messages = [{'role': 'user', 'content': user_query}]
    
    print("\n[\033[94mAgent Memulai Eksekusi\033[0m] Memproses instruksi...\n")
    
    for response in bot.run(messages=messages):
        # Qwen-Agent mengembalikan generator respons bertahap
        for msg in response:
            if msg.get('role') == 'assistant':
                content = msg.get('content', '')
                if content:
                    print(content, end='', flush=True)
    print("\n\n[\033[92mSelesai\033[0m] Alur kerja tuntas dieksekusi.")

if __name__ == '__main__':
    main()

python dev_agent.py "Periksa tests/test_auth.py, cari tahu mengapa login gagal saat password mengandung simbol, dan perbaiki kodenya di auth/service.py"

+-------------------------------------------------------------+
|                     Local Workstation                       |
|                                                             |
|  +------------------------+      +-----------------------+  |
|  |   Qwen2.5-Coder-7B     |      |  Qwen-Agent Framework |  |
|  |   (Lokal / Caching)    |      |  (State & Execution)  |  |
|  +-----------+------------+      +-----------+-----------+  |
|              |                               |              |
|              | Tugas Rutin & Syntax          |              |
|              +---------------+---------------+              |
+------------------------------|------------------------------+
                               |
                               | Tugas Penalaran Kompleks
                               v
+-------------------------------------------------------------+
|             AiStudio.id API Gateway(Regional)              |
|                                                             |
|  - Rute latensi rendah(Server Asia Pasifik/Lokal)          |
|  - Akses terpadu ke model penalaran tinggi(Qwen 72B / Max) |
|  - Kompatibilitas OpenAI-endpoint standar                   |
+-------------------------------------------------------------+