Prompts
As perguntas monitoradas, o desempenho de cada uma e o texto das respostas das IAs.
list_prompts
Os prompts monitorados com o desempenho no período. Cada item traz citationRatePct, a porcentagem das conversas em que a marca foi citada (0 a 100). Serve pra achar os prompts mais fracos e os mais fortes.
Pergunte assim: "quais os 10 prompts em que eu menos apareço?", "onde eu mais caí este mês?"
- brand_idstringobrigatório
- UUID da marca.
- orderenum
worst_first(padrão, piores primeiro) oubest_first.- limitinteger
- Padrão 50, máximo 100.
- searchstring
- Só prompts que contêm esse texto.
- exclude_termsstring[]
- Tira prompts que contêm qualquer um desses termos.
- with_trendboolean
- Traz também a taxa do período anterior (
previousCitationRatePct) e a diferença (deltaCitationRatePct). - periodenum
- Padrão
7d. - start_date / end_datestring
- Janela exata.
- llm_providerstring
- Só uma IA.
- segment_idstring
- Só um segmento.
list_prompts só mostra prompts que já rodaram no período. Pra ver o inventário completo, incluindo prompts recém-criados, use list_monitored_prompts.
list_monitored_prompts
O inventário de prompts cadastrados, independente de desempenho. Inclui os que acabaram de ser adicionados e ainda não rodaram.
Pergunte assim: "quais prompts eu monitoro?", "quais prompts estão sem segmento?"
- brand_idstringobrigatório
- UUID da marca.
- segment_idstring
- Só um segmento.
- unsegmented_onlyboolean
- Só prompts sem segmento.
- countrystring
- País, em duas letras (
BR,US). - searchstring
- Só prompts que contêm esse texto.
- include_inactiveboolean
- Inclui prompts desativados. Padrão
false. - limitinteger
- Padrão 100, máximo 200.
list_segments
Os segmentos da marca, com quantos prompts ativos cada um agrupa. É de onde vêm os segment_id.
- brand_idstringobrigatório
- UUID da marca.
get_prompt_deep_dive
Tudo sobre um prompt: desempenho em cada IA, concorrentes que mais aparecem nele, fontes mais citadas, o que as IAs pesquisaram na web, presença em Shopping, mapa e posts do X, e um trecho da última resposta de cada IA.
Pergunte assim: "me explica o que está acontecendo no prompt sobre preço"
- brand_idstringobrigatório
- UUID da marca.
- brand_prompt_idstringobrigatório
- UUID do prompt.
- periodenum
- Padrão
7d. - start_date / end_datestring
- Janela exata.
get_recent_responses
As últimas respostas completas das IAs pra um prompt, com o trecho onde a marca foi citada, como os concorrentes aparecem na mesma resposta, as fontes e as pesquisas feitas. É a tool pra análise qualitativa: tom, argumentos, como a marca é descrita.
Pergunte assim: "como o ChatGPT fala de mim nesse prompt?", "como o concorrente X é apresentado?"
- brand_idstringobrigatório
- UUID da marca.
- brand_prompt_idstringobrigatório
- UUID do prompt.
- limit_per_providerinteger
- Respostas por IA. Padrão 3, máximo 5.
- llm_providerstring
- Só uma IA.
- only_mentioning_brandboolean
- Só respostas que citam a marca.
- only_mentioning_competitor_idstring
- Só respostas que citam esse concorrente.
suggest_prompts
Reúne o contexto pra IA sugerir prompts novos: dados da marca, uma amostra dos prompts já monitorados, os prompts em que você perde (com o concorrente e a fonte que dominam), países e segmentos. A sugestão em si é escrita pela IA que você está usando.
Pergunte assim: "sugira 5 prompts novos que eu deveria monitorar"
- brand_idstringobrigatório
- UUID da marca.