Trải nghiệm thực tế với Antigravity CLI

1. Giới thiệu

Trong lớp học lập trình này, bạn sẽ tìm hiểu về Antigravity CLI, một giao diện người dùng đầu cuối (TUI) đơn giản của Antigravity. Nền tảng này mang đến những chức năng cốt lõi tương tự như Antigravity 2.0 (chẳng hạn như suy luận nhiều bước, chỉnh sửa nhiều tệp, gọi công cụ và nhật ký trò chuyện) ngay trên thiết bị đầu cuối của bạn.

Kiến thức bạn sẽ học được

  1. Cài đặt và định cấu hình Antigravity CLI
  2. Tìm hiểu cách sử dụng cơ bản Antigravity CLI
  3. Khám phá một số trường hợp sử dụng với Antigravity CLI

Bạn cần có

Bạn sẽ cần những thông tin sau:

  • Trình duyệt web Chrome
  • Tài khoản Gmail

Lớp học lập trình này được thiết kế cho người dùng và nhà phát triển ở mọi cấp độ (kể cả người mới bắt đầu). Các trường hợp sử dụng trong lớp học lập trình được phân loại thành các nhiệm vụ dành cho nhà phát triển và không dành cho nhà phát triển. Các trường hợp sử dụng của nhà phát triển minh hoạ cách sử dụng mã rung với Antigravity CLI và cách làm việc với một kho lưu trữ trên GitHub để thực hiện các tác vụ phát triển phổ biến như giải thích/hiểu mã, tạo tài liệu, khắc phục vấn đề, v.v. Bạn nên hoàn tất các trường hợp sử dụng này trong lớp học lập trình. Có một phần không bắt buộc ở cuối, bao gồm một số việc cần làm hằng ngày không dành cho nhà phát triển.

2. Trước khi bắt đầu

Tạo dự án

  1. Trong Google Cloud Console, trên trang chọn dự án, hãy chọn hoặc tạo một dự án trên Google Cloud.
  2. Đảm bảo rằng bạn đã bật tính năng thanh toán cho dự án trên đám mây. Tìm hiểu cách kiểm tra xem tính năng thanh toán có được bật trên một dự án hay không.
  3. Bạn sẽ sử dụng Cloud Shell, một môi trường dòng lệnh chạy trong Google Cloud và được tải sẵn bằng bq. Nhấp vào Kích hoạt Cloud Shell ở đầu bảng điều khiển Cloud.

Hình ảnh nút Kích hoạt Cloud Shell

  1. Sau khi kết nối với Cloud Shell, bạn có thể kiểm tra để đảm bảo rằng bạn đã được xác thực và dự án được đặt thành mã dự án của bạn bằng lệnh sau:
gcloud auth list
  1. Chạy lệnh sau trong Cloud Shell để xác nhận rằng lệnh gcloud biết về dự án của bạn.
gcloud config list project
  1. Nếu bạn chưa đặt dự án, hãy dùng lệnh sau để đặt dự án:
gcloud config set project <YOUR_PROJECT_ID>

3. Cài đặt

Trước khi bạn thiết lập và chạy Antigravity CLI, hãy tạo một thư mục mà chúng ta sẽ dùng làm thư mục chính cho tất cả các dự án mà chúng ta tạo bên trong thư mục đó. Đây là điểm xuất phát để Antigravity CLI hoạt động, mặc dù nó cũng sẽ tham chiếu một số thư mục khác trên hệ thống của bạn và bạn sẽ truy cập vào các thư mục đó sau, nếu cần.

Tiếp tục tạo một thư mục mẫu (agy-cli-projects) rồi chuyển đến thư mục đó bằng các lệnh bên dưới. Nếu bạn muốn sử dụng một tên thư mục khác, vui lòng thực hiện.

mkdir agy-cli-projects

Hãy chuyển đến thư mục đó:

cd agy-cli-projects

Quá trình cài đặt rất đơn giản và các tệp nhị phân có sẵn trên các Hệ điều hành chính. Tôi đã lấy các lệnh để chạy trong thiết bị đầu cuối ngay từ tài liệu cài đặt:

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

Lệnh này sẽ thiết lập và cài đặt Antigravity CLI (agy) trong hệ thống và trong Path (Đường dẫn).

Trong một số trường hợp, nếu không thể thêm tệp nhị phân ( agy vào PATH), trình cài đặt sẽ cho bạn biết. Ví dụ: đây là một đầu ra mẫu trên một máy, trong đó trình cài đặt không thể thêm tệp nhị phân vào PATH và trình cài đặt đã đề xuất những việc cần làm.

% 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.

Bạn chỉ cần kiểm tra phiên bản Antigravity CLI bằng lệnh sau (phiên bản hiển thị là phiên bản tại thời điểm viết lớp học lập trình này):

$ agy --version
1.0.5

Khi bạn khởi chạy Antigravity CLI lần đầu tiên, công cụ này sẽ yêu cầu bạn đăng nhập. Hãy khởi chạy agy và bạn sẽ thấy nội dung tương tự như sau:

    ▄▀▀▄
   ▀▀▀▀▀▀
  ▀▀▀▀▀▀▀▀
 ▄▀▀    ▀▀▄
▄▀▀      ▀▀▄

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]

Hiện tại, hãy sử dụng tài khoản cá nhân của bạn. Chọn 1. Google OAuth rồi nhấn Enter. Thao tác này sẽ khởi chạy một trình duyệt và bạn có thể đăng nhập bằng Tài khoản Google của mình. Sau khi xác thực và uỷ quyền thành công, bạn sẽ được yêu cầu sao chép một mã. Vui lòng quay lại thiết bị đầu cuối Antigravity CLI rồi dán mã đó.

Sau khi bạn đăng nhập thành công, một số điều sau sẽ xảy ra:

  1. Trước tiên, công cụ này sẽ hỏi bạn về chủ đề màu sắc mà bạn muốn chọn cho Antigravity CLI, như minh hoạ bên dưới. Chọn một kiểu bạn thích.
  2. Tiếp theo, bạn cần chấp nhận một số điều khoản dịch vụ. Chấp nhận những yêu cầu đó.

Cuối cùng, điều quan trọng nhất là bạn phải cấp quyền để cho biết bạn tin tưởng thư mục đó, như minh hoạ dưới đây:

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

Bạn thường thấy điều này trong mọi thư mục mới mà bạn khởi chạy Antigravity CLI. Chúng ta sẽ tìm hiểu thêm về vấn đề này ở phần sau của loạt video, nhưng hiện tại, hãy cứ chọn Có, tôi tin tưởng thư mục này.

Xin chúc mừng! Bạn đã hoàn tất và Antigravity CLI đang chờ câu lệnh của bạn.

4. Lần tương tác đầu tiên của chúng ta với Antigravity CLI

Hãy bắt đầu bằng Antigravity CLI và nhập truy vấn đầu tiên của bạn như minh hoạ dưới đây:

Give me a famous quote on Artificial Intelligence and who said that?

Sau đây là phản hồi dự kiến:

● 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         
  

Bạn sẽ nhận thấy rằng Antigravity đã sử dụng một trong những công cụ nội bộ của mình là WebSearch để lấy câu trích dẫn.

Ngoài việc đưa ra lời nhắc tại đây, Antigravity CLI còn hỗ trợ những lệnh nào khác? Bạn có thể tìm thấy thông tin đó bằng cách nhập /help (dấu gạch chéo) và bạn sẽ thấy nhiều lệnh cũng như tổ hợp phím. Dưới đây là một số lệnh tại thời điểm viết bài:

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>

Tạm thời thoát khỏi Antigravity CLI. Bạn có thể thực hiện việc này thông qua lệnh /quit hoặc nhấn ctrl+d hai lần trong phiên tương tác của Antigravity CLI.

5. Antigravity CLI – một số lệnh dọn dẹp

Đảm bảo rằng Antigravity CLI đã được khởi chạy và đang chờ lệnh của bạn.

Hãy chú ý đến mô hình mà ứng dụng đang sử dụng. Tên của mô hình này sẽ xuất hiện ở dưới cùng bên phải. Điều đầu tiên bạn cần hiểu là hầu hết các chế độ tuỳ chỉnh và chế độ cài đặt mà bạn cần thực hiện đều có sẵn thông qua lệnh /config hoặc /settings.

Cấu hình / Chế độ cài đặt

Tiếp tục và gọi lệnh /config. Thao tác này sẽ mở ra nhiều phần của Antigravity mà bạn có thể tuỳ chỉnh theo ý thích. Trong đó bao gồm Bảng phối màu, Quyền truy cập vào công cụ, chế độ cài đặt đo từ xa và nhiều chế độ khác.

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

Ví dụ: Bảng phối màu sẽ hiển thị các lựa chọn sau đây, trong đó tôi có thể chọn bảng phối màu mà mình muốn:

 Color Scheme                   ╭─────────────────────────────────────────────────────────────╮
    terminal                     │   
    light                        │                                                             
    solarized light              │                                         
    colorblind-friendly light    │                                                             
  > dark (current)               │                                            
    solarized dark               │                                                           
    colorblind-friendly dark     │                                      
    tokyo night      

settings.json

Bạn cần lưu trữ các chế độ cài đặt cấu hình ở một nơi nào đó, phải không? Tất cả các chế độ cài đặt này đều được lưu trữ trong tệp ~/.gemini/antigravity-cli/settings.json. Dưới đây là một ví dụ:

{
      "colorScheme": "dark",
      "model": "Gemini 3.5 Flash (High)",
      "statusLine": {
        "type": "",
        "command": "",
        "enabled": true
      },
      "trustedWorkspaces": [
        "/Users/romin/antigravity-cli-projects",
        "/Users/romin/agy-cli-projects"
      ]
    }

Bạn có thể thấy colorScheme mà tôi đã chọn, mô hình và nhiều thư mục khác mà tôi đã bắt đầu Antigravity CLI và đồng ý tin tưởng các thư mục đó.

Lưu ý: Bạn cũng có thể sửa đổi trực tiếp settings.json và khởi động lại Antigravity CLI để xem các thay đổi. Tuy nhiên, hãy đảm bảo bạn nắm rõ các chế độ cài đặt, nếu không, hệ thống sẽ hiển thị lỗi khi khởi động. Nếu không muốn sửa đổi trực tiếp tệp này, bạn nên dùng lệnh /settings hoặc /config trong Antigravity CLI để thao tác với tệp này.

Quyền truy cập vào công cụ

Một chế độ cài đặt quan trọng mà bạn cần hiểu là Quyền sử dụng công cụ. Chế độ này kiểm soát việc các lệnh trong dòng lệnh có cần bạn phê duyệt trước khi chạy hay không. Bạn có thể truy cập vào phần này thông qua lệnh /config.

 Tool Permission
  > request-review (current)
    proceed-in-sandbox
    always-proceed
    strict

Theo mặc định, giá trị này được đặt thành request-review. Hãy cùng tìm hiểu chi tiết hơn về vấn đề này. Trong Antigravity, chế độ cài đặt Quyền truy cập vào công cụ kiểm soát sự cân bằng giữa tính bảo mật (bảo vệ hệ thống máy chủ khỏi những thay đổi không mong muốn) và tốc độ (mức độ tự động của tác nhân mà không cần tạm dừng để chờ bạn nhập dữ liệu). Hãy xem các lựa chọn:

request-review (Mặc định hiện tại)

Ở chế độ này, tác nhân được coi là một đối tác cộng tác, sẽ kiểm tra trước khi thực hiện bất kỳ hành động nào có thể ảnh hưởng đến hệ thống hoặc tệp dự án của bạn bên ngoài các giới hạn được phê duyệt trước. Mỗi khi tác nhân cố gắng chạy một lệnh trên thiết bị đầu cuối, thực hiện một thao tác trên tệp (chẳng hạn như ghi/xoá) hoặc gọi một dịch vụ bên ngoài mà chưa được phê duyệt trước, quá trình thực thi sẽ tạm dừng. Người dùng được nhắc phê duyệt hoặc từ chối hành động cụ thể.

proceed-in-sandbox

Chế độ này cho phép tác nhân tự động thực thi các lệnh trên thiết bị đầu cuối, nhưng trong một vùng chứa biệt lập, an toàn. Tác nhân có thể chạy các lệnh mà không cần nhắc bạn, nhưng những lệnh đó sẽ được thực thi trong một hộp cát ảo hoá (ví dụ: một vùng chứa gọn nhẹ). Chúng không thể sửa đổi hệ thống tệp của máy chủ lưu trữ thực tế hoặc truy cập vào mạng cục bộ của bạn.

always-proceed

Đây là chế độ hoàn toàn tự động, mang lại tốc độ và khả năng tối đa cho tác nhân. Tác nhân được cấp toàn bộ quyền chạy các lệnh và ghi tệp trực tiếp trên máy chủ lưu trữ của bạn. Tác nhân sẽ không bao giờ nhắc bạn xác nhận.

strict

Đây là chế độ không tin cậy, có tính bảo mật cao. Các chức năng của tác nhân bị hạn chế ở việc thực thi các công cụ đọc. Tất cả các công cụ không chỉ đọc đều sẽ yêu cầu người dùng được nhắc thực hiện hành động.

6. Antigravity CLI – Tham số lệnh

Có một số tham số dòng lệnh mà bạn có thể cung cấp khi khởi động Antigravity CLI. Để xem danh sách đầy đủ các lựa chọn, bạn có thể sử dụng --help như minh hoạ dưới đây.

agy --help

Thao tác này sẽ cho thấy đầy đủ các lựa chọn hiện có. Dưới đây là một ví dụ về danh sách:

$ 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

Hãy cùng xem xét một vài ví dụ.

Chế độ không tương tác (tự động)

Một lựa chọn thú vị là chạy Antigravity CLI ở chế độ không tương tác. Điều này có nghĩa là bạn cung cấp trực tiếp câu lệnh cho công cụ này và công cụ sẽ tiếp tục phản hồi câu lệnh đó mà không cần mở thiết bị đầu cuối tương tác Antigravity CLI. Điều này rất hữu ích nếu bạn dự định sử dụng Antigravity CLI theo cách tự động trong tập lệnh hoặc bất kỳ quy trình tự động hoá nào khác.

Bạn sử dụng tham số -p để cung cấp câu lệnh cho Antigravity CLI như minh hoạ dưới đây:

agy -p "What is the gcloud command to deploy to Cloud Run"

Đây có thể là một cách hay để nhận được câu trả lời nhanh, nhưng hãy lưu ý rằng bạn không thể tiếp tục cuộc trò chuyện bằng các câu hỏi tiếp theo.

Chọn một mô hình cụ thể

Cách đầu tiên là yêu cầu Antigravity CLI sử dụng một chế độ cụ thể của Gemini. Bạn có thể sử dụng tham số --model để yêu cầu Antigravity CLI chỉ sử dụng một mô hình cụ thể trong phiên hoạt động của nó. Điều này rất hữu ích cho chế độ không tương tác mà chúng ta đã đề cập trong phần trước, trong đó bạn muốn chạy một số phiên agy và sử dụng các mô hình cụ thể cho các tác vụ cụ thể.

Nhưng trước tiên, bạn cần biết những mô hình nào có sẵn cho Antigravity CLI. Bạn có thể thực hiện việc này thông qua lệnh con models như minh hoạ dưới đây:

$ 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)

Bạn có thể sử dụng bất kỳ tên mô hình nào trong số này để chỉ định mô hình sẽ được dùng cho phiên. Bạn có thể thực hiện việc này thông qua lệnh --model như minh hoạ bên dưới:

$ agy --model "Claude Opus 4.6 (Thinking)"

Sau khi Antigravity CLI khởi chạy, bạn có thể kiểm tra thông qua lệnh /model về mô hình cụ thể mà bạn yêu cầu sử dụng hoặc xem ở dưới cùng bên phải để biết mô hình được dùng cho phiên.

Sống mạo hiểm

Nếu thích mạo hiểm, bạn có thể tìm một tham số có tên rất phù hợp là --dangerously-skip-permissions. Thao tác này sẽ tự động phê duyệt tất cả các quyền đối với công cụ. Bạn sẽ không thấy lời nhắc yêu cầu cấp quyền. Vì vậy, hãy sử dụng tính năng này một cách cẩn thận.

Khởi chạy Antigravity CLI bằng lệnh sau:

agy --dangerously-skip-permissions

Sau đó, hãy đưa ra lời nhắc sau. Kiểm tra để đảm bảo rằng lời nhắc đó không yêu cầu tôi cấp bất kỳ quyền ghi tệp nào.

> 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.                                                        

Chế độ này có thể hữu ích trong những trường hợp mọi thứ đều nằm trong tầm kiểm soát của bạn, nhưng bạn vẫn cần chuẩn bị cho những điều bất ngờ và do đó, hãy sử dụng chế độ này một cách thận trọng.

7. Antigravity CLI – Chế độ Shell

Đây là thời điểm thích hợp để tìm hiểu cách làm việc trực tiếp với Shell trong Antigravity CLI. Bạn có thể chuyển sang chế độ shell bằng cách nhấn ! trong hộp tin nhắn. Thao tác này sẽ chuyển sang chế độ Shell. Bạn có thể quay lại bằng cách nhấn lại nút ! hoặc nhấn phím ESC.

Khi ở chế độ shell, bạn sẽ thấy biểu tượng ! ở đầu lời nhắc như minh hoạ dưới đây:

8019057be515e68f.png

Bạn có thể kiểm tra trực tiếp bằng các lệnh tiêu chuẩn như pwdls như minh hoạ bên dưới. Xin lưu ý rằng các lệnh này giả định một hệ điều hành loại Linux. Nếu bạn đang dùng một hệ điều hành khác (Windows), vui lòng sử dụng các lệnh tương đương như (cd, dirtype).

8. Các trường hợp sử dụng để thử

Bạn có thể áp dụng Antigravity CLI cho nhiều trường hợp sử dụng áp dụng cho cả nhà phát triển và người không phải là nhà phát triển. Sau đây là một số trường hợp và tuỳ thuộc vào lĩnh vực mà bạn quan tâm, bạn có thể thử bất kỳ hoặc tất cả các trường hợp này.

Trong mỗi trường hợp này, lời nhắc sẽ được cung cấp. Bạn có thể dùng thử chế độ tương tác của Antigravity CLI để hiểu rõ hơn về cách Antigravity CLI thực hiện nhiệm vụ của mình.

Lập trình theo cảm hứng bằng Antigravity CLI

Hãy sử dụng Antigravity CLI để tạo mã cho một ứng dụng. Trong nhiệm vụ này, bạn sẽ yêu cầu Antigravity CLI tạo một ứng dụng rồi đẩy phiên bản ban đầu vào một kho lưu trữ GitHub.

Điều kiện tiên quyết

Để thực hiện các tác vụ trong phần này, bạn cần đáp ứng một số điều kiện tiên quyết:

  • Git
  • Antigravity CLI
  • Môi trường Python 3
  • Thiết lập gh ( công cụ GitHub CLI).
  • Làm quen với các kiến thức cơ bản về Git và có một chút kiến thức về lập trình

Chúng tôi sẽ giả định rằng bạn đã chạy Antigravity CLI trong một thư mục cụ thể mà bạn chọn. Trong trường hợp của chúng tôi, chúng tôi đã chạy Antigravity CLI từ thư mục gốc ban đầu : agy-cli-projects và một thư mục khác bq-releases-notes bên trong thư mục đó.

Bắt đầu bằng một câu lệnh ban đầu. Hãy xem đây là một quy cách cho ứng dụng của bạn. Bạn có thể sửa đổi theo ý mình. Xin lưu ý rằng trong suốt phiên hoạt động với Antigravity CLI, công cụ này sẽ yêu cầu bạn cấp quyền tạo tệp, v.v. Hãy cấp các quyền cần thiết.

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.

Một vài câu lệnh và câu trả lời tiếp theo là một quy trình mẫu đã được quan sát. Antigravity CLI sẽ đưa ra một kế hoạch và yêu cầu bạn xác nhận / làm rõ hoặc tiếp tục. Vui lòng làm theo hướng dẫn. Ví dụ: đây là chuỗi hội thoại mẫu của tôi:

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

Đã đến lúc tìm hiểu về Thành phần trong Antigravity. Các cấu phần phần mềm là cách Antigravity CLI giúp chúng ta nắm được thông tin về kế hoạch triển khai, danh sách các tác vụ mà công cụ này đang thực hiện, các đầu ra có thể xác minh và nhiều thông tin khác. Đây là những tệp được tạo và là bản ghi về công việc mà Antigravity đang thực hiện, kế hoạch, danh sách việc cần làm và nhiều nội dung khác.

Sau đó, nó nói "Tôi đã tạo implementation_plan.md để vạch ra thiết kế và cấu trúc của Ứng dụng web Ghi chú phát hành BigQuery. Vui lòng xem xét kế hoạch này, đặc biệt là cách tiếp cận đối với Trình soạn thảo và Thẻ xem trước trên Twitter, đồng thời cho tôi biết liệu bạn có phê duyệt hay muốn điều chỉnh gì không nhé!"

Bạn có thể thấy rằng ở dưới cùng bên phải, thông báo cũng đề cập đến việc có 1 Artifact to review (1 hiện vật cần xem xét) và trong trường hợp này, đó là implementation_plan.md.

Đưa ra lệnh /artifact. Thao tác này sẽ hiển thị cấu phần phần mềm mà nó đã tạo implementation_plan.md và bạn có thể dùng các phím mũi tên để mở, phê duyệt, từ chối, v.v. Chỉ cần nhấn Escape rồi quay lại câu lệnh, bạn có thể phê duyệt câu lệnh đó nếu muốn.

Trong trường hợp này, chúng ta sẽ sử dụng nội dung mà AI tạo sinh đã tạo và phê duyệt nội dung đó. Thao tác này sẽ bắt đầu một loạt các bước tiếp theo, trong đó thao tác này sẽ bắt đầu quá trình triển khai, tức là tạo tệp, chạy một số lệnh, v.v. Bạn sẽ được nhắc phê duyệt và cấp quyền thực thi (nếu cần).

Trong trường hợp này, chúng ta đã cho phép tạo môi trường ảo Python, cài đặt các phần phụ thuộc thông qua requirements.txt, v.v.

Ở chế độ nền, ứng dụng này cũng đã tạo một tệp task.md trong số những việc cần làm dựa trên kế hoạch triển khai và đánh dấu vào từng việc khi hoàn thành. Sau khi hoàn tất, ứng dụng sẽ thông báo cho bạn và bạn có thể kiểm tra ứng dụng trong trình duyệt. Sau đây là nội dung mà công cụ này đã tạo cho chúng tôi:

366a66b7a4249b18.png

Chúng ta có thể dừng lại ở đây. Ý tưởng này là để minh hoạ và kiểm tra những gì có thể làm với các yêu cầu đơn giản.

(Không bắt buộc) Đẩy các thay đổi vào kho lưu trữ GitHub

Nếu không muốn chuyển trang web sự kiện mà chúng tôi đã tạo lên GitHub, bạn có thể bỏ qua phần này và chuyển sang phần tiếp theo.

Trước tiên, hãy tạo một tệp .gitignore và bạn có thể sử dụng Antigravity CLI.

Create a .gitignore file for this project.

Bước tiếp theo bạn cần làm là đưa ra hướng dẫn cho Antigravity CLI để đẩy kho lưu trữ này vào tài khoản GitHub của chúng tôi. Việc này sẽ sử dụng trình trợ giúp Github (gh) dự kiến sẽ có sẵn và được định cấu hình / thiết lập trên máy của bạn. Các công cụ GitHub MCP Server ở chế độ nền.

Đưa ra một câu lệnh tương tự như câu lệnh bên dưới:

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

Thao tác này sẽ thực hiện một số lệnh sau:

  1. Tạo kho lưu trữ.
  2. Thao tác này sẽ sử dụng nhiều lệnh Git : init, add, commit để quản lý kho lưu trữ Git cục bộ.
  3. Sau đó, nó sẽ thiết lập Git từ xa và thực hiện thao tác đẩy

Nếu mọi việc diễn ra suôn sẻ, bạn sẽ có một kho lưu trữ GitHub. Bạn có thể truy cập trang kho lưu trữ trên GitHub. Dưới đây là ảnh chụp màn hình mẫu:

b393c67b13ddf19a.png

Xin lưu ý rằng bạn chưa tạo README.md cho dự án này và đó là một bài tập hay cho phần tiếp theo, nơi chúng ta sẽ làm việc với kho lưu trữ mà bạn vừa tạo.

Sử dụng Antigravity CLI để làm việc với kho lưu trữ mã

Trong trường hợp sử dụng này, bạn sẽ dùng Antigravity CLI để làm việc với một kho lưu trữ mã. Bạn sẽ thực hiện nhiều nhiệm vụ, bao gồm:

  • Tìm hiểu cơ sở mã
  • Tạo tài liệu
  • Triển khai một tính năng mới

Điều này sẽ giúp bạn có nền tảng vững chắc để làm việc với các kho lưu trữ và sử dụng Antigravity CLI làm trợ lý cho những tác vụ dành riêng cho nhà phát triển này.

Điều kiện tiên quyết

Để thực hiện các thao tác trong phần này, bạn cần phải làm những việc sau:

  • Antigravity CLI
  • Bạn nên hoàn thành phần trước và có sẵn mã đã được tạo, trong đó chúng ta đã tạo một trình đọc Ghi chú phát hành của BigQuery.

Hãy tiếp tục sử dụng Antigravity CLI trong thư mục/thư mục mà bạn đã dùng để tạo ứng dụng Ghi chú phát hành BigQuery.

Hãy thử các câu lệnh sau đây:

Tìm hiểu cơ sở mã

  • Tôi muốn hiểu rõ dự án này. Giúp tôi hiểu các tính năng chính, sau đó chia nhỏ thành phía máy chủ và phía máy khách. Lấy một quy trình mẫu và cho tôi biết cách hoạt động của yêu cầu và phản hồi. Lưu ý rằng thao tác này sẽ tạo một tệp mới (hiện vật) và bạn có thể xem tất cả hiện vật hoặc hiện vật cụ thể thông qua lệnh **/artifact**.
  • Giải thích @app.py

Tạo tệp README

  • Tạo tệp README cho dự án này.

Triển khai một tính năng mới

  • Vui lòng triển khai 2 tính năng tiện ích đơn giản: nút "Sao chép vào bảng nhớ tạm" trên mỗi thẻ và nút "Xuất sang CSV".
  • Vui lòng triển khai một công tắc bật/tắt đơn giản trong tiêu đề để chuyển đổi bảng phối màu của trang từ chế độ tối sang chế độ sáng bằng cách ghi đè các biến gốc CSS.

Công cụ này sẽ cung cấp cho bạn một kế hoạch mà bạn có thể phê duyệt. Sau khi được phê duyệt, Antigravity CLI sẽ tiến hành thực hiện những thay đổi đó. Hãy kiểm tra các thay đổi của bạn và nếu có lỗi (rất có thể), hãy yêu cầu Antigravity CLI sửa lỗi.

Tạo vấn đề dựa trên các tính năng được đề xuất

Hãy thử một điều thú vị ở đây. Bạn sẽ hỏi Antigravity CLI về cách công cụ này có thể cải thiện trải nghiệm người dùng của ứng dụng này.

Hãy thử câu lệnh sau:

  • Tôi muốn bạn đánh giá ứng dụng này theo quan điểm trải nghiệm người dùng, chẳng hạn như mức độ dễ sử dụng, khả năng phản hồi, thông báo hữu ích và nhiều yếu tố khác. Vui lòng đưa ra một danh sách các điểm cần cải thiện.

Tiếp theo, bạn có thể chọn một trong những vấn đề đã được tạo trước đó và yêu cầu Antigravity CLI xử lý và triển khai vấn đề đó.

(Không bắt buộc) Việc hằng ngày

Các trường hợp sử dụng dưới đây là những việc mà bạn có thể thường xuyên phải làm, chẳng hạn như sắp xếp tệp vào thư mục, tìm nạp và tóm tắt nội dung trên web, xử lý tệp hình ảnh và trích xuất nội dung từ tệp, làm việc với cơ sở dữ liệu, v. v.

Bạn có thể thoải mái khám phá bất kỳ trường hợp sử dụng nào mà bạn thích.

Sắp xếp tệp/thư mục

Bạn có thể sử dụng Antigravity CLI để sắp xếp các tệp tuỳ theo loại trong nhiều thư mục khi cần. Chuyển đến một thư mục trên máy có nhiều tệp .txt, .png, .jpg, .pdf, .mp4 và các tệp khác. Đây thường là thư mục Desktop (Màn hình) hoặc thư mục Downloads (Tải xuống).

Chuyển đến thư mục đó rồi khởi động Antigravity CLI. Trước tiên, bạn sẽ yêu cầu Antigravity CLI tạo một số thư mục: Hình ảnh, Tài liệu, Video, sau đó bạn sẽ yêu cầu Antigravity CLI sắp xếp các tệp trong các thư mục đó.

Antigravity CLI thường sẽ nhắc bạn cấp quyền trước khi thực thi các lệnh, đặc biệt là những lệnh sửa đổi hệ thống tệp của bạn (chẳng hạn như ghi, di chuyển hoặc xoá tệp). Luôn xem xét kỹ lưỡng những lời nhắc này trước khi cấp quyền. Đây là biện pháp đảm bảo an toàn cho bạn.

Create the following folders "Images","Documents","Videos"

Sau đó, hãy đưa ra câu lệnh sau:

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.

Dưới đây là ví dụ về một lần chạy trên máy của chúng tôi:

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 .

Một số trường hợp sắp xếp khác (các câu lệnh được đưa ra bên cạnh mỗi trường hợp):

  1. Tóm tắt: Đối với mỗi tài liệu trong thư mục "Tài liệu", hãy tạo một tệp txt trong cùng thư mục có tên là "summary_ORIGINAL_FILENAME.txt" chứa bản tóm tắt gồm 3 câu về các điểm chính của tài liệu.
  2. Phân loại theo loại: Quét tất cả tệp PDF và DOCX trong thư mục này. Di chuyển tất cả tệp có từ "hoá đơn" trong tên hoặc nội dung vào thư mục "Tài chính/Hoá đơn". Di chuyển các tệp có "biên nhận" vào thư mục "Tài chính/Biên nhận". Mọi tệp .docx khác sẽ được chuyển vào thư mục "Báo cáo".
  3. Trích xuất thông tin chính (và "gắn thẻ"): Đối với mỗi tệp PDF trong thư mục "Financial/Invoices" (Tài chính/Hoá đơn), hãy đọc nội dung của tệp đó. Nếu bạn tìm thấy một ngày, hãy đổi tên tệp để thêm ngày đó theo định dạng YYYY-MM-DD, ví dụ: "hoá_đơn_2025-07-26_tên_gốc.pdf".

Tóm tắt bài viết (Tệp cục bộ hoặc trên web)

Đối với mỗi trường hợp dưới đây, bạn có thể thay đổi URL, chủ đề quan tâm và tên tệp cục bộ nếu cần. Tên tệp được cung cấp là tên tệp mẫu, bạn có thể thay thế bằng tên tệp của các tệp có trên hệ thống của mình.

Hãy thử một trong các tình huống sau (các câu lệnh được cung cấp bên cạnh mỗi tình huống):

  • Tóm tắt một bài viết trên web (một URL): Truy cập vào https://medium.com/google-cloud/antigravity-cli-tutorial-series-12b46cfe3bf2 rồi tóm tắt 3 điểm chính hàng đầu trong bài viết tin tức này.
  • Tóm tắt nhiều bài viết trên web (ví dụ: từ một cụm từ tìm kiếm): Tìm các bài viết tin tức mới nhất về "CLI chống trọng lực" bằng Google Tìm kiếm. Đối với 5 bài viết có liên quan nhất, hãy tóm tắt mỗi bài trong 2 đến 3 câu và liệt kê URL của các bài viết đó.
  • Tóm tắt một tệp văn bản cục bộ: Tóm tắt những điểm chính của bài viết trong tệp "my_research_paper.txt". Tập trung vào phương pháp và kết luận.
  • Tóm tắt một tệp PDF trên thiết bị: Đọc "financial_report_Q2_2025.pdf". Tóm tắt hiệu suất tài chính và những thách thức chính được đề cập.

Trích xuất thông tin cụ thể (Tệp cục bộ hoặc Web)

Đối với mỗi trường hợp dưới đây, bạn có thể thay đổi URL, chủ đề quan tâm và tên tệp cục bộ nếu cần. Tên tệp được cung cấp là tên tệp mẫu, bạn có thể thay thế bằng tên tệp của các tệp có trên hệ thống của mình.

Hãy thử một trong các tình huống sau (các câu lệnh được cung cấp bên cạnh mỗi tình huống):

  • Trích xuất thực thể từ một bài viết trên máy: Từ "biography.txt", hãy liệt kê tất cả cá nhân có tên và những ngày quan trọng liên quan đến họ.
  • Trích xuất dữ liệu từ một bảng trong tệp PDF: Trong tệp "quarterly_sales.pdf", hãy trích xuất dữ liệu từ bảng trên trang 3 cho biết "Doanh số bán sản phẩm theo khu vực" và trình bày dữ liệu đó ở định dạng bảng Markdown.
  • Trích xuất tiêu đề và nguồn tin tức từ một trang web tin tức: Truy cập vào "https://news.google.com/" (hoặc một trang web tin tức tương tự). Trích xuất các tiêu đề chính trên trang nhất và nguồn tin tức tương ứng. Trình bày dưới dạng danh sách có dấu đầu dòng.
  • Tìm thông số kỹ thuật của sản phẩm trên một trang thương mại điện tử: Duyệt đến "https://www.amazon.in/Google-Cloud-Certified-Associate-Engineer/dp/1119871441" (ví dụ về một cuốn sách). Trích xuất tên sách, tác giả và các thông tin khác. Trình bày thông tin này ở định dạng JSON có cấu trúc.
  • Trích xuất thời lượng của một video ở một định dạng nhất định (ví dụ: "2h37m42s").

Trả lời câu hỏi dựa trên nội dung (hành vi tương tự như RAG)

Đối với mỗi trường hợp dưới đây, bạn có thể thay đổi URL, chủ đề quan tâm và tên tệp cục bộ nếu cần. Tên tệp được cung cấp là tên tệp mẫu, bạn có thể thay thế bằng tên tệp của các tệp có trên hệ thống của mình.

Hãy thử một trong các tình huống sau (các câu lệnh được cung cấp bên cạnh mỗi tình huống):

  • Hỏi và đáp về tài liệu tại địa phương: Tôi đang đính kèm "user_manual.pdf". Các bước khắc phục sự cố kết nối mạng là gì?
  • Hỏi và đáp trên trang web: Dựa vào nội dung trên"https://www.who.int/news-room/fact-sheets/detail/climate-change-and-health", theo WHO, những nguy cơ chính đối với sức khoẻ liên quan đến biến đổi khí hậu là gì?
  • So sánh thông tin từ nhiều nguồn: Tôi có hai bài viết tin tức: "article1.txt" và "article2.txt", cả hai đều thảo luận về những thay đổi gần đây trong chính sách kinh tế. So sánh và đối chiếu quan điểm của họ về tác động tiềm ẩn đối với doanh nghiệp nhỏ.

Tạo nội dung dựa trên thông tin được trích xuất

Đối với mỗi trường hợp dưới đây, bạn có thể thay đổi URL, chủ đề quan tâm và tên tệp cục bộ nếu cần.

Hãy thử một trong các tình huống sau (các câu lệnh được cung cấp bên cạnh mỗi tình huống):

  • Tạo bản tin vắn tắt từ một bài viết: Đọc @tech_innovation_article.txt. Viết một bản tin ngắn gọn, hấp dẫn (khoảng 150 từ) phù hợp với bản tin của công ty, nêu bật công nghệ mới và tiềm năng của công nghệ đó.
  • Soạn thảo email tóm tắt bản chép lời của cuộc họp: Đây là tệp bản chép lời của cuộc họp: @meeting_transcript.txt. Soạn thảo một email cho nhóm để tóm tắt các quyết định chính đã đưa ra và việc cần làm đã giao, bao gồm cả người chịu trách nhiệm cho từng việc.

Antigravity CLI hỗ trợ nhiều phương thức

Antigraity CLI hỗ trợ nhiều mô hình thông qua Gemini và bạn có thể yêu cầu công cụ này xử lý các tệp có nhiều định dạng nội dung theo yêu cầu của bạn.

Bạn sẽ xử lý một loạt hình ảnh hoá đơn bằng Antigravity CLI và trích xuất thông tin chính từ các hình ảnh đó. Hãy làm theo các bước bên dưới:

  • Tạo một thư mục trên máy của bạn rồi tải một số hoá đơn xuống từ kho lưu trữ GitHub sau đây.
  • Chạy Antigravity CLI từ thư mục đó

Đưa ra câu lệnh sau để trích xuất thông tin từ hoá đơn dưới dạng bảng.

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.

Lý tưởng nhất là bạn sẽ nhận được kết quả đầu ra có dạng như sau:

7203d699d875a91f.png

Sau đây là một tình huống khác, trong đó bạn có thể yêu cầu các cột phái sinh bổ sung. Giả sử bạn muốn hiển thị biểu tượng dấu thập màu đỏ cho tất cả ngày đến hạn thanh toán hoá đơn đã qua. Bạn có thể đưa ra câu lệnh như sau:

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.

Kết quả sẽ như sau:

e11fcde0400f5a0b.png

Áp dụng quy tắc này cho mọi tệp của riêng bạn ở các định dạng khác ngoài văn bản.

Sử dụng Antigravity CLI để tạo dữ liệu

Bạn có thể nhắc Antigravity CLI tạo dữ liệu ở nhiều định dạng dữ liệu. Điều này có thể bao gồm từ các phần nội dung đến dữ liệu JSON mà bạn có thể cần mô phỏng. Hãy tập trung vào các trường hợp áp dụng cho nhà phát triển/người kiểm thử.

Sau đây là một số câu lệnh bạn có thể thử:

Tạo dữ liệu JSON của các bài đánh giá mẫu của khách hàng

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).

Tạo phản hồi API mô phỏng (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').

Tạo câu lệnh chèn cơ sở dữ liệu mẫu (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'.

Tạo dữ liệu CSV để tải/phân tích dữ liệu

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).

Tạo tệp cấu hình (YAML)

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.

Tạo dữ liệu kiểm thử cho các trường hợp đặc biệt/xác thực

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. Xin chúc mừng

Xin chúc mừng! Bạn đã khám phá thành công Antigravity CLI, các chức năng của công cụ này và áp dụng cho một số trường hợp sử dụng.

Tài liệu tham khảo