Rahasia dan Variabel Lingkungan Tanpa Menempelkan Kunci di Chat

Hampir setiap aplikasi nyata membutuhkan setidaknya satu rahasia: kunci dari penyedia pembayaran, kunci layanan email, atau kunci untuk API AI. Di Mythex, Anda tidak perlu menempelkan kunci-kunci itu ke dalam prompt. Saat agen membutuhkan salah satunya, agen menampilkan kartu permintaan rahasia di chat, Anda mengetik nilainya ke dalam kartu, dan nilai itu disimpan sebagai rahasia proyek yang bisa dibaca aplikasi Anda, tanpa kunci tersebut masuk ke percakapan.

Apa fungsinya

Setiap proyek Mythex bisa menyimpan variabel lingkungan: nilai bernama, misalnya STRIPE_SECRET_KEY, yang dibaca aplikasi Anda saat berjalan, alih-alih ditulis langsung ke dalam kode. Rahasia adalah variabel lingkungan yang nilainya harus tetap pribadi.

Nilai yang sama tersedia di dua tempat:

• Sandbox, tempat agen membangun dan menjalankan aplikasi Anda selagi Anda bekerja.
• Deployment yang sudah dipublikasikan, tempat pengunjung menggunakan aplikasi Anda.

Ada tiga cara untuk menambahkannya:

1. Kartu permintaan rahasia, yang ditampilkan agen di chat saat membutuhkan kunci untuk menyelesaikan sesuatu.
2. Pengaturan proyek → Rahasia, tempat Anda bisa menambah atau mengedit nilai kapan saja.
3. /secrets di chat, untuk menambah atau memperbarui rahasia sesuai permintaan.

Mengapa ini membantu

Cara yang paling mudah untuk memberi agen AI sebuah kunci adalah dengan menempelkannya ke pesan Anda. Cara ini berhasil, tetapi kunci itu lalu menjadi bagian dari riwayat chat Anda, tersimpan sebagai teks biasa di samping semua yang sudah Anda tulis.

Kartu rahasia menjaga nilainya tetap di luar transkrip. Anda memasukkannya ke kolom di dalam kartu, bukan ke kotak pesan, dan nilainya disimpan sebagai rahasia proyek. Agen melanjutkan pekerjaannya dengan kunci yang sudah tersedia di sandbox.

Menyimpan kunci di pengaturan proyek, bukan di dalam kode, juga memberi manfaat lain:

• Kunci tetap di luar kontrol sumber. Kode Anda merujuk kunci dengan namanya; nilainya tersimpan di pengaturan proyek.
• Agen dan aplikasi yang berjalan melihat konfigurasi yang sama. Tidak ada salinan yang tertinggal dan tidak sinkron.
• Anda bisa mengganti kunci tanpa menulis ulang kode. Ubah nilainya di pengaturan; kode tetap membacanya dengan nama yang sama.

Jika variabel lingkungan masih baru bagi Anda, panduan kami tentang apa itu variabel lingkungan dan rahasia menjelaskan gagasannya dari awal.

Cara menggunakan kartu rahasia

1. Minta fitur yang Anda inginkan, misalnya “kirim email sambutan saat ada yang mendaftar”.
2. Saat agen membutuhkan kunci, kartu permintaan rahasia muncul di chat dan menyebutkan nilai yang dibutuhkan.
3. Masukkan nilai di kolom kartu, bukan di kotak pesan.
4. Konfirmasi. Nilai disimpan sebagai rahasia proyek.
5. Agen melanjutkan, dengan kunci yang sudah tersedia di sandbox.

Cara menambahkan rahasia sendiri

1. Buka pengaturan proyek, lalu Rahasia.
2. Tambahkan kunci seperti STRIPE_SECRET_KEY, OPENAI_API_KEY, atau kredensial layanan Anda sendiri.
3. Minta agen membacanya dengan cara standar untuk framework Anda, misalnya dari process.env pada aplikasi Node.
4. Publikasikan ulang jika aplikasi yang sudah dipublikasikan membutuhkan nilai baru.

Anda juga bisa mengetik /secrets di chat untuk menambah atau memperbaruinya di sana.

Mengganti rahasia pada aplikasi yang sudah dipublikasikan

Aplikasi yang sudah dipublikasikan mengambil rahasia saat dipublikasikan. Setelah Anda menambah atau mengubah rahasia, publikasikan lagi agar deployment yang aktif mendapatkan nilai terbaru. Sampai saat itu, pengunjung masih memakai aplikasi dengan konfigurasi lama.

Tips keamanan

• Jangan pernah menyimpan rahasia di dalam repositori. Simpan di pengaturan proyek.
• Utamakan kunci khusus server untuk operasi yang berhak istimewa. Kunci yang bisa menagih kartu atau mengirim email sebaiknya berada di kode yang berjalan di server, bukan di sesuatu yang diunduh browser pengunjung.
• Jika kunci pernah muncul di riwayat chat, ganti kuncinya. Buat kunci baru di penyedia, cabut yang lama, lalu perbarui nilainya di pengaturan proyek. Anggap kunci apa pun yang pernah ditempel ke chat sudah terekspos.

Batasan

• Kartu hanya membantu jika Anda memakainya. Jika Anda tetap menempelkan kunci di kotak pesan, kunci itu ada di transkrip. Cabut di penyedia dan perbarui nilai yang tersimpan.
• Aplikasi yang sudah dipublikasikan perlu dipublikasikan ulang untuk mengambil rahasia baru atau yang diubah.
• Menyimpan kunci dengan aman tidak membuat setiap penggunaannya aman. Di mana kunci dipakai tetap penting. Simpan kunci yang berhak istimewa di sisi server aplikasi Anda.

Untuk info lebih lanjut tentang menjaga aplikasi tetap aman sebelum Anda membagikannya, lihat daftar periksa keamanan untuk aplikasi buatan AI.

Dokumentasinya memuat detailnya: Environment variables and secrets dan Secrets in chat.