Build AI Agent dengan n8n dan OpenRouter: Tutorial Step-by-Step
Taufiq M
Taufiq M

Dipublikasikan 23 Mei 2026

Build AI Agent dengan n8n dan OpenRouter: Tutorial Step-by-Step

ai
ai-agent
n8n
n8n
low-code

AI agent sudah jadi standar baru di 2026. Nggak cuma chatbot biasa, tapi workflow otomatis yang bisa mikir, ambil keputusan, dan eksekusi task end-to-end. Di tutorial ini, kita bakal bangun AI agent sederhana pakai n8n (open-source workflow automation) dan OpenRouter sebagai gateway ke berbagai model LLM. Setup ini cocok buat developer yang mau prototipe cepat tanpa perlu bangun infrastructure AI dari nol.

Persiapan Environment dan Install n8n

Pastikan kamu sudah punya Node.js versi 18+ dan Docker terinstall di mesin lokal atau VPS. n8n bisa dijalankan via Docker Compose dengan konfigurasi minimal:

docker run -it --rm \
  --name n8n \
  -p 5678:5678 \
  -v ~/.n8n:/home/node/.n8n \
  n8nio/n8n:latest

Setelah container jalan, buka http://localhost:5678 dan lakukan setup akun admin. n8n menyediakan UI drag-and-drop yang intuitif buat merakit workflow. Dokumentasi lengkap bisa cek di official n8n docs.

Setup Kredensial OpenRouter

OpenRouter adalah unified API untuk mengakses model dari Anthropic, OpenAI, Google, Meta, dan lainnya. Daftar akun di openrouter.ai, generate API key, lalu masukkan ke n8n via menu Settings > Credentials.

Pilih credential type OpenRouter API atau gunakan generic HTTP Request credential dengan header Authorization: Bearer <API_KEY>. Pastikan kamu sudah top-up kredit minimal $5 untuk testing tanpa rate limit yang mengganggu.

Build Workflow Trigger dan LLM Node

Buat workflow baru dengan trigger Webhook. Ini akan jadi entry point saat ada request masuk dari aplikasimu. Konfigurasi HTTP method ke POST dan path bebas, misalnya /agent-query.

Tambahkan node HTTP Request setelah trigger. Method: POST. URL: https://openrouter.ai/api/v1/chat/completions. Body JSON:

{
  "model": "anthropic/claude-sonnet-4-20250514",
  "messages": [
    {"role": "system", "content": "Kamu adalah AI assistant yang membantu menjawab pertanyaan teknis seputar programming."},
    {"role": "user", "content": "{{ $json.body.query }}"}
  ],
  "max_tokens": 1024
}

Node ini akan meneruskan user query ke Claude via OpenRouter. Jangan lupa attach credential yang sudah dibuat di step sebelumnya.

Tambahkan Logic Branching dengan IF Node

Agent yang baik harus bisa bedain jenis request. Gunakan node IF untuk branching berdasarkan intent atau keyword dari input user. Contoh: jika query mengandung kata "bug", arahkan ke branch debugging workflow. Jika query mengandung "deploy", arahkan ke branch deployment checklist.

Di masing-masing branch, tambahkan node Set untuk mempersiapkan prompt khusus sebelum dikirim ke LLM. Teknik ini disebut prompt routing dan sangat efektif untuk meningkatkan akurasi respons tanpa perlu fine-tune model.

Testing dan Deployment

Klik Test Workflow di n8n dan kirim sample payload via Postman atau cURL:

curl -X POST http://localhost:5678/webhook/agent-query \
  -H "Content-Type: application/json" \
  -d '{"query": "Cara fix CORS error di Next.js?"}'

Jika respons LLM muncul di execution log, artinya agent sudah jalan. Untuk production, deploy n8n ke VPS atau railway. Dokumentasi deployment production bisa merujuk ke n8n hosting guide.

Kesimpulan

Kombinasi n8n dan OpenRouter bikin prototipe AI agent jadi sangat cepat. Kamu nggak perlu maintain infrastruktur model sendiri, cukup fokus di logic workflow dan prompt engineering. Dari sini, bisa dikembangkan lagi dengan integrasi Slack, Telegram, atau database internal untuk memory persistence. Happy building!