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.