A Letaido / docs
DOCUMENTATION

FAQ

Pertanyaan yang muncul di minggu pertama.

Ada pertanyaan? Tanyakan pada agen

Jika Anda memiliki pertanyaan tentang apa yang dapat dilakukan Letaido, mengalami error, atau tidak yakin bagaimana sesuatu bekerja, cara tercepat untuk mendapatkan jawaban adalah dengan bertanya langsung kepada agent di chat. Agent dapat membaca dokumentasinya sendiri, melihat workspace Anda, memeriksa pengaturan Anda, dan memandu Anda melalui apa yang dilihatnya, semuanya di tempat yang sama.

FAQ di bawah ini mencakup pertanyaan yang paling sering muncul. Jika pertanyaan Anda tidak ada di sini, tanyakan kepada agen; jika layak untuk diteruskan, agen akan menawarkan untuk menambahkannya.

Dasar-dasar

Apakah ia mengingat di seluruh percakapan?

Ya, tetapi hanya yang Anda minta untuk diingat. Ini membaca ~/workspace/.memory.md di awal setiap percakapan. Katakan "ingat ini: X" dan itu akan ditambahkan. Log perubahan (progress.md) juga dibaca, sehingga ia tahu apa yang baru saja dibangun.

Bisakah saya mengembalikan sesuatu yang dibuatnya?

File mudah: tanyakan "tunjukkan apa yang Anda ubah dalam satu jam terakhir dan kembalikan X." Perubahan database tidak dikembalikan secara otomatis, tetapi setiap tindakan dicatat, jadi membatalkannya biasanya merupakan percakapan yang jelas. Untuk perubahan destruktif (menghapus tabel, menghapus Skills), agen akan bertanya sebelum melakukannya.

Bisakah beberapa orang berbagi workspace?

Ya. Peran yang tersedia adalah owner, admin, member, dan viewer. Owner dan admin memutuskan kartu persetujuan, mengelola secrets, dan mengaktifkan/menonaktifkan situs publik. Member dapat melakukan chat dan menggunakan halaman Console. Viewer hanya memiliki akses baca saja.

Apakah apa pun yang saya ketik dikirim ke pihak ketiga?

Agen melakukan penalaran melalui penyedia LLM via proxy lokal. Pesan dikirim untuk inferensi dan output dikembalikan. Tidak ada penyimpanan di luar kebijakan penyedia model itu sendiri. Tidak ada yang dibagikan dengan Workspace lain.

Apa yang terjadi ketika API eksternal gagal?

Agen melaporkan kegagalan (kode status, kategori kesalahan jika konektor menyediakannya), berhenti, dan menunggu instruksi. Agen tidak akan mencoba lagi hingga anggaran Anda habis.

Membangun sesuatu

Berapa lama waktu yang dibutuhkan untuk membangun aplikasi Console?

Yang sederhana (satu formulir, satu kueri, satu hasil) selesai dalam beberapa menit. Yang kompleks (pipeline multi-langkah, integrasi pihak ketiga, visualisasi kustom) memerlukan sesi chat, terkadang dua. Agen akan memberi tahu Anda jika diperkirakan memerlukan lebih dari satu putaran.

Bagaimana cara membagikan sesuatu dengan pelanggan?

Bangun di situs publik, dapatkan URL, alihkan mode situs ke open atau authorized, bagikan tautannya. Pola yang perlu diketahui: laporan berbasis token (/<route>/<token>), dokumentasi publik (situs ini), halaman penangkapan prospek.

Bisakah agen membangun sesuatu yang belum pernah dibangun sebelumnya?

Ya, selama primitif tersebut ada (blueprint Console, rute situs, cron job, webhook, konektor). Sistem akan menyusunnya. Jika primitif tidak ada (diperlukan kemampuan platform baru), sistem akan memberi tahu Anda dengan jelas daripada berpura-pura bisa melakukannya.

Bagaimana jika tidak ada konektor untuk layanan yang saya butuhkan?

Minta dukungan untuk menambahkan konektor baru untuk aplikasi tersebut. Konektor baru ditambahkan secara berkala berdasarkan permintaan pelanggan; sementara itu, agen biasanya dapat menggunakan API key generik, daftar izin domain, dan HTTP mentah sebagai alternatif, tetapi konektor yang tepat selalu lebih disukai (dilengkapi dengan input bertipe, logging, kredensial terbatas, dan persetujuan per-permukaan secara bawaan).

Memori, skills, voice

Bagaimana cara memastikan agen menggunakan suara merek kami?

Ada skill brand-voice di ruang kerja Anda. Agen membacanya saat menulis atau meninjau salinan. Untuk menambahkan aturan baru: "perbarui skill brand voice untuk menambahkan: ." Untuk memaksanya pada draft satu kali: "gunakan skill brand voice sebelum menulis."

Mengapa Anda mengatakan tidak ada em dash?

Ini adalah pilihan gaya rumah yang telah dikomitmenkan oleh ruang kerja ini. Aturan tersebut tersimpan dalam memori dan dalam skill suara merek, sehingga setiap draf (dan dokumen-dokumen ini) menghindarinya. Ganti dengan koma, titik dua, titik, atau tanda kurung.

Haruskah saya memasukkan semuanya ke dalam memori?

Tidak. Memori adalah untuk hal-hal yang mengubah default agen: siapa Anda, bagaimana Anda menulis, apa yang Anda pedulikan dalam jangka panjang. Untuk aturan alur kerja ("daftar periksa peluncuran standar kami adalah X"), skill lebih baik. Untuk konteks sekali pakai ("pelanggan ini sensitif tentang harga"), katakan saja di chat.

Situs publik, dokumentasi, ringkasan mingguan

Bagaimana dokumen ini diperbarui?

Sumber markdown berada di ~/workspace/docs/*.md. Pengelola mengedit secara manual. Pekerjaan sinkronisasi (setiap 30 menit) merender markdown ke dalam database. Situs publik membaca dari database.

Apa itu ringkasan mingguan?

Pekerjaan terjadwal yang berjalan setiap Senin pukul 10:00 Europe/Bucharest. Ini membandingkan memori agen, log perubahan, dan folder skills sejak digest terakhir, menanyakan kepada LLM apa yang berubah dan perlu diketahui pelanggan, lalu mengirimkan saran edit dokumen ke maintainer melalui Slack. Maintainer meninjau; dokumen kemudian diperbarui.

Mengapa tidak langsung mempublikasikan saran secara otomatis?

Dua alasan. (1) Suntingan yang disarankan LLM bisa saja salah secara halus; dokumentasi adalah wajah publik produk. (2) Tinjauan manusia menjaga konsistensi suara dan menangkap hal-hal yang terlihat benar tetapi sebenarnya tidak.

Bagaimana cara melaporkan masalah dengan dokumentasi?

Beri tahu agen di chat. Agen akan membuka catatan di ruang kerja dan menyampaikannya kepada pengelola dokumentasi dalam ringkasan mingguan berikutnya.

Persetujuan, rahasia, uang

Mengapa terus meminta saya untuk menyetujui sesuatu?

Karena tindakan tersebut memerlukan biaya, mengakses jaringan, atau menyentuh kredensial. Setiap tindakan dicatat. Solusi untuk "terlalu banyak kartu persetujuan" biasanya adalah mengelompokkan permintaan: minta agen untuk merencanakan seluruh alur terlebih dahulu sehingga meminta semua cakupan dan persetujuan sekaligus.

Bisakah saya melihat kredensial apa saja yang telah dikonfigurasi?

Ya, dari UI ruang kerja. Anda dapat melihat nama secret, jenis, status, dan konektor serta surface mana yang diberikan aksesnya. Anda tidak dapat melihat nilai secret; tidak ada yang bisa, termasuk agen.

Bisakah saya membatasi pengeluaran agen?

Platform mengukur token LLM dan panggilan konektor. Untuk kontrol biaya yang berkelanjutan, pekerjaan adalah permukaan yang tepat (mereka adalah pengeluaran berulang yang eksplisit); pengeluaran obrolan ad-hoc adalah apa pun yang Anda minta. Jika pekerjaan tidak berfungsi dengan baik, jeda dari tab Pekerjaan.

Pemecahan Masalah

URL situs publik mengembalikan 403.

Mode situs adalah off. Alihkan ke authorized (hanya anggota) atau open (siapa saja) dari tab situs Publik.

Halaman Console dimuat selamanya.

Halaman tersebut melakukan panggilan eksternal yang lama (timeout nginx adalah 30 detik; pekerjaan yang lama harus menggunakan pola job-id-then-poll), atau proses Flask telah crash. Periksa log yang di-tail di /home/console/http/data/.tail.log.

Panggilan konektor mengembalikan approval_pending atau not_approved.

Pertama kali untuk kombinasi (konektor, rahasia, permukaan) tersebut. Setujui kartu. Untuk permukaan Console atau situs, pemilik atau admin mengklik request_connector_approval secara terpisah dari permukaan chat.

Pekerjaan tidak berjalan saat saya harapkan.

Waktu cron adalah UTC pada host. Jika pekerjaan Anda adalah "setiap Senin pukul 9 pagi Bucharest," baris jadwal adalah 0 7 * * 1 (musim panas) atau 0 8 * * 1 (musim dingin); agen biasanya memilih salah satu dan menambahkan penjaga zoneinfo di dalam skrip untuk menangani DST. Periksa tab Jobs untuk waktu eksekusi berikutnya.

Trigger tidak aktif.

Periksa daftar langganan. Jika menunjukkan paused atau revoked, langganan ulang. Jika menunjukkan active tetapi tidak ada event, periksa konfigurasi aplikasi pihak ketiga (URL langganan harus diatur di sisi mereka juga).

Ruang kerja saya terasa lambat.

Sesi obrolan yang panjang menurun kualitasnya. Mulai obrolan baru; memori dan progres membawa konteks penting ke sesi berikutnya.

Last updated 2026-10-02