Documentação · ✨ Pergunte ao Pommy

O assistente na caixa de busca

Encontre uma página, pesquise a documentação ou faça uma pergunta — tudo na mesma caixa.

O botão Search no topo do painel — ⌘K no Mac, Ctrl K nos demais sistemas — abre uma caixa que faz três coisas: leva a uma página do painel, pesquisa esta documentação e responde perguntas. Não existe uma tela de chat separada. A mesma caixa vira a conversa e depois volta a ser busca.

A caixa de busca aberta sobre o painel, mostrando páginas correspondentes, páginas da documentação correspondentes e uma linha Ask Pommy na parte de baixo
Modo de busca: primeiro as páginas, depois a documentação e, embaixo, “Ask Pommy” com o que você digitou.

Comece a digitar. Os resultados vêm sempre na mesma ordem, então você aprende onde olhar:

  • Pages (páginas) — até seis páginas do painel, cada uma com o grupo do menu a que pertence. Só aparecem páginas que você realmente pode abrir. A busca também usa o nome interno da página em inglês, então digitar widget encontra a página com o painel em inglês ou em turco.
  • Documentation (documentação) — até quatro páginas deste guia, com o resumo de uma linha e a seção de cada uma.
  • Ask Pommy — sempre a última linha, com exatamente o que você digitou. Ela aparece mesmo quando nada mais corresponde.

As setas do teclado percorrem as linhas, Enter abre a selecionada e Esc fecha a caixa. Se nada corresponder, aparece uma única linha — *No page or document matches that — You can still ask Pommy* (nenhuma página ou documento corresponde — você ainda pode perguntar ao Pommy).

Com a caixa vazia, você vê Quick jump — seis páginas usadas com frequência — e Try asking, três perguntas de exemplo: *How do I add the widget to my site?*, *How do I train my AI agent?*, *How do I connect WhatsApp?* Clicar em uma delas já faz a pergunta.

Fazendo uma pergunta

Há três formas de entrar na conversa: escolher a linha Ask Pommy, clicar em um dos exemplos de Try asking ou clicar em uma das sugestões do mascote no dashboard — elas abrem esta mesma caixa com a pergunta já enviada e estão descritas em O mascote do painel.

A mesma caixa no modo de chat: a pergunta no topo, uma resposta curta abaixo e uma lista de fontes com links para duas páginas da documentação
Modo de chat: uma resposta curta e, abaixo dela, as páginas da documentação em que a resposta se baseou.

O cabeçalho vira Ask Pommy, o corpo vira a conversa e o campo de digitação desce para a parte de baixo. Enquanto ele trabalha, você vê *Reading the docs…* (lendo a documentação); depois chega a resposta, seguida de Sources (fontes).

  • Sources são as páginas da documentação de onde a resposta veio. Clique em uma e ela abre — a caixa fecha e você vai para aquela página.
  • Continue perguntando na caixa de baixo. Dentro de uma conversa, ele lembra as últimas trocas, então uma pergunta de acompanhamento não precisa repetir o contexto. Uma mensagem pode ter até 500 caracteres.
  • Voltar para a busca — a seta no canto superior esquerdo leva de volta à lista de busca. Esc fecha a caixa por completo.
  • Cada abertura começa vazia. A conversa não é guardada; abra a caixa de novo e você começa uma nova.

A linha abaixo do campo diz o mesmo que esta página: *Answers come from Pommy's documentation. If it isn't there, it won't invent it.* (as respostas vêm da documentação do Pommy; se não estiver lá, ele não inventa).

De onde vêm as respostas

Sua pergunta é pesquisada nesta documentação. No máximo quatro páginas são escolhidas, e de cada uma é extraído um trecho da parte que corresponde à sua pergunta — não o parágrafo inicial nem a página inteira. É com esses trechos que a resposta é escrita, e é para eles que a lista Sources aponta.

As duas edições da documentação, em inglês e em turco, são pesquisadas, e a que reconhecer mais palavras da sua pergunta é a usada. Assim, uma pergunta em turco funciona com o painel em inglês, e vice-versa — você não precisa escrever a pergunta no idioma da interface.

Isso é tudo o que ele lê. Ele não vê sua base de conhecimento, seus produtos, as conversas dos seus clientes, sua equipe nem seu faturamento, e não pesquisa na internet. A única exceção são os números ao vivo descritos na próxima seção, e esses são entregues a ele pelo dashboard.

Quando nada na documentação corresponde, ele não chuta: diz que não encontrou nada e sugere reformular a pergunta ou abrir a aba relacionada no painel. As respostas são curtas de propósito — de duas a quatro frases, no máximo quatro tópicos — porque a página de origem está a um clique.

Regra: Este assistente apenas lê e explica. Ele não pode alterar nada na sua conta: não cria, não edita, não exclui e não envia mensagens aos seus clientes. Para um assistente que pode alterar sua configuração, veja Conectando um agente de programação.

Seus próprios números

Uma pergunta chega com dados ao vivo anexados: a sugestão Analyze this page do mascote no dashboard. Ela envia ao assistente os mesmos números de resumo que o dashboard está mostrando, das últimas 24 horas:

  • Visitantes.
  • Total de conversas, além das de hoje e de ontem.
  • Total de mensagens, divididas entre a IA e sua equipe.
  • Quantas conversas a IA resolveu e quantas foram para uma pessoa.
  • A taxa de conversas assumidas por humanos.
  • A nota de satisfação e em quantas avaliações ela se baseia.
  • Quantas pessoas estão esperando na fila.

São os números que já estão na sua tela — o dashboard os repassa como texto em vez de contá-los uma segunda vez, então o assistente e a página nunca informam valores diferentes. Nessa pergunta a documentação não é pesquisada, por isso a resposta não tem lista Sources. O assistente é instruído a usar os números exatamente como recebidos e a não inventar nenhum.

Dica: Nenhuma outra pergunta leva seus números junto. Se você mesmo digitar uma pergunta sobre dados na caixa, ela é respondida com base na documentação como qualquer outra — para uma leitura dos seus números, use a sugestão do mascote.

Idiomas

O assistente funciona em inglês e turco e responde no idioma em que você perguntou — não no idioma em que o painel está. Ele escreve texto simples, sem formatação, e se refere aos lugares do painel com os nomes que você vê na tela.

Quando algo não funciona

Ele diz que não encontrou nada na documentação.
Nenhuma página correspondeu às suas palavras e, em vez de chutar, ele parou. Tente o termo que o painel realmente usa — "Knowledge Base" em vez de "dados de treinamento" — ou reduza a pergunta às duas ou três palavras que importam.
Ele diz que as páginas relevantes estão abaixo, mas não há resposta.
As páginas foram encontradas, mas a resposta em si não pôde ser gerada — geralmente porque demorou demais. As fontes continuam listadas, então você pode ler a página diretamente, e perguntar de novo costuma funcionar.
Ele diz que estou perguntando rápido demais.
Há um limite por conta para a frequência de perguntas. Espere um momento e pergunte de novo.
A resposta é mais curta do que eu queria.
É de propósito: ele responde em poucas frases e indica a página. Abra a fonte abaixo da resposta para a versão completa.
Ele não sabe nada sobre meus próprios produtos ou clientes.
Ele lê a documentação, não o conteúdo do seu projeto. Para perguntas sobre seus próprios dados, use as páginas do painel — ou a sugestão "Analyze this page" do mascote para o resumo do dashboard.
Minha conversa anterior sumiu.
As conversas não são armazenadas. Fechar a caixa encerra a conversa, e a próxima abertura começa vazia.