Ndërtoni aplikacione në Google AI Studio

Kjo faqe përshkruan se si të përdorni Google AI Studio për të ndërtuar (ose "kod vibe") dhe për të vendosur shpejt aplikacione që testojnë aftësitë më të fundit të Gemini si Nano Banana dhe Live API . Google AI Studio tani mbështet kohëzgjatje të plota , duke ju lejuar të ndërtoni aplikacione të fuqishme me logjikë nga ana e serverit, menaxhim të sigurt të sekreteve dhe mbështetje të paketave npm, të gjitha përmes nxitjes në gjuhën natyrore.

Filloni

Filloni kodimin me vibe në modalitetin Ndërtim të Google AI Studio. Mund të filloni ndërtimin në disa mënyra:

  • Filloni me një kërkesë : Në modalitetin Ndërtim, përdorni kutinë e të dhënave për të futur një përshkrim të asaj që dëshironi të ndërtoni. Zgjidhni Çipat e IA-së për të shtuar veçori specifike si gjenerimi i imazheve ose të dhënat e Google Maps në kërkesën tuaj. Madje mund të thoni çfarë të dëshironi duke përdorur butonin e shndërrimit të të folurit në tekst.
  • Butoni "Ndihem me fat" : Nëse keni nevojë për një shkëndijë krijuese, përdorni butonin "Ndihem me fat" dhe Binjakët do të gjenerojnë një mesazh me një ide projekti për t'ju ndihmuar të filloni.
  • Përzieni një projekt nga galeria : Hapni një projekt nga Galeria e Aplikacioneve dhe zgjidhni Kopjo Aplikacionin .

Pasi të ekzekutoni komandën, do të shihni që gjenerohen kodi dhe skedarët e nevojshëm, me një pamje paraprake të aplikacionit tuaj që shfaqet në anën e djathtë.

Çfarë krijohet?

Kur ekzekutoni kërkesën tuaj, AI Studio krijon një aplikacion të plotë. Si parazgjedhje, ai krijon një mjedis të plotë që mund të përfshijë:

  • Ana e klientit : një frontend uebi (React është parazgjedhja).
  • Ana e serverit : një kohë ekzekutimi Node.js që lejon thirrje të sigurta API, lidhje me bazën e të dhënave dhe përdorim të paketës npm.

Mund ta shikoni kodin që gjenerohet duke zgjedhur skedën Kodi në panelin e pamjes paraprake në të djathtë. Agjenti Antigravity menaxhon në mënyrë inteligjente skedarë të shumtë në të gjithë grumbullin tuaj, duke siguruar që ndryshimet të përhapen saktë.

Agjenti Antigravitacional

Agjenti Antigravity është funksionaliteti kryesor i IA-së brenda Google Antigravity dhe tani komponentët kryesorë të këtij agjenti po fuqizojnë përvojën e modalitetit Build në Google AI Studio. Ai shkon përtej gjenerimit të thjeshtë të kodit duke ruajtur kontekstin e të gjithë projektit tuaj, duke menaxhuar skedarë të shumtë dhe duke kuptuar udhëzime komplekse për të ndërtuar aplikacione të fuqishme dhe të plota.

Aftësitë kryesore përfshijnë:

  • Ndërgjegjësimi për kontekstin : mirëmban kontekstin e kërkesave të mëparshme dhe gjendjeve të skedarëve.
  • Menaxhimi i shumë skedarëve : trajton varësitë midis skedarëve të shumtë.
  • Ekzekutim i verifikuar : verifikon përditësimet e kodit për të zvogëluar halucinacionet.

Aftësi të plota

Google AI Studio zhbllokon fuqinë e ekosistemit modern të uebit, duke ju lejuar të ndërtoni më shumë sesa thjesht prototipa nga ana e klientit.

  • Koha e ekzekutimit në server dhe npm : përdorni bibliotekën e gjerë të paketave npm. Agjenti do të identifikojë dhe instalojë automatikisht paketat sipas nevojës për aplikacionin tuaj (p.sh., biblioteka specifike për vizualizimin e të dhënave ose klientët API). Gjithashtu mund të kërkoni paketa specifike nëse dëshironi.
  • Menaxhimi i sekreteve : ruani në mënyrë të sigurt çelësat dhe sekretet e API-t në menynë e Cilësimeve . Këto janë të arritshme në kodin tuaj në anën e serverit, duke i mbajtur të sigurta nga ekspozimi në anën e klientit.
  • Shumëlojtar : ndërto përvoja bashkëpunuese në kohë reale direkt brenda AI Studio. Runtime në anën e serverit menaxhon gjendjen dhe lidhjet e nevojshme që përdoruesit të bashkëveprojnë së bashku.
  • Integrimi i Firebase : përgatitja dhe konfigurimi automatik i Firebase, duke përfshirë bazën e të dhënave Firestore (ruajtje e përhershme e të dhënave) dhe Autentifikimin Firebase (rrjedhat e hyrjes, konkretisht "Hyr me Google"). Agjenti trajton të gjithë procesin e konfigurimit dhe madje shkruan kodin në aplikacionin tuaj për këto shërbime.

Mësoni më shumë rreth zhvillimit të aplikacioneve full-stack

Vazhdo ndërtimin

Pasi Google AI Studio të gjenerojë kodin fillestar për aplikacionin tuaj, mund të vazhdoni ta përsosni atë:

Ndërto në Google AI Studio

  • Përsëriteni me Gemini : Përdorni panelin e bisedës në modalitetin Ndërtim për t'i kërkuar Gemini të bëjë modifikime, të shtojë veçori të reja ose të ndryshojë stilin.
  • Modifiko kodin direkt : Hap skedën Kodi në panelin e pamjes paraprake për të bërë ndryshime të drejtpërdrejta.

Zhvillo nga jashtë

Për rrjedha pune më të avancuara, mund ta eksportoni kodin dhe të punoni në mjedisin tuaj të preferuar:

  • Shkarkoni dhe zhvilloni lokalisht : Eksportoni kodin e gjeneruar si skedar ZIP dhe importojeni atë në redaktuesin tuaj të kodit.
  • Shtyje në GitHub : Integroni kodin me proceset tuaja ekzistuese të zhvillimit dhe vendosjes duke e shtyrë atë në një depo GitHub .

Karakteristikat kryesore

Google AI Studio përfshin disa veçori për ta bërë procesin e ndërtimit intuitiv dhe vizual:

  • Krijo dhe përsërit aplikacione me shumë funksione : Krijo aplikacione me shumë funksione vetëm me një kërkesë dhe përsërit përmes modalitetit të bisedës ose shënimeve . Modaliteti i shënimeve ju lejon të theksoni çdo pjesë të ndërfaqes së përdoruesit të aplikacionit tuaj dhe të përshkruani ndryshimin që dëshironi.
  • Ndani dhe vendosni aplikacionin tuaj : Mund të ndani krijimet tuaja me të tjerët për të bashkëpunuar ose për të shfaqur punën tuaj. Pastaj, kur aplikacioni juaj të jetë gati, vendoseni në Cloud Run.
  • Galeria e aplikacioneve : Galeria e aplikacioneve ofron një bibliotekë vizuale me ide projektesh. Mund të shfletoni çfarë është e mundur me Gemini, të shikoni paraprakisht aplikacionet menjëherë dhe t'i ripërpunoni ato për t'i bërë tuajat.

Vendosni ose arkivoni aplikacionin tuaj

Pasi aplikacioni juaj të jetë gati, mund ta instaloni atë:

  • Google Cloud Run : vendosni aplikacionin tuaj si një shërbim të shkallëzueshëm. Mund të aplikohen çmime për Google Cloud Run në varësi të përdorimit.
  • GitHub : eksportoni projektin tuaj në një depo GitHub.

Kufizime

Ky seksion rendit kufizimet aktuale të modalitetit të ndërtimit në Google AI Studio.

Siguria e Çelësit API

  • Ana e klientit : mos përdorni kurrë çelësa të vërtetë API direkt në kodin e anës së klientit.
  • Ana e serverit : përdorni veçorinë e Menaxhimit të Sekreteve për të trajtuar çelësat e ndjeshëm në mënyrë të sigurt në kohën e ekzekutimit në anën e serverit.

Vendosja jashtë Google AI Studio

  • Ndërkohë që mund ta vendosni aplikacionin tuaj në Cloud Run për një URL publike, ky konfigurim do të përdorë çelësin tuaj API për të gjitha thirrjet Gemini API të përdoruesve.
    • Aplikacionet JavaScript ekzekutohen në anën e klientit, prandaj sigurohuni që çelësat API të kenë vetëm akses minimal për të parandaluar rrjedhjet e të dhënave ose keqpërdorimin. Për shembull, Dyqanet e tjera të Kërkimit të Skedarëve nga i njëjti projekt mund të jenë të arritshme për përdoruesit nëpërmjet këtij mekanizmi.
  • Vendosje e sigurt e jashtme: Për të ekzekutuar një aplikacion në mënyrë të sigurt jashtë AI Studio (p.sh., pas shkarkimit të skedarit zip), duhet të zhvendosni logjikën që përdor çelësin API në një komponent në anën e serverit për të parandaluar ekspozimin e çelësit ndaj përdoruesve fundorë. Kjo nuk është e nevojshme nëse vendosni duke përdorur Cloud Run.
  • Paralajmërim për ekspozimin ndaj çelësit: Zëvendësimi i thjeshtë i vendmbajtësit me një çelës të vërtetë API në një mjedis nga ana e klientit nuk rekomandohet fuqimisht, pasi çelësi do të bëhet i dukshëm për çdo përdorues.

Gabim gjatë ndarjes së aplikacioneve

Nëse e ndani aplikacionin tuaj dhe përdoruesi juaj fundor has një gabim 403 Access Restricted kur përdor URL-në e përbashkët, kjo mund të jetë për shkak të njërës prej këtyre arsyeve:

  • Zgjerimet e shfletuesit : zgjerimet e privatësisë si Privacy Badger mund ta bllokojnë aplikacionin. Çaktivizoni zgjerimin për të shmangur gabimin.
  • Probleme me ndërtimin : mund të ketë probleme me kodin aktual. Kërkoji agjentit të "rregullojë çdo problem me ndërtimin me kodin aktual" dhe më pas ndaje përsëri URL-në.

Pyetje të shpeshta

Çfarë është Build in AI Studio?

AI Studio Build është një platformë e projektuar për t'ju çuar nga një kërkesë e thjeshtë në një aplikacion të gatshëm për prodhim, të mundësuar nga IA duke përdorur Gemini. Përshkruani se çfarë doni të ndërtoni me një kërkesë dhe Gemini do të gjenerojë një aplikacion për ju. Gjithashtu mund të eksploroni galerinë tonë për të parë se çfarë është e mundur me Gemini API dhe të përzieni aplikacionet për t'i bërë tuajat.

Pse Build e thërret Gemini API nga kodi i klientit?

Normalisht, praktika më e mirë është të thirret Gemini API nga ana e serverit, në mënyrë që të mos ekspozohet çelësi juaj API. Por AI Studio ka një proxy Gemini API për thirrjet nga ana e klientit, i cili bashkëngjit çelësin API pa e ekspozuar atë në kod. Për momentin, ne gjenerojmë thirrje nga ana e klientit për të përdorur këtë proxy, pasi thjeshton kodin dhe ju lejon të ndani aplikacionin tuaj me të tjerët pa pasur nevojë të jepni një çelës API.

A është çelësi im API i ekspozuar kur ndaj aplikacione?

Mos përdorni një çelës të vërtetë API në aplikacionin tuaj. Përdorni një vlerë vendmbajtëse në vend të kësaj. process.env.GEMINI_API_KEY është vendosur në një vlerë vendmbajtëse që mund ta përdorni. Kur një përdorues tjetër përdor aplikacionin tuaj, AI Studio i dërgon thirrjet në Gemini API, duke zëvendësuar vlerën e vendmbajtëse me çelësin API të përdoruesit (jo tuajin). Mos përdorni një çelës të vërtetë API në aplikacionin tuaj, pasi kodi është i dukshëm për këdo që mund ta shikojë aplikacionin tuaj.

Kush mund t'i shohë aplikacionet e mia?

Si parazgjedhje, aplikacioni juaj është privat. Mund ta ndani aplikacionin tuaj me përdorues të tjerë që ata t'i lejojnë ta përdorin atë. Përdoruesit me të cilët ndani aplikacionin tuaj mund ta shohin kodin e tij dhe ta përdorin atë për qëllimet e tyre. Nëse e ndani aplikacionin tuaj me leje redaktimi, përdoruesit e tjerë mund ta modifikojnë kodin e aplikacionit tuaj.

A mund të ekzekutoj aplikacione jashtë AI Studio?

Mund ta vendosni aplikacionin tuaj në Cloud Run nga AI Studio, gjë që do t'i japë aplikacionit tuaj një URL publike. Vendoset së bashku me një server proxy që do ta mbajë çelësin tuaj API privat, megjithatë aplikacioni i vendosur do të përdorë çelësin tuaj API për të gjitha thirrjet Gemini API të përdoruesve. Gjithashtu mund ta shkarkoni aplikacionin tuaj si skedar zip. Nëse e zëvendësoni vlerën e mbajtësit të vendit me një çelës të vërtetë API, ai duhet të funksionojë ende. Por nuk duhet ta vendosni aplikacionin tuaj në këtë mënyrë, pasi çdo përdorues do të jetë në gjendje ta shohë çelësin API. Për ta bërë një aplikacion të funksionojë në mënyrë të sigurt jashtë AI Studio, kërkohet zhvendosja e disa logjikave në anën e serverit , kështu që çelësi API nuk është më i ekspozuar.

A mund të zhvilloj aplikacione në nivel lokal me mjetet e mia dhe pastaj t'i ndaj ato këtu?

Ky funksionalitet nuk është ende i disponueshëm. Jemi të emocionuar të mbështesim më shumë raste përdorimi për aplikacionet në të ardhmen. Ju lutemi, merrni në konsideratë të na jepni reagime nëse keni ndonjë gjë specifike në mendje.

Si mund të përdor një bazë të dhënash ose një hapësirë ​​tjetër ruajtjeje me aplikacionet e mia?

Aplikacionet AI Studio janë aplikacione standarde që funksionojnë në një kontejner Cloud Run. Mund të përdorni çdo zgjidhje ruajtjeje me të cilën mund të lidheni nëpërmjet një rrjeti, për sa kohë që nuk ka një firewall që pengon aksesin nga një diapazon IP dinamik.

Po punojmë për të shtuar mbështetje të drejtpërdrejtë për ruajtjen në të ardhmen, të cilën do të jeni në gjendje ta konfiguroni direkt brenda AI Studio.

Për t'u siguruar që shikuesit janë të vetëdijshëm për përdorimin e kamerës së tyre të internetit ose pajisjeve të tjera nga një aplikacion, ne kërkojmë një konfirmim shtesë përpara se aplikacioni të mund të hyjë në këto API të Navigator . Krijuesit e aplikacioneve mund t'i shtojnë këto kërkesa për leje në skedarin metadata.json të aplikacionit të tyre. Për shembull:

{
  "name": "My app",
  "requestFramePermissions": [
    "microphone",
    "camera",
    "display-capture",
    "geolocation",
    "bluetooth",
    "clipboard-read",
    "serial",
    "usb"
  ]
}

Vlerat e mbështetura për requestFramePermissions janë një nëngrup i veçorive standarde të kontrolluara nga politikat .

Si mund ta përdor GitHub me aplikacionet e mia?

Integrimi i AI Studio me GitHub ju lejon të krijoni një depo për punën tuaj dhe të ruani ndryshimet tuaja të fundit. Aktualisht nuk e mbështesim tërheqjen e ndryshimeve në distancë.

A mund t'u jap përdoruesve të tjerë akses për të modifikuar aplikacionin tim?

Kjo nuk mbështetet ende, por do të vijë së shpejti.

Pse aplikacioni im u raportua për shkelje të politikave?

Ne kemi sisteme që shqyrtojnë automatikisht aplikacionet për t'u siguruar që ato përputhen me politikat tona. Nëse zbulojmë se një aplikacion shkel politikat tona, aplikacioni do të hiqet nga AI Studio. Shkeljet e politikave mund të përfshijnë, por nuk kufizohen vetëm në, sa vijon:

  • Aplikacione që përmbajnë programe keqdashëse, phishing ose imitim
  • Aplikacionet që shfaqin ose shpërndajnë përmbajtje që shkel politikën e imazheve të abuzimit seksual me fëmijë
  • Aplikacionet që shfaqin ose shpërndajnë përmbajtje që shkel politikën e ngacmimit
  • Aplikacionet që shfaqin ose shpërndajnë përmbajtje që shkel politikën e gjuhës së urrejtjes
  • Aplikacionet që shfaqin ose shpërndajnë përmbajtje që shkel politikën e trafikimit të qenieve njerëzore
  • Aplikacionet që shfaqin ose shpërndajnë përmbajtje që shkel politikën e përmbajtjes me përmbajtje seksuale eksplicite
  • Aplikacione që shfaqin ose shpërndajnë përmbajtje që shkel politikën e dhunës dhe gjakderdhjes
  • Aplikacionet që shfaqin ose shpërndajnë përmbajtje që shkel politikën e dëmshme ose të rrezikshme

Nëse aplikacioni juaj është raportuar për një shkelje të politikave dhe ju besoni se është gabim, mund të paraqisni një apel. Shkeljet e përsëritura të politikave tona mund të rezultojnë në ndërprerjen e aksesit tuaj në AI Studio.

Cilat janë përgjegjësitë e mia si zhvillues aplikacionesh?

Si kujtesë, si pronar i aplikacionit tuaj, ju jeni përgjegjës për sjelljen e tij dhe të gjitha të dhënat që ai trajton. Kjo përfshin:

  • Pajtueshmëria Ligjore dhe të Drejtat e Palëve të Treta: Sigurimi që aplikacioni juaj të jetë në përputhje me të gjitha ligjet dhe rregulloret në fuqi dhe të mos shkelë të drejtat e të tjerëve, duke përfshirë të drejtat e pronësisë intelektuale dhe të privatësisë.
  • Monitorimi i Përmbajtjes: Pajtueshmëria me kushtet shtesë mund të zbatohet për shërbime të tjera të përdorura nga aplikacioni juaj. Për shembull, Kushtet e Shërbimit të Google Cloud , të zbatueshme për Firestore, kërkojnë që klientët që strehojnë përmbajtje të palëve të treta të publikojnë politika që përcaktojnë se cila përmbajtje është e ndaluar (p.sh., përmbajtje e paligjshme) dhe të monitorojnë praninë e asaj përmbajtjeje të paligjshme.
  • Implementim i Sigurt: Implementimi i masave të nevojshme mbrojtëse dhe mjeteve të moderimit për të parandaluar keqpërdorimin e aplikacionit tuaj.

Jini të vetëdijshëm për kufizimet e përdorimit në Kushtet e Shërbimit.

Kushtet shtesë të shërbimit të Gemini API zbatohen për përdorimin e aplikacioneve të paraqitura në galerinë e aplikacioneve në AI Studio, përveç nëse përcaktohet ndryshe.

Çfarë vjen më pas