Орчны хувьсагч (Environment Variables)
Орчны хувьсагч (Environment Variables) нь API түлхүүр болон workflow-д шаардлагатай бусад мэдрэмтгий өгөгдлийг аюулгүйгээр удирдах стандарт арга юм. Эдгээр нь нууц мэдээллийг workflow-ийн тодорхойлолтоос салгаж, гүйцэтгэлийн явцад ашиглах боломжийг олгодог.
Хувьсагчийн төрлүүд
OpenAgentAGI дахь орчны хувьсагчид нь хоёр түвшинд ажилладаг:
- Хувийн орчны хувьсагчид: Зөвхөн таны аккаунтад хамаарах бөгөөд та л харах, ашиглах боломжтой
- Workspace орчны хувьсагчид: Бүх workspace-д хуваалцагдаж, багийн бүх гишүүд ашиглах боломжтой
Нэр давхцсан тохиолдолд workspace орчны хувьсагч нь хувийн хувьсагчаас давуу эрхтэй байна.
Орчны хувьсагч тохируулах
Орчны хувьсагчаа тохируулахын тулд Settings хэсэг рүү орно уу:
Workspace тохиргооноос та хувийн болон workspace түвшний орчны хувьсагчдыг үүсгэх, удирдах боломжтой. Хувийн хувьсагчид нь зөвхөн танд хамаарах бол workspace хувьсагчид нь багийн бүх гишүүдэд нээлттэй байдаг.
Хувьсагчийг Workspace-т хамааруулах
Workspace scope тохиргоог идэвхжүүлснээр тухайн хувьсагчийг бүх багт ашиглах боломжтой болгоно:
Workspace scope-ийг идэвхжүүлсний дараа уг хувьсагч нь тухайн workspace доторх бүх workflow-д ашиглагдана.
Workspace хувьсагчдын жагсаалт
Workspace-т хамаарах хувьсагчид үүссэний дараа тэдгээр нь орчны хувьсагчдын жагсаалтад харагдана:
Workflow дотор хувьсагч ашиглах
Workflow дотор орчны хувьсагчийг дуудахын тулд {{}} тэмдэглэгээг ашиглана. Аль ч input талбарт {{ гэж бичихэд dropdown цэс гарч, таны хувийн болон workspace түвшний бүх хувьсагчдыг харуулна. Тэндээс хэрэгтэй хувьсагчаа сонгоход л хангалттай.
Хувьсагчийн давуу эрх
Ижил нэртэй хувийн болон workspace хувьсагч хоёул байгаа тохиолдолд:
- Workspace хувьсагч нь хувийн хувьсагчаас давуу эрхтэй
- Энэ нь багийн workflow-уудын зан төлөвийг тогтвортой, нэгэн жигд байлгахад тусалдаг
- Workspace хувьсагч оршин байвал ижил нэртэй хувийн хувьсагч үл хэрэгсэгдэнэ
Санамсаргүй дарж бичихээс зайлсхийхийн тулд хувьсагчийн нэрийг нямбай сонгоорой. Жишээ нь, хувийн хувьсагчид эхний үсэг, workspace хувьсагчид төслийн нэрийн угтвар ашиглахыг зөвлөе.
Аюулгүй байдлын шилдэг туршлагууд
Мэдрэмтгий өгөгдлийн хувьд
- API түлхүүр, токен, нууц үгийг код дотор бичихийн оронд орчны хувьсагчид хадгалах
- Олон хүн ашигладаг нөөцөд workspace хувьсагч ашиглах
- Хувийн итгэмжлэлүүдийг зөвхөн хувийн хувьсагчид хадгалах
Хувьсагчийн нэршил
- Тайлбарлах чадвартай нэр ашиглах:
DATABASE_URLгэх мэт,DB-ийн оронд - Багийн хэмжээнд тогтвортой нэршлийн дүрэм баримтлах
- Давхцлаас зайлсхийхийн тулд угтвар ашиглах:
PROD_API_KEY,DEV_API_KEY
Хандалтын хяналт
- Workspace орчны хувьсагчид нь workspace-ийн эрхийн түвшинг хүндэтгэнэ
- Зөвхөн write эсвэл түүнээс дээш эрхтэй хэрэглэгчид workspace хувьсагч үүсгэх, засах боломжтой
- Хувийн орчны хувьсагчид нь үргэлж тухайн хэрэглэгчид л харагдана