- „Google Workspace“ komandų eilutės sąsaja suteikia prieigą prie „Gmail“, Disko, Kalendoriaus, Dokumentų, Skaičiuoklių, „Chat“, Administratoriaus ir kitų paslaugų vienoje vietoje.
gwskomanda - Įrankis yra specialiai sukurtas dirbtinio intelekto agentams, turintis struktūrizuotą JSON išvestį, daugiau nei 100 įgūdžių ir integruotą MCP serverį „Gemini“, „Claude“ ir panašiems klientams.
- Jo komandų paviršius dinamiškai generuojamas iš „Google Discovery Service“, todėl nauji „Workspace“ API galiniai taškai atsiranda be rankinių atnaujinimų.
- Nepaisant savo galimybių, jis lieka kūrėjo pavyzdžiu be oficialios „Google“ paramos, todėl saugumas, apimties nustatymas ir testavimas yra vartotojo atsakomybė.
Per pastaruosius kelerius metus komandinė eilutė tyliai vėl atsidūrė dėmesio centre ir „Google Workspace“ komandinė eilutės sąsaja yra šio pokyčio centreUžuot viską valdius per grafines sąsajas, naujausias „Google“ įrankis leidžia tiek kūrėjams, tiek dirbtinio intelekto sistemoms valdyti „Gmail“, Diską, Kalendorių ir likusią „Workspace“ dalį naudojant vieną, scenarijumi pagrįstą komandą.
Šis naujas projektas, paprastai iškviečiamas kaip gws, siekia, kad „Google“ produktyvumo paketas būtų lengviau automatizuojamas ir daug prieinamesnis agentinėms dirbtinio intelekto darbo eigoms. Jis sujungia beveik visas pagrindines „Workspace“ API į vieną nuoseklią komandinės eilutės sąsają., kartu pridedant galimybes, kurios yra aiškiai pritaikytos dirbtinio intelekto agentams, o ne tik žmonėms terminale.
Kas iš tikrųjų yra „Google Workspace“ komandinė eilutė (CLI)
Iš esmės „Google Workspace“ komandinė eilutės sąsaja (dažnai sutrumpinta iki gws) yra vieninga komandinės eilutės sąsaja, skirta „Google Workspace“ APIIš vieno vykdomojo failo vartotojai ir agentai gali sąveikauti su „Gmail“, „Google“ disku, „Google“ kalendoriumi, „Google“ dokumentais, „Google“ skaičiuoklėmis, „Google“ pokalbių kambariais ir net administravimo įrenginiais, nereikalaudami naudoti kelių SDK ar pasirinktinių apvalkalų.
Projektas yra „GitHub“ platformoje, naudojant googleworkspace/cli saugykloje ir platinamas kaip npm paketas. Įdiegimas visame pasaulyje naudojant npm install -g @googleworkspace/cli kelia gws įsakymas tavo kelyje, paverčiant kiekvieną palaikomą „Workspace“ API į vieno įrankio subkomandąSaugykloje naudojama šūkis puikiai apibendrina jos tikslą: „Viena komandinė eilutė visai „Google Workspace“ sistemai – sukurta žmonėms ir dirbtinio intelekto agentams.“
Skirtingai nuo daugelio tradicinių komandų sąsajų (CLI), kurios yra kuriamos pagal fiksuotus naudojimo atvejus, gws yra dinamiškai sukurtas vykdymo metu naudojant „Google“ paieškos paslaugąKiekvieną kartą paleidus, jis konsultuojasi su „Google“ API schemos paslauga, sukuria savo komandų paviršių pagal naujausius apibrėžimus ir kaupia tą schemą talpykloje tam tikrą laikotarpį (pavyzdžiui, maždaug 24 valandas), kad paleidimo laikas būtų nuspėjamas. Kai „Google“ prideda arba pakeičia galinį tašką „Workspace“ API, CLI gali jį automatiškai parodyti kitą kartą atnaujindama schemą.
Šis schemomis pagrįstas metodas reiškia, kad nereikia laukti naujo dvejetainio failo išleidimo kiekvieną kartą, kai API tobulėja. Komandoms nebereikia pakartotinai atnaujinti statinių REST apvalkalų tiesiog tam, kad neatsiliktumėte nuo nedidelių Disko, „Gmail“ ar Kalendoriaus pakeitimų.
Techniniu požiūriu projektas parašytas Rust kalba, tačiau kūrėjams, kurie jį diegia per npm, Rust įrankių grandinės nereikia. Paketas pateikia iš anksto sukurtus vietinius dvejetainius failus įprastoms operacinėms sistemoms ir architektūroms., taip pat yra galimybių įdiegti naudojant „Nix flake“ arba tiesiogiai iš šaltinio su „Cargo“, jei pageidaujama.
Sukurta dirbtinio intelekto agentams nuo nulio
Viena iš „Google Workspace“ komandinės eilutės sąsajos (CLI) charakteristikų yra ta, kad ji buvo nuo pat pradžių sumanyta su dirbtinio intelekto agentais kaip pagrindiniais naudotojaisJustinas Poehneltas, vyresnysis „Google“ kūrėjų ryšių inžinierius ir šio įrankio kūrėjas, teigė, kad daugelis esamų komandų sąsajų (CLI) buvo sukurtos žmonėms, o vėliau pritaikytos agentams, todėl jos elgiasi nestabiliai ir integracijos linkusios į haliucinacijas.
Priešingai, „gws“ buvo sukurta remiantis prielaida, kad dideli kalbos modeliai ir autonominiai agentai analizuos kiekvieną vėliavėlę, kiekvieną parametrą ir kiekvieną išvesties eilutę. Žmonių patogumas vis dar svarbus, tačiau pirmenybė teikiama mašininio skaitomumo patogumuiŠią filosofiją galima pastebėti visuose dizaino pasirinkimuose: nuspėjamos argumentų struktūros, griežto įvesties patvirtinimo vykdymas ir JSON pagrindu sukurti atsakymai.
Užuot rėmęsi žmonėms patogiomis sutrumpintų tekstų vėliavėlėmis ir laisvai suformatuotu tekstu, CLI skatina neapdoroti JSON užklausų tekstai, kurie tiksliai atitinka pagrindines API schemasDirbtinio intelekto sistemoje tai pašalina spėliones, kurie laukai kur priklauso, ir sumažina riziką, kad agentas išgalvos parametrus arba neteisingai interpretuos išvestį.
Įrankis taip pat suteikia savarankiškai aprašomą galimybę: agentai vykdymo metu gali pateikti užklausą pačiai CLI, kad gautų naujausią schemos informaciją. Tai sumažina modelių poreikį ieškoti išorinėje dokumentacijoje., apribojant žetonų naudojimą ir išvengiant neatitikimų tarp pasenusių dokumentų ir dabartinių API.
Kaip „gws MCP“ paverčia „Workspace“ aktyviu agentų galiniu punktu
Į CLI įterpta funkcija, vadinama gws mcp, kuris veikia kaip Modelio konteksto protokolo (MCP) serverisPaleidus šį serverį, „Workspace“ API sąsajos pateikiamos kaip struktūrizuoti įrankiai, naudojant standartinę įvestį ir išvestį, todėl bet kuris su MCP suderinamas klientas gali bendrauti su „Google Workspace“ tuo pačiu protokolu.
Praktiškai tai reiškia, kad tokie įrankiai kaip „Claude Desktop“, „Gemini CLI“, tam tikri „VS Code“ plėtiniai ir kiti agentų prieglobos serveriai, suprantantys MCP, gali tiesiogiai prisijungti prie „Google Workspace“ CLI. Jie „Workspace“ operacijas traktuoja kaip aukščiausios klasės įrankius– užklausų teikimas „Gmail“, kalendoriaus įvykių kūrimas, Disko failų skaitymas arba rašymas – nereikalaujant specialių HTTP integracijų ar pasirinktinių demonų.
Ryšys per „stdio“ užtikrina paprastą diegimą. Yra nereikia atidaryti papildomų prievadų, nereikia valdyti ilgai veikiančių foninių paslaugų ir mažiau problemų dėl užkardos, o tai gali būti reikšmingas pranašumas užrakintoje įmonės aplinkoje. Agentas tiesiog paleidžia komandinę eilutę (CLI), apsikeičia struktūrizuotais pranešimais per „stdio“ ir išjungia, kai darbas baigtas.
Kadangi MCP klientai dažnai riboja vienu metu pasiekiamų įrankių skaičių – paprastai nuo kelių dešimčių iki maždaug šimto – CLI įgyvendina paslaugų lygio filtravimą. Pateikiamos tik atitinkamos darbo srities paslaugos konkrečiam scenarijui, pvz., „Drive“ ir „Docs“ dokumentų apdorojimui arba „Calendar“ darbo eigų planavimui, kad pagrindinio kliento įrankių sąrašai būtų lengvai tvarkomi.
Kiekvienas MCP serverio atsakymas, nesvarbu, ar tai sėkminga užklausa, klaidos pranešimas, ar atsisiųsti metaduomenys, grąžinamas kaip struktūrizuotas JSON failas. Agentų srautai gali tiesiogiai analizuoti išvestį ir šakotis pagal aiškius laukus, panaikinant poreikį iššifruoti teksto žurnalus ar interpretuoti žmogui skirtą prozą.
Agento įgūdžiai, receptai ir komandų paviršius
Kad agentai galėtų patikimai veikti, saugykloje pateikiamas platus rašytinių instrukcijų, vadinamų agento įgūdžiais, katalogas. Įtraukta daugiau nei šimtas SKILL.md failų, apimančių kiekvieną palaikomą API ir aukštesnio lygio darbo eigų rinkinį.Šiuose dokumentuose pateikiami tikslūs įprastų užduočių iškvietimo modeliai, kad modeliams nereikėtų nuo nulio kurti komandų sintaksės.
Idėja, kaip Poehnelt yra išreiškęs kitur, yra ta, kad gerai parengtas įgūdžių failas yra pigesnis nei haliucinacijų rinkinysBe šių vadovų agentas, iškviečiantis CLI, gali neteisingai pavadinti vėliavėlę, praleisti būtiną argumentą arba netinkamai naudoti subkomandą, remdamasis vien tik kontekstinėmis išvadomis. Turint SKILL.md failus, modelis gali sekti aiškius pavyzdžius, kurie rodo, kokių parametrų reikia ir kaip atrodys išvestis.
Be vieno žingsnio įgūdžių, projekte taip pat yra dešimtys kuruojamų receptų – apie penkiasdešimt, remiantis dokumentacija – kurie atspindi kelių žingsnių darbo eigą. Šie receptai apima tokias užduotis kaip el. laiškų gijų santraukų sudarymas, juodraščių generavimas arba failų filtravimas į pakartotinai naudojamas sekas. kad agentai galėtų suaktyvinti veiksmus pagal pavadinimą, o ne kaskart iš naujo planuoti nuo pirmųjų principų.
Kadangi CLI kuriama dinamiškai iš aptikimo paslaugos, komandų paviršius prisitaiko, kai „Google“ tobulina „Workspace“. Nauji galiniai taškai rodomi kaip naujos subkomandos, nereikalaujant rankinio registravimo kodo bazėje., o tai sumažina komandų, kurios priklauso nuo pažangiausių funkcijų, priežiūros poreikį.
Nors ši dinaminė konstrukcija vyksta vykdymo metu, schemos dokumentai yra kaupiami talpykloje, kad dažni automatizavimo srautų iškvietimai pakartotinai nepasiektų tinklo. Tai suderina šviežumą su nuspėjamu našumu agentams, vykdantiems daug komandų iš eilės.
Kūrėjo patirtis ir integravimo galimybės
Kūrėjo požiūriu, pradėti naudotis „Google Workspace“ komandų eiga yra sąmoningai paprasta. Pagrindinė sąlyga yra suderinama „Node.js“ instaliacija. naudojant „npm“ paskirstymą kartu su „Google Cloud“ projektu, sukonfigūruotu su atitinkamais „OAuth“ prisijungimo duomenimis.
Įdiegus „gws“, jį galima tiesiogiai prijungti prie esamų aplinkų. Pavyzdžiui, jį galima pridėti kaip „Google Gemini“ komandinės eilutės sąsajos plėtinį naudojant paprastą komandą, kuri nukreipia „Gemini“ į „GitHub“ saugyklą. Po to „Gemini“ gauna tiesioginę prieigą prie viso rinkinio gws komandos ir agento įgūdžiai, todėl „Gemini“ pagrindu veikiantiems agentams lengviau dirbti su „Workspace“ duomenimis be papildomo „climing“ kodo.
Redaktoriams ir IDE integravimas paprastai reiškia CLI iškvietimą gws kaip subprocesas, perduodantis JSON naudingąją apkrovą ir naudojantis JSON rezultatus. Kadangi išvesties formatas yra vienodas visose komandose, klaidų tvarkymas ir registravimas gali būti centralizuotas. o ne pritaikyta kiekvienai „Workspace“ paslaugai atskirai.
Kūrėjai, pageidaujantys daugiau kontrolės, gali tiesiogiai kompiliuoti „Rust“ kodą arba panaudoti pateiktą „Nix“ fragmentą, kad būtų lengviau atkurti versijas. Atvirojo kodo „Apache-2.0“ licencija leidžia naudoti privačias šakas, vidines modifikacijas ir diegimui pritaikytas programas. be papildomų licencijavimo išlaidų.
CI aplinkose ir serverio pagrindu veikiančiuose agentuose CLI palaiko neinteraktyvius autentifikavimo srautus. Apskaitomi paslaugos paskyros raktai, iš anksto gauti prieigos žetonai ir kitos automatizuotos kredencialų strategijos., todėl kanalai, veikiantys ne vartotojo darbalaukio sesijoje, vis tiek gali programiškai sąveikauti su „Workspace“.
Ką CLI suteikia „Google Workspace“ sistemoje
Sukonfigūravus „Google Workspace“ komandų eilutės sąsają, galima atlikti daugybę operacijų visame rinkinyje. Agentai ir žmonės gali ieškoti „Gmail“ gijų, kurti atsakymų juodraščius, tvarkyti etiketes ir atlikti gautųjų rūšiavimą vien tik naudodami komandas.Panašiai ir tokios Disko operacijos kaip failų sąrašo sudarymas, aplankų perkėlimas, metaduomenų atnaujinimas arba naujų dokumentų kūrimas, yra prieinamos kaip scenarijams paleidžiami primityvai.
Dokumentuose ir Skaičiuoklėse CLI gali padėti rinkti turinį arba atlikti duomenų operacijas kaip didesnių darbo eigų dalį, pavyzdžiui, generuoti santraukos dokumentą iš šaltinio failų rinkinio arba ištraukti langelius iš kelių skaičiuoklių. Kalendoriaus įvykius galima kurti, atnaujinti arba užklausti, o pokalbių pranešimus galima skelbti arba skaityti kaip pokalbių automatizavimo dalį.
Kadangi įrankis taip pat apima administracinius galinius taškus, yra potencialas politika pagrįsta automatizacija, susijusi su paskyros valdymu, registravimu ir atitikties reikalavimams užduotimisNepaisant to, autonominių agentų naudojimas administratoriaus galimybėmis dar labiau padidina kruopštaus taikymo srities nustatymo ir griežto testavimo svarbą, atsižvelgiant į platesnį klaidų poveikį tuo lygmeniu.
Dirbtinio intelekto naudojimo atvejais šios operacijos yra sudedamosios dalys, kurias galima sudaryti. Pavyzdžiui, agentas gali sudaryti neskaitytų pranešimų sąrašą palaikymo pašto dėžutėje, apibendrinti gijas būsenos ataskaitoje, išsaugoti tą ataskaitą diske ir tada nusiųsti nuorodą į pokalbių kanalą.visi jie naudoja sujungtus CLI iškvietimus be sąveikos su grafine sąsaja.
Kadangi CLI yra aiškios ir stabilios, palyginti su vartotojo sąsajomis, kurių išdėstymas gali dažnai keistis, autonominės sistemos gali patikimiau samprotauti apie tolesnius veiksmus, remiantis struktūrizuotais atsakymais o ne pikselių pagrindu veikiantį ekrano iškarpymą. Šis stabilumas yra viena iš pagrindinių priežasčių, kodėl daugelis specialistų komandinės eilutės prieigą laiko geresniu dirbtinio intelekto valdomos automatizacijos pagrindu.
Apsaugos funkcijos, apsauginiai turėklai ir kelių paskyrų palaikymas
Atvėrus plačią API prieigą agentams, kyla aiškių saugumo klausimų, o „Google Workspace“ komandinės eilutės sąsajos dizainas stengiasi numatyti kai kuriuos iš jų. Įvesties patvirtinimas yra griežtesnis nei daugelyje žmonėms skirtų įrankių, tikrinant, ar nėra negaliojančių kelių, valdymo simbolių ir netinkamai suformuotų išteklių identifikatorių, iš dalies siekiant apriboti haliucinuotų ar priešiškų įvesčių poveikį.
CLI taip pat apima bandomojo paleidimo galimybę jautrioms operacijoms. Kai ši funkcija įjungta, komandos įvertinamos nesiunčiant rašymo užklausų į „Workspace“ API. leisti komandoms patvirtinti, kas nutiks prieš atliekant negrįžtamus pakeitimus pvz., ištrynimai arba masiniai atnaujinimai.
Kita verta dėmesio funkcija – galimybė dezinfekuoti atsakymus integruojant juos su „Google Cloud“ „Model Armor“ paslauga. Su specialiu --sanitize vėliava, atsakymus galima nuskaityti greiti injekcijos bandymai ar kitą kenkėjišką turinį prieš perduodant juos modeliuiTai ypač aktualu, kai agentai skaito iš naudotojų kontroliuojamų dokumentų ar gautų laiškų dėžučių, kuriose gali būti priešiško turinio.
Kalbant apie kredencialų pusę, CLI palaiko kelis autentifikavimo šablonus. Vartotojai gali prisijungti interaktyviai, jungtis per paslaugų paskyras, pasikliauti esamais prieigos žetonais arba konfigūruoti neinteraktyvius srautus, tinkamus serveriams ir nuolatinės integracijos sistemoms. Kiekvienos paskyros prisijungimo duomenys saugomi užšifruota forma vartotojo konfigūracijos kataloge., naudojant AES-256-GCM ir raktus, kuriuos tvarko operacinės sistemos raktų žiedas.
Kelių paskyrų scenarijai tvarkomi aiškiai. Įrankis gali vienu metu saugoti kelių „Google“ paskyrų prisijungimo duomenis. leidžia vartotojams perjungti juos arba nustatyti numatytąjį kasdieniam naudojimuiŠis lankstumas gali padėti komandoms, kurios atskiria asmeninę, testavimo ir gamybos aplinkas arba kurios dalijasi automatizavimo infrastruktūra keliose srityse.
Rizika, palaikymo būsena ir veiklos aspektai
Nors „Google Workspace“ komandinė eilutės sąsaja (CLI) yra talpinama oficialiai atrodančioje organizacijoje „GitHub“ platformoje, ji yra... aiškiai aprašytas kaip kūrėjo pavyzdys, o ne kaip visiškai palaikomas „Google“ produktasDokumentacijoje nurodoma, kad sąsajos gali keistis, elgsena gali labai pasikeisti projektui vystantis ir nėra oficialaus palaikymo kanalo verslo klientams.
Bendruomenės diskusijose, įskaitant tokias platformas kaip „Hacker News“, stebėtojai projektą apibūdino kaip kažką artimesnio eksperimentinei ar hobio pagrindu vykdomai konkrečių darbuotojų veiklai, o ne aukščiausio lygio komerciniam pasiūlymui. Tai nesumažina jo naudingumo, tačiau turi įtakos lūkesčiams dėl stabilumo ir ilgalaikių garantijų..
Organizacijoms, svarstančioms galimybę naudoti sistemą gamybinėje aplinkoje, galioja įprastas principas: CLI traktuokite kaip galingą, bet potencialiai nepastovią infrastruktūrą. Pernelyg platūs leidimai, pvz., visiška prieiga prie viso „Gmail“ domeno modifikavimo arba neribotos „Drive“ aprėpties, gali paversti vieną klaidingą komandą ar ydingą planą didelio masto sutrikimu. Pradedant nuo tik skaitymui skirtų sričių, prieigos apribojimas prie konkrečių aplankų ir smėlio dėžės paskyrų naudojimas yra atsargesnis kelias..
Veiklos apsaugos priemonės, tokios kaip greičio apribojimai, žmogaus patvirtinimo žingsniai destruktyviems veiksmams ir aiškūs incidentų planai žetonų atšaukimui arba pakeitimų anuliavimui, gali sušvelninti kai kurias būdingas rizikas. CLI komandų aiškumas yra pranašumas atliekant auditus ir atšaukimus., bet tai taip pat reiškia, kad plataus masto operacijas lengva išreikšti viena eilute.
Kadangi įrankis sukurtas standartinių „Workspace“ API sąsajų pagrindu, jis gali būti pritaikytas prie esamų valdymo modelių. Organizacijos vis tiek gali pasikliauti „OAuth“ leidžiamųjų sąrašų, duomenų praradimo prevencijos politikos, saugyklos saugojimo taisyklės ir audito žurnalai per administratoriaus ir disko veiklos API, kad būtų galima stebėti ir apriboti prieigą prie duomenų, net kai agentai inicijuoja skambučius.
Signalai įmonėms ir kas bus toliau
Komandoms, jau eksperimentuojančioms su agentiniais darbo eigomis „Workspace“ sistemoje, „Google Workspace“ komandinė eilutės sąsaja siūlo tiesesnį kelią į vertę nei individualūs apvalkalai aplink kiekvieną atskirą APIĮprasti scenarijai apima gautų laiškų santraukų rengimą palaikymo komandoms, automatinį dokumentų žymėjimą Diske arba pasikartojančias valymo užduotis, kurios sumažina netvarką bendrinamoje saugykloje.
Platesnės dirbtinio intelekto ekosistemos stebėtojai pastebėjo, kad komandinė eilutės sąsaja (CLI) remiasi tokiomis sistemomis kaip „OpenClaw“ ir sklandžiai integruojasi su „Gemini“ ir kitais MCP palaikančiais įrankiais. Ši kryžminė sąveika tarp nepriklausomų agentų projektų ir pagrindinių dirbtinio intelekto platformų rodo ateitį, kurioje CLI-first integracijos gali tapti norma. produktyvumo įrankiams, sumažinant priklausomybę nuo patentuotų jungčių.
Tikėtina, kad keli pokyčiai nulems, kaip plačiai „Workspace“ komandinė eilutė bus pritaikyta. Vienas iš jų – ar „Google“ galiausiai ją iš eksperimentinio pavyzdžio pakeis į palaikomą įrankių rinkinį su stabiliomis, versijomis pagrįstomis versijomis. Kitas yra standartizuotų saugių OAuth sričių politikos ir šablonų atsiradimas. kad administratoriai galėtų lengviau patvirtinti arba apriboti agento prieigą pagal vaidmenį.
Taip pat bus svarbūs išsamesni, visą procesą apimantys pavyzdžiai. Pavyzdinių procesų srautai, testavimo rinkiniai ir sintetiniai duomenų rinkiniai gali padėti komandoms patvirtinti automatizavimą prieš pradedant dirbti su gamybos duomenimis. Dokumentacija, kurioje demonstruojami visi darbo eigos etapai – nuo pradinio autentifikavimo iki registravimo ir klaidų taisymo – gali sumažinti barjerą atsargioms organizacijoms. kurie nori nuspėjamo elgesio prieš diegdami dirbtinio intelekto valdomus procesus.
Tuo tarpu projektas toliau juda į priekį aktyviu išleidimo ritmu pagal atvirojo kodo licenciją. Versijuotos versijos, tokios kaip 0.4.x, jau yra prieinamos. o „Apache-2.0“ licencijavimo modelis leidžia organizacijoms suskaidyti, išplėsti ir pritaikyti komandinę eilutę (CLI). prie jų infrastruktūros, įskaitant kryžminį kompiliavimą pritaikytoms platformoms, jei reikia.
Apibendrinus, „Google Workspace“ komandų eilutės sąsaja (CLI) yra reikšmingas žingsnis siekiant, kad „Gmail“, „Drive“, „Docs“ ir likusi „Workspace“ dalis būtų prieinamesnė tiek kūrėjams, tiek dirbtinio intelekto agentams. Sutelkdama dėmesį į struktūrizuotą JSON, dinaminį schemų generavimą, MCP integraciją ir aiškias saugos funkcijas, ji siūlo lankstų, tačiau pagrįstą automatizavimo pagrindą, tuo pačiu paliekant atsakomybę už kruopštų taikymo srities nustatymą, testavimą ir valdymą tiems, kurie nusprendžia ją diegti.
