> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/pt/acoes/workflow-concepts/workflow-steps/aeo-research/query-versus-report.md).

# Relatório Query Versus

Compare os resultados do Google e as citações de IA para um prompt-alvo com o Query Versus Report.

Query Versus Report analisa as páginas que competem por um prompt-alvo entre os resultados do Google e as citações de IA. Use-o para pesquisar uma oportunidade de conteúdo antes de você ter uma página própria para comparar.

## Visão geral

Forneça um Brand Kit e a pergunta que você quer analisar. O relatório reúne páginas concorrentes e pesquisas relacionadas para ajudar você a avaliar o conteúdo que aborda essa pergunta. Um prompt-alvo é obrigatório; uma palavra-chave sozinha não basta.

## Como Configurar

1. Adicione uma **Relatório Query Versus** Etapa para o seu fluxo de trabalho.
2. Defina o **ID do Brand Kit** quanto no **Prompt-alvo**.
3. Opcionalmente, defina um tipo de conteúdo para focar as páginas concorrentes.
4. Revise a região, o idioma e as plataformas de IA do Google.
5. Execute a etapa e inspecione o relatório antes de passá-lo para uma etapa de redação ou planejamento.

## Parâmetros

| Parâmetro       | Obrigatório | Descrição                                                                                                        |
| --------------- | ----------- | ---------------------------------------------------------------------------------------------------------------- |
| `brand_kit_id`  | Sim         | Brand Kit usado para a análise.                                                                                  |
| `target_prompt` | Sim         | A pergunta ou prompt a pesquisar.                                                                                |
| `content_type`  | Não         | Tipo de conteúdo livre usado para filtrar as páginas concorrentes.                                               |
| `gl`            | Não         | Código de região do Google. O valor padrão é `us`.                                                               |
| `hl`            | Não         | Código de idioma do Google. O valor padrão é `en`.                                                               |
| `ai_platforms`  | Não         | Valores separados por vírgulas: `chatgpt`, `gemini`, `perplexity`, `google_ai_mode`. O valor padrão é `chatgpt`. |
| `soft_fail`     | Não         | Permita que o fluxo de trabalho continue se esta etapa falhar.                                                   |

## Exemplo

Use um prompt como “Quais ferramentas de gestão de projetos funcionam bem para equipes distribuídas?” com o seu Brand Kit. Defina `content_type` para `comparação` se quiser focar em páginas de comparação.

```json
{
  "brand_kit_id": 123,
  "target_prompt": "Quais ferramentas de gestão de projetos funcionam bem para equipes distribuídas?",
  "content_type": "comparação",
  "gl": "us",
  "hl": "en",
  "ai_platforms": "chatgpt,perplexity"
}
```

Substitua `123` pelo seu ID do Brand Kit. Revise as páginas retornadas e a pesquisa de apoio antes de decidir o que criar.

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-f0952f7848bbf175eda611d6cfe958f336e5b135%2Fquery-versus-01-step-config.png?alt=media" alt="Query Versus Report step comparing Google and AI results for a rideshare launch booking prompt"><figcaption><p>Defina o prompt-alvo, o tipo de conteúdo, a região, o idioma e as plataformas de IA para o relatório.</p></figcaption></figure>

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-c8f3f5465378f4fafd3fc4c91cea65984bba32a2%2Fquery-versus-02-report.png?alt=media" alt="Query Versus Report output comparing Google results with AI-cited pages for a rideshare launch prompt"><figcaption><p>O relatório mostra onde os resultados do Google e as citações de IA diferem.</p></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.airops.com/docs/pt/acoes/workflow-concepts/workflow-steps/aeo-research/query-versus-report.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
