#Dành cho AI agent
Trang tài liệu này tuân theo quy ước llmstxt.org để các AI agent và công cụ tự động đọc được toàn bộ nội dung mà không cần crawl HTML.
#Các tài nguyên có sẵn
/llms.txt(ở gốc site) và/docs/llms.txt(bản sao) — danh sách liên kết Markdown tới mọi trang, theo định dạng llmstxt.org./llms-full.txt(ở gốc site) và/docs/v1/llms-full.txt(bản sao) — toàn bộ nội dung Markdown của mọi trang, nối liền trong một file.- Bản Markdown song song — mỗi trang HTML (ví dụ
/docs/v1/sdk/stripe/) có một fileindex.mdcùng cấp (/docs/v1/sdk/stripe/index.md), liên kết qua<link rel="alternate" type="text/markdown">trong<head>và một liên kết "Xem bản Markdown" hiển thị ở đầu trang. - OpenAPI —
openapi.jsonvàopenapi.yaml, đặc tả máy đọc được đầy đủ cho mọi endpoint, tham số, và schema. - JWKS — khóa công khai Ed25519 để xác minh envelope đã ký:
https://keys.vkl-shield.com/v1/keys(live),https://keys.vkl-shield.com/sandbox/v1/keys(sandbox).
#Gợi ý sử dụng
- Agent muốn tổng quan nhanh về site: đọc
/llms.txttrước — đây là bản tóm tắt với liên kết tới từng trang. - Agent cần toàn bộ nội dung trong một lần gọi: đọc
/llms-full.txt. - Agent cần gọi API thật: dùng
openapi.json/openapi.yamlđể tạo client hoặc import vào Postman/Insomnia. - Agent chỉ cần một trang cụ thể dạng text thuần (không HTML): thêm
index.mdvào cuối URL của trang đó.
Liên kết nhanh
llms.txt (danh sách liên kết)https://docs.vkl-shield.com/llms.txt
llms-full.txt (toàn bộ nội dung)https://docs.vkl-shield.com/llms-full.txt
OpenAPI (JSON)https://docs.vkl-shield.com/docs/v1/openapi.json
OpenAPI (YAML)https://docs.vkl-shield.com/docs/v1/openapi.yaml
JWKS — livehttps://keys.vkl-shield.com/v1/keys
JWKS — sandboxhttps://keys.vkl-shield.com/sandbox/v1/keys