Chuyển tới nội dung

Dành cho người dùng Antigravity

Antigravity vận hành các tác nhân.
Maguyva cho chúng bản đồ.

Antigravity là một IDE ưu tiên tác nhân: các tác nhân lập kế hoạch và chỉnh sửa trên trình soạn thảo, terminal, và trình duyệt. Trên một monorepo thực thụ, chúng vẫn cần một bản đồ để biết tệp nào quan trọng. Maguyva lập chỉ mục codebase của bạn và trả về qua MCP (ngữ nghĩa, AST, đồ thị, và văn bản), để câu hỏi “auth xảy ra ở đâu” trả về đúng luồng auth thực tế, chứ không phải bảy test stub.

Bắt đầu dùng FreeĐọc hướng dẫn cài đặt Antigravity

Gói Free: 3 repository, Tối đa 50K dòng repo đã index, không cần thẻ.

Antigravity vận hành tác nhân. Maguyva cho nó biết nên chạm vào tệp nào.

Mỗi lớp làm gì

Bốn mảnh ghép. Mỗi mảnh có một nhiệm vụ.

// agent ide

Antigravity

Nơi các tác nhân của bạn lập kế hoạch, chỉnh sửa, và xác minh.

// ngữ cảnh thủ công

@ mentions + rules

Ngữ cảnh thủ công vẫn ổn, cho đến khi repo trở nên lớn.

// codebase

Maguyva

Dữ kiện codebase tự động qua MCP.

// ai trả tiền

Workspace, không phải theo ghế

Tác nhân không phải trả tiền theo ghế. Xem bảng giá

Antigravity vận hành các tác nhân. Cứ để nó làm vậy.

Vấn đề không nằm ở agent IDE. Agent Manager, thực thi đa bề mặt, và các tệp rules đều xuất sắc, và bạn đã dùng chúng cho:

  • Lập kế hoạch và chạy các tác nhân trên trình soạn thảo, terminal, và trình duyệt.
  • Chỉnh sửa đa tệp khi thay đổi mang tính cục bộ.
  • Rules của tác nhân cho quy ước repo và các rào chắn phong cách viết mã.
  • @-mentions để đưa một tệp cụ thể vào ngữ cảnh.

Cứ tiếp tục làm vậy. Không có gì trong số đó biến mất cả.

Nhưng trong một monorepo thực thụ (TypeScript với các phụ thuộc workspace, dịch vụ Python, các package hỗn hợp) ngữ cảnh của tác nhân sẽ vỡ ngay khi tệp liên quan chưa nằm trong tầm nhìn của tác nhân.

Những cách khắc phục thủ công bạn đã thử, và chúng vỡ ở đâu

Bốn cách khắc phục thủ công đi kèm với kiểu thất bại của chúng. Trái = điều bạn làm hôm nay. Phải = nơi nó vỡ.

// the fix

// nhắc đến các tệp

Bạn @-mention ba tệp mà bạn nghĩ là quan trọng. Tác nhân chỉnh sửa gọn gàng bên trong chúng.

// where it breaks

// nhắc đến chỉ là phỏng đoán

Nó chỉ hiệu quả khi bạn đã biết những tệp nào liên quan. Một tác nhân tự động cần những tệp mà bạn không biết để nhắc tới.

// the fix

// dán đoạn mã

Bạn dán 200 dòng từ một package khác vào tác nhân để cho nó đủ ngữ cảnh.

// where it breaks

// mã dán vào sẽ trở nên lỗi thời

Đoạn mã bạn dán lúc 9 giờ sáng không phản ánh lần rebase mà đồng đội của bạn đã đẩy lên lúc 11 giờ. Tác nhân đang chỉnh sửa dựa trên một phiên bản ma của package đó.

// the fix

// viết tài liệu ngữ cảnh

Bạn viết một tệp rules của tác nhân hoặc một tài liệu markdown về kiến trúc. Nó đúng ở thời điểm hôm nay.

// where it breaks

// tài liệu trôi nhanh hơn mã

Bất cứ thứ gì bạn viết tay đều sẽ trôi dần. Mã nguồn mới là nguồn sự thật. Một tài liệu giải thích lớp hàng đợi đúng trong một tuần, rồi sai mãi mãi.

// the fix

// giữ các tệp rules

Bạn thêm rules của tác nhân cho quy ước đặt tên, lint, và các lệnh build. Rất tốt cho hành vi.

// where it breaks

// rules ≠ chỉ mục

Rules là nơi đúng để ghi “luôn chạy pnpm tsc -b trước khi commit.” Chúng không phải là một chỉ mục có thể truy vấn của mọi ký hiệu, tệp, và call-site trong monorepo của bạn.

Maguyva là lớp nằm bên dưới

Không phải để thay thế Antigravity. Đây là lớp ngữ cảnh repo gắn vào khả năng hỗ trợ MCP của nó.

  • Ngữ nghĩa + AST + đồ thị + văn bản tìm kiếm theo ý nghĩa, cấu trúc, phụ thuộc, hoặc văn bản chính xác. Mỗi kết quả trả về đường dẫn tệp và số dòng.
  • Xuyên package theo mặc định call-site và importer trên mọi package trong monorepo, không chỉ package mà tác nhân đang mở.
  • Nhận biết nhánh Maguyva thấy đúng phiên bản mã mà tác nhân đang chỉnh sửa.
  • Được xây dựng cho tính tự động một tác nhân lập kế hoạch nhiều chỉnh sửa cần biết trước phạm vi ảnh hưởng, không phải sau khi CI báo đỏ.

Antigravity quyết định chỉnh sửa gì.

Maguyva cho tác nhân biết chỉnh sửa đó chạm vào những gì.

Ba quy trình làm việc trong monorepo

Xuyên package, xuyên ngôn ngữ. Có căn cứ vào đồ thị lệnh gọi thực tế, không phải grep của tác nhân.

// workflow 01

Tìm luồng auth xuyên package, mà không cần nhắc đến gì cả

agent> xác thực xảy ra ở đâu trong monorepo này?

graph::query("authentication flow")
  packages/web/src/auth/session.ts:42       middleware
  packages/api/src/auth/jwt.ts:88           xác thực token
  packages/shared/src/auth/types.ts:12      AuthContext
  packages/admin/src/auth/admin-only.ts:31  cổng rbac

→ 4 điểm vào trên 4 package, xếp hạng theo mật độ call-site.
[exit 0]

Bạn không nhắc đến tệp nào. Bạn không dán đoạn mã nào. Tác nhân có sẵn bốn tệp quan trọng, đúng thứ tự xếp hạng, và có thể thực hiện một chỉnh sửa có căn cứ.

// workflow 02

Tìm cài đặt thực sự, chứ không phải test stub

agent> normalizePhoneNumber xử lý E.164 như thế nào?

semantic::query("normalize phone E.164")
  packages/shared/util/phone.ts:88     normalizePhoneNumber()  ← cài đặt thực
  packages/api/test/phone.spec.ts:14   jest.mock(...)          ← stub
[exit 0]

Tên gọi có thể lừa dối. Mock che khuất mã thực. Maguyva xếp hạng cài đặt thực cao hơn test mock, trên mọi package.

// workflow 03

Kiểm tra phạm vi ảnh hưởng trước khi tác nhân tái cấu trúc

agent> điều gì gọi QueueDispatcher.publish trên toàn monorepo?

graph::callers(QueueDispatcher.publish)
  3 in packages/billing/*
  1 in packages/audit/*
  1 in packages/notifications/*
  1 in services/python-worker/*  ← xuyên ngôn ngữ qua gRPC stub
[exit 0]

Xuyên package, và xuyên ngôn ngữ khi bạn có một repo đa ngôn ngữ, call-site hiện ra ngay trong dòng kết quả. Một tác nhân tự động biết phạm vi ảnh hưởng trước khi chỉnh sửa, không phải sau khi CI báo đỏ.

Cài đặt với Antigravity

Ba bước. Gói Free: 3 repository, Tối đa 50K dòng repo đã index, không cần thẻ.

  1. // step 01

    Lập chỉ mục một repo tại maguyva.ai

    Chọn monorepo mà bạn cảm thấy đau đầu nhất về ngữ cảnh.

  2. // step 02

    Thêm Maguyva làm MCP server trong Antigravity

    // ~/.gemini/antigravity/mcp_config.json
{
  "mcpServers": {
    "maguyva": {
      "serverUrl": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer <your-key>"
      }
    }
  }
}

  3. // step 03

    Đặt một câu hỏi mà bạn đã biết câu trả lời

    Đừng trỏ tác nhân vào toàn bộ công ty của bạn. Hãy bắt đầu với một repo và một câu hỏi có thể kiểm chứng, như “điều gì gọi formatInvoice xuyên package?”

Đăng ký tự phục vụ đang mở.

Lập chỉ mục một repo mà bạn đã biết rõ.

Kiểm tra một câu hỏi mà bạn có thể xác minh câu trả lời.

Lập chỉ mục repo đầu tiên của bạnXem tài liệu tương thích

gói Free: 3 repository, Tối đa 50K dòng repo đã index, không cần thẻ.