> For the complete documentation index, see [llms.txt](https://docs.greennode.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.greennode.ai/vn/ai-stack/agent-base/built-in-tools.md).

# Built-in Tools

Built-in Tools giúp agent của bạn **chạy code** và **điều khiển trình duyệt thật** trong môi trường sandbox được cô lập theo từng session — mà không cần tự dựng hạ tầng, image hay container.

Hiện có 2 tool:

| Tool                 | Dùng để                                                                                                              |
| -------------------- | -------------------------------------------------------------------------------------------------------------------- |
| **Code Interpreter** | Chạy Python và lệnh shell, đọc/ghi file, chạy tiến trình nền — mỗi session trong một sandbox riêng, cô lập hoàn toàn |
| **Browser**          | Điều khiển Chrome thật (qua CDP), xem trực tiếp màn hình qua noVNC, lưu bản ghi phiên                                |

Cả hai tool đều **tích hợp qua MCP** — agent của bạn kết nối vào endpoint MCP do GreenNode cấp, tool xuất hiện như các MCP tool bình thường.

{% hint style="info" %}
Built-in Tools đang được mở theo từng đợt **whitelist**. Nếu account của bạn chưa được bật, liên hệ <support@greennode.ai>, hotline **19001549**, hoặc [Trung tâm hỗ trợ](https://helpdesk.greennode.ai/portal/vi/home) để được thêm vào danh sách.
{% endhint %}

***

## Kiến trúc

Mỗi session của bạn chạy trong một sandbox riêng, được nền tảng cấp sẵn nên tạo session chỉ mất vài giây. Hai tool dùng chung một nền sandbox — khác nhau ở lớp sản phẩm bên trên:

<figure><img src="https://3672463924-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FB0NrrrdJdpYOYzRkbWp5%2Fuploads%2Fgit-blob-7ea2249c255b2b43b15e787cd7ab2943961f9d92%2Fagentbase-code-interpreter-architecture.svg?alt=media" alt=""><figcaption><p>Code Interpreter — agent gọi tool qua MCP, code chạy trong sandbox cô lập</p></figcaption></figure>

<figure><img src="https://3672463924-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FB0NrrrdJdpYOYzRkbWp5%2Fuploads%2Fgit-blob-8c2263523872211716e93a06342b24ff5ce6c23a%2Fagentbase-browser-architecture.svg?alt=media" alt=""><figcaption><p>Browser — agent điều khiển Chromium trong sandbox qua CDP</p></figcaption></figure>

Các tầng chính:

* **Built-in Tools** — lớp sản phẩm: quản lý tài nguyên bạn sở hữu (Code Interpreter / Browser có id, tên, trạng thái), quota, xác thực và vòng đời. Runtime sandbox nằm ẩn bên dưới, không lộ id hay URL ra ngoài.
* **AgentBase Runtime** — lớp nền tảng: quản lý vòng đời sandbox — cấp một sandbox riêng cho mỗi session mới, theo dõi trạng thái và thu hồi khi session kết thúc.

### Vì sao mỗi session một sandbox riêng?

Agent cần chạy code và điều khiển trình duyệt đúng theo yêu cầu của bạn — và nền tảng cần đảm bảo mọi session hoạt động **hoàn toàn độc lập** với nhau, kể cả khi code gặp lỗi hoặc chứa lỗ hổng. Vì thế mỗi session chạy trong một sandbox riêng: tiến trình, filesystem và bộ nhớ của session này hoàn toàn tách biệt với session khác — sự cố của session này được giữ nguyên trong đúng session đó. Hết session, sandbox bị huỷ và mọi trạng thái bên trong biến mất.

***

## Kết nối agent của bạn

Mỗi tool có một endpoint MCP (streamable HTTP) nằm sau AgentBase Gateway. Kết nối bằng bất kỳ MCP client nào (Claude Code, Cursor, hoặc MCP SDK):

| Tool             | Endpoint MCP                                                                                 |
| ---------------- | -------------------------------------------------------------------------------------------- |
| Code Interpreter | `https://gw-greennode-builtin-tools-110718.agentbase-gateway.aiplatform.vngcloud.vn/code`    |
| Browser          | `https://gw-greennode-builtin-tools-110718.agentbase-gateway.aiplatform.vngcloud.vn/browser` |

### Xác thực

Endpoint là một **OAuth resource server** — client tự điều phối toàn bộ flow đăng nhập, bạn không cần tạo hay dán token thủ công:

1. Client gọi endpoint không kèm token → nhận `401` kèm header `WWW-Authenticate` trỏ tới authorization server.
2. Client tự đăng ký (**Dynamic Client Registration**) và mở trình duyệt tại URL login của GreenNode Portal.
3. Sau khi đăng nhập, client giữ access token và **tự refresh** — không cần đăng nhập lại mỗi session.

Token từ **Root user, IAM user hoặc Service Account** đều dùng được — cả ba đều cấp cùng một loại access token. Nếu agent chạy headless (không mở được trình duyệt), gắn access token trực tiếp vào cấu hình của client.

Mỗi kết nối MCP gắn với một tài nguyên cụ thể qua header — `x-code-interpreter-id` cho Code Interpreter, `x-browser-id` cho Browser — xem hướng dẫn kết nối chi tiết trong trang từng tool.

***

## Bắt đầu với Built-in Tools

| Tôi muốn...                                                   | Đi đến                                                                                                                         |
| ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| Cho agent chạy được Python / shell                            | [Sử dụng Code Interpreter](https://docs.greennode.ai/vn/ai-stack/agent-base/built-in-tools/su-dung-code-interpreter.md)        |
| Cho agent điều khiển trình duyệt, xem live và xem lại bản ghi | [Sử dụng Browser](https://docs.greennode.ai/vn/ai-stack/agent-base/built-in-tools/su-dung-browser.md)                          |
| Hiểu mô hình cô lập, bảo mật và giới hạn                      | [Sandbox: bảo mật và giới hạn](https://docs.greennode.ai/vn/ai-stack/agent-base/built-in-tools/sandbox-bao-mat-va-gioi-han.md) |
