Rahsia dan Pembolehubah Persekitaran Tanpa Tampal Kunci dalam Sembang

Kebanyakan aplikasi sebenar memerlukan sekurang-kurangnya satu rahsia: kunci pembekal pembayaran, kunci perkhidmatan e-mel, atau kunci untuk API AI. Dalam Mythex, anda tidak perlu menampal kunci-kunci itu dalam arahan. Apabila ejen memerlukan satu kunci, ia memaparkan kad permintaan rahsia dalam sembang, anda menaip nilainya dalam kad itu, dan ia disimpan sebagai rahsia projek yang boleh dibaca oleh aplikasi anda, tanpa kunci itu berakhir dalam perbualan.

Apa yang ia lakukan

Setiap projek Mythex boleh menyimpan pembolehubah persekitaran: nama dan nilai, seperti STRIPE_SECRET_KEY, yang dibaca oleh aplikasi anda semasa ia berjalan dan bukannya ditulis terus dalam kod. Rahsia ialah pembolehubah persekitaran yang nilainya mesti kekal persendirian.

Nilai yang sama tersedia di dua tempat:

• Sandbox, tempat ejen membina dan menjalankan aplikasi anda semasa anda bekerja.
• Penerbitan anda, tempat pengunjung menggunakan aplikasi itu.

Ada tiga cara untuk menambahnya:

1. Kad permintaan rahsia, yang dipaparkan ejen dalam sembang apabila ia memerlukan kunci untuk menyiapkan sesuatu.
2. Tetapan projek → Rahsia, tempat anda boleh menambah atau mengedit nilai bila-bila masa.
3. /secrets dalam sembang, untuk menambah atau mengemas kini rahsia atas permintaan.

Mengapa ia membantu

Cara yang paling mudah untuk memberi ejen AI satu kunci ialah dengan menampalnya dalam mesej anda. Ia berfungsi, tetapi kunci itu kemudian menjadi sebahagian daripada sejarah sembang anda, terletak dalam teks biasa di sebelah semua yang lain anda tulis.

Kad rahsia menyimpan nilai itu di luar transkrip. Anda memasukkannya dalam medan kad, bukan dalam kotak mesej, dan ia disimpan sebagai rahsia projek. Ejen meneruskan kerja dengan kunci itu tersedia dalam sandbox.

Menyimpan kunci dalam tetapan projek dan bukannya dalam kod juga mempunyai beberapa kelebihan lain:

• Kunci kekal di luar kawalan sumber. Kod anda merujuk kunci mengikut nama; nilainya berada dalam tetapan projek.
• Ejen dan aplikasi anda yang sedang berjalan melihat konfigurasi yang sama. Tiada salinan yang lapuk.
• Anda boleh menukar kunci tanpa menulis semula kod. Tukar nilainya dalam tetapan; kod tetap membacanya mengikut nama.

Jika pembolehubah persekitaran masih baharu bagi anda, panduan kami tentang apakah pembolehubah persekitaran dan rahsia menerangkan idea ini dari awal.

Cara menggunakan kad rahsia

1. Minta ciri itu, contohnya "hantar e-mel alu-aluan apabila seseorang mendaftar".
2. Apabila ejen memerlukan kunci, kad permintaan rahsia muncul dalam sembang dan menyenaraikan nilai yang diperlukan.
3. Masukkan nilai dalam medan kad, bukan dalam kotak mesej.
4. Sahkan. Nilai itu disimpan sebagai rahsia projek.
5. Ejen meneruskan kerja, dengan kunci itu tersedia dalam sandbox.

Cara menambah rahsia sendiri

1. Buka tetapan projek, kemudian Rahsia.
2. Tambah kunci seperti STRIPE_SECRET_KEY, OPENAI_API_KEY, atau kelayakan perkhidmatan anda sendiri.
3. Minta ejen membacanya dengan cara standard untuk rangka kerja anda, contohnya daripada process.env dalam aplikasi Node.
4. Terbitkan semula jika aplikasi yang diterbitkan memerlukan nilai baharu.

Anda juga boleh menaip /secrets dalam sembang untuk menambah atau mengemas kini rahsia di situ.

Menukar rahsia pada aplikasi yang diterbitkan

Aplikasi yang diterbitkan mengambil rahsia semasa ia diterbitkan. Selepas anda menambah atau menukar satu rahsia, terbitkan sekali lagi supaya penerbitan langsung mendapat nilai baharu. Sehingga itu, pengunjung masih menggunakan aplikasi dengan konfigurasi lama.

Tip keselamatan

• Jangan sekali-kali commit rahsia ke dalam repositori. Simpan dalam tetapan projek.
• Utamakan kunci khusus pelayan untuk operasi istimewa. Kunci yang boleh mengenakan caj kad atau menghantar e-mel patut berada dalam kod yang berjalan di pelayan, bukan dalam apa-apa yang dimuat turun oleh pelayar pengunjung.
• Jika kunci pernah muncul dalam sejarah sembang, tukarkannya. Cipta kunci baharu di pembekal, batalkan kunci lama, dan kemas kini nilainya dalam tetapan projek. Anggap mana-mana kunci yang pernah ditampal dalam sembang sebagai telah terdedah.

Had

• Kad itu hanya membantu jika anda menggunakannya. Jika anda tetap menampal kunci dalam kotak mesej, ia akan tersimpan dalam transkrip. Batalkan kunci itu di pembekal dan kemas kini nilai yang disimpan.
• Aplikasi yang diterbitkan perlu diterbitkan semula untuk mengambil rahsia baharu atau yang ditukar.
• Menyimpan kunci dengan selamat tidak menjadikan setiap penggunaannya selamat. Di mana kunci itu digunakan tetap penting. Simpan kunci istimewa di bahagian pelayan aplikasi anda.

Untuk maklumat lanjut tentang memastikan aplikasi selamat sebelum anda berkongsinya, lihat senarai semak keselamatan untuk aplikasi yang dibina dengan AI.

Dokumentasi mempunyai butiran lengkap: Pembolehubah persekitaran dan rahsia dan Rahsia dalam sembang.