1. Giriş
Bu codelab'de, Antigravity'nin hafif bir terminal kullanıcı arayüzü (TUI) olan Antigravity CLI hakkında bilgi edineceksiniz. Antigravity 2.0 ile aynı temel ajan özelliklerini (ör. çok adımlı akıl yürütme, çoklu dosya düzenleme, araç çağırma ve görüşme geçmişi) doğrudan terminalinize getirir.
Neler öğreneceksiniz?
- Antigravity KSA'yı yükleme ve yapılandırma
- Antigravity CLI'nın temel kullanımını anlama
- Antigravity CLI ile birkaç kullanım alanını keşfetme
Gerekenler
İhtiyacınız olanlar:
- Chrome web tarayıcısı
- Gmail hesabı
Bu codelab, yeni başlayanlar da dahil olmak üzere her seviyeden kullanıcı ve geliştirici için tasarlanmıştır. Codelab'deki kullanım alanları, geliştirici ve geliştirici olmayan görevler olarak sınıflandırılmıştır. Geliştiriciler için kullanım alanları, Antigravity CLI ile kodun nasıl yorumlanacağını ve kod açıklaması/anlama, doküman oluşturma, sorunları düzeltme gibi yaygın geliştirme görevlerini gerçekleştirmek için GitHub deposuyla nasıl çalışılacağını gösterir. Bu kullanım alanlarını codelab'de tamamlamanız önerilir. En sonda, geliştiricilere odaklanmayan ve günlük olarak yapılan çeşitli görevleri kapsayan isteğe bağlı bir bölüm bulunur.
2. Başlamadan önce
Proje oluşturma
- Google Cloud Console'daki proje seçici sayfasında bir Google Cloud projesi seçin veya oluşturun.
- Cloud projeniz için faturalandırmanın etkinleştirildiğinden emin olun. Bir projede faturalandırmanın etkin olup olmadığını kontrol etmeyi öğrenin.
- bq'nun önceden yüklendiği, Google Cloud'da çalışan bir komut satırı ortamı olan Cloud Shell'i kullanacaksınız. Google Cloud Console'un üst kısmında Cloud Shell'i etkinleştir'i tıklayın.
- Cloud Shell'e bağlandıktan sonra aşağıdaki komutu kullanarak kimliğinizin doğrulandığını ve projenin proje kimliğinize ayarlandığını kontrol edin:
gcloud auth list
- gcloud komutunun projeniz hakkında bilgi sahibi olduğunu onaylamak için Cloud Shell'de aşağıdaki komutu çalıştırın.
gcloud config list project
- Projeniz ayarlanmamışsa ayarlamak için aşağıdaki komutu kullanın:
gcloud config set project <YOUR_PROJECT_ID>
3. Kurulum
Kurulumu yapıp Antigravity CLI'ı çalıştırmadan önce, içinde oluşturduğumuz tüm projeler için ana klasör olarak kullanacağımız bir klasör oluşturalım. Bu, Antigravity CLI'ın çalışması için bir başlangıç noktasıdır. Ancak sisteminizdeki diğer bazı klasörlere de referans verecek ve gerektiğinde daha sonra bu klasörlere geleceksiniz.
Devam edin ve bir örnek klasör (agy-cli-projects) oluşturun ve aşağıdaki komutları kullanarak bu klasöre gidin. Dilerseniz başka bir klasör adı kullanabilirsiniz.
mkdir agy-cli-projects
Şimdi o klasöre gidelim:
cd agy-cli-projects
Yükleme işlemi basittir ve ikili dosyalar, başlıca işletim sistemlerinde kullanılabilir. Terminalde çalıştırılacak komutları doğrudan yükleme belgesinden aldım:
macOS | Linux
curl -fsSL https://antigravity.google/cli/install.sh | bash
Windows PowerShell
irm https://antigravity.google/cli/install.ps1 | iex
Windows CMD
curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd
Bu komut, ideal olarak Antigravity CLI'yı (agy) sisteminizde ve Path'te kurup yüklemelidir.
Bazı durumlarda, yükleyici ikili programı ( agy to the PATH) ekleyemezse bunu belirtir. Örneğin, yükleyicinin ikili programı PATH'e ekleyemediği ve ne yapılması gerektiğini önerdiği bir makinedeki örnek çıktı aşağıda verilmiştir.
% curl -fsSL https://antigravity.google/cli/install.sh | bash
⠋ Detecting system environment...
✓ Platform detected: darwin_arm64
⠋ Querying release repository...
✓ Latest available version: 1.0.1
⠋ Downloading release package...
✓ Download complete and checksum verified.
⠋ Extracting binary from archive...
⠋ Configuring shell environment...
I0523 11:44:14.012088 76528 installer.go:27] Running Antigravity CLI setup...
Warning: /Users/neilirani/.local/bin is not present in your active PATH.
To use the 'agy' CLI globally, please manually add it to your shell profile:
echo 'export PATH="/Users/yourusername/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc
✅ Antigravity CLI binary placed successfully at /Users/yourusername/.local/bin/agy
Note: The binary is installed, but it is not in your active PATH. Please follow the instructions above to add it, then restart your terminal session.
Antigravity CLI'nın sürümünü aşağıdaki komutla kontrol edebilirsiniz (gösterilen sürüm, bu codelab yazıldığı sıradaki sürümdür):
$ agy --version
1.0.5
Antigravity CLI'yı ilk kez başlattığınızda giriş yapmanız istenir. agy'ı başlatın. Aşağıdakine benzer bir şey gösterilir:
▄▀▀▄
▀▀▀▀▀▀
▀▀▀▀▀▀▀▀
▄▀▀ ▀▀▄
▄▀▀ ▀▀▄
Welcome to the Antigravity CLI. You are currently not signed in.
Select login method:
> 1. Google OAuth
2. Use a Google Cloud project
[Use arrow keys to navigate, Enter to select]
Şimdilik kişisel hesabınızı kullanın. 1. Google OAuth yazıp Enter tuşuna basın. Bu işlemle bir tarayıcı başlatılır ve Google Hesabınızla giriş yapabilirsiniz. Kimlik doğrulama ve yetkilendirme başarılı olduğunda bir kodu kopyalamanız istenir. Lütfen Antigravity CLI terminaline geri dönüp kodu yapıştırın.
Giriş başarılı olduktan sonra şunlar olur:
- İlk olarak, aşağıda gösterildiği gibi Antigravity CLI için seçmek istediğiniz renk teması hakkında soru sorar. Beğendiğinizi seçin.
- Ardından, birkaç hizmet şartını kabul etmeniz gerekir. Bunları kabul edin.
Son olarak, en önemli adım, klasöre güvendiğinize dair izin vermektir. Bu işlemi aşağıdaki şekilde yapabilirsiniz:
Accessing workspace:
/Users/yourusername/agy-cli-projects
Do you trust the contents of this project?
Antigravity CLI requires permission to read, edit, and execute files here.
> Yes, I trust this folder
No, exit
↑/↓ Navigate · enter Confirm
Bu mesajı genellikle Antigravity CLI'yi başlattığınız yeni klasörlerde görürsünüz. Bu konuyla ilgili daha fazla bilgiyi serinin ilerleyen bölümlerinde paylaşacağız. Şimdilik Yes, I trust this folder (Evet, bu klasöre güveniyorum) seçeneğini belirleyin.
Tebrikler! Artık hazırsınız ve Antigravity CLI, isteminizi bekliyor.
4. Antigravity CLI ile ilk etkileşimimiz
Antigravity CLI'yı kullanmaya başlayalım ve ilk sorgunuzu aşağıda gösterildiği gibi yazın:
Give me a famous quote on Artificial Intelligence and who said that?
Beklenen yanıt aşağıda gösterilmiştir:
● WebSearch(famous quotes on Artificial Intelligence) (ctrl+o to expand)
Here is one of the most famous quotes on Artificial Intelligence:
│ "AI is the new electricity."
│ — Andrew Ng (Co-founder of Coursera and Google Brain, Adjunct Professor at Stanford University)
Another widely cited perspective on the potential risks of AI is:
│ "The development of full artificial intelligence could spell the end of the human race. It would take off on its
│ own, and re-design itself at an ever-increasing rate."
│ — Stephen Hawking
Antigravity'nin alıntıyı almak için dahili araçlarından biri olan WebSearch'ü kullandığını fark edeceksiniz.
Burada istem vermenin dışında, Antigravity CLI'nin desteklediği çeşitli komutlar nelerdir? /help (eğik çizgi) yazarak bunu bulabilirsiniz. Çeşitli komutlar ve klavye kısayolları görürsünüz. Yazma sırasında kullanılan komutlardan bazıları aşağıda gösterilmiştir:
Antigravity CLI general commands shortcuts (←/→ or tab to cycle)
Available Commands
> /add-dir Add a directory to the workspace
/agents List available custom agents
/artifact View and review artifacts
/btw Ask a side question without interrupting the current task
/changelog Show release notes and changes
/clear (new) Clear conversation and start a new one
/config (settings) Open settings panel
/context Visualize current context usage
/copy Copy the last planner response to the clipboard (may require allowing clipboard ac...
/credits Show remaining G1 credits and purchase link
/diff View uncommitted changes and per-turn diffs
/exit (quit) Exit the CLI
/fast Agent will execute tasks directly. Use for simple tasks that can be completed faster
/feedback Submit qualitative feedback to improve the agent
/fork (branch) Create a branch of the current conversation at this point
/help Show available commands and keybindings
/hooks Manage hook configurations for tool events
/keybindings Set custom keybindings
/logout Log out
/mcp Manage MCP servers
/model Set a model
/open Open a file or view opened/edited files
/permissions Manage tool permissions
/planning Agent can plan before executing tasks. Use for deep research, complex tasks, or co...
<MORE_COMMANDS>
Şimdilik Antigravity CLI'dan çıkalım. Bu işlemi /quit komutuyla veya etkileşimli Antgiravity KSA terminal oturumunda ctrl+d komutunu iki kez çalıştırarak yapabilirsiniz.
5. Antigravity CLI - birkaç bakım komutu
Antigravity CLI'nin başlatıldığından ve komutunuzu beklediğinden emin olun.
Kullandığı modele dikkat edin. Modelin adı sağ altta gösterilir. İdeal olarak, yapmanız gereken özelleştirme ve ayarların çoğunun /config veya /settings komutuyla kullanılabildiğini anlamanız gerekir.
Yapılandırma / Ayarlar
/config komutunu çalıştırın. Bu komut, Antigravity'nin tercihlerinize göre özelleştirebileceğiniz çeşitli alanlarını gösterir. Renk şeması, araç izni ve telemetri ayarları gibi alanlar bu kapsamdadır.
Settings
Search:
────────────────────
> Animation Speed medium
Artifact Review asks for review
Color Scheme dark
Editor auto ($EDITOR)
Enable Telemetry on
Non-Workspace Access off
Notifications off
Rendering Mode native terminal (inline)
Sandbox Mode off
Show Feedback Survey on
Show Tips on
Tool Permission request-review
Use AI Credits off
Verbosity high
Örneğin, Renk Düzeni'nde aşağıdaki seçenekler gösterilir. Bu seçenekler arasından tercih ettiğim renk düzenini seçebilirim:
Color Scheme ╭─────────────────────────────────────────────────────────────╮
terminal │
light │
solarized light │
colorblind-friendly light │
> dark (current) │
solarized dark │
colorblind-friendly dark │
tokyo night
settings.json
Yapılandırma ayarlarının bir yerde saklanması gerekir. Tüm ayarlar ~/.gemini/antigravity-cli/settings.json dosyasına kaydedilir. Aşağıda bir örnek gösterilmektedir:
{
"colorScheme": "dark",
"model": "Gemini 3.5 Flash (High)",
"statusLine": {
"type": "",
"command": "",
"enabled": true
},
"trustedWorkspaces": [
"/Users/romin/antigravity-cli-projects",
"/Users/romin/agy-cli-projects"
]
}
Seçtiğim colorScheme, modeli ve Antigravity CLI'yı başlattığım ve klasörlere güvenmeyi kabul ettiğim çeşitli klasörleri görebilirsiniz.
Not: settings.json dosyasını doğrudan da değiştirebilir ve değişiklikleri görmek için en iyi uygulama olarak Antigravity CLI'yı yeniden başlatabilirsiniz. Ancak ayarlardan emin olun, aksi takdirde başlangıçta bir hata gösterilir. Dosyayı doğrudan değiştirmek istemiyorsanız bu dosyayla çalışmak için Antigravity CLI'da /settings veya /config komutunu kullanmanız önerilir.
Araç İzni
Anlaşılması gereken önemli bir ayar da Araç İzni'dir. Bu ayar, terminal komutlarının çalıştırılmadan önce onayınızı gerektirip gerektirmediğini kontrol eder. Bu işleme /config komutuyla ulaşabilirsiniz.
Tool Permission
> request-review (current)
proceed-in-sandbox
always-proceed
strict
Varsayılan olarak request-review şeklinde ayarlanır. Bu ayarı daha ayrıntılı bir şekilde inceleyelim. Antigravity'de, Araç İzni ayarları güvenlik (ana makine sisteminizi istenmeyen değişikliklere karşı koruma) ve hız (aracının, girişiniz için duraklamadan ne kadar bağımsız çalışabileceği) arasındaki dengeyi kontrol eder. Seçenekleri inceleyelim:
request-review (Mevcut Varsayılan)
Bu modda, aracı, önceden onaylanmış sınırlar dışında sisteminizi veya proje dosyalarınızı etkileyebilecek herhangi bir işlem gerçekleştirmeden önce kontrol eden bir iş ortağı olarak kabul edilir. Aracı bir terminal komutu çalıştırmaya, dosya işlemi (ör. yazma/silme) gerçekleştirmeye veya iznin önceden onaylanmadığı bir harici hizmeti çağırmaya çalıştığında yürütme duraklatılır. Kullanıcıdan söz konusu işlemi onaylaması veya reddetmesi istenir.
proceed-in-sandbox
Bu mod, aracının terminal komutlarını otomatik olarak yürütmesine olanak tanır ancak bunu güvenli ve izole bir kapsayıcı içinde yapar. Agent, sizden istemde bulunmadan komutları çalıştırabilir ancak bu komutlar sanallaştırılmış bir korumalı alanda (ör. hafif bir kapsayıcı) yürütülür. Gerçek ana makinenizin dosya sistemini değiştiremez veya yerel ağınıza erişemezler.
always-proceed
Bu, aracının maksimum hız ve kapasiteye sahip olduğu tamamen özerk moddur. Aracıya, komutları çalıştırmak ve dosyaları doğrudan ana makinenize yazmak için tam izin verilir. Aracı, sizden asla onay istemez.
strict
Bu, sıfır güvene dayalı, yüksek güvenlikli bir moddur. Aracının yetenekleri, okuma araçlarını çalıştırmakla sınırlıdır. Okuma dışındaki tüm araçlar, kullanıcının işlem yapmasını gerektirir.
6. Antigravity CLI - Komut Parametreleri
Antigravity CLI'yı başlatırken sağlayabileceğiniz birkaç komut satırı parametresi vardır. Seçeneklerin tam listesini görmek için aşağıda gösterildiği gibi --help kullanabilirsiniz.
agy --help
Bu, mevcut seçeneklerin tamamını göstermelidir. Aşağıda örnek bir giriş gösterilmektedir:
$ agy --help
Usage of agy:
--add-dir Add a directory to the workspace (repeatable) (default [])
-c Short alias for --continue
--continue Continue the most recent conversation
--conversation Resume a previous conversation by ID
--dangerously-skip-permissions Auto-approve all tool permission requests without prompting
-i Short alias for --prompt-interactive
--log-file Override CLI log file path
--model Model for the current CLI session
-p Short alias for --print
--print Run a single prompt non-interactively and print the response
--print-timeout Timeout for print mode wait (default 5m0s)
--prompt Alias for --print
--prompt-interactive Run an initial prompt interactively and continue the session
--sandbox Run in a sandbox with terminal restrictions enabled
Available subcommands:
changelog Show changelog and release notes
help Show help for subcommands
install Configure environment paths and shell settings
models List available models
plugin Manage plugins (install, uninstall, list, enable, disable)
plugins Alias for plugin
update Update CLI
Bunlardan birkaçına göz atalım.
Etkileşimli olmayan mod (bağımsız)
Antigravity CLI'yı etkileşimli olmayan bir modda çalıştırmak ilginç bir seçenektir. Bu durumda, istemi doğrudan siz sağlarsınız ve Antigravity CLI etkileşimli terminali açılmadan yanıt verilir. Antigravity CLI'yı komut dosyasının veya başka bir otomasyon sürecinin bir parçası olarak otomatik bir şekilde kullanmayı planlıyorsanız bu seçenek çok faydalıdır.
Aşağıda gösterildiği gibi, istemi Antigravity CLI'ye sağlamak için -p parametresini kullanırsınız:
agy -p "What is the gcloud command to deploy to Cloud Run"
Bu yöntemle hızlı yanıtlar alabilirsiniz ancak ek sorularla sohbete devam edemeyeceğinizi unutmayın.
Belirli bir model seçme
İlk yöntem, Antigravity CLI'dan belirli bir Gemini modunu kullanmasını istemektir. Antigravity CLI'ya yalnızca oturumu sırasında belirli bir modeli kullanmasını söylemek için --model parametresini kullanabilirsiniz. Bu, önceki bölümde bahsettiğimiz etkileşimli olmayan modda çok kullanışlıdır. Bu modda, birkaç agy oturumu başlatmak ve belirli görevler için belirli modelleri kullanmak isteyebilirsiniz.
Ancak öncelikle Antigravity CLI'da hangi modellerin kullanılabildiğini bilmeniz gerekir. Bunu, aşağıda gösterildiği gibi models alt komutuyla yapabilirsiniz:
$ agy models
Gemini 3.5 Flash (Medium)
Gemini 3.5 Flash (High)
Gemini 3.5 Flash (Low)
Gemini 3.1 Pro (Low)
Gemini 3.1 Pro (High)
Claude Sonnet 4.6 (Thinking)
Claude Opus 4.6 (Thinking)
Oturumda kullanılacak modeli belirtmek için bu model adlarından herhangi birini kullanabilirsiniz. Bunu aşağıdaki --model komutuyla yapabilirsiniz:
$ agy --model "Claude Opus 4.6 (Thinking)"
Antigravity CLI başlatıldıktan sonra, /model komutunu kullanarak kullanmasını istediğiniz belirli modeli kontrol edebilir veya oturum için kullanılan modeli gösteren sağ alt kısma bakabilirsiniz.
Tehlikeli yaşam
Risk almayı seviyorsanız --dangerously-skip-permissions adlı parametreyi kullanabilirsiniz. Bu parametre, tüm araç izinlerini otomatik olarak onaylar. İzinleri onaylamanızı isteyen bir istem gösterilmez. Bu nedenle, bu parametreyi dikkatli bir şekilde kullanın.
Aşağıdaki komutla Antigravity CLI'yı başlatın:
agy --dangerously-skip-permissions
Ardından aşağıdaki istemi girin. Benden herhangi bir dosya yazma izni istemediğini kontrol edin.
> get the latest news and write it in a file called news.txt. Then create another file that contains the summary of that file.
● ListDir(/Users/romin/agy-cli-projects)
● WebSearch(latest world news May 24 2026 news headlines) (ctrl+o to expand)
▸ Thought for 2s, 95 tokens
Processing News Information
● Create(/Users/romin/agy-cli-projects/news.txt)
● Create(/Users/romin/agy-cli-projects/summary.txt) (ctrl+o to expand)
I have fetched the latest world news headlines and created the requested files in your workspace:
1. news.txt: Contains the detailed news headlines for today (May 24, 2026), including topics on geopolitics (U.S.-Iran negotiations, Ukraine conflict), U.S.
security incidents, the Ebola outbreak in Central Africa, and the passing of NASCAR champion Kyle Busch.
2. summary.txt: Contains a concise, structured summary of the major categories covered in the news file.
Bu mod, her şeyin yerel olduğu ve kontrolünüzde olduğu senaryolarda faydalı olabilir. Ancak sürprizlere karşı hazırlıklı olmanız ve bu nedenle dikkatli kullanmanız gerekir.
7. Antigravity CLI - Shell modu
Bu, Antigravity CLI'dan Shell ile doğrudan nasıl çalışacağınızı öğrenmek için iyi bir zamandır. İleti kutusunda ! tuşuna basarak kabuk moduna geçebilirsiniz. Bu işlem, kabuk moduna geçiş yapar. ! tuşuna tekrar basarak veya ESC tuşuna basarak geri dönebilirsiniz.
Kabuk modundayken istemin başında aşağıdaki gibi ! simgesini görürsünüz:
Aşağıda gösterildiği gibi pwd ve ls gibi standart komutları kullanarak doğrudan kontrol edebilirsiniz. Komutların Linux türü bir işletim sistemi için geçerli olduğunu lütfen unutmayın. Başka bir işletim sistemi (Windows) kullanıyorsanız lütfen (cd, dir ve type) gibi eşdeğer komutları kullanın.
8. Deneyebileceğiniz kullanım alanları
Antigravity CLI, hem geliştiriciler hem de geliştirici olmayanlar için geçerli olan çok çeşitli kullanım alanlarında uygulanabilir. Burada birkaç senaryo sunulmuştur. İlgi alanınıza bağlı olarak bu senaryolardan herhangi birini veya tümünü deneyebilirsiniz.
Bu durumlarda istem sağlanır. Antigravity CLI'nın görevini nasıl yerine getirdiğini daha iyi anlamak için bunu Antigravity CLI etkileşimli modunda deneyebilirsiniz.
Antigravity CLI ile sezgisel kodlama
Bir uygulamayı vibe code etmek için Antigravity CLI'yı kullanalım. Bu görevde, Antigravity CLI'dan bir uygulama oluşturmasını isteyecek ve ardından ilk sürümü bir GitHub deposuna göndereceksiniz.
Ön koşul
Bu bölümdeki görevleri gerçekleştirmek için birkaç ön koşul vardır:
- Git
- Antigravity CLI
- Python 3 ortamı
- Setup
gh( GitHub CLI aracı). - Git'in temelleri ve biraz programlama bilgisi
Antigravity CLI'yı seçtiğiniz belirli bir klasörde başlattığınızı varsayacağız. Bizim durumumuzda, Antigravity CLI'yi ilk ana klasörden agy-cli-projects ve bu klasörün içindeki başka bir klasörden bq-releases-notes başlattık.
İlk istemle başlayın. Bunu, uygulamanızın spesifikasyonu olarak düşünebilirsiniz. İstediğiniz gibi değiştirebilirsiniz. Antigravity CLI ile oturum boyunca dosya oluşturma gibi işlemler için izin isteyeceğini unutmayın. Gerekli izinleri verin.
Please build a web application for me using Python Flask and plain vanilla HTML, JavaScript and CSS that fetches the BigQuery Release notes from (https://docs.cloud.google.com/feeds/bigquery-release-notes.xml) and shows them to me.
A simple refresh button with a spinner is good enough, anytime I'd like to refresh the details.
I would also like the ability to take any specific update, select it and then Tweet about it.
Aşağıdaki birkaç istem ve yanıt, gözlemlenen örnek bir akışı gösterir. Antigravity CLI bir plan oluşturur ve onay / açıklama ister ya da devam eder. Lütfen talimatları uygulayın. Örnek olarak, örnek sohbet dizim:
I will start by exploring the workspace to see if there is an existing structure or if this is a brand new project.
● ListDir(/Users/romin/agy-cli-projects/bq-release-notes) (ctrl+o to expand)
I will read the BigQuery release notes XML feed to understand its structure (Atom/RSS elements, entry/item elements, namespaces, dates, titles, content) so that we can parse it
correctly in the Python Flask backend.
● ReadURL(https://docs.cloud.google.com/feeds/bigquery-release-notes.xml) (ctrl+o to expand)
I will view the fetched feed content saved locally to understand its format and structure.
● Read(/Users/romin/.gemini/antigravity-cli/brain/116191af-e6ea-4ba5-aa23-62f995bd068a/.system_generated/steps/6/content.md) (ctrl+o to expand)
▸ Thought for 2s, 2.3k tokens
Analyzing XML Feed Structure
I will write the implementation plan detailing the architecture, design aesthetic, components, and verification steps for the BigQuery Release Notes Web Application. This plan will be
written to the artifacts directory.
● Create(/Users/romin/.gemini/antigravity-cli/brain/116191af-e6ea-4ba5-aa23-62f995bd068a/implementation_plan.md) (ctrl+o to expand)
I have created the implementation_plan.md to outline the design and architecture of the BigQuery Release Notes Web Application.
Please review the plan, especially the approach for the Twitter Composer & Preview Card, and let me know if you approve or if there are any adjustments you'd like to make!
1 artifact · /artifact to review
Antigravity'de Artifacts'in ne olduğunu anlamanın zamanı geldi. Artifacts, Antigravity CLI'nın bizi uygulama planı, üzerinde çalıştığı görevlerin listesi, doğrulanabilir çıktılar ve daha fazlası hakkında bilgilendirme şeklidir. Bu dosyalar oluşturulur ve Antigravity'nin yaptığı çalışmaların, planının, görev listesinin ve daha fazlasının kaydıdır.
Bunu yaptıktan sonra "BigQuery Sürüm Notları Web Uygulamasının tasarımını ve mimarisini özetlemek için implementation_plan.md oluşturdum. Lütfen planı, özellikle Twitter Composer ve önizleme kartı yaklaşımını inceleyin ve onaylayıp onaylamadığınızı veya yapmak istediğiniz ayarlamalar olup olmadığını bana bildirin."
Sağ altta 1 incelemeye hazır öğe olduğu da belirtiliyor. Bu örnekte, incelemeye hazır öğe implementation_plan.md.
/artifact komutunu verin. Bu işlem, oluşturulan yapıyı gösterir implementation_plan.md. Ok tuşlarını kullanarak yapıyı açabilir, onaylayabilir, reddedebilir vb. Escape tuşuna basıp isteme geri dönün. İsterseniz burada isteği onaylayabilirsiniz.
Bu örnekte, oluşturulan yanıtı onaylayacağız. Bu işlem, sonraki adımları başlatır. Bu adımlarda uygulama başlatılır (ör. dosyalar oluşturulur, birkaç komut çalıştırılır vb.). Gerekli durumlarda onaylamanız ve yürütme izni vermeniz istenir.
Bizim durumumuzda, Python sanal ortamını oluşturması, bağımlılıkları requirements.txt aracılığıyla yüklemesi vb. için onay verdik.
Ayrıca, uygulama planına göre yapması gereken görevlerin bir parçası olarak arka planda bir task.md dosyası oluşturur ve tamamladığı görevleri işaretler. İşlem tamamlandığında size bildirilir ve uygulamayı tarayıcıda kontrol edebilirsiniz. İşte bizim için oluşturduğu sonuç:
Şimdilik durabiliriz. Buradaki amaç, basit gereksinimlerle neler yapabileceğini göstermek ve kontrol etmekti.
(İsteğe bağlı) Değişiklikleri bir GitHub deposuna aktarma
Oluşturduğumuz etkinlik web sitesini GitHub'a göndermek istemiyorsanız bu bölümü atlayıp bir sonraki bölüme geçebilirsiniz.
Öncelikle bir .gitignore dosyası oluşturalım. Bu işlem için Antigravity CLI'dan yardım alabilirsiniz.
Create a .gitignore file for this project.
Bir sonraki adımda, Antigravity CLI'ya bu depoyu GitHub hesabımızda gönderme talimatı vermeniz gerekir. Bu işlem için makinenizde kullanılabilir ve yapılandırılmış / kurulmuş olması gereken GitHub yardımcı programı (gh) kullanılmalıdır. Bu işlem, arka planda GitHub MCP sunucu araçlarını kullanır.
Aşağıdakine benzer bir istem girin:
Great! I would now like to push all of this to a new repository in my GitHub account. I would like to name this repository <Your-Name>-event-talks-app
Burada çeşitli komutlar çalıştırılır:
- Depoyu oluşturun.
- Yerel Git deposunu yönetmek için init, add, commit gibi birden fazla Git komutu kullanılır.
- Ardından, Git remote'u kurar ve push işlemi yapar.
Her şey yolunda giderse GitHub deponuz hazır olur. Github deposu sayfasını ziyaret edebilirsiniz. Örnek ekran görüntüsü aşağıda gösterilmektedir:
Bu proje için README.md oluşturmadığınızı ve bunun, şimdi oluşturduğunuz bu depoyla çalışacağımız bir sonraki bölüm için iyi bir alıştırma olduğunu unutmayın.
Kod deposuyla çalışmak için Antigravity CLI'yı kullanma
Bu kullanım alanında, kod deposuyla çalışmak için Antigravity CLI'yı kullanmanız gerekir. Aşağıdakiler de dahil olmak üzere birden fazla görev gerçekleştireceksiniz:
- Kod tabanını anlama
- Belge oluşturma
- Yeni bir özelliği uygulama
Bu, depolarınızla çalışmak ve Antigravity CLI'yı geliştiricilere özel bu görevler için asistan olarak kullanmak üzere iyi bir temel oluşturmanızı sağlar.
Ön koşul
Bu bölümdeki görevleri gerçekleştirmek için aşağıdakileri yapmanız gerekir:
- Antigravity CLI
- Önceki bölümü tamamlamış ve BigQuery sürüm notları okuyucusu oluşturduğumuz yerde oluşturulan kodu hazır bulunduruyor olmanız gerekir.
BigQuery sürüm notları uygulamasını oluşturmak için kullandığınız klasör/dizinden Antigravity CLI'yı kullanmaya devam edelim.
Aşağıda listelenen istemleri deneyin:
Kod tabanını anlama
- Bu projeyi ayrıntılı olarak anlamak istiyorum. Temel özellikleri anlamama yardımcı ol ve bunları sunucu ve istemci tarafı olarak ayır. Örnek bir akış al ve istek ile yanıtın nasıl çalıştığını göster. Yeni bir dosya (yapı) oluşturulacağını ve tüm yapıları ya da belirli yapıları**
/artifact** **komutuyla görüntüleyebileceğinizi unutmayın.** @app.pykimlikli denemeyi açıkla
README dosyası oluşturma
- Bu proje için
READMEdosyası oluştur.
Yeni bir özelliği uygulama
- Lütfen iki basit yardımcı özellik uygulayın: Her kartta "Panoya Kopyala" düğmesi ve "CSV'ye Aktar" düğmesi.
- Lütfen CSS kök değişkenlerini geçersiz kılarak sayfanın renk şemasını koyu moddan açık moda değiştiren basit bir açma/kapatma düğmesini üstbilgiye ekleyin.
Onaylayabileceğiniz bir plan sunulur. Onaylandıktan sonra Antigravity CLI bu değişiklikleri yapar. Değişikliklerinizi test edin ve hatalar varsa (büyük olasılıkla) Antigravity CLI'dan bunları düzeltmesini isteyin.
Önerilen özelliklere göre sorun oluşturma
Burada ilginç bir şey deneyelim. Antigravity CLI'ya bu uygulamanın kullanıcı deneyimini nasıl iyileştirebileceğini soracaksınız.
Aşağıdaki istemi deneyin:
- Uygulamayı kullanıcı deneyimi açısından değerlendirmeni istiyorum. Kullanım kolaylığı, duyarlılık, faydalı mesajlar ve daha fazlası. Lütfen bir iyileştirme listesi oluşturun ve bunları bana liste olarak sunun.
Takip eden adımda, daha önce oluşturulan sorunlardan birini alıp Antigravity CLI'dan bu sorunu çözmesini ve uygulamasını isteyebilirsiniz.
(İsteğe bağlı) Günlük Görevler
Aşağıda verilen kullanım alanları, düzenli olarak yapmanız gereken görevlerdir. Örneğin, dosyaları klasörler halinde düzenleme, web'deki içerikleri getirme ve özetleme, resim dosyalarını işleme ve bu dosyalardan içerik ayıklama, veritabanlarıyla çalışma gibi işlemler bu kapsamdadır.
İstediğiniz kullanım alanlarını inceleyebilirsiniz.
Dosyaları/Klasörleri Düzenleme
Antigravity CLI'yı kullanarak dosyaları, gerektiğinde çeşitli klasörlerde türlerine göre düzenleyebilirsiniz. Makinenizde .txt, .png, .jpg, .pdf, .mp4 ve diğer uzantılı dosyaların bulunduğu bir klasöre gidin. Bu klasör büyük olasılıkla Masaüstü veya İndirilenler klasörünüzdür.
İlgili klasöre gidip Antigravity CLI'yı başlatın. Öncelikle Antigravity CLI'dan şu klasörleri oluşturmasını isteyeceksiniz: Resimler, Dokümanlar, Videolar. Ardından Antigravity CLI'dan klasörlerdeki dosyaları düzenlemesini isteyeceksiniz.
Antigravity CLI, özellikle dosya sisteminizi değiştiren (ör. dosya yazma, taşıma veya silme) komutları yürütmeden önce genellikle sizden izin ister. İzin vermeden önce bu istemleri her zaman dikkatlice inceleyin. Bu, güvenlik önleminizdir.
Create the following folders "Images","Documents","Videos"
Ardından aşağıdaki istemi girin:
Go through all the files in this folder and then organize them by moving all the files ending with .jpg, .jpeg, .gif into the "Images" folder. Move all ".txt" files into the "Documents" folder. Move all the ".mp4" files in the "Videos" folder.
Makinenizde çalıştırılan bir örneği aşağıda görebilirsiniz:
I have completed organizing your files into their respective folders. Here is a summary of the files moved:
• Images: Moved 95 files ending in .jpg or .jpeg (no .gif files were present).
• Documents: Moved 1 file ending in .txt ( 12March_Live_chat_transcript.txt ).
• Videos: Moved 26 files ending in .mp4 .
Diğer bazı düzenleme senaryoları (istemler her senaryonun yanında verilmiştir):
- Özetleme: "Belgeler" klasöründeki her belge için aynı klasörde "summary_ORIGINAL_FILENAME.txt" adlı bir txt dosyası oluşturun. Bu dosya, belgenin ana noktalarının 3 cümlelik özetini içermelidir.
- Türe Göre Kategorize Etme: Bu dizindeki tüm PDF ve DOCX dosyalarını tarayın. Adında veya içeriğinde "fatura" kelimesi geçen tüm dosyaları "Finansal/Faturalar" klasörüne taşı. "Makbuz" içeren dosyaları "Finansal/Makbuzlar" klasörüne taşıyın. Diğer tüm .docx dosyaları "Raporlar" klasörüne gider.
- Önemli bilgileri çıkarma (ve "etiketleme"): "Financial/Invoices" (Finansal/Faturalar) klasöründeki her PDF dosyasının içeriğini okuyun. Bir tarih bulursanız dosyayı, bu tarihi YYYY-AA-GG biçiminde içerecek şekilde yeniden adlandırın (ör. "invoice_2025-07-26_original_name.pdf").
Makaleleri Özetleme (Yerel Dosyalar veya Web)
Aşağıdaki senaryoların her birinde, URL'yi, ilgi alanını ve yerel dosya adlarını uygun şekilde değiştirebilirsiniz. Sağlanan dosya adları örnek dosya adlarıdır. Bunları sisteminizdeki dosyaların dosya adlarıyla değiştirebilirsiniz.
Aşağıdaki senaryolardan herhangi birini deneyin (istemler her senaryonun yanında verilmiştir):
- Bir web makalesini özetleme (tek URL): https://medium.com/google-cloud/antigravity-cli-tutorial-series-12b46cfe3bf2 adresine gidin ve bu haber makalesinden çıkarılacak en önemli 3 sonucu özetleyin.
- Birden fazla web makalesini özetleme (ör. arama sonuçlarından): Google Arama'yı kullanarak "Antigravity CLI" ile ilgili en son haber makalelerini bulun. En alakalı ilk 5 makaleyi 2-3 cümleyle özetleyin ve URL'lerini listeleyin.
- Yerel bir metin dosyasını özetleme: "my_research_paper.txt" dosyasındaki makalenin ana noktalarını özetle. Metodolojiye ve sonuçlara odaklanın.
- Yerel bir PDF'yi özetleme: "financial_report_Q2_2025.pdf" dosyasını oku. Bahsedilen finansal performansın ve temel zorlukların bir özetini sağlayın.
Belirli Bilgileri Çıkarma (Yerel Dosyalar veya Web)
Aşağıdaki senaryoların her birinde, URL'yi, ilgi alanını ve yerel dosya adlarını uygun şekilde değiştirebilirsiniz. Sağlanan dosya adları örnek dosya adlarıdır. Bunları sisteminizdeki dosyaların dosya adlarıyla değiştirebilirsiniz.
Aşağıdaki senaryolardan herhangi birini deneyin (istemler her senaryonun yanında verilmiştir):
- Yerel bir makaleden öğe ayıklama: "biyografi.txt" dosyasındaki tüm kişilerin adlarını ve onlarla ilişkili önemli tarihleri listeleyin.
- PDF'deki bir tablodan veri ayıklama: "quarterly_sales.pdf" dosyasında, 3. sayfadaki "Bölgeye Göre Ürün Satışları" tablosundan verileri ayıklayıp Markdown tablo biçiminde sun.
- Bir haber web sitesinden haber başlıklarını ve kaynaklarını ayıklama: "https://news.google.com/" (veya benzer bir haber sitesi) adresine gidin. Ön sayfadaki ana başlıkları ve ilgili haber kaynaklarını ayıklayın. Bunları madde işaretli liste olarak sun.
- E-ticaret sayfasından ürün spesifikasyonlarını bulma: "https://www.amazon.in/Google-Cloud-Certified-Associate-Engineer/dp/1119871441" adresine gidin (kitap örneği). Kitap başlığını, yazarı ve diğer ayrıntıları çıkarır. Bunu yapılandırılmış bir JSON biçiminde sun.
- Belirli bir biçimde (ör. "2s37dk42sn") videodan süreyi ayıklayın.
İçeriğe Dayalı Soruları Yanıtlama (RAG benzeri davranış) [Answering Questions based on Content (RAG-like behavior)]
Aşağıdaki senaryoların her birinde, URL'yi, ilgi alanını ve yerel dosya adlarını uygun şekilde değiştirebilirsiniz. Sağlanan dosya adları örnek dosya adlarıdır. Bunları sisteminizdeki dosyaların dosya adlarıyla değiştirebilirsiniz.
Aşağıdaki senaryolardan herhangi birini deneyin (istemler her senaryonun yanında verilmiştir):
- Yerel bir dokümanla ilgili soru-cevap: "user_manual.pdf" dosyasını ekliyorum. Ağ bağlantısı sorunlarını gidermek için hangi adımlar uygulanır?
- Web sayfasında soru-cevap: "https://www.who.int/news-room/fact-sheets/detail/climate-change-and-health" adresindeki içeriği kullanarak, DSÖ'ye göre iklim değişikliğiyle ilişkili başlıca sağlık riskleri nelerdir?
- Birden fazla kaynaktaki bilgileri karşılaştır: "article1.txt" ve "article2.txt" adlı iki haber makalem var. Her ikisinde de son ekonomik politika değişiklikleri ele alınıyor. Küçük işletmeler üzerindeki potansiyel etkiyle ilgili görüşlerini karşılaştırın ve aralarındaki farkları belirtin.
Ayıklanan bilgilere dayalı içerik oluşturma
Aşağıdaki senaryoların her birinde URL'yi, ilgi alanını ve yerel dosya adlarını uygun şekilde değiştirebilirsiniz.
Aşağıdaki senaryolardan herhangi birini deneyin (istemler her senaryonun yanında verilmiştir):
- Bir makaleden haber özeti oluşturma: @tech_innovation_article.txt dosyasını oku. Yeni teknolojiyi ve potansiyelini vurgulayan, şirket bülteni için uygun, kısa ve ilgi çekici bir haber özeti (yaklaşık 150 kelime) yaz.
- Toplantı transkriptini özetleyen bir e-posta taslağı oluştur: Toplantı transkripti dosyası: @meeting_transcript.txt. Ekibe, alınan önemli kararları ve atanan yapılacak işleri (her birinden kimin sorumlu olduğu dahil) özetleyen bir e-posta taslağı oluştur.
Antigravity CLI'da çok formatlı destek
Antigraity CLI, Gemini aracılığıyla çoklu model desteğine sahiptir ve farklı içerik biçimlerindeki dosyaları gereksinimlerinize göre işlemesini isteyebilirsiniz.
Antigraity CLI ile bir grup fatura resmini işleyip bunlardan önemli bilgileri çıkaracaksınız. Aşağıdaki adımları uygulayın:
- Makinenizde bir klasör oluşturun ve aşağıdaki GitHub deposundan bazı faturaları indirin.
- Antigravity CLI'yı bu klasörden başlatın.
Faturalardaki bilgileri tablo şeklinde ayıklamak için aşağıdaki istemi girin.
The current folder contains a list of invoice files in Image format. Go through all the files in this folder and extract the following invoice information in the form of a table: Invoice No, Invoice Date, Invoice Sent By, Due Date, Due Amount.
İdeal olarak şu şekilde bir çıkış almanız gerekir:
Türetilmiş ek sütunlar isteyebileceğiniz başka bir senaryo: Geçmişteki tüm fatura son ödeme tarihleri için kırmızı çarpı emojisi göstermek istediğinizi varsayalım. Aşağıdaki gibi bir istem girebilirsiniz:
list all files with .png extension in this folder. Extract the invoice information from it by reading them locally and display it in a table format containing the following column headers: : Invoice No, Invoice Date, Invoice Sent By, Due Date, Due Amount. Add a column at the end of the table that shows a red cross emoji in case the due date is in the past.
Bu işlem aşağıdaki çıkışı üretir:
Bu özelliği, metin biçiminde olmayan kendi dosyalarınızda kullanabilirsiniz.
Veri oluşturmak için Antigravity CLI'ı kullanma
Antigravity CLI'dan çeşitli veri biçimlerinde veri üretmesini isteyebilirsiniz. Bu, içerik parçalarından, taklit etmeniz gerekebilecek JSON verilerine kadar değişebilir. Burada geliştiriciler/test kullanıcıları için geçerli olan senaryolara odaklanacağız.
Deneyebileceğiniz bazı istemler:
Örnek müşteri yorumlarının JSON verilerini oluşturma
Generate a JSON array of 3 synthetic customer reviews for a new smartphone. Each review should have 'reviewId' (string, UUID-like), 'productId' (string, e.g., 'SMARTPHONE_X'), 'rating' (integer, 1-5), 'reviewText' (string, 20-50 words), and 'reviewDate' (string, YYYY-MM-DD format).
Sahte API yanıtları oluşturma (JSON)
Generate a JSON array representing 7 daily sales records for a mock API endpoint. Each record should include 'date' (YYYY-MM-DD, chronologically increasing), 'revenue' (float, between 5000.00 and 20000.00), 'unitsSold' (integer, between 100 and 500), and 'region' (string, either 'North', 'South', 'East', 'West').
Örnek Veritabanı Ekleme İfadeleri Oluşturma (SQL)
Generate 5 SQL INSERT statements for a table named 'users' with columns: 'id' (INTEGER, primary key), 'username' (VARCHAR(50), unique), 'email' (VARCHAR(100)), 'password_hash' (VARCHAR(255)), 'created_at' (DATETIME, current timestamp). Ensure the password_hash is a placeholder string like 'hashed_password_X'.
Veri yükleme/analiz için CSV verileri oluşturma
Generate 10 lines of CSV data, including a header row, for customer transactions. Columns should be: 'TransactionID' (unique string), 'CustomerID' (integer), 'ItemPurchased' (string, e.g., 'Laptop', 'Monitor', 'Keyboard'), 'Quantity' (integer, 1-3), 'UnitPrice' (float, between 100.00 and 1500.00), 'TransactionDate' (YYYY-MM-DD).
Yapılandırma dosyası (YAML) oluşturma
Generate a sample YAML configuration for a 'user_service'. Include sections for 'database' with 'host', 'port', 'username', 'password', 'database_name'. Also include a 'api_keys' section with 'payment_gateway' and 'email_service' placeholders. Use realistic default values.
Sınır durumları/doğrulama için test verileri oluşturma
Generate a JSON array of 8 email addresses for testing purposes. Include a mix of: 2 valid standard emails, 2 with missing '@', 2 with invalid domains (e.g., '.com1'), and 2 with special characters in the local part that are usually invalid (e.g., spaces or multiple dots).
9. Tebrikler
Tebrikler, Antigravity CLI'yı, özelliklerini başarıyla keşfettiniz ve birkaç kullanım alanında uyguladınız.