🏗️ Day 5: Proyek Bisnis — Equity Portfolio Rebalancer
Rangkuman 6 video: Rekap Webhook & Autentikasi, Tipe Node n8n, Membangun Portfolio Rebalancer, Otonomi Agen & Context Engineering, Integrasi Gmail + Pushover, dan If Node untuk Logika Kondisional
🎯 Tujuan Hari Ini
Hari terakhir Week 1 adalah hari proyek nyata. Semua yang dipelajari selama empat hari sebelumnya — JSON, expressions, autentikasi, integrasi Google, Pushover — digabungkan untuk membangun Equity Portfolio Rebalancer: sebuah AI Agent yang membaca portofolio saham, mencari harga pasar terkini, membuat keputusan rebalancing, lalu mengirim email dan notifikasi. Ini adalah jenis proyek yang bisa kamu bangun untuk klien dalam sebuah AI automation agency.
🔄 Bagian 1: Rekap Cepat — Webhook & Autentikasi
Sebelum masuk ke proyek, instruktur merangkum konsep kunci dari hari sebelumnya:
Webhook dalam Satu Diagram
Tanpa Webhook (Request-Response):
┌──────┐ "Kirim pesan" ┌─────────┐
│ n8n │ ────────────────▶│ Platform│
│ │ ◀────────────────│ │
└──────┘ "Berhasil" └─────────┘
Dengan Webhook (Event-Driven):
┌──────┐ ┌─────────┐
│ n8n │ ◀────────────────│ Platform│
│ │ "Ada pesan baru │ │
└──────┘ yang mention └─────────┘
bot-mu!"Webhook = URL endpoint yang kamu sediakan → sistem luar memanggil URL itu untuk memberitahu n8n bahwa sebuah event telah terjadi. Ini adalah mekanisme trigger untuk platform seperti Slack.
Tiga Level Autentikasi (Rekap)
| Level | Metode | Contoh |
|---|---|---|
| 🟢 | API Key — copy & paste | OpenAI, Pushover, Telegram |
| 🟡 | Pre-configured OAuth2 — klik & allow | Google Sheets, Gmail |
| 🔴 | Full OAuth2 — setup scopes, token, webhook | Slack |
🧩 Bagian 2: Tipe-Tipe Node di n8n
n8n memiliki taksonomi node yang penting untuk dipahami agar kamu tidak bingung saat membangun workflow yang lebih kompleks.
Hierarki Node
┌─────────────────────────────────────────────────────────┐
│ CLUSTER NODE │
│ (Grup node = satu langkah) │
│ │
│ ┌─────────────────────────────────────────────┐ │
│ │ ROOT NODE │ │
│ │ (Core Node utama) │ │
│ │ Contoh: AI Agent │ │
│ │ │ │
│ │ ┌──────────┐ ┌────────┐ ┌──────────┐ │ │
│ │ │ SUB-NODE │ │SUB-NODE│ │ SUB-NODE │ │ │
│ │ │ Model │ │ Memory │ │ Tools │ │ │
│ │ └──────────┘ └────────┘ └──────────┘ │ │
│ └─────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────┘| Tipe | Deskripsi | Contoh |
|---|---|---|
| Core Node | Blok bangunan utama di canvas | Telegram, Google Sheets, If |
| Node Operation | Dua jenis: Trigger (memulai workflow) atau Action (menjalankan tugas) | Trigger: "On Message", Action: "Send Text" |
| Sub-Node | Bagian di dalam core node, tidak bisa berdiri sendiri | Tool, Model, Memory |
| Cluster Node | Grup root node + sub-nodes = satu langkah | AI Agent + Model + Memory + Tools |
Items: Data yang Mengalir Antar Node
INPUT (Array of Items) OUTPUT (Array of Items)
┌──────────────────────┐ ┌──────────────────────┐
│ [ │ │ [ │
│ {"fruit": "apple"},│ ──▶ │ {"fruit": "APPLE"},│
│ {"fruit": "banana"}│ │ {"fruit": "BANANA"}│
│ ] │ │ ] │
└──────────────────────┘ └──────────────────────┘
Expression: {{ $json.fruit.toUpperCase() }}
Diterapkan ke SETIAP item dalam array!💡 Penting:
$jsonsebenarnya adalah shortcut dari$input.item.json— artinya "untuk setiap item, ambil JSON-nya." Expression kamu dijalankan pada setiap item secara otomatis.
📈 Bagian 3: Proyek — Equity Portfolio Rebalancer
Gambaran Besar
┌────────────┐ ┌───────────┐ ┌──────────────────────────────────┐
│ Form │───▶│ AI Agent │───▶│ If Node │
│ Submission │ │ (GPT-4.1) │ │ output == "ok" ? │
│ │ │ │ │ ├─ TRUE → 📱 Push: Sukses │
│ "Rebalance │ │ 6 Tools: │ │ └─ FALSE → 🚨 Push: Gagal │
│ 60/40" │ │ 📊 Sheets│ └──────────────────────────────────┘
└────────────┘ │ 💹 Market│
│ ✏️ Update│
│ ✏️ Rebal │
│ 📧 Gmail │
│ 📱 Push │
└───────────┘Google Sheet: Struktur Portfolio
| Kolom | Isi | Diisi Oleh |
|---|---|---|
| A: Ticker | Kode saham (VTI, VXUS, BND, dll.) | Manual |
| B: Quantity | Jumlah kepemilikan saat ini | Manual |
| C: % Equity | Persentase saham | Manual |
| D: % Fixed Income | Persentase obligasi | Manual |
| E: Price | Harga pasar terkini | 🤖 Agent |
| F: Value | Quantity × Price | Formula |
| G: New Quantity | Jumlah setelah rebalancing | 🤖 Agent |
Form Trigger: Antarmuka Pengguna
Alih-alih Chat Trigger, proyek ini menggunakan Form Submission sebagai trigger — menghasilkan web form yang bisa diakses siapa saja:
┌─────────────────────────────────────────┐
│ 📋 Portfolio Rebalancer │
│ │
│ How would you like to rebalance │
│ your portfolio? │
│ ┌─────────────────────────────────┐ │
│ │ Ensure the portfolio is 60% │ │
│ │ equity and 40% fixed income │ │
│ └─────────────────────────────────┘ │
│ │
│ [ Submit ] │
└─────────────────────────────────────────┘⚡ Lightning bolt (⚡) di samping node menandakan bahwa itu adalah trigger node.
6 Tools pada AI Agent
| # | Tool | Fungsi | Konfigurasi |
|---|---|---|---|
| 1 | Google Sheets — Get Rows | Baca isi portfolio | Doc: Portfolio, Sheet: Sheet1 |
| 2 | MarketStack — End of Day | Cari harga saham terkini | Filter: latest, ticker: model decide |
| 3 | Google Sheets — Update Row (Price) | Update kolom harga | Match: ticker, Set: price |
| 4 | Google Sheets — Update Row (Rebal) | Update kolom rebalancing | Match: ticker, Set: new quantity |
| 5 | Gmail — Send Email | Kirim email trading decisions | To: fixed, Subject: fixed, Body: model decide |
| 6 | Pushover — Push Notification | Notifikasi ringkas | User key: fixed, Message: model decide |
🧠 Bagian 4: Otonomi Agen & Context Engineering
Prompt = Instruksi + Expression
┌──────────────────────────────────────────────────────┐
│ PROMPT KE AI AGENT: │
│ │
│ (Teks statis) │
│ You have access to the user's equity portfolio │
│ in a Google Sheet. You also have access to market │
│ data. The user has asked you to rebalance their │
│ portfolio with this instruction: │
│ │
│ (Expression dinamis) │
│ {{ $json["How would you like to rebalance..."] }} │
│ │
│ (Instruksi langkah-langkah) │
│ 1. Read the portfolio from the sheet │
│ 2. Fetch latest prices │
│ 3. Update table with prices │
│ 4. Make rebalancing decisions │
│ 5. Update table with decisions │
│ 6. Read table again to verify │
│ 7. Iterate if needed │
│ 8. Send email + push notification │
│ │
│ Only respond "ok" when mission is complete. │
└──────────────────────────────────────────────────────┘Spektrum Otonomi
Terlalu Ketat Sweet Spot Terlalu Longgar
(Bukan AI) (Agentic) (Unreliable)
◀─────────────────────────────────────────────────────────────────▶
Step 1: buka file X "Baca portfolio, "Rebalance
Step 2: baca baris 3 cari harga terkini, portfolio-ku"
Step 3: kalikan rebalance 60/40,
Step 4: tulis ke kolom G kirim email & notif"
❌ Bisa pakai code ✅ Cukup jelas, ❌ LLM bingung,
tanpa AI masih fleksibel hasil acak💡 Insight: Instruksi "loosey goosey" — cukup jelas agar agen tahu arahnya, tapi cukup fleksibel agar ia bisa membuat keputusan cerdas sendiri. Ini adalah seni context engineering — dan cara terbaik menemukan sweet spot adalah dengan eksperimen berulang.
Tool Description yang Baik
Jangan biarkan deskripsi tool default. Customize untuk membantu LLM:
Default: "Get rows in sheet in Google Sheets"
Custom: "This tool provides details of the user's portfolio
in a Google Sheet. It includes the positions, the
equity/fixed income breakdown. Use this tool to
retrieve the Google Sheet before updating prices
and making rebalancing decisions. IMPORTANT: You
must also use this tool AFTER rebalancing to check
the breakdown achieves your goal. If not, keep
iterating."Max Iterations
Default: 10 iterasi. Untuk workflow kompleks seperti portfolio rebalancer, naikkan ke 30 agar agen punya cukup ruang untuk berpikir, mengeksekusi tools, dan memeriksa ulang.
🔀 Bagian 5: If Node — Logika Kondisional
If Node memungkinkan kamu membuat percabangan dalam workflow tanpa coding — ini adalah fitur workflow tradisional (seperti Zapier) yang tersedia di n8n.
Struktur If Node
┌─────────────────┐
│ AI Agent │
│ Output: "ok" │
└────────┬────────┘
│
┌────────▼────────┐
│ IF NODE │
│ │
│ $json.output │
│ == "ok" ? │
└──┬───────────┬──┘
TRUE │ │ FALSE
▼ ▼
┌──────────┐ ┌──────────┐
│ Pushover │ │ Pushover │
│ "Sukses!" │ │ "GAGAL!" │
│ Low prio │ │ Emergency │
└──────────┘ └──────────┘Perbedaan Kritis: Tool vs Core Node
| Aspek | Tool (Sub-Node) | Core Node (Action) |
|---|---|---|
| Posisi | Di dalam AI Agent (lingkaran) | Di canvas workflow (kotak) |
| Siapa panggil? | LLM yang memutuskan | Workflow yang selalu menjalankan |
| Input | Bisa "Let model decide" | Fixed atau Expression |
| Kapan dipanggil? | Saat LLM merasa perlu | Setiap kali workflow sampai di node itu |
| Contoh | Pushover tool dalam Agent | Pushover setelah If Node |
💡 Insight: Kamu bisa menggunakan node yang sama (Pushover, Gmail, dll.) sebagai tool (keputusan LLM) ATAU sebagai core node (keputusan workflow). Pilihan tergantung siapa yang harus memutuskan: AI atau logika tetap.
🚀 Deploy ke Production
Setelah workflow berhasil di mode test:
- Buka Form Trigger node → copy Production URL
- Tekan Publish → beri nama versi
- Buka Production URL di browser → form web muncul!
- Submit → workflow berjalan otomatis
- Cek Google Sheet → harga & rebalancing terisi 🤖
- Cek email → trading decisions masuk 📧
- Cek HP → push notification berbunyi 📱
Monitoring via Executions Tab
┌─────────────────────────────────────────────────────┐
│ EXECUTIONS TAB │
│ │
│ Status: ✅ Success Duration: 87s │
│ │
│ ┌────────────────────────────────────────────┐ │
│ │ OpenAI Chat Model ×10 calls │ │
│ │ Google Sheets (Read) ×4 calls │ │
│ │ MarketStack ×4 calls │ │
│ │ Update Price ×5 calls │ │
│ │ Update Rebalance ×7 calls │ │
│ │ Pushover ×1 call │ │
│ │ Gmail ×1 call │ │
│ └────────────────────────────────────────────┘ │
│ │
│ Toggle: [Visual] [Logs] │
│ Logs → Details tab → lihat input/output per call │
└─────────────────────────────────────────────────────┘🎯 Tantangan Peningkatan
Instruktur memberikan beberapa ide untuk meningkatkan proyek ini:
| # | Tantangan | Hint |
|---|---|---|
| 1 | Buat lebih stabil untuk portfolio besar | Tambahkan info lebih detail di spreadsheet |
| 2 | Tambahkan kalkulator sebagai tool | Agar agen bisa menghitung alokasi dengan tepat |
| 3 | Ubah trigger ke Schedule | Rebalancing otomatis setiap hari/minggu |
| 4 | Tingkatkan prompt engineering | Eksperimen dengan instruksi berbeda |
| 5 | Tukar Pushover dengan Telegram/Slack | Gunakan integrasi yang sudah dibangun kemarin |
📝 Glosarium Hari Ini
| Istilah | Definisi |
|---|---|
| Core Node | Blok bangunan utama workflow, muncul di canvas |
| Sub-Node | Komponen di dalam core node (tool, model, memory) |
| Cluster Node | Grup root + sub-nodes yang membentuk satu langkah (AI Agent) |
| Items | Array data yang mengalir antar node — expression dijalankan per item |
| $input.item.json | Bentuk lengkap dari shortcut $json |
| Form Submission | Trigger berupa web form yang bisa diakses pengguna |
| If Node | Node logika kondisional — routing TRUE/FALSE |
| Context Engineering | Seni menyusun prompt & tool descriptions agar AI Agent optimal |
| Max Iterations | Batas berapa kali agent boleh menggunakan tools (default: 10) |
| Tool Description | Deskripsi kustom yang membantu LLM memutuskan kapan pakai tool |
✅ Progress Tracker
Week 1: Automate with Workflows
=========================================
Day 1 ████████████████████ ✅ AI Agent + Setup
Day 2 ████████████████████ ✅ Teori Agentic AI
Day 3 ████████████████████ ✅ Integrasi Google
Day 4 ████████████████████ ✅ JSON + Auth + 3 Integrasi
Day 5 ████████████████████ ✅ Proyek Bisnis ◀── HARI INI
=========================================
📊 Progress: 33% kursus selesai — Week 1 COMPLETE! 🎉🏆 Pencapaian Week 1
╔═══════════════════════════════════════════════════════════╗
║ 🎓 WEEK 1 COMPLETE — AUTOMATE WITH WORKFLOWS ║
║ ║
║ ✅ Membangun AI Agent pertama (OpenRouter + n8n) ║
║ ✅ Memahami 5 trik + 1 jebakan Agentic AI ║
║ ✅ Integrasi Google Sheets, Drive, Gmail ║
║ ✅ JSON, Expressions, 3 tingkat Autentikasi ║
║ ✅ 3 integrasi platform (Pushover, Telegram, Slack) ║
║ ✅ Proyek bisnis nyata: Portfolio Rebalancer ║
║ ✅ If Node untuk logika kondisional ║
║ ✅ Deploy workflow ke production ║
║ ✅ Context engineering & tool descriptions ║
║ ║
║ 🚀 Siap untuk Week 2: Voice Agents & RAG! ║
╚═══════════════════════════════════════════════════════════╝