generate_chart
Restituisci le proprietà essenziali del bodygraph in una risposta stabile e adatta agli agenti. Dal piano Startup in su è possibile richiedere il livello completo di dettaglio.
Risultato per lo sviluppatore: Fornisci a un prodotto AI dati bodygraph affidabili senza dover insegnare al modello le regole di calcolo del grafico.
Parametri
| Nome | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
birthDateTime | stringa (ora locale) | Sì | Data e ora di nascita come appaiono sull’orologio del luogo di nascita, senza Z né scostamento UTC. Il campo timezone specifica il fuso. |
timezone | stringa | Sì | Fuso orario IANA, ad esempio America/New_York. |
detailLevel | "core" | "full" | No | Core è disponibile con Free; full richiede Startup o un piano superiore. |
idempotencyKey | stringa | Sì | Chiave stabile per questo calcolo. Riutilizzala solo con argomenti identici durante un nuovo tentativo. |
Gli orari di nascita sono espressi nell’ora locale. Invia data e ora di nascita come appaiono sull’orologio del luogo di nascita, senza Z né scostamento UTC, e specifica separatamente il fuso orario con un identificatore IANA. "birthDateTime": "1990-05-15T14:30:00" con "timezone": "America/New_York" indica le due e mezza del pomeriggio a New York.
Deprecato: I valori che terminano con Z o con un offset numerico sono deprecati. MCP li inoltra e per ora l’API li accetta ancora, interpretandoli come UTC; la risposta API segnala la deprecazione. In futuro non saranno più accettati e la data verrà comunicata in anticipo. Leggi la regola completa.
Richiesta
JSON-RPC sanificato
{
"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"
}
}
}Struttura della risposta di successo
- Tipo, strategia, autorità, profilo e definizione
- Centri, canali, porte e attivazioni
- Metadati della quota insieme al risultato dello strumento
La risposta include anche i metadati relativi al piano e alla quota forniti dal livello di autorizzazione dell’API. I campi esatti del dominio variano in base allo strumento e al livello di dettaglio richiesto.
Errori
- Ora di nascita che non corrisponde all’ora locale
- Ora saltata o ripetuta a causa del cambio dell’ora legale
- Ora di nascita futura
- Fuso orario sconosciuto
- Il dettaglio completo richiede Startup
- Quota superata
Comportamento della quota
Dopo il superamento della convalida dell’input, dell’autorizzazione e dei controlli del piano, ogni tentativo di esecuzione che raggiunge il servizio di calcolo consuma esattamente un’unità API condivisa, anche se una fase successiva di presentazione non riesce. Input malformati o ambigui, piani non autorizzati, riferimenti sconosciuti e altri errori precedenti al servizio consumano zero unità. Verifica l’utilizzo attuale su my.humandesign.ai.