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» означає 14:30 у Нью-Йорку.
Застарілий формат: Формат значень, що закінчуються на 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.