Секрети та змінні середовища без вставляння ключів у чат

Більшості справжніх застосунків потрібен принаймні один секрет: ключ платіжного провайдера, ключ сервісу електронної пошти, ключ AI API. У Mythex ви не вставляєте їх у запит. Коли агенту потрібен ключ, він показує в чаті картку запиту секрету, ви вводите значення в цю картку, і воно зберігається як секрет проєкту, який ваш застосунок може прочитати, а ключ при цьому не потрапляє в розмову.

Що це робить

Кожен проєкт Mythex може зберігати змінні середовища: іменовані значення, наприклад STRIPE_SECRET_KEY, які застосунок читає під час роботи замість того, щоб вони були записані в код. Секрети це змінні середовища, значення яких мають залишатися приватними.

Ці значення доступні в двох місцях:

• Пісочниця, де агент збирає та запускає ваш застосунок, поки ви працюєте.
• Ваші опубліковані розгортання, якими користуються відвідувачі.

Додати їх можна трьома способами:

1. Картка запиту секрету, яку агент показує в чаті, коли йому потрібен ключ, щоб щось завершити.
2. Налаштування проєкту → Секрети, де можна додавати або змінювати значення будь-коли.
3. /secrets у чаті, щоб додати або оновити секрети на вимогу.

Чому це допомагає

Очевидний спосіб передати агенту ключ це вставити його у своє повідомлення. Це працює, але тоді ключ стає частиною історії чату, у вигляді простого тексту поруч з усім іншим, що ви написали.

Картка секрету не дає значенню потрапити в стенограму. Ви вводите його в полях картки, а не в полі повідомлення, і воно зберігається як секрет проєкту. Агент продовжує роботу, а ключ доступний у пісочниці.

Зберігання ключів у налаштуваннях проєкту, а не в коді, має й інші переваги:

• Ключі не потрапляють у систему контролю версій. Ваш код посилається на ключ за назвою, а значення зберігається в налаштуваннях проєкту.
• Агент і ваш запущений застосунок бачать одну й ту саму конфігурацію. Немає копії, яка застаріває.
• Ключ можна замінити без переписування коду. Змініть значення в налаштуваннях, а код і далі читатиме його за назвою.

Якщо змінні середовища для вас нові, посібник про що таке змінні середовища та секрети пояснює цю ідею з нуля.

Як користуватися карткою секрету

1. Попросіть функцію, наприклад: «надсилати вітальний лист, коли хтось реєструється».
2. Коли агенту потрібен ключ, у чаті з'являється картка запиту секрету зі списком потрібного значення.
3. Введіть значення в полях картки, а не в полі повідомлення.
4. Підтвердьте. Значення зберігається як секрет проєкту.
5. Агент продовжує роботу з ключем, доступним у пісочниці.

Як додати секрети самостійно

1. Відкрийте налаштування проєкту, потім Секрети.
2. Додайте ключі, наприклад STRIPE_SECRET_KEY, OPENAI_API_KEY або облікові дані власного сервісу.
3. Попросіть агента прочитати їх стандартним для вашого фреймворку способом, наприклад з process.env у застосунку на Node.
4. Опублікуйте знову, якщо опублікованому застосунку потрібні нові значення.

Ви також можете ввести /secrets у чаті, щоб додати або оновити їх там.

Зміна секрету в опублікованому застосунку

Опублікований застосунок отримує секрети під час публікації. Після додавання або зміни секрету опублікуйте знову, щоб активне розгортання отримало нове значення. Доки цього не зроблено, відвідувачі користуються застосунком зі старою конфігурацією.

Поради з безпеки

• Ніколи не комітьте секрети в репозиторій. Зберігайте їх у налаштуваннях проєкту.
• Для привілейованих операцій віддавайте перевагу ключам, доступним лише на сервері. Ключ, який може списувати гроші з карток або надсилати листи, має бути в коді, що працює на сервері, а не в тому, що завантажується в браузер відвідувача.
• Якщо ключ коли-небудь потрапив в історію чату, замініть його. Створіть новий ключ у провайдера, відкличте старий і оновіть значення в налаштуваннях проєкту. Вважайте скомпрометованим будь-який ключ, вставлений у чат.

Обмеження

• Картка допомагає лише тоді, коли нею користуються. Якщо ви все одно вставите ключ у поле повідомлення, він опиниться в стенограмі. Замініть його у провайдера й оновіть збережене значення.
• Опубліковані застосунки потребують повторної публікації, щоб підхопити нові або змінені секрети.
• Безпечне зберігання ключа не робить безпечним кожне його використання. Важливо, де саме ключ застосовується: тримайте привілейовані ключі на серверному боці застосунку.

Більше про захист застосунку перед тим, як ним ділитися, читайте в нашому контрольному списку безпеки для застосунків, створених з AI.

Документація містить подробиці: Змінні середовища та секрети і Секрети в чаті.