generate_chart
Returnați proprietățile bodygraph principale într-un răspuns stabil, ușor de folosit de agenți. Planul Startup și cele superioare pot solicita nivelul extins de detalii.
Rezultatul pentru dezvoltator: Oferiți unui produs AI date bodygraph fiabile fără să învățați modelul regulile de calcul al diagramelor.
Parametri
| Nume | Tip | Obligatoriu | Descriere |
|---|---|---|---|
birthDateTime | string (oră locală de pe ceas) | Da | Data și ora nașterii exact așa cum arăta ceasul în locul în care s-a născut persoana, fără Z și fără decalaj UTC. Câmpul timezone specifică fusul. |
timezone | string | Da | Fus orar IANA, precum America/New_York. |
detailLevel | "core" | "full" | Nu | Core este disponibil în Free; full necesită Startup sau un nivel superior. |
idempotencyKey | string | Da | Cheie stabilă pentru acest calcul intenționat. Reutilizați-o numai cu argumente identice atunci când reîncercați. |
Orele nașterii sunt ore locale indicate de ceas. Trimiteți data și ora nașterii exact așa cum arăta ceasul în locul în care s-a născut persoana, fără Z și fără decalaj UTC, iar fusul orar transmiteți-l separat ca identificator IANA. "birthDateTime": "1990-05-15T14:30:00" împreună cu "timezone": "America/New_York" înseamnă ora două și jumătate după-amiaza la New York.
Depreciat: Valorile care se termină în Z sau conțin un decalaj numeric sunt depreciate. MCP le transmite, iar API-ul încă le acceptă pentru moment, interpretându-le ca UTC și anunțând deprecierea în răspunsul API. Nu vor mai fi acceptate; data va fi anunțată în avans. Citiți regula completă.
Solicitare
JSON-RPC igienizat
{
"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"
}
}
}Structura răspunsului de succes
- Tip, strategie, autoritate, profil și definiție
- Centre, canale, porți și activări
- Metadate despre cotă alături de rezultatul instrumentului
Răspunsul include și metadate despre nivel și cotă, furnizate de componenta care gestionează drepturile API. Câmpurile exacte ale domeniului variază în funcție de instrument și de nivelul de detaliu solicitat.
Erori
- Ora nașterii nu este o oră locală de pe ceas
- Ora a fost sărită sau repetată din cauza unei schimbări de oră de vară
- Ora nașterii este în viitor
- Fus orar necunoscut
- Detaliile complete necesită Startup
- Cotă epuizată
Comportamentul cotei
După trecerea verificărilor de validare a intrărilor, autorizare și nivel, o încercare de execuție care ajunge la furnizorul de calcul consumă exact o unitate API comună, chiar dacă un pas ulterior de prezentare eșuează. Intrările malformate sau ambigue, nivelurile neautorizate, referințele necunoscute și alte erori apărute înainte de furnizor consumă zero. Verificați utilizarea actuală la my.humandesign.ai.