Resumo dos resultados

Responde "e aí, o que a pesquisa disse?" com números e uma conclusão, em vez de uma exportação bruta

Skill grátis para Claude Code, Codex, Cursor e Gemini CLI. Funciona pelo servidor MCP do SurveyNinja, com as suas permissões.

Categoria
Entender os resultados
Tags
relatório, respostas abertas, comparação
Funciona com
Claude Code, Codex, Cursor, Gemini CLI
Ferramentas MCP
9, 1 alteram dados
Versão
1.1, 20 de outubro de 2026
Feita por
SurveyNinja
Preço
Grátis
Veja também
Análise de pesquisas com IARelatórios de pesquisas
Arquivo da skill
SKILL.md

O que ela faz

  • Primeiro a conclusão, depois os números. Em vez de "a pergunta 3 tem esta distribuição", você lê "dois terços estão insatisfeitos com o prazo" e depois vê o detalhamento.
  • Todo percentual tem uma base. Você sempre sabe se a proporção vem de todas as respostas ou só das concluídas.
  • Arquivo só se você pedir. No chat você recebe números. A exportação para Excel só aparece quando você pede.

Exemplo

Você escreve

O que a pesquisa mostrou? Me dá a versão curta

O que o assistente traz

412
Começaram
318
Concluíram77%
4,1
Nota médiade 5
186
Deixaram contato45% de quem começou
  • Muito satisfeito 134 (42%)
  • Satisfeito 92 (29%)
  • Neutro 48 (15%)
  • Insatisfeito 29 (9%)
  • Muito insatisfeito 15 (5%)
O ponto principal é o prazo, não o preço

Nas respostas abertas, 41 de 96 pessoas citam a espera e 12 citam o preço. Os percentuais acima saem de 318 respostas concluídas; as abandonadas ficam de fora.

Os números acima são um exemplo. O resumo é montado com as suas respostas reais.

Como funciona

  1. Começa pelo resumo e pelo relatórioO SurveyNinja já calcula as distribuições. As respostas uma a uma só são necessárias para uma pessoa específica ou para citar alguma coisa.
  2. Confere se os dados estão completosSe muita gente abandonou a pesquisa, essas respostas são contadas à parte em vez de entrar no mesmo número das concluídas.
  3. Filtra quando você dá uma condição"Só setembro", "só quem escolheu a opção premium", "só quem veio do e-mail". A skill filtra por datas, respostas, tags ou conjuntos de links em vez de contar a olho.
  4. Começa pela conclusãoVocê lê primeiro "dois terços estão insatisfeitos com o prazo" e depois a base desse percentual.

Experimente também

  • Mostre os resultados só de setembro e só de quem veio pelo e-mail
  • Resuma a pesquisa e me diga o que merece atenção

O que ela não faz

  • Não exportar arquivo sem você pedir.
  • Não recalcular à mão o que o resumo ou o relatório já entregam.
  • Não misturar concluídas e abandonadas num número sem avisar.
  • Não sugerir troca de plano nem levar ao pagamento.

A skill funciona com as suas permissões. As ferramentas que alteram dados vêm marcadas, então você confere o que o assistente vai fazer antes de confirmar. Para cortar o acesso, remova o conector no assistente ou apague a chave de API.

Em resumo

Por onde a skill começa?

Pelo resumo da pesquisa e pelo relatório por pergunta, onde distribuições e percentuais já estão calculados. Ela lê respostas individuais só quando você pergunta por uma específica ou quando precisa de uma citação.

Dá para ver os resultados só de setembro ou de um canal?

Sim. Diga a condição e a skill monta um recorte por datas, por respostas a uma pergunta, por tags ou por um conjunto de links únicos. Recortes por datas, respostas e tags não estão em todos os planos. Para separar canais, cada um precisa do seu próprio conjunto de links únicos; uma etiqueta no link é contada nas respostas que a trazem.

Como ela trata as respostas abandonadas?

Separadamente. Primeiro confere quantas pessoas concluíram e, se muitas desistiram, avisa. Concluídas e abandonadas nunca entram no mesmo número sem uma observação.

E as respostas abertas?

A skill não repete uma por uma. Ela agrupa por temas e traz algumas citações típicas.

Ela tira conclusões mesmo com poucas respostas?

Não como fato. Com umas dez respostas, ela diz com clareza que os dados não bastam para concluir.

A skill muda alguma coisa na minha pesquisa?

Não. Ela só lê o resumo, o relatório e as respostas, e gera um arquivo de exportação apenas se você pedir. O link de download funciona por uma hora.

A skill completa

O arquivo SKILL.md que o assistente lê, exatamente como está no arquivo para download.

Ver o texto completo

What the survey showed

The answer is a few numbers with an explanation of what they mean. A dump of raw responses is not an answer.

Reply to the person in the language they write in.

Which tool for what

This is where the wrong tool gets picked most often:

What you need Tool What it returns
The funnel get_quiz_summary visits, completed, abandoned, completion rate, screened out, average time, by day, devices, countries
Answers per question get_quiz_report distributions for every question, completed responses only
A slice by answers, tags or a set of unique links generate_filtered_report the same report over the selected responses
Individual submissions get_quiz_answers raw responses one by one
Free text of one question get_quiz_report_inputs text answers, 50 per page
A file for a human export_answers_xlsx and the other export_* tools a download link

Start with the summary and the report, not with raw answers. Raw answers are for a specific submission or for quoting examples.

Order

  1. get_quiz_summary: how many visited, how many finished, how many abandoned. If many abandoned, say so and treat them separately.
  2. get_quiz_report: the distributions. It counts completed responses only, whatever is_complete says. Unfinished ones are read one by one with get_quiz_answers with is_complete false, if the plan keeps them; if it does not, that call quietly returns completed ones, so check is_complete on each response.
  3. If a condition was named, such as "September only" or "only people who chose the premium option", build a slice: dates in get_quiz_report, answers and tags in generate_filtered_report. Dates, answers and tags apply only when the plan includes results filters; otherwise the report covers everything and does not say so. Check get_workspace_tariff (the workspace_id comes from get_workspace_list) or compare the totals with the summary. For "only from the link I sent by email", check how that link was marked: a set of unique links filters directly, on any plan. A link label such as utm_source is in the extra_fields of each response from get_quiz_answers: count the responses with that value there. No tool builds the whole report for one label value; in the app that is the Hidden Variables filter in Results.
  4. Open answers: get_quiz_report_inputs with the report_uuid from the report and the question's widget_id and widget_hash from get_quiz_structure. It returns 50 answers per page: page with offset to read them all. The texts follow the report filters saved in the app, not the slice built here.
  5. Export a file only if a file was asked for. The link lives for one hour.

How to answer

  • Conclusion first, numbers second. Not "question 3 has this distribution" but "two thirds are unhappy with turnaround times, here is the breakdown".
  • Always name the base for a percentage: all submissions or completed ones.
  • Do not present conclusions from ten responses as fact.
  • Do not retell free text one by one. Group it into themes with a couple of representative quotes.

What not to do

  • Do not export a file unasked. Chat needs numbers, not a download link.
  • Do not recompute by hand what the summary or the report already provides.
  • Do not mix completed and abandoned in one figure without saying so.
  • Do not suggest a plan upgrade or lead to payment. If a limit is hit or a feature is not on the plan, state the fact and stop.
O ninja do SurveyNinja em um foguete

Conecte o SurveyNinja ao seu assistente

O servidor MCP funciona em todos os planos, inclusive no Free. Crie sua conta, permita o acesso e peça ao assistente para montar a primeira pesquisa.