generate_composite_chart
Genera i dati dei grafici individuali e le dinamiche relazionali combinate per due persone con una sola chiamata allo strumento.
Risultato per lo sviluppatore: Consenti all’agente di ragionare sulle dinamiche relazionali usando dati strutturati coerenti.
Parametri
| Nome | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
personA | oggetto | Sì | Data ISO e fuso orario IANA della prima persona. |
personB | oggetto | Sì | Data ISO e fuso orario IANA della seconda persona. |
idempotencyKey | stringa | Sì | Chiave stabile per questo calcolo composito. 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_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"
}
}
}Struttura della risposta di successo
- Entrambi i bodygraph individuali
- Centri, canali e connessioni elettromagnetiche combinati
- Metadati strutturati a livello relazionale
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
- Dati mancanti della persona
- Data o fuso orario non validi
- 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.