generate_chart
החזירו מאפייני מפת גוף מרכזיים בתשובה יציבה ונוחה לסוכנים. ברמת Startup ומעלה ניתן לבקש את רמת הפירוט המורחבת.
תוצאה למפתחים: ספקו למוצר AI קלטי מפת גוף אמינים בלי ללמד את המודל את כללי חישוב המפות.
פרמטרים
| שם | סוג | נדרש | תיאור |
|---|---|---|---|
birthDateTime | מחרוזת (שעה מקומית לפי השעון שעל הקיר) | כן | תאריך ושעת הלידה כפי שהופיעו בשעון במקום הלידה, ללא Z וללא היסט UTC. שדה אזור הזמן מציין את האזור. |
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.