Tajné údaje a proměnné prostředí bez vkládání klíčů do chatu

Většina skutečných aplikací potřebuje alespoň jedno tajné údaje: klíč platební služby, klíč e-mailové služby nebo klíč k AI API. V Mythexu tyto klíče nevkládáte do promptu. Když je agent potřebuje, zobrazí v chatu kartu žádost o tajný údaj, vy zadáte hodnotu do karty a uloží se jako tajný údaj projektu, ke kterému může vaše aplikace přistupovat, aniž by se klíč dostal do konverzace.

Co to dělá

Každý projekt v Mythexu může ukládat proměnné prostředí: pojmenované hodnoty, například STRIPE_SECRET_KEY, které aplikace čte při spuštění, místo aby byly napsané přímo v kódu. Tajné údaje jsou proměnné prostředí, jejichž hodnoty musí zůstat v soukromí.

Stejné hodnoty jsou dostupné na dvou místech:

• Sandbox, kde agent sestavuje a spouští vaši aplikaci během práce.
• Vaše publikovaná nasazení, kde aplikaci používají návštěvníci.

Přidat je můžete třemi způsoby:

1. Karta žádosti o tajný údaj, kterou agent zobrazí v chatu, když potřebuje klíč k dokončení úkolu.
2. Nastavení projektu → Tajné údaje, kde můžete hodnoty kdykoli přidat nebo upravit.
3. /secrets v chatu, pro přidání nebo změnu tajných údajů na vyžádání.

Proč to pomáhá

Nejzjevnější způsob, jak dát AI agentovi klíč, je vložit ho do zprávy. Funguje to, ale klíč se pak stane součástí historie chatu a leží v čitelné podobě vedle všeho, co jste napsali.

Karta s tajným údajem drží hodnotu mimo přepis konverzace. Hodnotu zadáte do polí karty, ne do pole pro zprávy, a uloží se jako tajný údaj projektu. Agent pokračuje s klíčem dostupným v sandboxu.

Uchovávání klíčů v nastavení projektu místo v kódu má i další výhody:

• Klíče zůstávají mimo správu verzí. Váš kód odkazuje na klíč podle názvu; hodnota je uložena v nastavení projektu.
• Agent a vaše běžící aplikace vidí stejnou konfiguraci. Nevzniká kopie, která by zastarala.
• Klíč můžete vyměnit bez přepisování kódu. Změníte hodnotu v nastavení; kód ji dál čte podle názvu.

Pokud jsou pro vás proměnné prostředí nové, vysvětluje je od začátku náš průvodce co jsou proměnné prostředí a tajné údaje.

Jak použít kartu s tajným údajem

1. Požádejte o funkci – například „po registraci pošli uvítací e-mail“.
2. Když agent potřebuje klíč, objeví se v chatu karta žádosti o tajný údaj se seznamem hodnoty, kterou potřebuje.
3. Zadejte hodnotu do polí karty, ne do pole pro zprávy.
4. Potvrďte. Hodnota se uloží jako tajný údaj projektu.
5. Agent pokračuje s klíčem dostupným v sandboxu.

Jak přidat tajné údaje sami

1. Otevřete nastavení projektu a pak Tajné údaje.
2. Přidejte klíče jako STRIPE_SECRET_KEY, OPENAI_API_KEY nebo přihlašovací údaje vlastní služby.
3. Požádejte agenta, aby je četl standardním způsobem vašeho frameworku – například z process.env v aplikaci Node.
4. Publikujte znovu, pokud publikovaná aplikace potřebuje nové hodnoty.

Typ /secrets můžete zadat i přímo do chatu a tajné údaje přidat nebo upravit tam.

Změna tajného údaje u publikované aplikace

Publikovaná aplikace převezme tajné údaje při publikování. Po přidání nebo změně publikujte znovu, aby živé nasazení dostalo novou hodnotu. Dokud to neuděláte, návštěvníci používají aplikaci se starou konfigurací.

Bezpečnostní tipy

• Nikdy neukládejte tajné údaje do repozitáře. Držte je v nastavení projektu.
• U privilegovaných operací používejte klíče určené jen pro server. Klíč, který může účtovat karty nebo odesílat e-maily, patří do kódu běžícího na serveru, ne do ničeho, co si prohlížeč návštěvníka stáhne.
• Pokud se klíč ocitl v historii chatu, vyměňte ho. Vytvořte nový klíč u poskytovatele, starý zrušte a aktualizujte hodnotu v nastavení projektu. Každý klíč vložený do chatu považujte za vystavený.

Omezení

• Karta pomáhá jen tehdy, když ji použijete. Pokud klíč přesto vložíte do pole pro zprávy, zůstane v přepisu. Vyměňte ho u poskytovatele a aktualizujte uloženou hodnotu.
• Publikované aplikace je nutné publikovat znovu, aby převzaly nové nebo změněné tajné údaje.
• Bezpečné uložení klíče neznamená, že každé jeho použití je bezpečné. Záleží i na tom, kde se klíč používá – privilegované klíče držte na serverové straně aplikace.

Více o tom, jak aplikaci zabezpečit před sdílením, najdete v našem kontrolním seznamu zabezpečení pro aplikace vytvořené s AI.

Podrobnosti najdete v dokumentaci: Proměnné prostředí a tajné údaje a Tajné údaje v chatu.