Passar para o conteúdo principal

Criar e gerenciar snippets

Usando Snippets como outra fonte de conteúdo para Fin e suporte self-serve.

Na página Content, você pode criar e gerenciar snippets e habilitá-los para uso com Fin AI. Snippets são pequenas fontes de informação que não estão publicamente disponíveis para clientes e são usadas apenas pelo Fin para melhorar a qualidade e abrangência das respostas.


Criar um snippet

Para criar um novo snippet, vá para Train > Sources e clique em Snippet abaixo da seção "Add content".

Adicionar conteúdo

Agora você pode criar seu snippet inserindo um título e corpo em formato de texto.

Você pode destacar o texto para formatá-lo, como adicionar cabeçalhos ou links.

Dica: Snippets são especificamente para conteúdo baseado em texto, então você não poderá adicionar imagens. Para obter os melhores resultados, recomendamos seguir estas melhores práticas.

Salvar

Quando terminar de escrever o snippet, ou quiser sair do editor, você pode clicar em Save no canto superior direito da tela para salvar suas alterações.

Nota:

  • Seu snippet também será salvo automaticamente a cada poucos segundos enquanto você estiver trabalhando no editor. Se suas alterações foram salvas automaticamente, o botão Save ficará desativado e você pode simplesmente clicar em Cancel para sair do editor.

  • Não há opção “Salvar como rascunho” para snippets. Quando os snippets são salvos, essas informações ficam disponíveis para os clientes através do Fin AI (se habilitado).

  • Uma vez salvos, os snippets geralmente estarão disponíveis para uso pelo Fin em até 10 minutos.


Gerenciar snippets

Para gerenciar snippets, vá para Train > Content e clique em Articles (Snippets, artigos públicos, internos, docs) na seção "Content sources", depois abra o snippet que deseja gerenciar.

Configurar configurações

Quando você cria um snippet, há um painel "Details" à direita que contém:

  • Data: Veja o tipo de conteúdo, idioma, data de criação, data da última atualização (quando foi sincronizado pela última vez com Box).

  • Fin: Ativar/desativar para Fin Agent e Fin Copilot. Quando ativado, o conteúdo fica disponível para clientes e colegas, respectivamente.

    • Audience: Direcione seu conteúdo para um público específico, para que seus clientes vejam apenas o conteúdo relevante para eles.

  • Reports: Acompanha com que frequência este conteúdo é usado para resolver conversas pelo Fin Agent.

  • Tag: Adicione uma tag para agrupar snippets e manter o conteúdo organizado.

Faça alterações no conteúdo

Para editar um snippet existente, vá para Train > Content e clique em Articles (Snippets, artigos públicos, internos, docs) na seção "Content sources", depois abra o snippet e clique no ícone Edit.

Quando terminar de fazer alterações, ou quiser sair do editor, clique em Save.

Nota: Seu snippet também será salvo automaticamente a cada poucos segundos enquanto você estiver trabalhando no editor. Se suas alterações foram salvas automaticamente, o botão Save ficará desativado e você pode simplesmente clicar no ícone Close para sair do editor.

Disponibilize para o Fin

Para disponibilizar um snippet para o Fin, vá para Train > Content e clique em Articles (Snippets, artigos públicos, internos, docs) na seção "Content sources", depois abra o snippet.

No painel "Details", role para baixo até “Fin” e ative:

  • Fin Agent - Esta configuração tornará o snippet disponível para o Fin Agent usar ao responder aos clientes (respeitará quaisquer regras de público).

  • Fin Copilot - Esta configuração tornará o snippet disponível para o Fin Copilot usar ao responder aos colegas.

Nota: O idioma do snippet deve ser um dos idiomas suportados pelo Messenger, caso contrário essas opções ficarão desativadas.

Agende para o Fin

Você pode agendar quando um snippet será ativado ou desativado para Fin e Copilot, em uma data, hora e fuso horário futuros. Defina apenas a data de início ou defina data de início e fim para criar uma janela de disponibilidade limitada. O agendamento se aplica a itens individuais ou em massa.

Agendar um único snippet

  1. Abra o snippet. No painel Detalhes à direita, encontre a seção Scheduling dentro do menu suspenso Fin.

  2. Clique em Schedule availability.

  3. No modal: selecione o produto de IA (Fin for Service ou Fin Copilot), defina a disponibilidade (Enable ou Disable) e escolha uma data, hora e fuso horário.

  4. Opcionalmente, ative Set end date para adicionar uma data e hora de término — a ação será revertida automaticamente nesse momento.

  5. Clique em Schedule para confirmar.

Agendamento em massa de snippets

  1. Selecione vários snippets na lista de conteúdo.

  2. Vá para o menu suspenso More actions e selecione Schedule availability.

  3. O mesmo modal de agendamento se aplica a todos os itens selecionados.

Como o agendamento funciona

  • Apenas data de início: A ação de ativar/desativar ocorre no horário agendado e permanece em efeito até que você a altere manualmente.

  • Data de início + fim: O conteúdo é ativado (ou desativado) no horário de início e depois reverte automaticamente no horário de término.

  • Alterações manuais não cancelam um agendamento pendente: Se você alterar manualmente a disponibilidade após definir um agendamento, a transição agendada ainda ocorrerá no horário previsto e substituirá sua alteração manual.

  • Um agendamento pendente por item por agente: Definir um novo agendamento substitui o anterior — sem duplicatas.

  • Conteúdo excluído: Se um snippet for excluído antes do agendamento ocorrer, o agendamento simplesmente não será aplicado e nenhum erro será exibido.

Disponibilize para um público específico

Se seu snippet for relevante apenas para um subconjunto específico de clientes, você pode usar filtros de público para torná-lo visível para certas pessoas.

Depois, vá para Train > Content e clique em Articles (Snippets, artigos públicos, internos, docs) na seção "Content sources", depois abra o snippet.

No painel "Details", role para baixo até “Fin” e use o menu suspenso de público para selecionar um dos públicos pré-definidos.

Nota:

  • O público padrão para snippets é “Everyone”.

  • O Fin Agent respeitará qualquer público que você aplicar a um snippet e usará esse snippet para responder às perguntas dos clientes somente se elas corresponderem às regras do público.


Comportamento da resposta do Fin

Quando um snippet é usado como fonte de conteúdo em uma resposta do Fin Agent, o cliente não vê o link para o snippet. Em vez disso, verá uma mensagem dizendo: As respostas de IA são geradas com base em fontes públicas e privadas fornecidas por [nome da sua empresa].


Melhores práticas para criar snippets eficazes para Fin

Snippets são uma ferramenta poderosa para garantir que agentes de IA, como o Fin, possam fornecer respostas precisas e úteis às consultas dos clientes. Siga estas melhores práticas para otimizar seus snippets para clareza e funcionalidade:

1. Evite ambiguidade

  • Títulos claros: Certifique-se de que o título do snippet defina explicitamente o produto, recurso ou serviço ao qual se refere. Evite termos vagos ou muito amplos.

  • Conteúdo específico: O corpo do snippet não deve deixar espaço para interpretações erradas. Explique claramente o tópico para eliminar confusões.

2. Reitere as perguntas no corpo

  • Para melhorar a capacidade do Fin de associar perguntas dos clientes aos snippets, reitere o conteúdo do título no corpo do snippet. Por exemplo:

    • Título: "Como redefinir sua senha"

    • Corpo: "Se você está procurando instruções sobre como redefinir sua senha..."

3. Use cabeçalhos para estrutura

  • Para snippets mais longos (200+ palavras), divida o conteúdo em seções distintas usando cabeçalhos (H1 ou H2). Cada cabeçalho deve resumir sucintamente a informação que segue.

    • Exemplo:

      • Cabeçalho: "Passos para redefinir sua senha"

      • Conteúdo: "Siga estes passos para redefinir sua senha..."

4. Utilize listas

  • Divida informações detalhadas em listas em vez de parágrafos longos. O Fin processa e entrega melhor pontos estruturados e concisos.

    • Exemplo:

      • Em vez de: "Para redefinir sua senha, vá para a página de login, clique em 'Forgot Password', insira seu endereço de e-mail e siga as instruções enviadas para sua inbox."

      • Use:

        • Vá para a página de login.

        • Clique em "Forgot Password."

        • Insira seu endereço de e-mail.

        • Siga as instruções enviadas para sua inbox.

5. Otimize títulos de snippets com variações

  • Inclua múltiplas variações da pergunta ou tópico no título do snippet. Separe essas variações usando pontuação como barras (/), pontos de interrogação (?) ou vírgulas (,).

    • Exemplo:

      • Título: "Como redefinir senha / Forgot password / Instruções para recuperação de senha"

  • Como os títulos dos snippets não são visíveis para os clientes, você pode torná-los tão descritivos e longos quanto necessário para cobrir várias formas que os clientes possam usar.

Ao aplicar essas melhores práticas, você garantirá que seus snippets sejam eficazes e amigáveis para IA, permitindo que o Fin forneça respostas precisas e contextualmente relevantes para seus clientes.

Respondeu à sua pergunta?