generate_chart
Zwróć podstawowe właściwości bodygraphu w stabilnej odpowiedzi przystosowanej do agentów. Startup i wyższe plany mogą zażądać rozszerzonego poziomu full.
Korzyść dla dewelopera: Dostarczaj produktowi AI wiarygodne dane bodygraph bez uczenia modelu zasad obliczania wykresu.
Parametry
| Imię | Typ | Wymagane | Opis |
|---|---|---|---|
birthDateTime | string (lokalny czas zegarowy) | Tak | Data i godzina urodzenia dokładnie tak, jak wskazywał zegar w miejscu urodzenia, bez Z i przesunięcia UTC. Pole strefy czasowej określa strefę. |
timezone | string | Tak | Strefa czasowa IANA, np. America/New_York. |
detailLevel | "core" | "full" | Nie | Core jest dostępne w planie Free; full wymaga Startup lub wyższego planu. |
idempotencyKey | string | Tak | Stabilny klucz dla tego konkretnego obliczenia. Używaj go ponownie podczas ponawiania wywołania wyłącznie przy identycznych argumentach. |
Godziny urodzenia podawaj jako lokalny czas zegarowy. Podaj datę i godzinę dokładnie tak, jak wskazywał zegar w miejscu urodzenia, bez Z i bez przesunięcia UTC. Strefę czasową podaj osobno jako identyfikator IANA. Wartość "birthDateTime": "1990-05-15T14:30:00" wraz z "timezone": "America/New_York" oznacza godzinę 14:30 w Nowym Jorku.
Wycofywane: Wartości kończące się na Z lub zawierające przesunięcie liczbowe są wycofywane. MCP przekazuje je dalej, a API na razie nadal je akceptuje, odczytując jako UTC, i informuje o wycofywaniu w odpowiedzi. W przyszłości nie będą akceptowane; termin zostanie podany z wyprzedzeniem. Przeczytaj pełną zasadę.
Żądanie
Oczyszczony 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"
}
}
}Struktura odpowiedzi w przypadku powodzenia
- Typ, strategia, autorytet, profil i definicja
- Centra, kanały, bramy i aktywacje
- Metadane limitu obok wyniku narzędzia
Odpowiedź zawiera również metadane poziomu i limitu dostarczone przez warstwę uprawnień API. Dokładne pola zależą od narzędzia i żądanego poziomu szczegółowości.
Błędy
- Godzina urodzenia, która nie jest lokalnym czasem zegarowym
- Godzina pominięta lub powtórzona wskutek zmiany czasu letniego
- Data urodzenia w przyszłości
- Nieznana strefa czasowa
- Pełny poziom szczegółowości wymaga Startup
- Przekroczony limit
Zasady limitu
Po pomyślnym przejściu weryfikacji danych, uprawnień i poziomu planu próba wykonania, która dotrze do dostawcy obliczeń, zużywa dokładnie jedną wspólną jednostkę API — nawet jeśli późniejszy etap prezentacji się nie powiedzie. Błędne lub niejednoznaczne dane, odmowa dostępu do poziomu, nieznane odwołania i inne problemy przed przekazaniem do dostawcy zużywają zero jednostek. Bieżące użycie sprawdzisz pod adresem my.humandesign.ai.