Saladused ja keskkonnamuutujad ilma võtmeid vestlusse kleepimata

Enamikus päris rakendustes on vähemalt üks saladus: makseteenuse pääsukood, e-posti teenuse võti või tehisintellekti API võti. Mythexis neid promptisse ei kleebita. Kui agent vajab mõnda neist, kuvab ta vestluses saladuste päringu kaardi, sina sisestad väärtuse kaardile ja see salvestatakse projekti saladusena, mida sinu rakendus saab lugeda, ilma et võti vestlusesse satuks.

Mida see teeb

Iga Mythexi projekt saab hoida keskkonnamuutujaid: nimega väärtusi, näiteks STRIPE_SECRET_KEY, mida rakendus käivitamisel loeb, selle asemel et need koodi kirjutada. Saladused on keskkonnamuutujad, mille väärtused peavad jääma privaatseks.

Sama väärtused on saadaval kahes kohas:

• Liivakastis, kus agent ehitab ja käivitab sinu rakendust, kui sa töötad.
• Avaldatud versioonides, mida külastajad kasutavad.

Lisamiseks on kolm viisi:

1. Saladuste päringu kaart, mille agent kuvab vestluses, kui ta vajab ülesande lõpetamiseks võtit.
2. Projekti seaded → Saladused, kus saad väärtusi igal ajal lisada või muuta.
3. /secrets vestluses, et saladusi soovi korral lisada või uuendada.

Miks see aitab

Tehisintellekti agendile võtme andmise ilmne viis on see kleepida oma sõnumisse. See töötab, kuid siis on võti osa sinu vestluse ajaloost, lihtsas tekstis kõige muu kõrval.

Saladuste kaart hoiab väärtuse väljaspool vestlust. Sisestad selle kaardi väljadesse, mitte sõnumikasti, ja see salvestatakse projekti saladusena. Agent jätkab, võti on liivakastis kättesaadav.

Võtmete hoidmine projekti seadetes, mitte koodis, toob veel mitu eelist:

• Võtmed jäävad versioonihaldusest välja. Sinu kood viitab võtmele nime järgi; väärtus on projekti seadetes.
• Agent ja sinu töötav rakendus näevad sama seadistust. Pole koopiat, mis aegub.
• Võtit saab vahetada ilma koodi ümber kirjutamata. Muuda väärtust seadetes; kood loeb seda endiselt nime järgi.

Kui keskkonnamuutujad on sulle uued, selgitab mis on keskkonnamuutujad ja saladused juhend ideed algusest peale.

Kuidas saladuste kaarti kasutada

1. Küsi funktsiooni, näiteks „saada tervitus-e-kiri, kui keegi registreerub“.
2. Kui agent vajab võtit, ilmub vestlusesse saladuste päringu kaart, mis loetleb vajaliku väärtuse.
3. Sisesta väärtus kaardi väljadesse, mitte sõnumikasti.
4. Kinnita. Väärtus salvestatakse projekti saladusena.
5. Agent jätkab, võti on liivakastis saadaval.

Kuidas saladusi ise lisada

1. Ava projekti seaded ja seejärel Saladused.
2. Lisa võtmed nagu STRIPE_SECRET_KEY, OPENAI_API_KEY või oma teenuse andmed.
3. Palu agendil need lugeda raamistiku standardviisil, näiteks Node-rakenduses process.env kaudu.
4. Avalda uuesti, kui avaldatud rakendus vajab uusi väärtusi.

Vestluses saad saladusi lisada või uuendada ka kirjutades /secrets.

Saladuse muutmine avaldatud rakenduses

Avaldatud rakendus võtab saladused vastu avaldamisel. Pärast uue lisamist või muutmist avalda uuesti, et reaalne versioon saaks uue väärtuse. Seni kasutavad külastajad rakendust vana seadistusega.

Turvanõuanded

• Ära kunagi salvesta saladusi repositooriumisse. Hoia need projekti seadetes.
• Privilegeeritud toimingutel kasuta ainult serveripoolseid võtmeid. Võti, millega saab kaarte maksta või e-kirju saata, kuulub koodi, mis töötab serveris, mitte millelegi, mille külastaja brauser alla laadib.
• Kui võti on kunagi vestlusajaloos, vaheta see. Loo teenusepakkujaga uus võti, tühista vana ja uuenda väärtus projekti seadetes. Käsitle iga vestlusse kleebitud võtit avalikuna.

Piirangud

• Kaart aitab ainult siis, kui seda kasutad. Kui kleebid võtme siiski sõnumikasti, on see vestluses. Vaheta see teenusepakkuja juures ja uuenda salvestatud väärtus.
• Avaldatud rakendused vajavad uuesti avaldamist, et võtta vastu uued või muudetud saladused.
• Võtme turvaline hoidmine ei tee iga selle kasutust turvaliseks. Koht, kus võtit kasutad, on endiselt oluline. Privilegeeritud võtmed hoia rakenduse serveripoolel.

Rohkem sellest, kuidas enne jagamist rakendust turvaliseks teha, leiad tehisintellektiga ehitatud rakenduste turvakontrollnimekirjast.

Detailid leiad dokumentatsioonist: Keskkonnamuutujad ja saladused ning Saladused vestluses.