generate_chart
Trả về các thuộc tính bodygraph cốt lõi theo định dạng ổn định, thân thiện với tác nhân. Gói Startup trở lên có thể yêu cầu mức chi tiết mở rộng đầy đủ.
Kết quả dành cho nhà phát triển: Cung cấp đầu vào bodygraph đáng tin cậy cho sản phẩm AI mà không cần dạy mô hình các quy tắc tính biểu đồ.
Tham số
| Tên | Loại | Bắt buộc | Mô tả |
|---|---|---|---|
birthDateTime | chuỗi (giờ địa phương trên đồng hồ) | Có | Ngày giờ sinh theo giờ hiển thị trên đồng hồ tại nơi người đó sinh ra, không có Z và không có độ lệch UTC. Trường timezone cung cấp múi giờ. |
timezone | chuỗi | Có | Múi giờ IANA, chẳng hạn America/New_York. |
detailLevel | "core" | "full" | Không | Mức core có trên Free; full cần Startup trở lên. |
idempotencyKey | chuỗi | Có | Khóa ổn định cho phép tính dự kiến này. Khi thử lại, chỉ dùng lại khóa nếu các đối số giống hệt. |
Giờ sinh là giờ trên đồng hồ địa phương. Gửi ngày giờ sinh theo giờ hiển thị trên đồng hồ tại nơi người đó sinh ra, không có Z và không có độ lệch UTC; cung cấp riêng múi giờ dưới dạng mã IANA. "birthDateTime": "1990-05-15T14:30:00" cùng "timezone": "America/New_York" có nghĩa là hai giờ rưỡi chiều ở New York.
Đã lỗi thời: Các giá trị kết thúc bằng Z hoặc độ lệch số đã lỗi thời. Hiện MCP chuyển tiếp chúng và API vẫn chấp nhận tạm thời, đọc chúng như UTC và thông báo việc ngừng dùng trong phản hồi API. Chúng sẽ không còn được chấp nhận; ngày áp dụng sẽ được thông báo trước. Đọc toàn bộ quy tắc.
Yêu cầu
JSON-RPC đã làm sạch
{
"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"
}
}
}Cấu trúc phản hồi thành công
- Loại, chiến lược, thẩm quyền, hồ sơ và định nghĩa
- Trung tâm, kênh, cổng và kích hoạt
- Siêu dữ liệu hạn mức đi kèm kết quả công cụ
Phản hồi cũng bao gồm siêu dữ liệu cấp gói và hạn mức do lớp quyền API cung cấp. Các trường cụ thể theo miền thay đổi tùy công cụ và mức độ chi tiết được yêu cầu.
Lỗi
- Giờ sinh không phải giờ trên đồng hồ địa phương
- Giờ địa phương bị bỏ qua hoặc lặp lại do thay đổi giờ mùa hè
- Giờ sinh trong tương lai
- Múi giờ không xác định
- Mức chi tiết full cần Startup
- Đã vượt hạn mức
Cách tính hạn mức
Sau khi xác thực đầu vào, cấp quyền và kiểm tra cấp gói thành công, mỗi lần thực thi đi đến nhà cung cấp tính toán sẽ tiêu thụ chính xác một đơn vị API dùng chung, kể cả khi bước trình bày sau đó thất bại. Đầu vào sai định dạng hoặc mơ hồ, cấp gói bị từ chối, tham chiếu không xác định và các lỗi khác xảy ra trước nhà cung cấp sẽ không tiêu thụ đơn vị nào. Kiểm tra mức sử dụng hiện tại tại my.humandesign.ai.