Agjentë në AI Studio Playground

Google AI Studio Playground ofron një ndërfaqe vizuale për të krijuar prototipa dhe për të mësuar se si të ndërtoni agjentë të menaxhuar pa pasur nevojë të krijoni dhe shkruani thirrje API.

Për të filluar, shkoni te skeda Playground në panelin e navigimit të Google AI Studio dhe kaloni butonin te Agjentët .

Shabllone të parapërgatitura

Skeda Agjentët ka një seri shabllonesh që parakonfigurojnë Agjentin bazë të Antigravitetit duke vendosur konfigurimet e mjeteve dhe mjedisit. Të gjitha shabllonet janë me burim të hapur dhe të publikuara në deponë google-gemini/gemini-managed-agents-templates . Eksplorimi i këtyre shablloneve është një mënyrë e shkëlqyer për të mësuar se si të ndërtoni dhe strukturoni agjentin tuaj të menaxhuar.

Për shembull, kur zgjidhni shabllonin AI Radio, ai aktivizon të gjitha mjetet e lejuara dhe lidh një skedar të specializuar AGENTS.md dhe aftësi për prodhimin e emisioneve radiofonike. Mund t'i shihni këto cilësime në ndërfaqen e përdoruesit të Playground nën seksionin Mjedisi , duke klikuar butonin Burimet .

Konfigurimi i mjetit

Nën cilësimet e Agjentit në Playground, mund të aktivizoni ose çaktivizoni qasjen në mjetet e mëposhtme të integruara:

• Kërkimi në Google: Hyni në uebin e hapur për informacion bazë në kohë reale.
• Konteksti i URL-së: Merrni dhe analizoni përmbajtjen tekstuale të URL-ve specifike të faqeve të internetit.
• Ekzekutimi i Kodit: Ekzekutoni komandat Bash dhe Python direkt brenda mjedisit të izoluar sandbox.
• Mjetet e Sistemit të Skedarëve: Lexoni, shkruani, listoni dhe fshini skedarët brenda hapësirës së punës.

Konfigurimi i Mjedisit

Agjentët e menaxhuar funksionojnë brenda një mjedisi të sigurt dhe të përkohshëm Linux (mjedisi) që ofron hapësirën e punës dhe mjetet e nevojshme për të vepruar. Për të mësuar më shumë, shihni udhëzuesin e mjedisit të agjentëve të menaxhuar .

Kontrollimi i sjelljes së agjentit

Sjellja, personaliteti dhe aftësitë e agjentit përcaktohen kryesisht nga skedarët e pranishëm në mjedisin e tij. Agjenti zbulon dhe ngarkon automatikisht konfigurimet nga një dosje e veçantë .agents :

• AGENTS.md : I para-ngarkuar në kontekstin e agjentit për të përcaktuar udhëzimet dhe personazhin e sistemit.
• SKILL.md : Ndodhet nën dosjet përkatëse të aftësive (p.sh., .agents/skills/my-skill/SKILL.md ) për të përcaktuar aftësi dhe rrjedha pune specifike.

Furnizimi i Mjedisit

Mund ta konfiguroni mjedisin që do të përdoret nga agjenti duke montuar skedarë në mjedis përpara se të filloni një seancë. Mund të ndërtoni një mjedis të ri duke montuar burimet ose të rivendosni një të mëparshëm:

• Për të krijuar një mjedis të ri , klikoni Shto Burime në panelin e Cilësimeve të Mjedisit dhe zgjidhni nga llojet e mëposhtme të burimeve:

• Për të rivendosur një mjedis të mëparshëm , mund të ripërdorni një ID të mjedisit ekzistues për të klonuar dhe ndarë gjendjen e tij të saktë.

Ripërdorimi i një ID-je ekzistuese të mjedisit

Nëse keni shpenzuar kohë duke krijuar një mjedis sandbox, nuk keni pse të filloni nga e para. Për të përdorur një mjedis ekzistues:

1. Shko te paneli Mjedise në AI Studio dhe ndrysho Llojin në Ekzistues
2. Futni ID-në e Mjedisit (p.sh., env_abc123 )

Për më shumë informacion, shihni Konfiguro një mjedis . Gjithashtu mund të merrni ID-në e Mjedisit të sesionit aktual nga skeda Mjedisi në ndërfaqen e përdoruesit.

Pasi t’ia dërgoni mesazhin e parë agjentit, konfigurimi i mjedisit bëhet i fiksuar për atë seancë. Nuk mund të montoni burime të reja ose të modifikoni listën e lejimeve të rrjetit ndërsa bashkëveprimi është duke u ekzekutuar në mënyrë aktive.

Shkarkoni mjedisin

Pasi të krijohet një mjedis, mund ta shkarkoni pamjen e ekranit të mjedisit në çdo kohë duke përdorur butonin Shkarko në cilësimet e Mjedisit të AI Studio Playground për të marrë skedarët e mjedisit si një skedar tarball.

Siguria dhe Menaxhimi i Kostos

Menaxhimi i Konsumit të Tokenëve

Ndryshe nga një kërkesë standarde bisede që prodhon një rezultat të vetëm, Agjenti Antigravity ekzekuton një rrjedhë pune autonome. Ai planifikon, ekzekuton kodin, vëzhgon rezultatet dhe përsërit. Kjo do të thotë që një kërkesë e vetme mund të rezultojë në konsum të pakufizuar të tokenëve.

Për të menaxhuar kostot, jepni kritere të qarta përfundimi në kërkesat tuaja dhe përcaktoni detyrat në mënyrë të ngushtë për agjentin . Një shembull i mirë mund të jetë një kërkesë si "Rishikoni kërkesën për tërheqje dhe ndaloni pasi të keni gjeneruar përmbledhjen e uljes së çmimit". Mos u përpiqni ta shkruani vetë rregullimin .

Kosto shtesë

Si parazgjedhje, të gjitha shabllonet e agjentëve në Playground kanë qasje në shërbimin Gemini API dhe mund të bëjnë thirrje API nga mjedisi për të përmbushur kërkesat. Këto mund të sjellin kosto shtesë të cilat nuk do të pasqyrohen në konsumin e tokenëve.

Në mënyrë të ngjashme, nëse shtoni shërbime të tjera të jashtme, agjenti mund të ketë kosto shtesë duke i telefonuar këto shërbime në emrin tuaj.

Lista e Lejimeve të Rrjetit

Si parazgjedhje, në AI Studio të gjitha kërkesat dalëse të rrjetit nga brenda mjedisit sandbox të agjentit tuaj kontrollohen dhe kufizohen rreptësisht për të garantuar sigurinë. Për t'i dhënë agjentit tuaj mundësinë për të arritur API-të e jashtme, shërbimet e uebit ose menaxherët e paketave, duhet t'i deklaroni ato në mënyrë të qartë:

1. Shko te paneli Mjediset në AI Studio.
2. Zgjidhni butonin e rregullave pranë Rrjetit .
3. Në panelin e konfigurimit të rrjetit , klikoni Shto në listën e lejimeve dhe plotësoni detajet përkatëse:
   • Kufizimi i Domenit: Vetëm domenet ose modelet specifike të karaktereve të ndyra të shtuara në listë mund të aksesohen nga makina virtuale e agjentit. Për shembull, mund të futni domene të sakta si api.github.com ose modele të gjera si *.googleapis.com .
   • Shto Kokë HTTP dhe Injeksion Tokeni: Përdorni opsionin Shto kokë HTTP për të injektuar në mënyrë të sigurt kredencialet e kërkuara (siç është një token API) për një domen specifik. Këto kredenciale kalojnë në mënyrë të sigurt përmes një ndërmjetësi daljeje dhe nuk ekspozohen kurrë drejtpërdrejt si tekst i papërpunuar brenda sandbox-it të agjentit.

Gjithmonë trego kujdes kur shton domene në listën tënde të lejuar. Dhënia e aksesit agjentit në shërbimet e autentifikuara do të thotë se ai mund të veprojë në emrin tënd, gjë që mund të çojë në veprime të padëshiruara nëse nuk monitorohet me kujdes.

Praktikat më të mira të kredencialeve

Nëse rrjedha juaj e punës kërkon që agjenti të autentifikohet me shërbime të jashtme, ju jeni përgjegjës për përgatitjen dhe përcaktimin e fushëveprimit të këtyre kredencialeve. Ndiqni këto udhëzime për të zvogëluar rrezikun:

• Përdorni kredencialet me privilegjin më të ulët: Krijoni llogari shërbimi ose çelësa API vetëm me lejet që i nevojiten agjentit tuaj. Shmangni kalimin e kredencialeve me akses të gjerë ose administrativ.
• Preferoni tokenët jetëshkurtër: Kur është e mundur, përdorni kredenciale të kufizuara në kohë ose tokena që skadojnë në vend të çelësave API jetëgjatë.
• Supozoni akses të plotë: Agjenti mund të përdorë çdo kredencial në të cilin ka akses për të përfunduar detyrën që i keni dhënë. Jepni vetëm kredencialet, të cilave jeni të gatshëm t'u jepni akses të plotë.
• Ndërroni kredencialet rregullisht: Trajtojini kredencialet e ndara me agjentin në të njëjtën mënyrë siç do të trajtonit çdo kredencial programatik; ndërroni ato sipas një orari të rregullt.

Lidhja e mjeteve dhe API-ve të jashtme

Mund të lidhni mjete dhe API të jashtme (siç janë serverat Model Context Protocol / MCP) për të zgjeruar aftësitë e agjentit. Kur veproni kështu:

• Lidhni vetëm mjete nga burime që u besoni. Një mjet keqdashës ose i shkruar keq mund të ekspozojë të dhëna ose të kryejë veprime të padëshiruara.
• Konfiguroni mjetet me lejet minimale të kërkuara për rastin tuaj të përdorimit. Nëse një mjet mbështet modalitetin vetëm për lexim, preferojeni këtë, përveç nëse shkrimet janë absolutisht të nevojshme.
• Para se të lidhni një mjet me një burim të dhënash prodhimi, testojeni atë kundrejt të dhënave shembullore ose sintetike për të verifikuar nëse agjenti e përdor atë siç pritet.

Mbikëqyrja njerëzore

Agjentët mund të arsyetojnë, planifikojnë dhe ekzekutojnë rrjedha pune me shumë hapa me një shkallë të lartë autonomie. Ndërsa kjo është e fuqishme, do të thotë gjithashtu se duhet të aplikoni mbikëqyrje të përshtatshme; veçanërisht për detyrat që modifikojnë të dhënat ose bashkëveprojnë me sistemet e jashtme.

Verifikoni gjithmonë rezultatet kritike, siç janë kodi i gjeneruar, transformimet e të dhënave ose ndryshimet e konfigurimit, përpara se t'i vendosni ato në përdorim.