# Giới thiệu AnyRouter Artifacts: đăng một trang, nhận một đường link

> Artifacts biến một trang HTML, một ghi chú Markdown, một sơ đồ Mermaid hay một thư mục nhỏ thành đường link anyrouter.dev/a/<id>. Đăng từ anyr CLI, API hoặc agent. Mọi artifact đều riêng tư lúc đầu, và bạn chọn khi nào chia sẻ.

- Date: October 26, 2026
- Category: product
- HTML: https://anyrouter.dev/blog/vi/introducing-anyrouter-artifacts

## Một đường link cho thứ agent vừa làm

Coding agent giờ viết rất nhiều HTML: báo cáo tuần, biểu đồ, ghi chú thiết kế, sơ đồ luồng request. Phần lớn nằm lại thành một file trên một máy. Muốn cho người khác xem, bạn phải tìm chỗ host, cài deploy và quyết định ai được xem.

Artifacts, đang ở bản beta, bỏ các bước đó. Bạn đăng một file hoặc một thư mục nhỏ lên AnyRouter và nhận đường link cố định `https://anyrouter.dev/a/<id>`. Đăng lại sẽ tạo một phiên bản đánh số mới ở cùng link. Mọi artifact đều riêng tư cho đến khi bạn đổi.

## Bắt đầu nhanh

Cài `anyr` CLI và đăng nhập. Lệnh `artifact` có trong bản CLI ổn định.

```bash
curl -fsSL https://anyrouter.dev/cli.sh | bash
anyr login
```

Đăng một trang. CLI in ra đường link.

```bash
anyr artifact publish ./page.html --title "Sales board"
```

Trang đang riêng tư, nên chỉ bạn mở được. Khi muốn chia sẻ, chuyển nó sang unlisted:

```bash
anyr artifact visibility <id> unlisted
```

Bạn cũng có thể đăng qua HTTP với bất kỳ API key AnyRouter nào:

```bash
curl -sS https://anyrouter.dev/api/v1/artifacts \
  -H "Authorization: Bearer $ANYROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"Hello","files":{"index.html":{"content":"<h1>Hi</h1>"}}}'
```

```json
{
  "id": "k3Vx9TqLm2Ab7Zcd",
  "version": 1,
  "url": "https://anyrouter.dev/a/k3Vx9TqLm2Ab7Zcd",
  "visibility": "private"
}
```

## Bạn đăng được gì

Một file, hoặc một thư mục kèm style, script và ảnh. Đuôi của file chính quyết định người xem thấy gì.

| File chính | Người xem thấy |
| --- | --- |
| `.html` | Chính trang đó |
| `.md` | Văn bản đã định dạng |
| `.svg` | Hình ảnh (script trong đó không chạy) |
| `.mmd`, `.mermaid` | Sơ đồ Mermaid, vẽ trong trình duyệt |
| `.py`, `.ts`, `.sql`, `.go`, `.rs` và file mã nguồn khác | Mã nguồn có tô màu cú pháp |

Trong thư mục, `index.html` được mở trước. Các file như `.js`, `.css`, `.json` và `.csv` không bao giờ là file chính, nên một trang kèm `app.js` vẫn mở trang đó.

## Ba cách dùng

**Để agent đăng báo cáo của nó.** Agent chạy được lệnh shell có thể đăng bằng một lệnh và đọc link từ JSON. Bảo nó dựng trang, rồi chạy:

```bash
anyr artifact publish report.html --json
```

Agent kết nối với MCP server của AnyRouter có thể gọi tool `publish_artifact`. Tool nhận file văn bản tới 1 MB và cần một [management key](https://anyrouter.dev/docs/api-reference/management-keys) có quyền `write:artifacts`.

**Chia sẻ một sơ đồ.** File `.mmd` thành sơ đồ Mermaid. Dán link vào pull request hoặc khung chat.

```bash
curl -sS https://anyrouter.dev/api/v1/artifacts \
  -H "Authorization: Bearer $ANYROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"Flow","files":{"flow.mmd":{"content":"graph TD\n  A[Request] --> B{Key valid?}\n  B -->|yes| C[Route]\n  B -->|no| D[401]"}}}'
```

**Giữ một link cho trang hay thay đổi.** Đăng một thư mục, rồi gửi phiên bản mới vào cùng id. Mỗi phiên bản có số và nhãn tùy chọn, nên ai có link cũng luôn thấy bản mới nhất.

```bash
anyr artifact publish ./report
anyr artifact publish ./report --id k3Vx9TqLm2Ab7Zcd --label "fix chart"
```

Khi tải thư mục lên, CLI bỏ qua dotfile, `node_modules` và `.git`.

## Chia sẻ và quyền riêng tư

Mỗi artifact có một trong ba chế độ hiển thị:

| Chế độ | Ai mở được | Có trong danh sách | Công cụ tìm kiếm |
| --- | --- | --- | --- |
| `private` (mặc định) | Chỉ bạn | Không | Không |
| `unlisted` | Ai có link | Không | Không |
| `public` | Ai có link | Có, trong thư viện công khai | Có |

- Tên bạn bị ẩn mặc định. Đầu trang ghi "by an AnyRouter user" cho đến khi bạn bật `--show-author`. Email không bao giờ hiện.
- Một id riêng tư trả về 404 với mọi người trừ bạn, nên không ai dò được nó.
- Tài khoản chỉ đặt artifact là public sau 24 giờ kể từ khi đăng ký, tối đa 5 cái mỗi ngày. Mỗi trang artifact có nút Report.
- Bạn xem được lượt xem và lượt khách mỗi ngày của artifact của mình. AnyRouter không lưu địa chỉ IP hay danh tính người xem cho các số này.
- Một trang chỉ fetch được file trong phiên bản của chính nó. Request tới artifact khác hay URL khác đều bị chặn.
- Xóa một artifact làm link ngừng hoạt động với mọi người khác ngay lập tức.

Bạn đổi chế độ hiển thị hay bật tên mình ở trang Artifacts trong dashboard, hoặc bằng `anyr artifact visibility`.

## Giới hạn

Các giới hạn như sau:

| Giới hạn | Giá trị |
| --- | --- |
| Artifact mỗi tài khoản | 100 |
| Dung lượng lưu mỗi tài khoản (phiên bản hiện tại) | 200 MB |
| Số lần đăng mỗi giờ | 20 |
| Một trang hoặc file mã nguồn | 5 MB |
| Một ảnh, font hoặc script | 25 MB |
| Một phiên bản | 200 file, 100 MB |

CLI tải tối đa 50 file và 20 MB mỗi lần đăng. Với thư mục lớn hơn, dùng [manifest upload](https://anyrouter.dev/docs/api-reference/artifacts) của API.

## Dùng thử

[Tài liệu Artifacts API](https://anyrouter.dev/docs/api-reference/artifacts) mô tả cách tải thư mục, xung đột phiên bản, mọi mã lỗi và các tool MCP. Xem những gì người khác đã đăng tại [anyrouter.dev/artifact](https://anyrouter.dev/artifact), và quản lý artifact của bạn ở [Dashboard, Artifacts](https://anyrouter.dev/dashboard/artifacts).

Đăng trang đầu tiên của bạn bằng một lệnh.

[Mở Artifacts](https://anyrouter.dev/artifact)
