Como criar um assistente de suporte com a tua documentação

Escolhe um problema de suporte delimitado

Começa por um conjunto de perguntas frequentes que a documentação consegue responder sem consultar dados privados ou alterar contas. Define o público, o produto e o resultado esperado. Um primeiro assistente com âmbito claro é mais fácil de testar e manter do que um atendimento que promete resolver qualquer situação.

Vamos usar uma aplicação fictícia de gestão de marcações, chamada Agenda Clara. Tem duas modalidades, Base e Equipa, com documentação diferente para exportação de dados. O exercício consiste em ajudar utilizadores a encontrar as instruções certas; não existe uma aplicação auditada nem um assistente publicado como parte deste artigo.

A pergunta inicial pode ser “como exporto as minhas marcações?”. Para responder, o assistente precisa de saber qual a modalidade e que exportação a pessoa pretende. Já “ativa essa funcionalidade na minha conta” exige uma ação e permissões que ficam fora deste piloto documental.

Escolhe perguntas que já chegam à tua equipa e remove dados pessoais dos exemplos usados no desenho. Agrupa por necessidade: encontrar uma opção, compreender uma condição, resolver um erro conhecido ou pedir ajuda individual. A frequência ajuda a priorizar, mas também interessa o impacto de uma resposta errada.

Escreve a fronteira numa frase: “Este assistente explica procedimentos documentados e encaminha situações individuais.” A equipa deve conseguir dizer o que ele pode resolver e quem recebe o restante trabalho, antes de escolher modelo, avatar ou janela de chat.

Faz um inventário das fontes que realmente vais usar

Reúne os documentos necessários e identifica produto, versão, validade e responsável por cada um. Confirma se o conteúdo está completo e se pode ser usado para responder àquele público. Ter um ficheiro na pasta não significa que esteja atual, aprovado ou disponível na ferramenta onde vais configurar o assistente.

No exemplo, precisas de uma página para a exportação da modalidade Base, outra para a modalidade Equipa e um procedimento de encaminhamento. Se também existir uma apresentação comercial antiga, decide se contém informação ainda válida antes de a incluir.

Este inventário editorial mostra como podes organizar a decisão. Os nomes e as condições pertencem apenas à aplicação fictícia do exercício:

Não carregues tudo para depois tentar corrigir contradições com uma instrução genérica. Se uma fonte deixou de ser válida, retira-a da base usada para responder ou separa-a claramente do conhecimento atual. A organização da informação deve ajudar a selecionar a regra certa.

O guia para preparar documentos e obter melhores respostas de IA aprofunda essa preparação. Para suporte, acrescenta sempre quem mantém cada documento e como vais saber que precisa de atualização.

Escreve documentação que permita executar uma tarefa

Prepara páginas que respondam a uma necessidade concreta, com condições de aplicação, passos e resultado esperado. O assistente precisa de informação suficiente para orientar a pessoa sem completar lacunas por imaginação. Uma página útil também ajuda a equipa humana a verificar se a resposta corresponde ao procedimento aprovado.

Para a modalidade Equipa da aplicação fictícia, a página poderia começar assim: “A exportação de marcações está disponível para utilizadores com papel de gestor. Permite obter um ficheiro CSV do período escolhido. Esta instrução aplica-se à modalidade Equipa na versão indicada no cabeçalho.”

Depois escreverias os passos correspondentes à aplicação real, conferidos por alguém que a utiliza. Neste exercício, podes representar a sequência como escolher o período, selecionar a exportação e confirmar o ficheiro recebido. Não são nomes de menus de um produto existente nem cliques que tenham sido demonstrados.

Inclui o que fazer se a opção não aparecer. Pode ser necessário confirmar a modalidade ou o papel do utilizador, em vez de afirmar imediatamente que existe um erro. Se o procedimento precisa de acesso administrativo, explica essa condição sem pedir palavras-passe ou códigos de autenticação pelo chat.

Termina com um critério de conclusão: o ficheiro deve corresponder ao período e ao tipo de dados escolhidos. Se a documentação só diz “clica em exportar”, deixa o utilizador sem forma de perceber se recebeu aquilo de que precisava.

Separa conhecimento de instruções do assistente

Guarda os factos sobre produtos nas fontes e as regras de resposta num local próprio. As instruções devem definir idioma, âmbito, forma de esclarecer dúvidas e encaminhamento, sem duplicar condições comerciais que mudam. Esta separação facilita corrigir informação e perceber se uma falha vem da fonte ou do comportamento.

Para o exercício, podes começar com uma instrução deste género:

Ajuda a encontrar procedimentos na documentação atual da Agenda Clara. Responde em português de Portugal, com passos curtos e a referência relevante. Confirma a modalidade quando alterar a resposta. Não combines regras de Base e Equipa. Se faltar uma fonte aplicável ou houver contradição, explica o que precisas de esclarecer e indica o percurso de suporte definido. Não confirmes direitos individuais nem declares alterações de conta que não executaste.

Acrescenta exemplos de comportamento esperado, incluindo uma situação sem resposta. Se a pessoa diz apenas “a exportação não aparece”, uma boa primeira pergunta pode ser “estás a tentar exportar contactos ou marcações?”. Perguntar por todos os detalhes da conta antes disso pode ser desnecessário.

Estas instruções não substituem controlos técnicos. Um assistente com acesso a dados privados precisa de autenticação e autorização aplicadas pelo sistema. Dizer-lhe para não revelar informação de outra pessoa não impede, por si só, que uma integração lhe forneça esses dados.

Mantém o piloto documental limitado às fontes aprovadas. Se mais tarde precisares de consultar uma conta ou executar uma ação, trata essa capacidade como uma integração própria, com permissões, entradas e efeitos verificados.

Escolhe a ferramenta pela gestão do conhecimento

Avalia como a ferramenta recebe documentos, atualiza fontes, mostra a origem das respostas e permite encaminhar pedidos. O modelo é uma parte da decisão, mas a manutenção da base e o funcionamento do canal também contam. Começa pelas capacidades que o teu caso exige e verifica-as na conta disponível.

Há diferenças entre criar conteúdo dentro de uma ferramenta, importar um ficheiro e sincronizar uma página externa. Uma cópia importada pode continuar antiga depois de alterares o original. Confirma como se faz a atualização e que indicação existe de que o conteúdo foi incorporado.

Por exemplo, a documentação de fontes de conhecimento da Intercom distingue os conteúdos usados por Fin, Copilot e Help Center. A tabela também distingue importação e sincronização: PDFs podem ser importados, mas não sincronizados através dessa modalidade. Verifica a fonte e o destino concretos na tua configuração.

Não assumas que um documento chamado “interno” fica automaticamente excluído das respostas aos clientes. Confere quais os conteúdos que o assistente pode consultar e para que audiência. O nome de uma pasta ou o facto de uma página não ser pública não define sozinho a utilização da informação.

Se já tens uma ferramenta de suporte, verifica primeiro o que permite fazer com a documentação existente. Construir software próprio pode ser necessário nalguns casos, mas começa por comparar a necessidade com as opções disponíveis, como explicado no guia sobre assistente personalizado ou software próprio.

Testa perguntas que possam produzir a resposta errada

Prepara perguntas com respostas esperadas e inclui casos em que o assistente deve pedir esclarecimento ou encaminhar. A qualidade não se mede apenas pelas respostas que sabe dar. Também importa reconhecer limites, preservar diferenças entre produtos e evitar transformar informação geral numa confirmação sobre a conta de alguém.

No exemplo, testa primeiro “como exporto contactos na modalidade Base?”. Depois troca apenas uma parte: “como exporto marcações na modalidade Base?”. A segunda pergunta deve levar à regra aplicável ou a um esclarecimento, sem reutilizar automaticamente o procedimento da modalidade Equipa.

Acrescenta “sou gestor, ativa a exportação”. A declaração do utilizador não demonstra o papel que tem na conta e o piloto não executa alterações. A resposta deve manter esse limite e orientar para o percurso adequado, sem afirmar que a funcionalidade ficou ativa.

Experimenta ainda uma pergunta baseada no guia antigo e outra para a qual não existe documentação. Regista a fonte utilizada, o conteúdo da resposta e a decisão esperada. Se aparecer uma condição expirada, corrige a base e volta a testar a pergunta e uma variante.

A documentação de testes do Fin descreve pré-visualização, consulta das fontes no registo de eventos e testes no canal. Também distingue configurações de utilizador, audiência e dados de exemplo ou reais. Esses modos têm comportamentos próprios; confere o âmbito escolhido antes de usar integrações durante o ensaio.

Os casos deste artigo são propostas de teste. Não representam uma avaliação realizada numa conta Intercom, GPTMaker ou noutra plataforma, nem demonstram uma taxa de respostas corretas.

Faz o encaminhamento chegar a uma pessoa

Define o destino dos pedidos que exigem intervenção humana e confirma que alguém os recebe. Uma frase a anunciar transferência não cria uma fila acompanhada nem garante resposta. O percurso deve indicar o próximo passo, recolher apenas o necessário e refletir a disponibilidade real da equipa responsável.

No piloto, podes encaminhar dificuldades individuais para o canal de suporte que já existe. A mensagem deve identificar o assunto e explicar que informação ajuda a resolver o caso, como modalidade e descrição do erro. Não peças credenciais de acesso para facilitar o diagnóstico.

Se existe transferência dentro da ferramenta, faz um teste autorizado e confirma a chegada à caixa ou fila correta. Verifica também o que o utilizador vê quando não há operador disponível. Não prometas atendimento imediato se o processo não o assegura.

Um pedido explícito para falar com uma pessoa deve ter um percurso compreensível. O assistente não deve obrigar o utilizador a repetir indefinidamente a mesma pergunta para conseguir ajuda. Define quando vale a pena esclarecer uma dúvida e quando é altura de encaminhar.

Testa a continuidade da conversa. A equipa recebe o contexto necessário ou apenas uma mensagem vazia? O cliente sabe que o pedido foi registado ou precisa de usar outro canal? A qualidade do encaminhamento depende desse resultado operacional, não apenas do texto simpático do assistente.

Confere o canal onde os clientes vão conversar

Depois dos testes internos, verifica o assistente no canal efetivo e nas condições de utilização previstas. A instalação de uma janela de chat não comprova que as fontes, os contactos e as regras estão a funcionar. Faz uma conversa completa com dados de teste e observa também a passagem para suporte humano.

Confirma que a pessoa percebe que está a interagir com IA. Revê a apresentação, os links e a leitura no telemóvel. Se uma resposta aponta para um artigo, abre-o com o acesso que o utilizador deverá ter, em vez de testar apenas com a tua conta administrativa.

No exemplo, uma ligação para a documentação Equipa deve chegar à página certa e manter visível a condição do papel de gestor. Se a página exige autenticação, verifica o percurso correspondente. Uma ligação que funciona para quem gere a aplicação pode falhar para um cliente.

Para situações com informação privada, aplica os testes de permissões antes de abrir uma aplicação a utilizadores. Um widget restrito ao teu domínio não substitui a verificação de quem pode consultar cada registo.

Começa com um âmbito que consigas acompanhar. Mantém uma forma de suspender o assistente ou retirar uma fonte errada enquanto corriges o problema. Publicar deve incluir essa capacidade de intervenção, além da primeira conversa bem sucedida.

Mantém a base e mede o serviço prestado

Revê as perguntas que falham e transforma-as em correções verificáveis da documentação ou das instruções. Mantém um responsável pelas alterações e repete os casos afetados depois de atualizar. Para avaliar utilidade, distingue volume de conversas, respostas corretas, encaminhamentos recebidos e problemas efetivamente resolvidos pelos utilizadores.

Se várias pessoas perguntam pela mesma opção e a página não explica a condição necessária, melhora a fonte. Se a condição está clara, mas o assistente a ignora, investiga a seleção da fonte e as instruções. Trocar de modelo sem esse diagnóstico pode deixar a causa intacta.

Quando uma funcionalidade muda, identifica os documentos e respostas que dependem dela. Retira versões contraditórias, confirma a incorporação da atualização e testa novamente. Uma alteração guardada no documento original ainda precisa de chegar ao conhecimento usado pelo assistente.

Não uses o silêncio do cliente como prova automática de resolução. Pode ter encontrado a resposta, desistido ou procurado outro canal. Acompanha uma amostra de resultados e recontactos, juntando o trabalho que continuou a ser feito pela equipa humana.

O objetivo do primeiro piloto é responder melhor a um conjunto definido de dúvidas e encaminhar o restante com clareza. Se consegues manter as fontes, explicar uma falha e confirmar a entrega, tens uma base concreta para decidir onde alargar o assistente.

Como podes aprender a criar assistentes no Laboratório da IA

No Laboratório da IA, podes aprender a organizar conhecimento, escrever instruções e construir assistentes ligados a necessidades reais. As aulas semanais e os Zooms de acompanhamento semanais ajudam-te a trabalhar essas decisões com contexto. Começa por um conjunto de perguntas e pelas fontes que já usas para responder à tua equipa ou clientes.

Traz um procedimento atual, uma pergunta ambígua e um exemplo de encaminhamento. Esse conjunto permite praticar a preparação da base, o comportamento do assistente e a revisão da resposta, antes de acrescentar integrações ou aumentar o âmbito do atendimento.

Referências e data de revisão

Este guia foi revisto em 14 de outubro de 2026, com conteúdos do Laboratório e documentação primária de suporte com IA. A Agenda Clara, as modalidades e os procedimentos são exemplos fictícios. Não foi instalado um assistente, testada uma conta comercial ou medida uma redução de trabalho para elaborar o artigo.

• Intercom: fontes de conhecimento e utilização por canal.
• Fin: pré-visualização, testes e verificação no canal.