personaa by dapur.ai

personaa Documentation

Learn how to setup, configure, and connect your ESP32 Voice Agents to our platform.

Pelajari cara memasang, mengatur, dan menghubungkan Agen Suara ESP32 Anda ke platform kami.

Acknowledgment: This platform is a custom deployment of the Xiaozhi project. All credits and our deepest gratitude go to the developers involved in both the xiaozhi-esp32 and xiaozhi-esp32-server open-source projects. Our goal is to introduce the usage of AI to the general public in an accessible and friendly way.

Catatan: Platform ini merupakan custom deploy dari proyek sumber terbuka Xiaozhi. Seluruh kredit dan rasa terima kasih yang sebesar-besarnya kami sampaikan kepada semua developer yang terlibat, baik pada proyek xiaozhi-esp32 maupun xiaozhi-esp32-server. Tujuan kami di sini adalah untuk memperkenalkan penggunaan AI ke khalayak umum dengan cara yang mudah diakses dan ramah pengguna.

Quickstart Guide Panduan Mulai Cepat

Follow these core steps to get your physical ESP32 device or Web Client running with an AI Persona in minutes.

Ikuti langkah-langkah utama ini untuk mulai menggunakan perangkat ESP32 fisik Anda atau Web Client bersama Persona AI dalam hitungan menit.

1. Flash Firmware 1. Flash Firmware

Install the Xiaozhi firmware to your ESP32-S3 via USB using our Web Serial flasher.

Instal firmware Xiaozhi ke perangkat ESP32-S3 Anda melalui USB menggunakan fitur Web Serial flasher kami.

Open Web Flasher → Buka Web Flasher →

2. Pair Device 2. Hubungkan Perangkat (Pairing)

Turn on the device, connect it to Wi-Fi, and it will speak a Pairing Code. Enter it here.

Nyalakan perangkat, sambungkan ke Wi-Fi, lalu perangkat akan menyebutkan Kode Pairing via suara. Masukkan kodenya di sini.

Pair Device → Pairing Perangkat →

3. Create Agent 3. Buat Agen Suara

Design your AI persona, configure its system prompt, choose a voice and an LLM model.

Rancang persona AI Anda, atur prompt sistemnya (instruksi otak AI), lalu pilih model bahasa dan model suara TTS-nya.

Create Agent → Buat Agen →

4. Bind Device 4. Ikat Perangkat (Bind)

Go to your dashboard and assign the paired ESP32 to your newly created Agent.

Buka kembali menu dashboard utama, dan pasangkan ESP32 yang sudah terhubung tadi ke dalam slot Agen yang baru saja Anda buat.

Web Client & Simple Mode Web Client & Mode Simpel

If you don't have a physical ESP32 device, you can test your AI using our built-in Web Client. It fully simulates the hardware experience via your browser's microphone and speakers.

Jika Anda belum memiliki perangkat fisik ESP32, Anda masih bisa menguji AI Anda menggunakan Web Client bawaan kami. Fitur ini mensimulasikan pengalaman hardware secara penuh menggunakan mikrofon dan speaker dari browser Anda.

  • Accessing the Client: Mengakses Client:

    Click the Open Client button on the dashboard, enter your agent's ID, and grant microphone permissions.

    Klik tombol Open Client di dashboard, masukkan ID agen Anda, dan izinkan akses mikrofon di browser.

  • Simple Mode vs Live2D: Mode Simpel vs Live2D Avatar:

    By default, the client opens in Simple Mode (a cosmic, low-distraction visualizer). If you prefer an anime-style interactive avatar, toggle the Simple Mode button off. Your preference is saved locally in your browser.

    Secara bawaan, Web Client akan terbuka dalam Simple Mode (visualisator kosmik yang minim distraksi). Jika Anda lebih suka melihat avatar anime interaktif bergaya Live2D, Anda bisa mematikan saklar Simple Mode. Preferensi tampilan Anda akan disimpan secara otomatis di browser.

  • Duplex Audio Support: Dukungan Audio Dupleks Penuh:

    The Web Client supports full-duplex communication. This means you can interrupt the AI while it is speaking, and it will hear you!

    Web Client mendukung komunikasi *full-duplex*. Artinya, mikrofon Anda tetap menyala dan Anda dapat menyela/memotong pembicaraan AI saat ia sedang berbicara, dan ia akan tetap mendengar Anda!

Agent Setup Menu Penjelasan Menu Setup Agen

When creating or editing an Agent, you are defining its personality and capabilities. Here is what each option means:

Saat membuat atau mengedit Agen, Anda sedang mendefinisikan kepribadian dan kemampuannya. Berikut adalah arti dari masing-masing opsi tersebut:

Agent Name Nama Agen

The display name of your persona. This is only visible to you on the dashboard.

Nama tampilan persona Anda. Nama ini hanya berfungsi sebagai penanda visual bagi Anda di dashboard.

System Prompt Prompt Sistem (Instruksi Utama)

The core instructions or "brain" of the AI. Use this to define its personality, background story, rules, and how it should respond.
Example: "You are an angry pirate. Answer in short sentences. Always say 'Arrr'."

Ini adalah inti "otak" AI Anda. Gunakan kotak teks ini untuk menulis instruksi detail tentang kepribadian, latar belakang cerita, pantangan/aturan, dan gaya bahasanya.
Contoh: "Kamu adalah Resepsionis galak bernama Siti. Jawab dengan kalimat pendek dan sinis. Gunakan bahasa gaul Jakarta."

AI Model (LLM) Model AI (LLM - Otak)

The language model that powers the AI's intelligence. Some models are faster, while others are smarter (e.g., GPT-4o vs Claude 3 Haiku).

Model bahasa skala besar (LLM) yang menjadi sumber kecerdasan AI. Beberapa model dirancang untuk kecepatan tinggi (seperti Claude 3 Haiku), sementara lainnya difokuskan pada kedalaman analisis (seperti GPT-4o).

Voice (TTS) Model Suara (TTS)

The Text-to-Speech voice model. This determines the accent, gender, and tone of how the AI sounds when speaking through the ESP32 speaker or Web Client.

Teknologi pengubah Teks-ke-Suara. Pilihan ini akan mengubah aksen, jenis kelamin, dan warna suara agen Anda saat ia berbicara melalui speaker ESP32 ataupun Web Client.

Knowledgebase (RAG) Basis Pengetahuan Kustom (KB)

Give your AI agent custom, private knowledge by uploading documents. When the user asks a question, the AI will search these documents for answers before generating a response.

Anda bisa memasukkan ilmu pengetahuan spesifik atau dokumen privat ke dalam "ingatan" AI. Ketika ada pengguna yang bertanya, AI akan terlebih dahulu mencari dan membaca referensi dari dokumen Anda ini sebelum menjawab.

Supported Formats Format yang Didukung

Currently, the platform only supports Markdown (`.md`) files. Support for PDF and TXT will be added in future updates. Ensure your Markdown files are well-structured with clear headings (`#`) for the best search accuracy.

Saat ini, sistem kami baru mendukung file Markdown (`.md`) saja. Dukungan untuk `.txt` dan `.pdf` sedang kami kembangkan untuk *update* mendatang. Pastikan dokumen Markdown Anda disusun rapi dengan format judul *Heading* (`#`, `##`) agar akurasi pencariannya lebih tajam.

How to Upload Cara Mengunggah File

  1. Navigate to the main dashboard.
  2. Find the Agent you want to train.
  3. Click the KB (Knowledgebase) button on the agent's card.
  4. Select your `.md` files to upload. The server will automatically chunk and vectorize the documents.
  1. Buka halaman dashboard utama Anda.
  2. Cari kartu Agen Suara yang ingin Anda "ajari" ilmu baru.
  3. Klik tombol KB (Knowledgebase) berwarna kuning di bagian bawah kartu tersebut.
  4. Pilih file `.md` Anda dari komputer. Server akan otomatis memproses dan menanamkan (vektorisasi) teks dokumen tersebut ke dalam memori AI.