generate_chart
Kembalikan sifat bodygraph teras dalam respons stabil yang mesra ejen. Startup dan ke atas boleh meminta tahap butiran penuh yang diperluas.
Hasil pembangun: Sediakan input bodygraph yang boleh dipercayai untuk produk AI tanpa mengajar model peraturan pengiraan carta.
Parameter
| Nama | Jenis | Wajib | Penerangan |
|---|---|---|---|
birthDateTime | rentetan (waktu tempatan pada jam) | Ya | Tarikh dan masa lahir tepat seperti yang tertera pada jam di tempat orang itu dilahirkan, tanpa Z atau ofset UTC. Medan timezone memberikan zon tersebut. |
timezone | rentetan | Ya | Zon waktu IANA seperti America/New_York. |
detailLevel | Nilai core | full | Tidak | Core tersedia pada Free; full memerlukan Startup atau lebih tinggi. |
idempotencyKey | rentetan | Ya | Kunci stabil untuk pengiraan ini. Gunakan semula hanya dengan argumen serupa apabila mencuba semula. |
Masa lahir ialah masa tempatan pada jam. Hantar tarikh dan masa lahir tepat seperti yang tertera pada jam di tempat orang itu dilahirkan, tanpa Z atau ofset UTC, dan nyatakan zon secara berasingan sebagai pengecam IANA. birthDateTime=1990-05-15T14:30:00 bersama timezone=America/New_York bermaksud pukul 2:30 petang di New York.
Tidak lagi disyorkan: Nilai yang berakhir dengan Z atau ofset angka tidak lagi disyorkan. MCP memajukannya dan API masih menerimanya buat masa ini sebagai UTC; keadaan ini diumumkan dalam respons API. Nilai tersebut akan berhenti diterima dan tarikhnya akan diumumkan lebih awal. Baca peraturan penuh.
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 berjaya
- Type, strategy, authority, profile dan definition
- Centers, channels, gates dan activations
- Metadata kuota bersama hasil alat
Respons turut merangkumi metadata tahap dan kuota yang dibekalkan oleh lapisan kelayakan API. Medan domain yang tepat berubah mengikut alat dan tahap butiran yang diminta.
Ralat
- Masa lahir bukan waktu tempatan pada jam
- Masa yang dilangkau atau berulang akibat perubahan waktu musim panas
- Masa lahir pada masa hadapan
- Zon waktu tidak diketahui
- Butiran penuh memerlukan Startup
- Kuota habis
Tingkah laku kuota
Selepas pengesahan input, kebenaran dan tahap pelan lulus, percubaan pelaksanaan yang mencapai penyedia pengiraan menggunakan tepat satu unit API bersama—walaupun langkah pembentangan kemudian gagal. Input cacat atau samar, tahap ditolak, rujukan tidak diketahui dan kegagalan sebelum penyedia menggunakan sifar. Semak penggunaan semasa di my.humandesign.ai.