Agent

Agent là hệ thống suy luận (reasoning system) cốt lõi của Antigravity. Đây là “bộ não” thực hiện tất cả các tác vụ coding.

Khả năng của Agent

Agent có thể thực hiện các bước phức tạp một cách tự động:

🔍 Phân tích

• Đọc và hiểu toàn bộ codebase
• Phân tích cấu trúc thư mục và dependencies
• Tìm kiếm patterns và anti-patterns

📝 Lập kế hoạch

• Tạo kế hoạch triển khai chi tiết
• Chia nhỏ task phức tạp thành các bước
• Đề xuất approach tối ưu

🛠️ Thực thi

• Tạo, sửa, xóa files
• Chạy commands trong terminal
• Điều khiển browser cho testing

✅ Xác minh

• Chạy tests
• Validate kết quả
• Tạo documentation

Multi-step Reasoning

Agent không chỉ trả lời câu hỏi đơn lẻ. Nó có khả năng:

graph LR
    A[Nhận task] --> B[Phân tích]
    B --> C[Lập kế hoạch]
    C --> D[Thực thi bước 1]
    D --> E[Đánh giá kết quả]
    E --> F{Cần điều chỉnh?}
    F -->|Có| C
    F -->|Không| G[Thực thi bước 2]
    G --> H[...]
    H --> I[Hoàn thành]

Quản lý Conversation

Mỗi conversation với Agent là một session độc lập:

• Context riêng biệt - Mỗi conversation có context riêng
• Lịch sử được lưu - Bạn có thể quay lại conversation cũ
• Artifacts được tạo - Mỗi task phức tạp sẽ tạo ra artifacts

Tools có sẵn

Agent có quyền truy cập đến một bộ công cụ mạnh mẽ:

File Operations

Tool	Mô tả
view_file	Đọc nội dung file
write_to_file	Tạo file mới
replace_file_content	Sửa đổi nội dung file
multi_replace_file_content	Sửa nhiều vị trí trong file

Search & Navigation

Tool	Mô tả
grep_search	Tìm kiếm text trong code
find_by_name	Tìm file/folder theo tên
view_file_outline	Xem cấu trúc file
view_code_item	Xem chi tiết class/function

Execution

Tool	Mô tả
run_command	Chạy lệnh terminal
command_status	Kiểm tra trạng thái lệnh
send_command_input	Gửi input đến process đang chạy

Browser

Tool	Mô tả
browser_subagent	Điều khiển browser
read_url_content	Đọc nội dung URL

Communication

Tool	Mô tả
notify_user	Thông báo cho user
task_boundary	Đánh dấu tiến độ task

Cách Agent suy nghĩ

Agent hoạt động theo workflow:

1. PLANNING Mode

Khi nhận yêu cầu mới, Agent sẽ:

• Nghiên cứu codebase
• Hiểu requirements
• Tạo implementation_plan.md
• Chờ user approve

2. EXECUTION Mode

Sau khi được approve:

• Thực hiện các thay đổi theo plan
• Cập nhật tiến độ trong task.md
• Xử lý lỗi nếu có

3. VERIFICATION Mode

Sau khi hoàn thành:

• Chạy tests
• Validate kết quả
• Tạo walkthrough.md

Best Practices

✅ Cung cấp context đầy đủ

Agent hoạt động tốt hơn khi có đủ thông tin:

• Mô tả rõ vấn đề
• Chỉ ra files liên quan
• Giải thích business logic nếu cần

✅ Review cẩn thận

Agent có thể mắc lỗi, đặc biệt với:

• Logic phức tạp
• Edge cases
• Business rules đặc thù

✅ Sử dụng Git

Luôn commit trước khi để Agent thay đổi lớn. Điều này cho phép:

• Rollback nếu cần
• Review diff
• Track history

✅ Chia nhỏ tasks

Thay vì một task lớn, hãy chia thành nhiều tasks nhỏ hơn để:

• Dễ review
• Dễ debug
• Dễ quản lý

Giới hạn

Agent hiện tại có một số giới hạn:

• Không hỗ trợ worktrees
• Không thể access private networks
• Rate limits theo plan
• Một số file types không được hỗ trợ (VD: .ipynb)