# Đưa Maguyva vào agent của bạn

Canonical source: https://maguyva.ai/vi/docs

License: text under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); code samples under [MIT-0](https://opensource.org/license/mit-0); the Maguyva name, logos, brand assets and other code are not covered. Details: [maguyva.ai/license](https://maguyva.ai/license).

Agent của bạn bắt đầu mỗi session trong trạng thái mù thông tin. Maguyva khắc phục điều đó bằng tìm kiếm codebase, symbol lookup, và context dependency qua MCP.

Con đường ngắn nhất rất đơn giản: bắt đầu miễn phí, lập chỉ mục một tập repo nhỏ mang tính đại diện, kết nối client của bạn, rồi đặt một câu hỏi thực tế mà bạn đã biết cách xác minh.

## Bốn bước từ agent mù thông tin đến câu trả lời có căn cứ.

Con đường ngắn nhất vẫn là con đường tốt nhất: kết nối một tập repo nhỏ, đưa Maguyva vào client của bạn, rồi đặt một câu hỏi mà bạn đã biết cách xác minh.

- **Bắt đầu miễn phí**: Không cần thẻ tín dụng. Hãy dùng một tập repo nhỏ, mang tính đại diện, thay vì cố lập chỉ mục toàn bộ công ty ngay ngày đầu tiên.
- **Lập chỉ mục một repo bạn đã biết rõ**: Chọn đoạn code mà bạn có thể kiểm tra nhanh. Điều đó cho thấy rõ ràng liệu Maguyva có đang neo mô hình vào dữ liệu thực tốt hơn một lượt tìm kiếm chung chung hay không.
- **Kết nối MCP client của bạn**
- **Đặt một câu hỏi thực tế về repo**: Nhảy thẳng đến symbol, nơi gọi hàm (caller), định nghĩa, và dependency — mọi kết quả đều dẫn chiếu đường dẫn file, còn kết quả tìm kiếm có thêm số dòng — thay vì hy vọng mô hình đoán đúng.

## Tổng quan tài liệu

- [Bắt đầu nhanh](https://maguyva.ai/vi/docs/quickstart): Từ con số 0 đến câu trả lời đã xác minh đầu tiên chỉ trong vài phút
- [Cài đặt](https://maguyva.ai/vi/docs/installation): Đưa Maguyva vào MCP client của bạn chỉ trong vài phút
- [Cách hoạt động](https://maguyva.ai/vi/docs/how-it-works): Xem cách lập chỉ mục, tìm kiếm, symbol, và đồ thị phụ thuộc kết hợp với nhau
- [Tài liệu tham chiếu MCP API](https://maguyva.ai/vi/docs/mcp-api): Tài liệu tham chiếu từng công cụ trong giao diện MCP của Maguyva
- [Khả năng tương thích](https://maguyva.ai/vi/docs/compatibility): Ngôn ngữ được hỗ trợ, giới hạn repository, và độ phủ file
- [Sổ tay công thức](https://maguyva.ai/vi/docs/cookbook): Công thức ngắn gọn để cài đặt, tìm kiếm trước khi chỉnh sửa, kết quả trống và nhiều kho lưu trữ
- [Khắc phục sự cố](https://maguyva.ai/vi/docs/troubleshooting): Khắc phục sự cố khóa API, cầu nối, và kết nối repository

## Tài nguyên khác

- [Hướng dẫn theo ngôn ngữ](https://maguyva.ai/vi/languages): Xem cách Maguyva xử lý stack ngôn ngữ của bạn
- [Blog](https://maguyva.ai/vi/blog): Các quyết định kiến trúc và bài viết chuyên sâu kỹ thuật
- [Giá](https://maguyva.ai/vi/pricing): Giá theo workspace, bắt đầu miễn phí

## Kiểm chứng bằng một câu hỏi mà bạn đã có thể tự chấm điểm.

Maguyva thể hiện tốt nhất khi bạn dùng nó với đoạn code bạn đã hiểu rõ. Bắt đầu với một repo, đặt một câu hỏi thực tế, kiểm tra các đường dẫn file, và để công cụ này chứng minh được sự tin cậy trước khi nó trở thành một phần trong quy trình mặc định của bạn.

- Câu hỏi: Đoạn code nào xử lý đăng nhập và hết hạn session?
- Kiểm tra: Mở các file được trích dẫn, lần theo các symbol, và xác minh rằng câu trả lời vẫn đứng vững khi đối chiếu với repo thực tế.
- Tín hiệu: Context nhỏ hơn, ít điểm mù hơn, và khả năng cao hơn rằng mô hình sẽ sửa đúng file ngay từ lần đầu.

### Bạn nhận lại được gì

- Câu trả lời có căn cứ, kèm đường dẫn file và số dòng.
- Tra cứu symbol, các hàm gọi, định nghĩa và đường dẫn phụ thuộc trong cùng một giao diện.
- Một MCP server từ xa duy nhất, hoạt động trên nhiều client, thay vì một quy trình riêng cho từng editor.