Tendências comparativas de ICSAP
compare_icsap_trendsCompare temporal trends in primary care-sensitive conditions (ICSAP) between Brazilian states or CSAP groups, calculate annual variation, and identify higher and lower performers.
Instructions
Análise temporal comparativa de ICSAP entre UFs ou grupos CSAP. Calcula tendências, variação anual e identifica melhores/piores desempenhos. Para percentage e count valem todos os anos do SIH (desde 1992); rate_per_10k exige população e aceita só os anos de get_available_years.population_years. Em 1992–1997 a ICSAP vem de lista CID-9 DERIVADA e não oficial (g03 e g05 não comparáveis com 1998+) e uf é a UF do arquivo — ver as notes. Percentual no universo do pacote R csapAIH por padrão (universe): fora do numerador e do denominador as internações por procedimento obstétrico, parto e longa permanência.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"start_year": "<start_year>",
"end_year": "<end_year>"
},
"name": "compare_icsap_trends"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end_year | Yes | Ano final | |
| universe | No | Universo do % ICSAP: 'csapaih' (padrão) tira do numerador e do denominador as internações por procedimento obstétrico, com diagnóstico de parto (O80-O84) e as AIH de longa permanência, como o pacote R csapAIH (Nedel); 'all' conta todas as internações. | |
| indicator | No | Indicador: percentage (% ICSAP), count (número), rate_per_10k (taxa) | |
| compare_by | No | Comparar por UF ou grupo CSAP | |
| start_year | Yes | Ano inicial | |
| compare_values | No | Valores específicos para comparar (UFs ou grupos CSAP) | |
| include_trend_line | No | Incluir análise de tendência linear (default: true) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | Sempre vazio: só aparece no caminho de erro-mole do funil | |
| note | No | Como obter o dado (por exemplo, consultar get_available_years) | |
| error | No | Motivo pelo qual não há dados nesta resposta (ano sem dado, cobertura populacional, falha na consulta) | |
| notes | No | Avisos que qualificam os números: era CID-9, raça/cor ausente, universo do % ICSAP, denominador populacional, truncamento | |
| period | No | Intervalo de anos pedido | |
| series | No | Pontos em ordem cronológica | |
| trends | No | Tendência por valor comparado; só com `include_trend_line` e ao menos dois anos — ausente quando desligada | |
| summary | No | Melhor e pior evolução entre os valores comparados (pela variação entre as pontas) e como ler o indicador; vazio quando não há o que dizer | |
| indicator | No | Indicador das séries | |
| compare_by | No | Eixo comparado: uf, csap_group ou total (sem eixo) | |
| provenance | Yes | Um bloco por procedência que contribuiu com esta resposta (SIH, lista CSAP, csapAIH, população…); licenças nunca se fundem | |
| attribution | Yes | URLs canônicas das fontes desta resposta (lista de atribuição) | |
| published_years | No | Anos que o canal de cubos publica — a verdade do canal, distinta do que esta instância tem em disco; só com o cache de cubos ligado | |
| population_years | No | Cobertura populacional; só no erro-mole de `rate_per_10k` fora do intervalo | |
| available_sih_years | No | Anos com dados SIH atendíveis por este servidor | |
| years_not_available | No | Presente só quando parte dos anos pedidos não tem dado: os números cobrem apenas os anos atendidos |