generate_chart
Возвращает основные свойства бодиграфа в стабильном формате, удобном для агентов. На тарифе Startup и выше доступен расширенный уровень полной детализации.
Польза для разработчика: Предоставьте ИИ-продукту надёжные исходные данные бодиграфа, не обучая модель правилам расчёта карты.
Параметры
| Имя | Тип | Обязательный | Описание |
|---|---|---|---|
birthDateTime | строка (местное время на часах) | Да | Дата и время рождения точно такими, какими они были на часах в месте рождения человека, без Z и смещения UTC. Часовой пояс задаётся отдельно в поле timezone. |
timezone | строка | Да | Часовой пояс IANA, например America/New_York. |
detailLevel | "core" | "full" | Нет | Уровень core доступен на Free; для full нужен тариф Startup или выше. |
idempotencyKey | строка | Да | Стабильный ключ для этого предполагаемого расчёта. При повторном запросе используйте его только с идентичными аргументами. |
Время рождения указывается как местное время на часах. Укажите дату и время рождения точно такими, какими они были на часах в месте рождения человека, без Z и смещения UTC; часовой пояс задайте отдельно в формате идентификатора IANA. Значение "birthDateTime": "1990-05-15T14:30:00" с "timezone": "America/New_York" означает половину третьего дня по времени Нью-Йорка.
Устарело: Значения, оканчивающиеся на Z или числовое смещение, считаются устаревшими. MCP передаёт их, а API пока принимает, интерпретируя как UTC; в ответе API указывается, что формат устарел. Позднее такие значения перестанут приниматься; дату объявят заранее. Прочитать полное правило.
Запрос
Очищенный 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"
}
}
}Формат успешного ответа
- Тип, стратегия, авторитет, профиль и определённость
- Центры, каналы, ворота и активации
- Метаданные квоты вместе с результатом инструмента
Ответ также содержит метаданные тарифа и квоты, предоставленные уровнем прав API. Точные поля зависят от инструмента и запрошенного уровня детализации.
Ошибки
- Время рождения указано не как местное время на часах
- Время пропущено или повторилось из-за перехода на летнее время
- Время рождения указано в будущем
- Неизвестный часовой пояс
- Полная детализация доступна на тарифе Startup
- Квота исчерпана
Расходование квоты
После успешного прохождения проверок входных данных, доступа и тарифа попытка, которая доходит до провайдера расчётов, расходует ровно одну общую единицу API — даже если на последующем этапе отображения возникнет сбой. Некорректные или неоднозначные данные, отказ по тарифу, неизвестные справочные элементы и другие ошибки до обращения к провайдеру ничего не расходуют. Проверяйте текущее использование на странице my.humandesign.ai.