> ## Documentation Index > Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt > Use this file to discover all available pages before exploring further. # Menggunakan APIMart di AnythingLLM > Panduan terperinci untuk mengonfigurasi dan menggunakan layanan API APIMart di AnythingLLM. Panduan ini membantu Anda mengatur API APIMart di AnythingLLM untuk membangun basis pengetahuan AI privat dan sistem percakapan. ## Prasyarat Sebelum memulai, pastikan: 1. **AnythingLLM installed**\ Unduh dan instal AnythingLLM dari [situs resmi](https://anythingllm.com/) atau kunjungi [GitHub](https://github.com/Mintplex-Labs/anything-llm) 2. **API key APIMart sudah diperoleh**\ Masuk ke [Konsol APIMart](https://apimart.ai/keys) untuk mendapatkan API key Anda (diawali dengan `sk-`) **Tips:** Jika Anda belum memiliki akun APIMart, daftar di [APIMart](https://apimart.ai) dan dapatkan API key terlebih dahulu. ## Langkah 1: Jalankan AnythingLLM dan Buka Pengaturan ### 1.1 Mulai Aplikasi 1. Jalankan aplikasi desktop AnythingLLM atau akses versi web 2. Layar sambutan akan muncul pada peluncuran pertama 3. Klik tombol **Open settings** di sudut kiri bawah AnythingLLM Main Interface *Antarmuka utama AnythingLLM yang menampilkan daftar workspace dan akses pengaturan* **Catatan:** AnythingLLM mendukung versi desktop (Windows, macOS, Linux) dan deployment Docker. ### 1.2 Buka Konfigurasi LLM Di halaman pengaturan: 1. Temukan **LLM Preference** di menu kiri 2. Klik untuk masuk ke halaman konfigurasi LLM ## Langkah 2: Konfigurasikan API APIMart ### 2.1 Pilih Penyedia LLM Di halaman konfigurasi LLM: 1. Temukan menu dropdown **LLM Provider** 2. Pilih **Generic OpenAI** LLM Provider Selection *Pilih Generic OpenAI sebagai penyedia LLM* **Mengapa Generic OpenAI?** APIMart menyediakan antarmuka API yang kompatibel dengan OpenAI, sehingga memilih penyedia Generic OpenAI di AnythingLLM memungkinkan Anda menggunakan layanan APIMart. ### 2.2 Konfigurasikan Informasi API Setelah memilih Generic OpenAI, isi konfigurasi berikut: | Kolom | Nilai | | ----------------------------------- | --------------------------------------------------------------- | | **API Key** | API key APIMart Anda (`sk-xxxxxxxxxxxx`) | | **Base URL** atau **API Base Path** | `https://api.apimart.ai/v1` | | **Chat Model** atau **Model Name** | Masukkan nama model tertentu (lihat rekomendasi model di bawah) | API Konfigurasi *Isi API Key APIMart, Base URL, dan nama model* **Penting:** * Base URL harus menyertakan sufiks `/v1`: `https://api.apimart.ai/v1` * API Key harus diperoleh dari konsol APIMart dan diawali dengan `sk-` * Nama model harus berupa ID model yang persis (misalnya `gpt-4o`, `claude-sonnet-4-5-20250929`, dll.) * Pastikan API key Anda memiliki saldo yang cukup **Model yang Direkomendasikan:** | Nama Model | ID Model | Fitur | | ----------------- | --------------------------------- | ------------------------------- | | GPT-5 | `gpt-5` | Terbaru dan paling kuat | | GPT-4o | `gpt-4o` atau `chatgpt-4o-latest` | Percakapan berkualitas tinggi | | GPT-4o Mini | `gpt-4o-mini` | Cepat dan ekonomis | | Claude Sonnet 4.5 | `claude-sonnet-4-5-20250929` | Unggul untuk kode dan penalaran | | Claude Haiku 4.5 | `claude-haiku-4-5-20251001` | Respons cepat | | Gemini 2.0 Flash | `gemini-2.0-flash-exp` | Dukungan multimodal | **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` ### 2.3 Sesuaikan Parameter Model (Opsional) Anda dapat menyesuaikan parameter berikut sesuai kebutuhan: | Parameter | Deskripsi | Nilai yang Direkomendasikan | | --------------- | -------------------------- | ------------------------------ | | **Temperature** | Controls output randomness | 0.7 (creative) / 0.3 (precise) | | **Max Tokens** | Maximum output length | 2000-4000 | | **Top P** | Nucleus sampling parameter | 0.9 | ### 2.4 Simpan Konfigurasi 1. Klik tombol **Save** di bagian bawah halaman 2. Sistem akan menguji koneksi secara otomatis 3. Pesan berhasil akan muncul jika konfigurasi benar ## Langkah 3: Konfigurasikan Model Embedding (Opsional) AnythingLLM mendukung embedding vektor untuk pengambilan dokumen dan fungsi basis pengetahuan. ### 3.1 Buka Pengaturan Embedding Di halaman pengaturan: 1. Temukan **Embedding Preference** di menu kiri 2. Klik untuk masuk ke halaman konfigurasi model embedding ### 3.2 Konfigurasikan Model Embedding | Kolom | Nilai | | ---------------------- | ------------------------------------------------------ | | **Embedding Provider** | Pilih **Generic OpenAI** | | **API Key** | API key APIMart Anda (`sk-xxxxxxxxxxxx`) | | **Base URL** | `https://api.apimart.ai/v1` | | **Model** | `text-embedding-3-small` atau `text-embedding-3-large` | **Rekomendasi Pemilihan Model:** * `text-embedding-3-small` - Cepat dan ekonomis, cocok untuk sebagian besar skenario * `text-embedding-3-large` - Presisi lebih tinggi, cocok untuk skenario yang membutuhkan kualitas pengambilan tinggi ## Langkah 4: Buat Workspace dan Unggah Dokumen ### 4.1 Buat Workspace 1. Kembali ke antarmuka utama 2. Klik **+ New Workspace** 3. Masukkan nama workspace (misalnya, "Asisten Dokumentasi Teknis", "Basis Pengetahuan Layanan Pelanggan") 4. Klik Create ### 4.2 Unggah Dokumen AnythingLLM mendukung berbagai format dokumen: **Jenis Dokumen yang Didukung:** * 📄 **Dokumen Teks** - .txt, .md, .pdf, .docx * 💻 **File Kode** - .py, .js, .java, .cpp, dll. * 🌐 **Halaman Web** - Melalui scraping URL * 📊 **File Data** - .csv, .json, .xml **Langkah Unggah:** 1. Di halaman workspace, klik **Upload Documents** 2. Pilih file atau seret dan lepaskan file ke area unggah 3. Tunggu hingga pemrosesan dokumen selesai 4. Dokumen akan divektorisasi secara otomatis **Pemrosesan Dokumen:** Dokumen yang diunggah otomatis dipecah menjadi potongan dan divektorisasi menggunakan model embedding, lalu disimpan di database lokal. ### 4.3 Kelola Dokumen Di halaman manajemen dokumen: 1. Lihat semua dokumen yang diunggah 2. Hapus dokumen yang tidak diperlukan 3. Lihat detail pemotongan dokumen 4. Edit metadata dokumen ## Langkah 5: Mulai Percakapan Setelah konfigurasi selesai, Anda dapat mulai menggunakan AnythingLLM: ### 5.1 Percakapan Dasar 1. Di workspace, temukan kotak input percakapan 2. Masukkan pertanyaan atau permintaan Anda 3. AI akan menghasilkan respons berdasarkan dokumen yang Anda unggah dan model APIMart ### 5.2 Menggunakan Fitur Basis Pengetahuan AnythingLLM akan secara otomatis: 1. Menganalisis pertanyaan Anda 2. Mengambil konten yang relevan dari dokumen yang diunggah 3. Menghasilkan jawaban akurat dengan menggabungkan konten yang diambil dan model AI **Tingkatkan Efektivitas Pengambilan:** * Unggah dokumen berkualitas tinggi dan terstruktur * Gunakan pertanyaan yang jelas dan spesifik * Perbarui dan pelihara basis pengetahuan secara rutin ### 5.3 Beralih Workspace Anda dapat membuat beberapa workspace untuk proyek atau topik yang berbeda: 1. Klik nama workspace di sudut kiri atas 2. Pilih workspace lain atau buat yang baru 3. Setiap workspace memiliki dokumen dan riwayat percakapan tersendiri ## Fitur Lanjutan ### 1. Agent Mode AnythingLLM mendukung fungsi Agent, sehingga AI dapat: * 🔍 **Cari Web** - Mendapatkan informasi real-time * 🧮 **Melakukan Perhitungan** - Menangani matematika dan analisis data * 📊 **Membuat Grafik** - Memvisualisasikan data * 🔗 **Memanggil API** - Berinteraksi dengan layanan eksternal **Enable Agent Mode:** 1. Temukan **Agent Configuration** di pengaturan workspace 2. Pilih alat dan fitur yang akan diaktifkan 3. Simpan konfigurasi ### 2. Manajemen Riwayat Percakapan * **Ekspor Percakapan** - Ekspor percakapan dalam format teks atau JSON * **Cari Riwayat** - Temukan percakapan lama dengan cepat * **Hapus Catatan** - Bersihkan riwayat percakapan yang tidak diperlukan ### 3. Prompt Sistem Kustom Di pengaturan workspace: 1. Temukan **System Prompt** 2. Sesuaikan peran dan perilaku AI 3. Contoh: ``` You are a professional technical support engineer, skilled at answering technical questions about products. When answering, please: 1. Maintain professionalism and courtesy 2. Provide detailed step-by-step instructions 3. If uncertain, recommend contacting technical support ``` ### 4. Manajemen Multi-Pengguna (Khusus Deployment Docker) Jika menggunakan deployment Docker: * Buat beberapa akun pengguna * Tetapkan tingkat izin yang berbeda * Kelola izin akses workspace ### 5. Akses API AnythingLLM menyediakan REST API untuk: * Akses workspace secara terprogram * Mengunggah dan mengelola dokumen * Mengirim permintaan percakapan * Mengintegrasikan ke aplikasi Anda ## FAQ ### Q1: Tidak dapat terhubung ke layanan APIMart? **Solusi:** 1. **Periksa Base URL**: * Pastikan nilainya `https://api.apimart.ai/v1` (termasuk `/v1`) * Jangan menambahkan path lain atau menghilangkan `/v1` 2. **Verifikasi API Key**: * Pastikan API Key diawali dengan `sk-` * Periksa apakah key valid di [Konsol APIMart](https://apimart.ai/keys) 3. **Periksa Koneksi Jaringan**: * Pastikan akses ke `https://api.apimart.ai` tersedia * Periksa pengaturan firewall atau proxy ### Q2: Dokumen tidak diambil dengan benar setelah diunggah? **Solusi:** 1. **Periksa Konfigurasi Model Embedding**: * Pastikan model embedding dikonfigurasi dengan benar * Uji koneksi model embedding 2. **Proses Ulang Dokumen**: * Hapus dan unggah ulang dokumen * Periksa apakah format dokumen didukung 3. **Sesuaikan Parameter Pengambilan**: * Sesuaikan ambang kemiripan di pengaturan workspace * Tingkatkan jumlah potongan dokumen yang dikembalikan ### Q3: Respons percakapan lambat? **Solusi:** 1. **Beralih ke Model yang Lebih Cepat**: * Gunakan `gpt-4o-mini` alih-alih `gpt-4o` * Gunakan `gemini-2.0-flash-exp` untuk respons yang lebih cepat 2. **Optimalkan Jumlah Dokumen**: * Kurangi jumlah dokumen dalam workspace * Hapus file besar yang tidak diperlukan 3. **Sesuaikan Max Tokens**: * Kurangi panjang output maksimum * Gunakan prompt yang lebih ringkas ### Q4: Bagaimana melihat penggunaan dan biaya API? Masuk ke [Konsol APIMart](https://apimart.ai/overview) untuk melihat: * 📊 Statistik panggilan API * 💰 Detail biaya * 📈 Grafik tren penggunaan * 🔍 Log permintaan terperinci ### Q5: Opsi deployment apa yang didukung AnythingLLM? AnythingLLM mendukung beberapa opsi deployment: * 🖥️ **Aplikasi Desktop** - Windows, macOS, Linux * 🐳 **Docker** - Deployment self-hosted * ☁️ **Versi Cloud** - AnythingLLM Cloud (segera hadir) ## Contoh Kasus Penggunaan ### 1. Basis Pengetahuan Perusahaan **Konfigurasi:** * Model: `gpt-4o-mini` (cost-effective) * Documents: Internal company documents, manuals, FAQs * Fungsi: Pencarian informasi cepat untuk karyawan **Contoh Kasus Penggunaan:** * Onboarding karyawan baru * Pencarian cepat kebijakan perusahaan * Pengambilan dokumentasi teknis ### 2. Asisten Dokumentasi Teknis **Konfigurasi:** * Model: `claude-sonnet-4-5-20250929` (excellent for code) * Dokumen: dokumentasi API, spesifikasi teknis, codebase * Fungsi: Membantu developer menemukan informasi teknis **Contoh Kasus Penggunaan:** * Kueri dokumentasi penggunaan API * Pengambilan contoh kode * Menjawab pertanyaan teknis ### 3. Basis Pengetahuan Layanan Pelanggan **Konfigurasi:** * Model: `gpt-4o` (high-quality conversation) * Documents: Product manuals, FAQs, solutions * Fungsi: Menjawab pertanyaan pelanggan dengan cepat **Contoh Kasus Penggunaan:** * Menjawab FAQ secara otomatis * Panduan penggunaan produk * Saran pemecahan masalah ### 4. Asisten Riset dan Pembelajaran **Konfigurasi:** * Model: `gpt-5` (powerful understanding) * Documents: Research papers, textbooks, notes * Fungsi: Membantu pembelajaran dan riset **Contoh Kasus Penggunaan:** * Ringkasan dan analisis makalah * Penjelasan poin pengetahuan * Perencanaan jalur belajar ## Fitur Dengan AnythingLLM + APIMart, Anda dapat: * 📚 **Private Knowledge Base** - Build secure private knowledge base locally * 🔒 **Privasi Data** - Semua data disimpan secara lokal untuk melindungi privasi * 🤖 **Multi-model Dukungan** - Flexibly switch between different AI models * 📄 **Multi-format Dukungan** - Mendukung berbagai document formats * 🎯 **Precise Retrieval** - Vector-based intelligent document retrieval * 💬 **Contextual Conversation** - Maintain context in long conversations * 🔧 **Highly Customizable** - Custom prompts, parameters, etc. * 🌐 **Cross-platform** - Mendukung Windows, macOS, Linux ## Keamanan Data dan Privasi ### Penyimpanan Data Lokal AnythingLLM data storage approach: * 📁 **Sistem File Lokal** - Dokumen disimpan secara lokal * 🗄️ **Database Vektor Lokal** - Indeks vektor disimpan secara lokal * 💾 **Riwayat Percakapan** - Catatan percakapan disimpan secara lokal ### Keamanan Panggilan API * 🔐 **Transmisi Terenkripsi** - Semua panggilan API menggunakan enkripsi HTTPS * 🔑 **Perlindungan Key** - API Key disimpan dengan aman * 🚫 **Tanpa Retensi Data** - APIMart tidak menyimpan konten percakapan Anda **Pemberitahuan Privasi:** Meskipun dokumen disimpan secara lokal, percakapan dan konten yang diambil untuk dikirim ke AI akan ditransmisikan ke server APIMart melalui API untuk diproses. Hindari mengunggah atau menanyakan konten yang berisi informasi sensitif. ## Praktik Terbaik ### 1. Manajemen Dokumen * **Pembaruan Rutin** - Jaga konten dokumen tetap mutakhir * **Organisasi Terstruktur** - Gunakan struktur folder yang jelas * **Konvensi Penamaan** - Gunakan nama file yang bermakna * **Hapus yang Usang** - Bersihkan dokumen usang secara berkala ### 2. Optimasi Prompt **❌ Prompt Buruk:** ``` You are an assistant ``` **✅ Prompt Baik:** ``` You are a professional technical support assistant specializing in helping users resolve product-related technical issues. When answering, please follow these principles: 1. Answer based on provided documentation; if information isn't available, clearly state so 2. Provide detailed step-by-step instructions with examples when necessary 3. Use clear, understandable language 4. For complex issues, recommend contacting the technical support team ``` ### 3. Optimasi Performa * **Kontrol Ukuran Dokumen** - Hindari mengunggah file individual yang terlalu besar * **Pemotongan Wajar** - Gunakan pengaturan pemotongan dokumen default * **Pilih Model yang Sesuai** - Pilih model berdasarkan kompleksitas tugas * **Pantau Penggunaan** - Periksa penggunaan API secara rutin ### 4. Perencanaan Workspace * **Bagi berdasarkan Proyek** - Buat workspace terpisah untuk proyek berbeda * **Manajemen Izin** - Atur izin workspace dengan tepat (versi Docker) * **Cadangkan Data** - Cadangkan workspace penting secara berkala ## Dukungan & Bantuan Jika Anda mengalami masalah: * 📚 [Dokumentasi APIMart](https://docs.apimart.ai) * 📚 [AnythingLLM Official Documentation](https://docs.anythingllm.com/) * 📚 [AnythingLLM GitHub](https://github.com/Mintplex-Labs/anything-llm) * 💬 [Discord Community](https://discord.gg/V8zqssyZ5c) * 🐦 [Twitter @APIMart\_](https://x.com/APIMart_) * 📧 Dukungan teknis: [zhihong@apimart.ai](mailto:zhihong@apimart.ai) *** Daftar APIMart sekarang, dapatkan API key Anda, dan bangun basis pengetahuan privat di AnythingLLM!