generate_chart
Kembalikan properti bodygraph inti dalam respons stabil yang ramah bagi agen. Startup dan tingkat lebih tinggi dapat meminta detail lengkap yang diperluas.
Hasil bagi pengembang: Berikan masukan bodygraph yang andal kepada produk AI tanpa mengajarkan aturan kalkulasi bagan kepada model.
Parameter
| Nama | Ketik | Wajib | Deskripsi |
|---|---|---|---|
birthDateTime | string (waktu lokal pada jam) | Ya | Tanggal dan waktu lahir sesuai bacaan jam di tempat orang tersebut lahir, tanpa Z atau UTC offset. Kolom timezone menetapkan zona. |
timezone | string | Ya | Zona waktu IANA, seperti America/New_York. |
detailLevel | "core" | "full" | Tidak | Core tersedia pada Free; full memerlukan Startup atau lebih tinggi. |
idempotencyKey | string | Ya | Key stabil untuk kalkulasi ini. Gunakan kembali hanya dengan argumen identik saat mencoba ulang. |
Waktu lahir adalah waktu lokal pada jam. Kirim tanggal dan waktu seperti yang terbaca pada jam di tempat orang tersebut lahir, tanpa Z atau UTC offset, dan berikan zona secara terpisah sebagai pengenal IANA. "birthDateTime": "1990-05-15T14:30:00" dengan "timezone": "America/New_York" berarti pukul setengah tiga sore di New York.
Tidak disarankan: Nilai yang diakhiri dengan Z atau offset numerik sudah tidak disarankan. MCP meneruskannya dan API masih menerimanya untuk saat ini dengan membacanya sebagai UTC; penghentian dukungan diumumkan dalam respons API. Nilai tersebut akan berhenti diterima dan tanggalnya akan diumumkan sebelumnya. Baca aturan lengkapnya.
Permintaan
JSON-RPC yang disanitasi
{
"jsonrpc": "2.0",
"id": 3,
"method": "tools/call",
"params": {
"name": "generate_chart",
"arguments": {
"birthDateTime": "1990-05-15T14:30:00",
"timezone": "America/New_York",
"detailLevel": "core",
"idempotencyKey": "chart-1990-05-15-v1"
}
}
}Bentuk respons berhasil
- Tipe, strategi, otoritas, profil, dan definisi
- Pusat, kanal, gerbang, dan aktivasi
- Metadata kuota bersama hasil alat
Respons juga mencakup metadata tingkat paket dan kuota dari lapisan hak API. Kolom domain yang tepat berbeda menurut alat dan tingkat detail yang diminta.
Kesalahan
- Waktu lahir bukan waktu lokal pada jam
- Waktu lokal dilewati atau terulang akibat perubahan waktu musim panas
- Waktu lahir berada di masa depan
- Zona waktu tidak dikenal
- Detail penuh memerlukan Startup
- Kuota habis
Perilaku kuota
Setelah validasi masukan, otorisasi, dan pemeriksaan tingkat paket berhasil, upaya eksekusi yang mencapai penyedia kalkulasi menggunakan tepat satu unit API bersama—meskipun tahap penyajian berikutnya gagal. Masukan rusak atau ambigu, tingkat paket yang ditolak, referensi tidak dikenal, dan kegagalan lain sebelum penyedia kalkulasi menggunakan nol unit. Periksa penggunaan terkini di my.humandesign.ai.