Estatísticas Invokely

Visão Geral

Use o servidor Invokely MCP configurado quando uma pergunta precisar de uma figura estatística oficial, série, comparação ou ranking. O serviço expõe seis operações de estatísticas e retorna informações de origem com suas figuras. Esta habilidade fornece um fluxo de trabalho de consulta e relatórios; ela não configura o cliente nem inclui o código do serviço hospedado da Invokely.

O conteúdo adapta uma habilidade comunitária de estevecastells/awesome-copilot. A contribuição original está aberta e não mesclada; veja o link da origem fixado e o PR em Recursos Adicionais. O autor da habilidade é afiliado à Invokely.

Quando Usar Esta Habilidade

• Use quando um usuário pedir um número oficial, uma série temporal, uma comparação entre locais ou um ranking de locais.
• Use quando a resposta precisar de uma fonte que possa ser citada e um período e unidade estatísticos claros.
• Use quando uma pergunta descrever uma medida ou local em linguagem comum e precisar ser correspondida a um indicador suportado ou local normalizado.

Como Funciona

1. Clarificar a medida, local e período

Identifique a estatística solicitada, a entidade geográfica e nível, o período e a frequência. Faça uma pergunta curta se uma ambiguidade puder mudar o resultado. Use apenas a conexão MCP invokely configurada. Se não estiver disponível, aponte para o guia de conexão oficial; não edite a configuração do cliente nem peça ao usuário para colar um segredo como parte deste fluxo de trabalho.

2. Encontrar o indicador e local exatos

• Chame search_indicators quando o usuário descrever uma medida em linguagem comum ou o ID exato do indicador for desconhecido. Passe geography quando a solicitação nomear um local específico. Leia a definição, unidade, frequências, níveis suportados e notas retornados antes de selecionar um ID.
• Chame resolve_place quando um nome puder se referir a mais de uma entidade ou o usuário precisar de um código oficial. Prefira o local e código normalizados retornados. Se vários resultados permanecerem plausíveis, pergunte qual deles o usuário deseja.
• Nunca invente IDs de indicador, IDs de local, períodos, frequências ou nomes de argumentos. Siga o esquema e as descrições atuais da ferramenta.

3. Escolher a operação de estatísticas

• Use get_value para uma figura. Omita period para o valor mais recente disponível. Quando um período ou frequência for solicitado, passe-o explicitamente no formato mostrado pela ferramenta, como 2024, 2024-Q3, 2024-S1 ou 2024-09.
• Use get_series para uma tendência. Defina o intervalo e a frequência solicitados quando necessário. Verifique truncated, lacunas, sinalizadores e notas; não apresente uma série parcial como completa. Solicite include_projections apenas quando o usuário pedir projeções ou previsões.
• Use compare para comparar um indicador entre locais para um período. Preserve o valor comparable retornado e explique quaisquer diferenças de origem ou período quando for falso.
• Use rank_places para um ranking. Declare o nível do local, área, período, ordenação e limite. Para taxas em pequenos municípios, considere min_population para que um denominador pequeno não domine o ranking.

4. Relatar a evidência

Para cada figura, relate o indicador, local, valor, unidade e período estatístico. Mantenha o período distinto da data de recuperação da origem. Inclua a editora, URL da origem e citação retornada. Preserve notas de origem significativas e sinalizadores de status como provisional, estimated ou low_reliability. Explique quando uma origem usa uma definição ou frequência particular que afeta a interpretação.

Mantenha as projeções separadas dos valores observados e rotule-as como projeções. Se a ferramenta relatar que um local ou período não tem dados, diga que está indisponível; não estime, transfira ou preencha a lacuna você mesmo.

5. Lidar com erros e limites com precisão

Se uma chamada falhar ou retornar um erro de autenticação, plano ou limite de uso, relate esse resultado e o próximo passo documentado pela Invokely. Não afirme que uma consulta foi bem-sucedida, altere a autenticação ou tente novamente de forma a contornar um limite. Verifique a documentação atual da Invokely e a página de preços, pois os requisitos de conexão e os limites do plano podem mudar.

Exemplos

Última população de um país

1. Pesquise population com o país solicitado como geography.
2. Verifique a definição, unidade, frequência e local do resultado.
3. Chame get_value com o ID do indicador retornado e o ID do local normalizado, omitindo o período para a figura mais recente disponível.
4. Relate o período, valor, unidade, editora, URL, data de recuperação e citação retornados.

Por exemplo, pesquise com:

…