Pengaturan
Pengaturan pengembang
Kunci pribadi, klien aplikasi, serta koneksi agen atau CLI: kontrol di halaman Sofia API dan mana yang sebaiknya dipilih.
Bagian ini adalah pintu masuk ke semua hal yang bersifat pemrograman. Dokumentasi rujukan ada di tab API, Agents, dan Tambahkan Sofia ke aplikasi Anda; halaman ini menjelaskan kontrol di antarmuka. Buka pengaturan, bagian “Sofia API”.
Akses
Halaman ini punya dua tab: “Akses pribadi” dan “Klien aplikasi”.
Kunci pribadi Anda
- Buat kunci. “Kunci baru”: beri nama jika mau, masa berlaku (7 hari, 30 hari, 90 hari, 1 tahun, atau tanpa kedaluwarsa), dan izinnya. Semuanya tercentang secara bawaan; pertahankan hanya yang dibutuhkan alat Anda.
- Salin segera. Kunci hanya ditampilkan sekali, dan Sofia hanya menyimpan sidik jarinya.
- Pakai. Kirim di header
Authorization: Bearerpada setiap panggilan. Satu kunci bertindak atas semua usaha Anda, dengan hak Anda.
Menghubungkan asisten AI
Untuk Claude, ChatGPT, Cursor, Gemini CLI, atau Claude Code, konektor pada aplikasi terhubung sering kali lebih mudah: tidak meminta kunci apa pun. Lihat Konektor AI.
CLI dan agen
“Salin instruksi agen” memberi teks yang ditempel ke agen Anda agar memakai API. Perintah sofia, yang dipublikasikan di npm dengan nama sofia-post, membungkus API untuk menerbitkan dari terminal, skrip, atau tugas terjadwal; pemasangannya ada di tab “Agents”.
Klien aplikasi
Klien aplikasi dipakai untuk membangun sesuatu yang akan diizinkan oleh pengguna Sofia lain, bukan sesuatu yang bertindak sebagai Anda.
- Buat klien. “Klien baru”: nama, logo minimal 180 × 180 piksel, alamat kebijakan privasi Anda, satu sampai lima URL pengalihan dalam HTTPS, dan izin yang boleh diminta aplikasi. Nama dan logo ditampilkan kepada orang saat otorisasi.
- Salin pengenal. Anda mendapat Client ID dan Client Secret. Klien publik, untuk aplikasi yang kodenya publik, tidak punya rahasia dan diautentikasi dengan PKCE; pilihan ini permanen.
- Implementasikan alurnya. Lihat tab “Tambahkan Sofia ke aplikasi Anda”.
Kunci atau klien OAuth?
| Kriteria | Kunci pribadi | Klien aplikasi |
|---|---|---|
| Bertindak sebagai | Anda | Orang yang mengizinkannya |
| Cocok untuk | Skrip dan otomatisasi Anda sendiri | Produk yang akan dipakai pengguna Sofia lain |
| Penyiapan | Menyalin kunci | Mendeklarasikan klien dan mengimplementasikan alurnya |
| Untuk mencabut | “Cabut” kuncinya | Orang tersebut mencabut akses di “Aplikasi terhubung”, atau Anda menghapus klien |
Jika Anda mengotomatiskan penerbitan Anda sendiri, gunakan kunci. Bangun klien hanya jika akun orang lain terlibat.
Untuk melangkah lebih jauh
- API: titik akses, payload, dan pengaturan per jaringan, di tab API.
- CLI: menerbitkan dari terminal, di tab Agents.
- Konektor AI: menghubungkan Claude, Cursor, atau ChatGPT; lihat Konektor AI.