generate_chart
Retorne as propriedades essenciais do bodygraph em uma resposta estável e adequada para agentes. Startup e níveis superiores podem solicitar o nível completo de detalhes.
Resultado para o desenvolvedor: Forneça dados confiáveis de bodygraph para um produto de IA sem precisar ensinar ao modelo as regras de cálculo dos gráficos.
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
birthDateTime | string (horário local) | Sim | Data e hora de nascimento como aparecem no relógio do local onde a pessoa nasceu, sem Z nem deslocamento UTC. O campo timezone informa o fuso. |
timezone | string | Sim | Fuso horário IANA, como America/New_York. |
detailLevel | "core" | "full" | Não | Core está disponível no Free; full requer Startup ou superior. |
idempotencyKey | string | Sim | Chave estável para este cálculo. Reutilize-a apenas com argumentos idênticos ao tentar novamente. |
Os horários de nascimento são horários locais. Envie a data e a hora de nascimento como aparecem no relógio do local onde a pessoa nasceu, sem Z nem deslocamento UTC, e informe o fuso separadamente como identificador IANA. "birthDateTime": "1990-05-15T14:30:00" com "timezone": "America/New_York" significa duas e meia da tarde em Nova York.
Obsoleto: Valores terminados em Z ou com deslocamento numérico estão obsoletos. O MCP os encaminha e a API ainda os aceita por enquanto, interpretando-os como UTC, e informa a descontinuação na resposta da API. Eles deixarão de ser aceitos; a data será anunciada com antecedência. Leia a regra completa.
Solicitação
JSON-RPC sanitizado
{
"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"
}
}
}Formato da resposta de sucesso
- Tipo, estratégia, autoridade, perfil e definição
- Centros, canais, portas e ativações
- Metadados da cota junto ao resultado da ferramenta
A resposta também inclui metadados do nível e da cota fornecidos pela camada de permissões da API. Os campos exatos do domínio variam conforme a ferramenta e o nível de detalhe solicitado.
Erros
- Horário de nascimento que não corresponde a um horário local
- Horário local inexistente ou repetido devido à mudança do horário de verão
- Horário de nascimento futuro
- Fuso horário desconhecido
- O detalhe full requer Startup
- Cota excedida
Funcionamento da cota
Após a validação da entrada, a autorização e as verificações de nível serem aprovadas, uma tentativa que chega ao provedor de cálculos consome exatamente uma unidade compartilhada da API, mesmo que uma etapa posterior de apresentação falhe. Entradas malformadas ou ambíguas, níveis não autorizados, referências desconhecidas e outras falhas anteriores ao provedor não consomem unidades. Consulte o uso atual em my.humandesign.ai.