Pesat AI Developer & Agent Documentation
Dokumentasi teknis resmi Pesat AI untuk pengembang perangkat lunak, sistem agen otonom (LLM agents), dan synthetic evaluation bots. Pesat AI menyediakan arsitektur sistem siap-mesin (agentic-ready) yang mendukung penemuan terstandar, negosiasi konten, dan antarmuka pemrograman terbuka.
1. Ikhtisar & Arsitektur Sistem
Pesat AI dirancang dengan prinsip dual-consumption: melayani pengguna manusia melalui antarmuka web modern berbasis SSR Next.js di Cloudflare Edge Workers, sekaligus melayani agen AI melalui format terstruktur (Markdown, RFC 9727 API Catalog, OpenAPI 3.1, dan JSON-LD).
Human Experience
Diagnosis wizard 5 menit, katalog 33 solusi terkurasi, SSR HTML lengkap dengan semantic landmark, dan responsivitas mobile.
Agent Experience
Content negotiation via Accept: text/markdown, status HTTP 404 informatif, katalog mesin, dan skema OpenAPI deterministik.
2. Protokol Penemuan Agen (Agent Discovery)
Agen cerdas dapat memetakan kapabilitas Pesat AI melalui titik akhir standar berikut:
| Endpoint | Format | Deskripsi |
|---|---|---|
/llms.txt | text/plain | Panduan kurasi LLM tingkat atas berisi ringkasan kapabilitas dan aturan penggunaan. |
/llms-full.txt | text/plain | Katalog komprehensif 33 solusi AI dan analogi operasional untuk agen pencari fakta. |
/.well-known/ai-catalog.json | application/json | Metadata katalog kapabilitas agen dan titik kontak layanan resmi. |
/.well-known/api-catalog | application/linkset+json | RFC 9727 API Catalog yang menghubungkan dokumen deskripsi layanan dan spesifikasi. |
/openapi.json | application/vnd.oai.openapi+json | Spesifikasi OpenAPI 3.1 resmi untuk seluruh antarmuka publik. |
3. Content Negotiation (Negosiasi Konten Markdown)
Untuk menghemat token pemrosesan LLM hingga 90%, seluruh rute publik Pesat AI mendukung permintaan Markdown murni tanpa overhead markup HTML atau stylesheet.
Contoh permintaan cURL:
curl -H "Accept: text/markdown" https://pesat.ai/ curl -H "Accept: text/markdown" https://pesat.ai/services curl -H "Accept: text/markdown" https://pesat.ai/docs
Setiap respons menyertakan header Vary: Accept dan Content-Type: text/markdown; charset=utf-8 untuk kepatuhan caching CDN.
4. Pesat AI CLI Tool
Pesat AI menyediakan CLI utilitas ringan untuk menguji konektivitas, menjalankan audit agentic lokal, dan mengambil spesifikasi layanan langsung dari terminal Anda.
# Jalankan tanpa instalasi via npx npx pesat-ai ping npx pesat-ai docs npx pesat-ai audit https://pesat.ai # Atau pasang secara global npm install -g pesat-ai pesat --help
Perintah yang tersedia meliputi:
pesat ping: Memeriksa latensi dan status ketersediaan endpoint Cloudflare Edge.pesat docs: Mengambil ringkasan dokumentasi Markdown ke terminal stdout.pesat catalog: Menampilkan daftar 33 solusi AI terstruktur berdasarkan cluster.pesat audit <url>: Menjalankan verifikasi agentic readiness cepat terhadap URL target.
5. Contoh Integrasi Kode
TypeScript / Node.js
async function fetchPesatMarkdown(path = "/") {
const res = await fetch(`https://pesat.ai${path}`, {
headers: { "Accept": "text/markdown" },
});
if (!res.ok) throw new Error(`HTTP ${res.status}`);
return await res.text();
}
const markdown = await fetchPesatMarkdown("/services");
console.log(markdown);Python 3
import urllib.request
req = urllib.request.Request(
"https://pesat.ai/services",
headers={"Accept": "text/markdown"}
)
with urllib.request.urlopen(req) as response:
content = response.read().decode("utf-8")
print(content)