Bí mật và biến môi trường: đưa khóa vào dự án mà không dán vào chat

Hầu hết ứng dụng thật đều cần ít nhất một bí mật: khóa của nhà cung cấp thanh toán, khóa của dịch vụ email, khóa của một API AI. Trong Mythex, bạn không dán những khóa đó vào prompt. Khi agent cần một khóa, nó hiển thị thẻ yêu cầu bí mật trong chat, bạn nhập giá trị vào thẻ, và giá trị đó được lưu thành bí mật của dự án mà ứng dụng của bạn có thể đọc, mà khóa không bao giờ xuất hiện trong cuộc trò chuyện.

Tính năng này làm gì

Mọi dự án Mythex đều có thể lưu biến môi trường: các giá trị có tên, chẳng hạn STRIPE_SECRET_KEY, mà ứng dụng đọc khi chạy thay vì ghi cứng vào mã. Bí mật là biến môi trường mà giá trị phải được giữ riêng tư.

Các giá trị này có sẵn ở hai nơi:

• Sandbox, nơi agent xây dựng và chạy ứng dụng khi bạn làm việc.
• Bản đã xuất bản, nơi người truy cập sử dụng ứng dụng.

Có ba cách để thêm chúng:

1. Thẻ yêu cầu bí mật, mà agent hiển thị trong chat khi nó cần một khóa để hoàn thành việc gì đó.
2. Cài đặt dự án → Bí mật, nơi bạn có thể thêm hoặc sửa giá trị bất cứ lúc nào.
3. /secrets trong chat, để thêm hoặc cập nhật bí mật khi cần.

Vì sao cách này hữu ích

Cách hiển nhiên để đưa khóa cho agent AI là dán nó vào tin nhắn. Cách đó chạy được, nhưng khóa khi ấy trở thành một phần lịch sử chat, nằm dạng văn bản thuần ngay cạnh mọi thứ khác bạn đã nói.

Thẻ bí mật giữ giá trị ngoài bản ghi hội thoại. Bạn nhập nó vào các trường của thẻ, không phải ô tin nhắn, và nó được lưu thành bí mật của dự án. Agent tiếp tục làm việc với khóa đã sẵn trong sandbox.

Giữ khóa trong cài đặt dự án thay vì trong mã còn mang lại những lợi ích khác:

• Khóa không nằm trong quản lý mã nguồn. Mã của bạn chỉ gọi khóa bằng tên; giá trị nằm trong cài đặt dự án.
• Agent và ứng dụng đang chạy dùng cùng một cấu hình. Không có bản sao nào bị lệch khỏi thực tế.
• Bạn có thể đổi khóa mà không cần viết lại mã. Đổi giá trị trong cài đặt; mã vẫn đọc khóa theo tên.

Nếu biến môi trường còn mới với bạn, hướng dẫn của chúng tôi về biến môi trường và bí mật là gì giải thích ý tưởng này từ đầu.

Cách dùng thẻ yêu cầu bí mật

1. Yêu cầu tính năng — ví dụ, “gửi email chào mừng khi có người đăng ký”.
2. Khi agent cần một khóa, một thẻ yêu cầu bí mật xuất hiện trong chat, liệt kê giá trị nó cần.
3. Nhập giá trị vào các trường của thẻ, không phải ô tin nhắn.
4. Xác nhận. Giá trị được lưu thành bí mật của dự án.
5. Agent tiếp tục, với khóa đã có sẵn trong sandbox.

Cách tự thêm bí mật

1. Mở cài đặt dự án, rồi chọn Bí mật.
2. Thêm các khóa như STRIPE_SECRET_KEY, OPENAI_API_KEY, hoặc thông tin xác thực của dịch vụ riêng của bạn.
3. Yêu cầu agent đọc chúng theo cách chuẩn của framework bạn dùng — ví dụ từ process.env trong ứng dụng Node.
4. Xuất bản lại nếu ứng dụng đã xuất bản cần các giá trị mới.

Bạn cũng có thể gõ /secrets trong chat để thêm hoặc cập nhật bí mật ngay tại đó.

Đổi bí mật trên ứng dụng đã xuất bản

Ứng dụng đã xuất bản nhận bí mật tại thời điểm xuất bản. Sau khi bạn thêm hoặc đổi một bí mật, hãy xuất bản lại để bản đang chạy nhận giá trị mới. Cho đến lúc đó, người truy cập vẫn dùng ứng dụng với cấu hình cũ.

Mẹo bảo mật

• Không bao giờ commit bí mật vào kho mã. Hãy giữ chúng trong cài đặt dự án.
• Ưu tiên khóa chỉ dùng trên máy chủ cho các thao tác đặc quyền. Khóa có thể thu tiền thẻ hoặc gửi email thuộc về mã chạy trên máy chủ, không thuộc thứ gì mà trình duyệt của người truy cập tải về.
• Nếu một khóa từng xuất hiện trong lịch sử chat, hãy đổi nó. Tạo khóa mới ở nhà cung cấp, thu hồi khóa cũ, và cập nhật giá trị trong cài đặt dự án. Hãy coi mọi khóa từng bị dán vào chat là đã lộ.

Giới hạn

• Thẻ chỉ có ích nếu bạn dùng nó. Nếu bạn vẫn dán khóa vào ô tin nhắn, khóa sẽ nằm trong bản ghi hội thoại. Hãy đổi khóa ở nhà cung cấp và cập nhật giá trị đã lưu.
• Ứng dụng đã xuất bản cần xuất bản lại để nhận bí mật mới hoặc đã đổi.
• Lưu khóa an toàn không có nghĩa mọi cách dùng khóa đó đều an toàn. Nơi khóa được dùng vẫn quan trọng — hãy giữ khóa đặc quyền ở phía máy chủ của ứng dụng.

Để biết thêm về cách giữ ứng dụng an toàn trước khi chia sẻ, xem danh sách kiểm tra bảo mật cho ứng dụng xây bằng AI.

Tài liệu có chi tiết: Biến môi trường và bí mật và Bí mật trong chat.