> ## Documentation Index
> Fetch the complete documentation index at: https://gccai.heqingsong.uk/llms.txt
> Use this file to discover all available pages before exploring further.
# Menggunakan GccAi di Dify
> Panduan lengkap untuk mengonfigurasi dan menggunakan layanan API GccAi di platform LLMOps Dify. Panduan ini membantu Anda menyiapkan API GccAi di Dify untuk membangun aplikasi AI yang kuat.
## Prasyarat
Sebelum memulai, pastikan:
1. **Akun Dify sudah terdaftar**
Kunjungi [situs resmi Dify](https://dify.ai/) untuk mendaftar akun, lalu pilih versi cloud atau self-hosted
2. **API Key GccAi sudah diperoleh**
Masuk ke [GccAi Console](https://gccai.heqingsong.uk/keys) untuk mendapatkan API key Anda (diawali dengan `sk-`)
> [!NOTE]
>
> **Tips:** Jika Anda belum memiliki akun GccAi, daftar terlebih dahulu di [GccAi](https://gccai.heqingsong.uk) dan dapatkan API key.
## Langkah 1: Masuk ke Dify dan Buka Pengaturan
### 1.1 Akses Platform Dify
* **Versi Cloud:** Kunjungi [https://cloud.dify.ai](https://cloud.dify.ai) lalu masuk
* **Versi Self-hosted:** Kunjungi alamat deployment Dify Anda
*Antarmuka utama Dify yang menampilkan daftar aplikasi dan tombol buat aplikasi*
### 1.2 Buka Pengaturan Model
1. Klik **ikon avatar** di sudut kanan atas
2. Pilih **Settings**
3. Pilih **Model Provider** pada menu kiri
*Temukan opsi "Model Provider" pada menu kiri*
> [!NOTE]
>
> **Catatan:** Dify mendukung konfigurasi beberapa penyedia model. Anda dapat menggunakan GccAi bersama penyedia lain.
## Langkah 2: Tambahkan Penyedia Model GccAi
> [!NOTE]
>
> **Metode Konfigurasi:** Ada dua cara untuk mengonfigurasi GccAi di Dify:
>
> **Metode 1 (Direkomendasikan):** Gunakan fitur Custom API pada penyedia OpenAI
>
> * Pada pengaturan penyedia OpenAI, ubah langsung Base URL menjadi `https://gccai.heqingsong.uk/v1`
> * Masukkan API Key GccAi Anda
> * Konfigurasi lebih cepat dan sederhana
>
> **Metode 2:** Tambahkan sebagai penyedia model kustom (metode dalam panduan ini)
>
> * Lebih fleksibel dan dapat mengelola penyedia GccAi secara terpisah
> * Praktis jika menggunakan beberapa penyedia API sekaligus
>
> Kedua metode memiliki fungsi yang sama. Pilih sesuai preferensi Anda.
### 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 GccAi Anda (`sk-xxxxxxxxxxxx`)
* **API Base URL** atau **Base URL**: Masukkan `https://gccai.heqingsong.uk/v1`
4. Klik **Save**
*Konfigurasikan API Key dan Base URL GccAi pada penyedia OpenAI*
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)
*Aktifkan model yang Anda butuhkan pada daftar model OpenAI*
> [!WARNING]
>
> **Penting:** Aktifkan hanya model yang benar-benar didukung oleh GccAi!
>
> Meskipun daftar model OpenAI di Dify menampilkan banyak model, hanya model yang didukung GccAi yang akan berfungsi dengan benar. Mengaktifkan model yang tidak didukung akan menyebabkan panggilan API gagal.
>
> Lihat [Dokumentasi API GccAi](https://gccai.heqingsong.uk) untuk daftar lengkap model yang didukung.
> [!TIP]
>
> **Model yang didukung dan direkomendasikan GccAi:**
>
> **Seri GPT:**
>
> * `gpt-5` / `gpt-5-chat-latest` - model seri GPT-5
> * `chatgpt-4o-latest` / `gpt-4o` - model GPT-4o terbaru
> * `gpt-4o-mini` - versi cepat dan ekonomis
> * `gpt-4.1` / `gpt-4.1-mini` - seri GPT-4.1
>
> **Seri Claude:**
>
> * `claude-sonnet-4-5-20250929` - Claude Sonnet 4.5
> * `claude-haiku-4-5-20251001` - Claude Haiku 4.5
>
> **Seri Gemini:**
>
> * `gemini-2.0-flash-exp` - Google Gemini 2.0 Flash
>
> Anda dapat mengaktifkan beberapa model sekaligus dan beralih secara fleksibel di dalam aplikasi.
Setelah selesai, Anda dapat langsung menggunakannya. Lanjutkan ke **Langkah 3**.
#### Metode 2: Tambahkan Penyedia Model Kustom
Pada halaman Model Provider:
1. Gulir ke bagian **Custom Model**
2. Klik tombol **+ Add Model**
*Gulir ke bagian model kustom dan klik tombol "+ Add Model"*
### 2.2 Konfigurasikan Penyedia GccAi
Pada dialog konfigurasi, isi informasi berikut:
| Kolom | Nilai |
| - | - |
| **Model Name** | `GccAi` atau nama kustom |
| **Model Type** | Pilih `LLM` (Large Language Model) |
| **API Key** | API key GccAi Anda (`sk-xxxxxxxxxxxx`) |
| **API endpoint URL** | `https://gccai.heqingsong.uk/v1` |
| **Endpoint model name** | Masukkan nama model tertentu (misalnya `gpt-4o`, `gpt-4o-mini`, `claude-sonnet-4-5-20250929`, dan lainnya) |
*Isi konfigurasi penyedia GccAi*
> [!WARNING]
>
> **Penting:**
>
> * Base URL harus menyertakan akhiran `/v1`: `https://gccai.heqingsong.uk/v1`
> * API Key harus diperoleh dari konsol GccAi dan diawali dengan `sk-`
> * Pastikan API key Anda memiliki saldo yang cukup
### 2.3 Tambahkan Model Lainnya (Opsional)
Untuk menambahkan model lainnya, ulangi langkah di atas:
1. Di bagian model kustom, klik lagi tombol **+ Add Model**
2. Isi informasi konfigurasi untuk model lain
3. Klik Save
*Ulangi langkah tambah model untuk mengonfigurasi beberapa model berbeda*
**Model yang Direkomendasikan untuk Ditambahkan:**
#### Seri GPT-4/5
| ID Model | Nama Model | Panjang Konteks | Kasus Penggunaan |
| - | - | - | - |
| `gpt-5` | GPT-5 | 128,000 | Tugas kompleks, pemrosesan teks panjang |
| `gpt-4o` | GPT-4o | 128,000 | Chat berkualitas tinggi, pembuatan kode |
| `gpt-4o-mini` | GPT-4o Mini | 128,000 | Respons cepat, hemat biaya |
#### Seri Claude
| ID Model | Nama Model | Panjang Konteks | Kasus Penggunaan |
| - | - | - | - |
| `claude-sonnet-4-5-20250929` | Claude Sonnet 4.5 | 200,000 | Penalaran kompleks, analisis kode |
| `claude-haiku-4-5-20251001` | Claude Haiku 4.5 | 200,000 | Respons cepat, tugas sederhana |
#### Seri Gemini
| ID Model | Nama Model | Panjang Konteks | Kasus Penggunaan |
| - | - | - | - |
| `gemini-2.0-flash-exp` | Gemini 2.0 Flash | 32,000 | Multimodal, aplikasi real-time |
> [!TIP]
>
> **Rekomendasi Performa:**
>
> * 💰 **Hemat biaya:** `gpt-4o-mini`, `claude-haiku-4-5-20251001`
> * 🚀 **Performa tinggi:** `gpt-5`, `gpt-4o`, `claude-sonnet-4-5-20250929`
> * ⚡ **Respons cepat:** `gemini-2.0-flash-exp`, `gpt-4o-mini`
## Langkah 3: Gunakan Model GccAi 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
*Pilih jenis aplikasi untuk membuat aplikasi baru*
### 3.2 Pilih Model GccAi
Pada halaman orkestrasi aplikasi:
1. Temukan area **Model Settings**
2. Klik dropdown **Select Model**
3. Pilih penyedia **GccAi**
4. Pilih model yang telah Anda konfigurasi (misalnya `gpt-4o`)
*Pilih model dari penyedia GccAi di dalam aplikasi*
### 3.3 Konfigurasikan Parameter Model
Sesuaikan parameter model sesuai kebutuhan:
| Parameter | Deskripsi | Nilai yang Direkomendasikan |
| - | - | - |
| **Temperature** | Mengontrol tingkat keacakan keluaran | 0.7 (kreatif) / 0.3 (presisi) |
| **Max Tokens** | Panjang keluaran maksimum | 2000-4000 |
| **Top P** | Parameter nucleus sampling | 0.9 |
| **Presence Penalty** | Mengurangi pengulangan | 0.0-0.5 |
| **Frequency Penalty** | Mengurangi kata yang terlalu sering muncul | 0.0-0.5 |
*Sesuaikan parameter model berdasarkan kebutuhan aplikasi*
## Langkah 4: Bangun dan Uji Aplikasi
### 4.1 Tambahkan Prompt
Pada halaman orkestrasi aplikasi:
1. Tulis prompt di area **System Prompt**
2. Gunakan variabel agar aplikasi lebih dinamis:
* `{{variable_name}}` - variabel input pengguna
* `{{context}}` - konteks basis pengetahuan
**Contoh Prompt:**
```
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}}
```
*Tulis dan konfigurasikan prompt di editor prompt*
### 4.2 Tambahkan Basis Pengetahuan (Opsional)
Jika Anda membutuhkan kemampuan RAG (Retrieval Augmented Generation):
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
*Uji efektivitas aplikasi di panel pratinjau*
### 4.4 Publikasikan Aplikasi
Setelah pengujian:
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
*Pilih metode publikasi yang sesuai*
## Langkah 5: Pantau dan Optimalkan
### 5.1 Lihat Log Aplikasi
Pada halaman detail aplikasi:
1. Klik tab **Logs**
2. Lihat semua catatan percakapan
3. Analisis pertanyaan pengguna dan respons AI
4. Temukan peluang perbaikan
*Lihat dan analisis log penggunaan aplikasi*
### 5.2 Pantau Penggunaan API
Masuk ke [GccAi Console](https://gccai.heqingsong.uk/overview) untuk melihat:
* 📊 **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
Optimalkan berdasarkan data pemantauan:
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
Fitur workflow Dify memungkinkan Anda untuk:
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
Bangun agent cerdas dengan model GccAi:
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
Manfaatkan kemampuan multimodal GccAi:
1. **Pemahaman Gambar** - gunakan `gpt-4o` atau `claude-3` untuk memproses gambar
2. **Pembuatan Gambar** - integrasikan API pembuatan gambar GccAi
3. **Pemrosesan Suara** - integrasikan layanan TTS dan STT
## FAQ
### Q1: Tidak dapat terhubung ke layanan GccAi?
**Solusi:**
1. **Periksa Base URL**:
* Pastikan nilainya `https://gccai.heqingsong.uk/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 [GccAi Console](https://gccai.heqingsong.uk/keys)
3. **Periksa Koneksi Jaringan**:
* Pastikan server dapat mengakses `https://gccai.heqingsong.uk`
* Untuk versi self-hosted, pastikan konektivitas jaringan server tersedia
### Q2: Respons model lambat?
**Solusi:**
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?
**Error umum dan solusinya:**
| Pesan Error | Penyebab | Solusi |
| - | - | - |
| `401 Unauthorized` | API Key tidak valid atau kedaluwarsa | Dapatkan ulang API Key dan perbarui konfigurasi |
| `429 Too Many Requests` | Batas laju permintaan terlampaui | Sesuaikan pengaturan konkurensi aplikasi atau tunggu lalu coba lagi |
| `500 Internal Server Error` | Masalah server sementara | Tunggu beberapa menit lalu coba lagi |
| `insufficient_quota` | Saldo akun tidak cukup | Isi saldo di konsol |
| `context_length_exceeded` | Input melebihi panjang konteks | Kurangi panjang input atau gunakan model dengan konteks lebih besar |
### Q4: Bagaimana mengurangi biaya penggunaan API?
**Saran optimasi biaya:**
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?
**Rekomendasi keamanan data:**
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
**Prompt Terstruktur:**
```
# 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
**Konfigurasi Aplikasi:**
* 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
**Konfigurasi Aplikasi:**
* 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
**Konfigurasi Aplikasi:**
* Model: `claude-sonnet-4-5` (sangat baik untuk kode)
* Fitur: pembuatan kode, penjelasan, debugging
* Basis Pengetahuan: dokumentasi proyek, dokumentasi API
### 4. Asisten Analisis Data
**Konfigurasi Aplikasi:**
* Model: `gpt-4o` (kemampuan penalaran kuat)
* Tool: eksekusi kode Python, visualisasi data
* Fitur: analisis data, pembuatan laporan
## Fitur
Dengan Dify + GccAi, Anda dapat:
* 🤖 **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
Jika Anda mengalami masalah:
* 📚 [Dokumentasi GccAi](https://gccai.heqingsong.uk)
* 📚 [Dokumentasi Resmi Dify](https://docs.dify.ai)
* 💬 [Komunitas Discord](https://discord.gg/V8zqssyZ5c)
* 🐦 [Twitter @GccAi\_](https://x.com/GccAi_)
* 📧 Dukungan Teknis: [zhihong@gccai.heqingsong.uk](mailto:zhihong@gccai.heqingsong.uk)
***
> **[Mulai Menggunakan GccAi](https://gccai.heqingsong.uk)**
>
> Daftar GccAi sekarang, dapatkan API key Anda, dan bangun aplikasi AI yang kuat di Dify!
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.