generate_composite_chart
Buat data bagan individu dan dinamika hubungan gabungan untuk dua orang melalui satu pemanggilan alat.
Hasil bagi pengembang: Biarkan agen menalar dinamika hubungan menggunakan data terstruktur yang konsisten.
Parameter
| Nama | Ketik | Wajib | Deskripsi |
|---|---|---|---|
personA | object | Ya | Tanggal ISO dan zona waktu IANA untuk orang pertama. |
personB | object | Ya | Tanggal ISO dan zona waktu IANA untuk orang kedua. |
idempotencyKey | string | Ya | Key stabil untuk kalkulasi komposit 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_composite_chart",
"arguments": {
"personA": {
"birthDateTime": "1990-05-15T14:30:00",
"timezone": "America/New_York"
},
"personB": {
"birthDateTime": "1988-11-02T08:15:00",
"timezone": "Europe/London"
},
"idempotencyKey": "composite-example-v1"
}
}
}Bentuk respons berhasil
- Kedua bodygraph individu
- Pusat, kanal, dan koneksi elektromagnetik gabungan
- Metadata terstruktur tingkat hubungan
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
- Masukan orang tidak ada
- Tanggal atau zona waktu tidak valid
- 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.