generate_chart
Renvoie les propriétés essentielles du bodygraph dans un résultat stable adapté aux agents. Les niveaux Startup et supérieurs peuvent demander le niveau de détail complet.
Résultat pour le développeur : Fournissez à un produit d’IA des données bodygraph fiables sans lui enseigner les règles de calcul des graphiques.
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
birthDateTime | chaîne (heure locale) | Oui | Date et heure de naissance telles qu’elles apparaissaient sur l’horloge du lieu de naissance, sans Z ni décalage UTC. Le champ timezone fournit le fuseau. |
timezone | chaîne | Oui | Fuseau horaire IANA, par exemple America/New_York. |
detailLevel | « core » | « full » | Non | Core est disponible dans Free ; full nécessite Startup ou un niveau supérieur. |
idempotencyKey | chaîne | Oui | Clé stable pour ce calcul prévu. Réutilisez-la uniquement avec des arguments identiques lors d’un nouvel essai. |
Les heures de naissance sont des heures locales telles qu’affichées par l’horloge. Indiquez la date et l’heure de naissance telles qu’elles apparaissaient sur l’horloge du lieu de naissance, sans Z ni décalage UTC, et indiquez séparément le fuseau sous forme d’identifiant IANA. « birthDateTime » : « 1990-05-15T14:30:00 » avec « timezone » : « America/New_York » signifie quatorze heures trente à New York.
Obsolète : Les valeurs se terminant par Z ou par un décalage numérique sont obsolètes. MCP les transmet et l’API les accepte encore pour le moment en les interprétant comme UTC ; la dépréciation est signalée dans la réponse de l’API. Elles ne seront plus acceptées, et la date sera annoncée à l’avance. Lire la règle complète.
Requête
JSON-RPC assaini
{
"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"
}
}
}Format de réponse en cas de succès
- Type, stratégie, autorité, profil et définition
- Centres, canaux, portes et activations
- Métadonnées de quota avec le résultat de l’outil
La réponse comprend également les métadonnées de niveau et de quota fournies par la couche de droits de l’API. Les champs exacts varient selon l’outil et le niveau de détail demandé.
Erreurs
- Heure de naissance qui n’est pas une heure locale
- Heure sautée ou répétée lors du passage à l’heure d’été
- Date de naissance dans le futur
- Fuseau horaire inconnu
- Le niveau de détail complet nécessite Startup
- Quota dépassé
Comportement du quota
Après validation des données, autorisation et vérification du niveau, une tentative d’exécution qui atteint le fournisseur de calcul consomme exactement une unité API partagée, même si une étape de présentation ultérieure échoue. Les données mal formées ou ambiguës, les niveaux refusés, les références inconnues et les autres échecs avant le fournisseur consomment zéro unité. Vérifiez l’utilisation actuelle sur my.humandesign.ai.