AI Class

Otomatisasi Pembuatan Diagram dan Flowchart dari Teks dengan n8n + AI: Langkah, Prompt & Template

· 4 menit baca

Otomatisasi Pembuatan Diagram dan Flowchart dari Teks dengan n8n + AI

Ringkasan: Panduan lengkap membuat workflow di n8n yang mengonversi teks—dari dokumen, chat, atau email—menjadi diagram/flowchart (Mermaid/Draw.io) otomatis menggunakan OCR, LLM, dan layanan rendering. Cocok untuk tim dokumentasi, SRE, product, dan engineering.

Mengapa otomatisasi diagram itu penting?

Dokumentasi visual mempercepat pemahaman proses. Namun membuat diagram manual memakan waktu dan rentan tidak terbarui. Dengan menggabungkan n8n dan AI, Anda bisa:

  • Mengubah meeting notes, SOP, atau log insiden jadi flowchart otomatis.
  • Menghasilkan diagram versi-mermaid yang mudah diupdate dan versi gambar untuk share.
  • Menjaga sumber kebenaran (single source of truth) dalam repositori atau wiki.

Gambaran arsitektur workflow

Workflow yang akan kita bangun terdiri dari komponen berikut:

  1. Trigger: Webhook / Email / Upload ke cloud storage
  2. Preprocessing: OCR untuk image/PDF, Language detection
  3. Parsing & Extraction: LLM meringkas dan meng-extract entitas/process steps
  4. Diagram Generation: LLM meng-output format Mermaid atau XML Draw.io
  5. Rendering (opsional): Merubah Mermaid ke PNG/SVG atau memanggil API draw.io
  6. Publish: Simpan ke repo, kirim ke Slack, update Confluence atau kirim email

Langkah-demi-langkah membangun workflow di n8n

1) Trigger & Ingest

Pilih trigger yang sesuai: Webhook untuk integrasi chat, IMAP/Email node untuk email, atau Cloud Storage node untuk upload file. Pastikan metadata (judul, author, waktu) ikut dikirim.

2) Preprocessing: OCR & Deteksi Bahasa

Untuk file PDF/image gunakan node OCR (tesseract via API atau layanan OCR seperti Google Vision). Lalu gunakan node detect language (bisa LLM atau service terpisah) supaya prompt bisa disesuaikan bahasa.

3) Prompt Engineering: Ekstrak Struktur Proses

Gunakan LLM untuk:

  • Meringkas teks menjadi langkah (step-by-step).
  • Mendeteksi keputusan (if/else), loop, dan entitas utama.
  • Menghasilkan output dalam format terstruktur (JSON) yang berisi nodes & edges.

Contoh prompt (ringkas):

"Convert the following meeting notes into a JSON flowchart with nodes and edges. Identify decisions as nodes with 'type':'decision'. Output only valid JSON. Notes: {meeting_text}"

4) Menghasilkan Mermaid atau Draw.io XML

Setelah mendapat JSON terstruktur, Anda bisa:

  • Gunakan template mermaid dan isi dengan loop nodes/edges.
  • Atau minta LLM untuk mengonversi JSON ke format Draw.io XML jika butuh diagram berfitur lebih lengkap.

Contoh konversi ke Mermaid:

graph LR
A[Start] --> B{Decision}
B -- Yes --> C[Action]
B -- No --> D[Alternate]

5) Rendering Diagram (opsional)

Jika butuh gambar (PNG/SVG) untuk dokumentasi atau email, gunakan:

  • Mermaid API (self-host atau layanan seperti mermaid-cli).
  • draw.io API atau export service.
  • headless browser (Puppeteer) untuk render jika opsi lain tidak tersedia.

6) Publish & Versioning

Simpan hasil ke Git (repo dokumentasi), update Confluence/Wiki, dan kirim notifikasi ke Slack/Teams. Terapkan versioning file sehingga update diagram menjadi terkontrol. Di n8n gunakan node Git, HTTP Request, dan integrasi Slack/Confluence.

Praktik terbaik & tips prompt

  • Output terstruktur dulu: Selalu minta LLM mengembalikan JSON yang divalidasi sebelum mengubah ke markup diagram.
  • Be explicit: Contoh format node/edge, tipe keputusan, label, dan arah panah.
  • Gunakan few-shot: Beri 2-3 contoh input-note -> expected JSON untuk meningkatkan akurasi.
  • Safety: Validasi kesalahan LLM (sanitize text untuk karakter reserved Mermaid/XML).
  • Multibahasa: Jika teks multibahasa, deteksi bahasa lalu pilih prompt yang sesuai; LLM multilingual bekerja baik tapi sering perlu instruksi tambahan.

Error handling, retry & observability

Workflow harus tangguh:

  • Terapkan retry dan exponential backoff pada pemanggilan API eksternal (LLM, OCR, rendering).
  • Fallback: jika LLM gagal menghasilkan diagram, kirim hasil ringkasan teks ke tim dokumentasi untuk review manual.
  • Logging: simpan raw input, JSON terstruktur, dan versi diagram untuk audit dan debugging.
  • Alerting: node terakhir dapat mengirimkan failure report ke Slack/Email dengan link ke payload untuk triage cepat.

Template workflow n8n (high-level node list)

  1. Webhook Trigger / IMAP node
  2. IF file -> OCR (Google Vision / Tesseract API)
  3. Detect Language node
  4. LLM Summarize & Extract (OpenAI/GPT/Anthropic)
  5. Transform JSON -> Mermaid template (Function node)
  6. Render Mermaid -> PNG (HTTP Request ke mermaid API atau Execute Command)
  7. Save to Git / Cloud Storage
  8. Notify Slack / Create Confluence page

Contoh prompt few-shot untuk ekstraksi

Convert the meeting notes into JSON with fields:
{
  "nodes": [{"id":"A","label":"Start","type":"start"}],
  "edges": [{"from":"A","to":"B","label":""}]
}

Notes:
1) Customer sends request
2) Support triages
3) If urgent, escalate to on-call

Expected: ...

Kasus penggunaan nyata

  • Menjadikan notulen rapat menjadi flow decision untuk product roadmap.
  • Dokumentasi runbook dari chat ops untuk SRE.
  • Konversi SOP HR menjadi flowchart onboarding otomatis.

Checklist implementasi cepat

  • Siapkan endpoints LLM & OCR dengan quota yang cukup.
  • Buat contoh-contoh prompt untuk domain Anda.
  • Implementasikan validasi JSON di n8n (Function node + schema check).
  • Tambahkan caching untuk diagram yang sama agar tidak berulang render.
  • Uji end-to-end dengan sample notes dan review output oleh manusia.

Kesimpulan

Dengan n8n + AI, mengotomatisasi pembuatan diagram & flowchart memungkinkan tim mempercepat dokumentasi, mengurangi kesalahan manual, dan menjaga konsistensi. Kuncinya adalah output terstruktur, prompt few-shot, dan pipeline yang tangguh untuk rendering & publishing.

Mulailah dari use-case kecil (notulen rapat atau SOP sederhana) lalu scale ke dokumen yang lebih kompleks. Simpan template Mermaid/Draw.io agar proses adaptasi ke proyek lain lebih cepat.

Butuh template n8n ready-to-import? Hubungi JIPRAKS Classroom atau cek repo kami untuk starter workflow yang bisa langsung digunakan.

Artikel terkait