# Hướng dẫn dành cho Agent — Hoàng Kiên

Tài liệu này mô tả cách các AI Agent có thể tương tác với cửa hàng trực tuyến của Hoàng Kiên tại địa chỉ [https://www.hoangkien.com](https://www.hoangkien.com).

Dành cho các agent chỉ cần đọc dữ liệu của cửa hàng:

### Dữ liệu sản phẩm

* Duyệt tất cả sản phẩm: `GET /collections/all`
* Trang sản phẩm: `GET /products/{handle}`
* Dữ liệu JSON của sản phẩm: `GET /products/{handle}.json`
* Trang danh mục sản phẩm: `GET /collections/{handle}`
* Dữ liệu JSON của danh mục sản phẩm: `GET /collections/{handle}/products.json`
* Tìm kiếm: `GET /search?q={query}&type=product`

### Dữ liệu mô tả cửa hàng (Metadata)

* Sitemap: `GET https://www.hoangkien.com/sitemap.xml`
* Agent discovery: Bản mô tả chuẩn hóa dành riêng cho AI Agent khi tương tác với cửa hàng ở `/agents.md`. Bạn đang đọc `/llms.txt` là bản sao của tài liệu


## Nền tảng

Cửa hàng này được xây dựng trên [Sapo](https://www.sapo.vn), nền tảng quản lý bán hàng hợp kênh được sử dụng nhiều nhất Việt Nam