Menggunakan APIMart di Dify

​

Prasyarat

1. Akun Dify sudah terdaftar Kunjungi situs resmi Dify untuk mendaftar akun, lalu pilih versi cloud atau self-hosted
2. API Key APIMart sudah diperoleh Masuk ke APIMart Console untuk mendapatkan API key Anda (diawali dengan sk-)

​

Langkah 1: Masuk ke Dify dan Buka Pengaturan

​

1.1 Akses Platform Dify

• Versi Cloud: Kunjungi https://cloud.dify.ai lalu masuk
• Versi Self-hosted: Kunjungi alamat deployment Dify Anda

​

1.2 Buka Pengaturan Model

1. Klik ikon avatar di sudut kanan atas
2. Pilih Settings
3. Pilih Model Provider pada menu kiri

​

Langkah 2: Tambahkan Penyedia Model APIMart

​

2.1 Pilih Metode Konfigurasi

​

Metode 1: Gunakan OpenAI Custom API (Direkomendasikan)

1. Temukan penyedia OpenAI pada halaman Model Provider
2. Klik tombol Configure atau Settings
3. Pada halaman konfigurasi:
   • API Key: Masukkan API key APIMart Anda (sk-xxxxxxxxxxxx)
   • API Base URL atau Base URL: Masukkan https://api.apimart.ai/v1
4. Klik Save

5. Setelah konfigurasi selesai, kembali ke halaman penyedia OpenAI dan lihat Model List
6. Pada daftar model, temukan model yang Anda butuhkan (misalnya gpt-4o, gpt-4o-mini, chatgpt-4o-latest, dan lainnya)
7. Klik switch di sisi kanan model untuk mengaktifkannya (warna biru berarti aktif)

​

Metode 2: Tambahkan Penyedia Model Kustom

1. Gulir ke bagian Custom Model
2. Klik tombol + Add Model

​

2.2 Konfigurasikan Penyedia APIMart

​

2.3 Tambahkan Model Lainnya (Opsional)

1. Di bagian model kustom, klik lagi tombol + Add Model
2. Isi informasi konfigurasi untuk model lain
3. Klik Save

​

Seri GPT-4/5

​

Seri Claude

​

Seri Gemini

​

Langkah 3: Gunakan Model APIMart di Aplikasi

​

3.1 Buat Aplikasi Baru

1. Kembali ke beranda Dify
2. Klik tombol Create App
3. Pilih jenis aplikasi:
   • Chatbot - aplikasi percakapan
   • Text Generator - aplikasi pembuatan teks
   • Agent - agen cerdas
   • Workflow - aplikasi alur kerja kompleks

​

3.2 Pilih Model APIMart

1. Temukan area Model Settings
2. Klik dropdown Select Model
3. Pilih penyedia APIMart
4. Pilih model yang telah Anda konfigurasi (misalnya gpt-4o)

​

3.3 Konfigurasikan Parameter Model

​

Langkah 4: Bangun dan Uji Aplikasi

​

4.1 Tambahkan Prompt

1. Tulis prompt di area System Prompt
2. Gunakan variabel agar aplikasi lebih dinamis:
   • {{variable_name}} - variabel input pengguna
   • {{context}} - konteks basis pengetahuan

You are a professional customer service assistant, skilled at answering product questions.

Product Information: {{product_info}}

Please provide accurate and friendly answers based on user questions. If unsure, honestly inform the user.

User Question: {{user_question}}

​

4.2 Tambahkan Basis Pengetahuan (Opsional)

1. Klik Knowledge Base pada menu kiri
2. Buat basis pengetahuan baru dan unggah dokumen
3. Hubungkan basis pengetahuan pada halaman orkestrasi aplikasi
4. Konfigurasikan parameter retrieval

​

4.3 Uji Aplikasi

1. Masukkan pertanyaan uji di panel Preview di sebelah kanan
2. Tinjau efektivitas respons AI
3. Sesuaikan prompt dan parameter sesuai kebutuhan
4. Ulangi pengujian hingga hasilnya memuaskan

​

4.4 Publikasikan Aplikasi

1. Klik tombol Publish di kanan atas
2. Pilih metode publikasi:
   • API Call - integrasi melalui API
   • Embed in Website - buat kode sematan
   • Public Link - buat tautan berbagi

​

Langkah 5: Pantau dan Optimalkan

​

5.1 Lihat Log Aplikasi

1. Klik tab Logs
2. Lihat semua catatan percakapan
3. Analisis pertanyaan pengguna dan respons AI
4. Temukan peluang perbaikan

​

5.2 Pantau Penggunaan API

• 📊 Statistik Panggilan API - total panggilan, tingkat keberhasilan
• 💰 Rincian Biaya - biaya harian/bulanan
• 📈 Tren Penggunaan - tren perubahan penggunaan
• 🔍 Log Permintaan - catatan permintaan terperinci

​

5.3 Optimalkan Performa Aplikasi

1. Sesuaikan Pilihan Model
   • Gunakan gpt-4o-mini untuk tugas sederhana agar biaya lebih rendah
   • Gunakan gpt-4o atau claude-sonnet-4-5 untuk tugas kompleks agar kualitas lebih baik
2. Optimalkan Prompt
   • Buat prompt lebih jelas dan spesifik
   • Tambahkan contoh untuk meningkatkan efektivitas
   • Gunakan chain-of-thought untuk penalaran yang lebih baik
3. Konfigurasikan Caching
   • Aktifkan caching untuk pertanyaan serupa
   • Kurangi biaya panggilan API

​

Fitur Lanjutan

​

Menggunakan Orkestrasi Workflow

1. Cabang Bersyarat - menjalankan logika berbeda berdasarkan kondisi
2. Kolaborasi Multi-model - menggabungkan keunggulan beberapa model
3. Panggilan Tool Eksternal - memanggil API, database, dan sumber eksternal lainnya
4. Penerusan Variabel - meneruskan data antar-node

​

Mengonfigurasi Kemampuan Agent

1. Tool Calling - memungkinkan AI memanggil tool eksternal
2. Manajemen Memori - mempertahankan memori percakapan jangka panjang
3. Pengambilan Keputusan Otonom - AI merencanakan langkah eksekusi secara mandiri

​

Aplikasi Multimodal

1. Pemahaman Gambar - gunakan gpt-4o atau claude-3 untuk memproses gambar
2. Pembuatan Gambar - integrasikan API pembuatan gambar APIMart
3. Pemrosesan Suara - integrasikan layanan TTS dan STT

​

FAQ

​

Q1: Tidak dapat terhubung ke layanan APIMart?

1. Periksa Base URL:
   • Pastikan nilainya https://api.apimart.ai/v1 (termasuk /v1)
   • Jangan menambahkan path tambahan atau menghilangkan /v1
2. Verifikasi API Key:
   • Pastikan API Key diawali dengan sk-
   • Periksa apakah key valid di APIMart Console
3. Periksa Koneksi Jaringan:
   • Pastikan server dapat mengakses https://api.apimart.ai
   • Untuk versi self-hosted, pastikan konektivitas jaringan server tersedia

​

Q2: Respons model lambat?

1. Beralih ke Model yang Lebih Cepat:
   • Gunakan gpt-4o-mini sebagai pengganti gpt-4o
   • Gunakan gemini-2.0-flash-exp untuk respons yang lebih cepat
2. Optimalkan Panjang Prompt:
   • Kurangi konteks yang tidak diperlukan
   • Sederhanakan deskripsi prompt
3. Sesuaikan Retrieval Basis Pengetahuan:
   • Kurangi jumlah dokumen yang diambil
   • Naikkan ambang kemiripan

​

Q3: Panggilan API gagal atau mengembalikan error?

​

Q4: Bagaimana mengurangi biaya penggunaan API?

1. Pemilihan Model:
   • Gunakan gpt-4o-mini untuk tugas sederhana (biayanya hanya sekitar 1/10 dari gpt-4o)
   • Pertimbangkan model yang lebih ekonomis untuk tugas batch
2. Aktifkan Caching:
   • Kembalikan hasil cache untuk pertanyaan yang sama
   • Konfigurasikan pencocokan kemiripan di Dify
3. Optimalkan Panjang Keluaran:
   • Tetapkan Max Tokens secara wajar
   • Hindari menghasilkan respons yang terlalu panjang
4. Gunakan Output Streaming:
   • Tingkatkan pengalaman pengguna tanpa menambah biaya

​

Q5: Bagaimana menangani data sensitif?

1. Gunakan Environment Variables:
   • Jangan hardcode API Key di dalam kode
   • Gunakan fitur environment variable Dify
2. Konfigurasikan Kontrol Akses:
   • Atur izin akses aplikasi
   • Aktifkan autentikasi untuk panggilan API
3. Audit Log:
   • Periksa log aplikasi secara berkala
   • Pantau pola akses yang tidak normal

​

Praktik Terbaik

​

1. Prompt Engineering

# Role Definition
You are a professional [role description]

# Task Objective
You need to help users [task description]

# Output Requirements
- Requirement 1
- Requirement 2
- Requirement 3

# Input Information
{{user_input}}

​

2. Manajemen Basis Pengetahuan

• Strategi Chunking: Tetapkan ukuran chunk dokumen yang wajar (direkomendasikan 500-1000 karakter)
• Penandaan Metadata: Tambahkan metadata pada dokumen agar lebih mudah diambil
• Pembaruan Berkala: Jaga konten basis pengetahuan tetap mutakhir

​

3. Penanganan Error

• Pesan yang Ramah: Berikan pesan error yang jelas kepada pengguna
• Strategi Fallback: Beralih ke model cadangan saat model utama gagal
• Mekanisme Retry: Coba ulang otomatis untuk error sementara

​

4. Pemantauan Performa

• Atur Peringatan: Beri peringatan untuk saldo rendah dan tingkat error tinggi
• Analisis Berkala: Analisis data penggunaan mingguan/bulanan
• Optimasi Berkelanjutan: Sesuaikan konfigurasi berdasarkan data

​

Contoh Kasus Penggunaan

​

1. Layanan Pelanggan Cerdas

• Model: gpt-4o-mini (hemat biaya)
• Basis Pengetahuan: dokumentasi produk, FAQ
• Fitur: jawab otomatis pertanyaan umum, eskalasi masalah kompleks ke manusia

​

2. Asisten Pembuatan Konten

• Model: gpt-4o atau claude-sonnet-4-5 (kualitas tinggi)
• Fitur: pembuatan artikel, penulisan ulang, penyempurnaan
• Parameter: Temperature=0.8 (meningkatkan kreativitas)

​

3. Asisten Kode

• Model: claude-sonnet-4-5 (sangat baik untuk kode)
• Fitur: pembuatan kode, penjelasan, debugging
• Basis Pengetahuan: dokumentasi proyek, dokumentasi API

​

4. Asisten Analisis Data

• Model: gpt-4o (kemampuan penalaran kuat)
• Tool: eksekusi kode Python, visualisasi data
• Fitur: analisis data, pembuatan laporan

​

Fitur

• 🤖 Membangun Aplikasi AI dengan Cepat - buat aplikasi AI yang kuat tanpa coding
• 📚 Peningkatan Basis Pengetahuan - teknologi RAG memungkinkan AI menjawab berdasarkan data Anda
• 🔧 Workflow yang Fleksibel - orkestrasi logika AI kompleks secara visual
• 🎯 Manajemen Prompt yang Presisi - version control dan A/B testing
• 📊 Pemantauan & Analitik Lengkap - pahami penggunaan dan performa aplikasi
• 🔌 Beragam Metode Integrasi - API, sematan, WebApp, dan lainnya
• 👥 Kolaborasi Tim - mendukung pengembangan kolaboratif multi-pengguna
• 🌐 Dukungan Multi-model - beralih secara fleksibel antar-model AI

​

Dukungan & Bantuan

• 📚 Dokumentasi APIMart
• 📚 Dokumentasi Resmi Dify
• 💬 Komunitas Discord
• 🐦 Twitter @APIMart_
• 📧 Dukungan Teknis: zhihong@apimart.ai