A Mintlify ügynöke már emberi beavatkozás nélkül élesítheti a dokumentációt

A telepítéstől az élő dokumentációig

A Mintlify október 28-i bejelentése szerint az ügynökök eddig elkészíthették a dokumentációs oldalt helyben, majd a regisztrációnál és a GitHub beállításánál visszaadták a feladatot a felhasználónak. A cég saját tesztjeiben az ügynökök eljutottak a regisztrációig, de az e-mailes ellenőrzést és a GitHub-kapcsolat létrehozását már embernek kellett elvégeznie.

A mint deploy ezt az átadást szünteti meg. A docs.json fájlt tartalmazó mappában az ügynök telepítheti a Mintlify parancssori felületét az npm i -g mint paranccsal, majd futtathatja a mint deploy --subdomain acme utasítást. A CLI létrehoz egy Mintlify által üzemeltetett Git-repozitóriumot, visszaad egy rövid ideig érvényes írási tokent, az ügynök pedig feltölti a dokumentációt. Az oldal ezt követően az acme.mintlify.site címen válik elérhetővé.

Az első telepítés előtt nincs szükség Mintlify-fiók létrehozására vagy GitHub-kapcsolat beállítására. A szolgáltatás a Claude Code-dal, a Cursorral és a Codexszel is használható, illetve minden olyan ügynökkel, amely képes shell-parancsokat, npm-et és Git-et futtatni.

GitHubbal is összeköthető

Ha a dokumentációt egy meglévő GitHub-repozitóriumban kell tárolni, a telepítéshez a mint deploy --github --subdomain acme parancs használható. Ez GitHub Actions-munkafolyamatot ír a repozitóriumba, amely a webhelyet frissíti, amikor a felhasználó a repozitórium alapértelmezett ágára küld változtatásokat.

A dokumentáció helyét a --directory kapcsolóval lehet megadni, ha az egy alkönyvtárban található. A Mintlify szerint a folyamatot azok az ügynökök is felfedezhetik, amelyek nem tudják telepíteni a CLI-t. Ehhez a mintlify.com/auth.md fájl ismerteti a regisztráció, a webhely létrehozása és az átadás menetét nyers HTTP-kérésekkel.

A dokumentum a WorkOS nyílt protokolljára, az auth.md-re épül. Ennek célja, hogy egy ügynök regisztráljon egy szolgáltatásba, létrehozza a szükséges erőforrást, majd azt egy embernek adja át.

A felhasználónak 24 órája van az átvételre

A webhely már él, amikor elkezdődik az átvételi folyamat. Az ügynöknek ehhez a felhasználó e-mail-címére van szüksége, amelyet a mint claim --email paranccsal ad át. A felhasználó megnyitja a kapott hivatkozást, bejelentkezik vagy fiókot hoz létre, majd az oldalon megjelenő kódot visszamásolja az ügynöknek. Az átvételt a mint claim --code paranccsal lehet befejezni.

Az átvétel után a felhasználó az oldal szervezetének rendszergazdája lesz, és a webhely bekerül a Mintlify vezérlőpultjába. Ha valaki már rendelkezik Mintlify-fiókkal, bejelentkezés után ott jelenik meg az oldal. Több szervezethez tartozó felhasználónál az átvételi oldal felkínálhatja a választást.

Az oldal létrehozása ingyenes. A Mintlify szerint az első oldal átvétele elindít egy Pro próbaidőszakot. Ha a felhasználó 24 órán belül nem veszi át az oldalt, az lejár, és a hozzá tartozó üzemeltetett repozitóriummal együtt törlődik. Újrakezdéshez a mint deploy --new --subdomain <name> parancs használható.

Mit jelent ez a dokumentáció készítőinek?

A változás a dokumentáció publikálását az ügynök által végrehajtható terminálos munkafolyamat részévé teszi. A felhasználó egyetlen utasítással kérheti a dokumentáció közzétételét, az ügynök pedig feltöltheti a fájlokat, ellenőrizheti, hogy az oldal betöltődik-e, és elküldheti az élő URL-t.

A Mintlify által üzemeltetett repozitóriumból indított oldal később átköltöztethető saját GitHub-repozitóriumba a vezérlőpult Git-beállításain keresztül. A mint deploy --github parancs csak azokra az oldalakra használható, amelyeket még nem vettek át.