generate_composite_chart
أنشئ بيانات المخطط الفردي وديناميكيات العلاقة المشتركة لشخصين من خلال استدعاء أداة واحدة.
النتيجة للمطور: مكّن الوكيل من تحليل آليات العلاقة باستخدام بيانات منظمة ومتسقة.
المعلمات
| الاسم | النوع | مطلوب | الوصف |
|---|---|---|---|
personA | كائن | نعم | تاريخ ميلاد الشخص الأول بصيغة ISO والمنطقة الزمنية وفق IANA. |
personB | كائن | نعم | تاريخ ميلاد الشخص الثاني بصيغة ISO والمنطقة الزمنية وفق IANA. |
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_composite_chart",
"arguments": {
"personA": {
"birthDateTime": "1990-05-15T14:30:00",
"timezone": "America/New_York"
},
"personB": {
"birthDateTime": "1988-11-02T08:15:00",
"timezone": "Europe/London"
},
"idempotencyKey": "composite-example-v1"
}
}
}شكل استجابة النجاح
- المخططان الجسديان لكل شخص
- المراكز والقنوات والروابط الكهرومغناطيسية المجمعة
- بيانات وصفية منظمة على مستوى العلاقة
تتضمن الاستجابة أيضًا بيانات الفئة والحصة من طبقة استحقاق API. وتختلف حقول المجال الدقيقة بحسب الأداة ومستوى التفاصيل المطلوب.
الأخطاء
- مدخلات الشخص مفقودة
- تاريخ أو منطقة زمنية غير صالحة
- تجاوز الحصة
سلوك الحصة
بعد اجتياز التحقق من المدخلات والتفويض والفئة، تستهلك محاولة التنفيذ التي تصل إلى مزود الحساب وحدة API مشتركة واحدة بالضبط، حتى إذا فشلت خطوة عرض لاحقة. ولا تستهلك المدخلات المشوهة أو الملتبسة والفئات المرفوضة والمراجع غير المعروفة وغيرها من حالات الفشل السابقة للمزود أي وحدات. تحقق من الاستخدام الحالي على my.humandesign.ai.