A Vercel Agent előbb tervet készít, csak utána kap engedélyt

A terv határozza meg a hozzáférést

A Vercel szerint egy produkciós rendszerben dolgozó ügynöknek engedélyre van szüksége a műveletek végrehajtásához. Egy olyan kérésből, mint a „javítsd ezt a telepítést”, előre nem derül ki, hogy az ügynök milyen lépéseket tenne, illetve milyen hozzáférést igényelne. A túl széles jogosultság egy hibás művelettel más erőforrásokra is hatással lehet, a minden egyes lépéshez kért jóváhagyás pedig idővel automatikus jóváhagyássá válhat.

A Vercel Agent ezért először vizsgálódik, majd tervet készít. Egy hibás produkciós telepítésnél elolvashatja a legutóbbi telepítéseket és buildnaplókat, majd összevetheti a sikertelen telepítést az utolsó ismert jó állapottal. Ehhez elegendő a csak olvasási hozzáférés. Ha az elemzés újratelepítést indokol, a rendszer külön tervben kéri a telepítési jogosultságot.

A Vercel példájában a hibakereséshez a read:deployment, az utolsó jó build újratelepítéséhez pedig a read-write:deployment hatókör tartozik. A hatókörök a Vercel engedélyezési rendszerében nyilvántartott képességek. A csak olvasási műveletek automatikusan elindulhatnak, hosszabb vizsgálatoknál azonban a Vercel Agent olvasási tervet készít, hogy a felhasználó követni tudja a feladatokat és a haladást.

A jogosultságokat tokenek és API-ellenőrzések korlátozzák

A Vercel Agent Vercel Appként működik, amelyet a felhasználó egy csapat nevében hatalmaz fel. Ez a felhatalmazás nem lépheti túl a felhasználó meglévő jogosultságait, így egy terv jóváhagyása sem adhat olyan hozzáférést, amellyel maga a felhasználó nem rendelkezik.

A Vercel OAuth szolgáltatása rövidebb élettartamú, meghatározott hatóköröket tartalmazó tokeneket készít. Ezek például a telepítések olvasását vagy a projektbeállítások módosítását engedélyezhetik. A Vercel API minden kérést ellenőriz a token alapján. Ha a modell olyan műveletet próbál végrehajtani, amely kívül esik a token jogosultságain, az API elutasítja a kérést.

A jóváhagyott munkához használt hitelesítő adat függ a feladattól. A csak olvasási vizsgálat alapértelmezett, olvasási hatóköröket tartalmazó tokent kap, a jóváhagyott Vercel-módosításokhoz pedig az alapjogosultságok mellett a tervben engedélyezett további hatókörök is társulnak. A külső műveletekhez, például egy GitHub-pull request megnyitásához, az adott szolgáltató külön hitelesítő adatai és engedélyei szükségesek.

A Vercel külön kiemeli, hogy egy újratelepítési tervben megnevezett telepítés önmagában nem korlátozza a tokent kizárólag arra az erőforrásra. A telepítési írási jogosultság ennél szélesebb lehet. GitHub esetében a pull request jogosultsága tulajdonoshoz és tárhelyhez kötött, ezért egy másik repositoryhoz új jóváhagyás kell.

A tervek ellenőrzése és folytatása

A Vercel Agent a terveket és a tokeneket ugyanazokból a jogosultság-definíciókból építi fel. A munkamenet indításakor betölti ezeket a Vercel hatókör-nyilvántartásából egy memóriában tárolt katalógusba. A rendszer a tervezéskor normalizálja a kért hatóköröket, az ismeretlen vagy hibás neveket pedig elutasítja, mielőtt a tervet eltárolná vagy jóváhagyásra bemutatná.

Ez a folyamat azt is kiszűrheti, ha egy feladat elavult jogosultságot kér, például tűzfalszabályok módosításakor. A rendszer érvénytelen terv helyett a használható hatóköröket adja vissza, így a Vercel Agentnek javítania kell a tervet, mielőtt újra jóváhagyást kérne. A katalógus betöltése késleltetést és szolgáltatásfüggőséget okoz, ezért a Vercel gyorsítótárazza azt.

A jóváhagyás után a tárolt terv rögzíti az állapotot, a jóváhagyó személyét, az időpontot, a feladatokat és a kért jogosultságokat. A munka folytatásakor a futtatási környezet újra ellenőrzi, hogy a terv aktív-e, és csak ezután választja ki a megfelelő hitelesítő adatot. Leállított terv akkor sem folytatható, ha a tokenje még nem járt le. Ha a vizsgálat alapján új tervre van szükség, a nagyobb hozzáférést kérő helyettesítő tervhez új jóváhagyás kell.

Ez a megközelítés a felhasználóknak előzetes rálátást ad arra, milyen műveletek készülnek, és ezeket milyen hozzáféréssel hajtaná végre az ügynök. A Vercel ugyanakkor jelzi, hogy a csak olvasási műveletek is felfedhetnek érzékeny információkat, ezért az automatikus engedélyezés nem jelenti azt, hogy az adott munka veszélytelen.