Nerra

Dokumentasi

Pelajari cara melatih AI agent, mengatur workflow, dan menghubungkan layanan eksternal untuk mengotomatisasi proses bisnis Anda

Pendahuluan

Apa itu AI Agent?

AI Agent adalah asisten virtual cerdas yang dilatih untuk melakukan tugas-tugas tertentu secara otomatis menggunakan artificial intelligence

Agent dapat memahami konteks percakapan, menjawab pertanyaan, dan mengambil keputusan berdasarkan knowledge base yang diberikan

Setiap agent dapat dikustomisasi dengan personality, tone, dan bahasa yang sesuai dengan brand Anda

Agent dapat diintegrasikan dengan berbagai platform seperti WhatsApp, Email, Website, dan lainnya

Tips

  • • Agent bekerja 24/7 tanpa perlu istirahat
  • • Dapat handle multiple conversations secara bersamaan
  • • Response time yang sangat cepat (biasanya < 2 detik)

Apa itu Workflow?

Workflow adalah serangkaian automasi yang menghubungkan berbagai actions dan conditions dalam satu flow

Dengan workflow, Anda dapat membuat automasi kompleks tanpa perlu coding

Workflow berjalan berdasarkan trigger tertentu (message, schedule, webhook, dll)

Setiap workflow dapat memiliki multiple branches dan conditions untuk handle berbagai scenarios

Contoh Kode

Simple Workflow Example:
1. Trigger: Customer sends "price" message
2. Action: AI Agent responds with price list
3. Action: Save conversation history
4. Action: Send notification to sales team

Tips

  • • Workflow dapat di-test sebelum deployment
  • • Support branching logic (if-else)
  • • Dapat mengintegrasikan multiple services

Bagaimana AI Agent & Workflow Bekerja Bersama di Nerra?

AI Agent dan Workflow bekerja secara sinergis untuk menciptakan automasi yang powerful dan intelligent

Workflow dapat memanggil AI Agent untuk memproses message, mengambil keputusan, atau generate response

AI Agent dapat diintegrasikan sebagai node di dalam workflow untuk menambahkan intelligence layer

Kombinasi keduanya memungkinkan automasi yang context-aware dan dapat beradaptasi dengan situasi berbeda

Contoh Kode

AI Agent + Workflow Integration:

1. TRIGGER: Customer sends WhatsApp message
   ↓
2. WORKFLOW: Check if customer is registered
   ↓
3. AI AGENT: Analyze message and customer intent
   ↓
4. WORKFLOW: Routing based on intent:
   - If "inquiry" → Agent answers directly
   - If "complaint" → Forward to human support
   - If "order" → Trigger order workflow
   ↓
5. AI AGENT: Generate personalized response
   ↓
6. WORKFLOW: Send response + Save to database
   ↓
7. WORKFLOW: Update CRM & Send notification

Tips

  • • Gunakan AI Agent untuk decision-making yang kompleks
  • • Workflow handle orchestration dan integration
  • • Combine keduanya untuk maximum automation
  • • Monitor performance untuk continuous improvement

AI Agent

Pemilihan Model

Pilih AI model yang sesuai dengan kebutuhan dan budget Anda

Nerra menyediakan 3 pilihan model: Nerra 1.0, Nerra 2.0, dan BYOK (Bring Your Own Key)

Setiap model memiliki karakteristik yang berbeda dalam hal kecepatan, akurasi, dan cost

Anda dapat switch model kapan saja untuk optimize performance dan cost

Contoh Kode

Available Models:

🟢 Nerra 1.0
   - Fast & efficient
   - Good for general conversations
   - Balanced cost/performance
   - Recommended for: Customer service, FAQ, simple workflows

🚀 Nerra 2.0
   - Advanced reasoning capabilities
   - Best for complex scenarios
   - Higher accuracy & context understanding
   - Recommended for: Complex decision making, multi-step reasoning

🔑 BYOK (Bring Your Own Key)
   - Use your own AI provider API keys
   - Full control over model selection
   - Direct billing to your account
   - Recommended for: Enterprise users with existing AI subscriptions

Tips

  • • Start dengan Nerra 1.0 untuk testing dan simple use cases
  • • Upgrade ke Nerra 2.0 jika butuh reasoning yang lebih advanced
  • • BYOK ideal untuk perusahaan dengan compliance requirements
  • • Monitor usage dan cost untuk optimization

Workflow

System Nodes

System nodes adalah fundamental building blocks dari setiap workflow

Start Node: Entry point dari workflow, harus ada di setiap workflow

End Node: Exit point dari workflow, semua paths harus berakhir di End node

Memory Node: Untuk store dan retrieve data di workflow context

HTTP Request Node: Untuk make API calls ke external services

Contoh Kode

System Nodes:

▶️ Start Node
   - Workflow entry point
   - Must have exactly 1 output
   - Contains initial instructions

⏹️ End Node
   - Workflow exit point
   - All paths must end here
   - Marks workflow completion

🧠 Memory Node
   - Store: Save data to memory
   - Get: Retrieve data from memory
   - Variables available across workflow

🌐 HTTP Request Node
   - Methods: GET, POST, PUT, PATCH, DELETE
   - Custom headers & body
   - Response handling

Tips

  • • Start node instructions penting untuk context
  • • Pastikan semua branches berakhir di End node
  • • Gunakan Memory untuk share data antar nodes
  • • HTTP Request node untuk integrasi custom APIs

Logic Nodes

Logic nodes memberikan conditional logic dan flow control

If/Else Node: Branching berdasarkan kondisi (support nested conditions)

Switch Node: Multi-branch routing berdasarkan nilai

Loop Node: Iterate sampai kondisi terpenuhi dengan safety limit

Merge Node: Combine outputs dari multiple branches

Contoh Kode

Logic Nodes:

🔀 If/Else Node
   - Condition: Expression or AI decision
   - Nested: Support if → else if → else
   - Use case: Data-based routing

🎚️ Switch Node
   - Value: Variable to check
   - Cases: Multiple branches
   - Default: Fallback path
   - Use case: Status-based routing

🔁 Loop Node
   - Iteration: Repeat nodes
   - Condition: Exit criteria
   - Max iterations: Safety limit
   - Use case: Process array items

🔀 Merge Node
   - Strategy: all/first/majority
   - Inputs: Multiple sources
   - Conflict resolution
   - Use case: Combine parallel results

Tips

  • • Use If/Else untuk simple branching
  • • Switch lebih efisien untuk multiple conditions
  • • Selalu set max_iterations di Loop
  • • Merge useful untuk parallel processing

System Tags

Handover (Leave Session)

Tag [HANDOVER] digunakan untuk menghentikan AI menjawab sementara waktu (default 24 jam)

Berguna saat percakapan diambil alih oleh manusia (Customer Service)

System akan otomatis mendeteksi tag ini di akhir kalimat AI, menghapusnya dari pesan yang dikirim ke user, lalu mengaktifkan mode silent

Setelah 24 jam (atau reset manual), AI akan kembali aktif dalam mode 'Fresh Session'

Contoh Kode

System Prompt Example:
"If the user is angry or asks for a human agent, apologize and say you are connecting them to support, then end with [HANDOVER]"

AI Output: "Baik Kak, saya sambungkan ke tim support ya... [HANDOVER]"
User Received: "Baik Kak, saya sambungkan ke tim support ya..."
System Status: Silent (24h)

Tips

  • • Gunakan tag ini di System Prompt atau SOP Agent
  • • Pastikan menggunakan kurung siku [...]
  • • AI tidak akan merespon pesan apapun selama periode handover

Media Sending

Tag [MEDIA:URL] memungkinkan AI mengirim gambar, video, atau dokumen

Format: [MEDIA:https://example.com/image.jpg]

System akan mengekstrak URL tersebut dan mengirimnya sebagai attachment terpisah (via WhatsApp/Channel)

Tag akan dihapus dari teks pesan utama

Contoh Kode

Example Response:
"Berikut adalah katalog produk kami: [MEDIA:https://nerra.id/catalog.pdf]"

System Action:
1. Send Text: "Berikut adalah katalog produk kami:"
2. Send File: catalog.pdf

Tips

  • • URL harus direct link (publicly accessible)
  • • Support JPG, PNG, MP4, PDF (tergantung platform)
  • • Gunakan URL yang valid dan aman (https)

Koneksi

Gambaran Umum

Connections adalah integrasi antara Nerra.ai dengan service eksternal

Dengan connections, workflow Anda bisa berinteraksi dengan berbagai platform

Setiap connection memerlukan authentication credentials yang aman

Nerra.ai mengenkripsi semua credentials dengan security standard terbaru