generate_chart
Gib zentrale Bodygraph-Eigenschaften in einer stabilen, agentenfreundlichen Antwort zurück. Startup und höhere Tarife können die erweiterte Detailstufe full anfordern.
Ergebnis für Entwickler: Stelle einem KI-Produkt zuverlässige Bodygraph-Eingaben bereit, ohne dem Modell Berechnungsregeln für Charts beibringen zu müssen.
Parameter
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
birthDateTime | Zeichenfolge (lokale Uhrzeit) | Ja | Geburtsdatum und -zeit so, wie sie auf der Uhr am Geburtsort standen, ohne Z und ohne UTC-Versatz. Das Feld timezone gibt die Zeitzone an. |
timezone | Zeichenfolge | Ja | IANA-Zeitzone, z. B. America/New_York. |
detailLevel | „core“ | „full“ | Nein | Core ist in Free verfügbar; full erfordert Startup oder höher. |
idempotencyKey | Zeichenfolge | Ja | Stabiler Schlüssel für diese vorgesehene Berechnung. Verwende ihn bei einem erneuten Versuch nur mit identischen Argumenten. |
Geburtszeiten sind lokale Uhrzeiten. Gib Datum und Uhrzeit so an, wie sie auf der Uhr am Geburtsort standen, ohne Z und ohne UTC-Versatz, und gib die Zeitzone separat als IANA-Kennung an. „birthDateTime“: „1990-05-15T14:30:00“ mit „timezone“: „America/New_York“ bedeutet halb drei nachmittags in New York.
Veraltet: Werte mit abschließendem Z oder numerischem Versatz sind veraltet. MCP leitet sie weiter und die API akzeptiert sie vorerst noch, interpretiert sie dabei jedoch als UTC. Die API-Antwort weist auf die Veraltung hin. Sie werden künftig nicht mehr akzeptiert; das Datum wird rechtzeitig bekannt gegeben. Vollständige Regel lesen.
Anfrage
Bereinigtes JSON-RPC
{
"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 einer erfolgreichen Antwort
- Typ, Strategie, Autorität, Profil und Definition
- Zentren, Kanäle, Tore und Aktivierungen
- Kontingentmetadaten neben dem Toolergebnis
Die Antwort enthält außerdem Tarif- und Kontingentmetadaten aus der API-Berechtigungsebene. Die konkreten Felder hängen vom Tool und dem angeforderten Detailgrad ab.
Fehler
- Geburtszeit, die keine lokale Uhrzeit ist
- Zeitpunkt, der durch die Sommerzeit übersprungen oder wiederholt wurde
- Geburtszeitpunkt liegt in der Zukunft
- Unbekannte Zeitzone
- Für vollständige Details ist Startup erforderlich
- Kontingent überschritten
Kontingentverhalten
Nach erfolgreicher Eingabevalidierung, Autorisierung und Tarifprüfung verbraucht ein Ausführungsversuch, der den Berechnungsanbieter erreicht, genau eine gemeinsame API-Einheit – selbst wenn ein späterer Darstellungsschritt fehlschlägt. Fehlerhafte oder mehrdeutige Eingaben, abgelehnte Tarife, unbekannte Referenzen und andere Fehler vor dem Anbieteraufruf verbrauchen null Einheiten. Prüfe die aktuelle Nutzung unter my.humandesign.ai.