Organização

• Favoritos: Agentes marcados como favoritos aparecem no topo da lista, para acesso rápido.
• Ordem de Atualização: Os agentes são ordenados pela data da última modificação, com os mais recentes aparecendo primeiro (após os favoritos).
• Compartilhados: Agentes compartilhados com você por outros usuários são identificados com um rótulo "Compartilhado".

Elementos da Lista

• Ícone Circular (ai-circle): Uma representação visual do seu agente, com cores personalizáveis.
• Nome do Agente: O nome que você atribuiu ao agente.
• Atualizado: Indica há quanto tempo o agente foi modificado.
• Ícone de Estrela: Clique para favoritar/desfavoritar o agente.
• Rótulo "Compartilhado" (se aplicável): Indica que o agente foi compartilhado com você.
• Ícone de Lixeira (se aplicável): Permite excluir o agente (apenas para agentes que você criou).

Funcionalidades

• Busca: Utilize o campo de busca para encontrar agentes rapidamente, digitando parte do nome.
• Favoritar: Clique no ícone de estrela para adicionar ou remover um agente da sua lista de favoritos.
• Agentes Compartilhados: São identificados pelo rótulo "Compartilhado". Você pode editar e usar agentes compartilhados, mas não pode excluí-los.
• Excluir Agente: Clique no ícone de lixeira para excluir um agente. Uma caixa de diálogo de confirmação será exibida. A exclusão é irreversível.

O que são os "Knowledge Files" e para que servem?

• "Knowledge Files" (arquivos de conhecimento) são a base de conhecimento do seu agente.
• Eles contêm as informações que o agente usará para responder às perguntas e interagir com os usuários.
• Você pode adicionar diferentes tipos de arquivos, como textos, PDFs, planilhas e links de websites.
• O agente processa o conteúdo desses arquivos e o utiliza para gerar respostas relevantes.

Como adicionar um novo "Knowledge File"

1. 1 Clique no botão "+ Novo".
2. 2 Uma janela modal (pop-up) será exibida, com um formulário para adicionar o novo arquivo.
3. 3
   Preencha os campos do formulário:

   • Nome: Dê um nome descritivo ao seu arquivo de conhecimento. Este nome será usado para identificar o arquivo na lista.
   • Frequência: Escolha como o agente utilizará este arquivo:

     • • Ativado Sempre (system): O agente sempre considerará o conteúdo deste arquivo ao gerar respostas. Use esta opção para informações essenciais que o agente deve sempre ter em mente.
     • • Ativado Dinamicamente (data): O agente usará este arquivo apenas quando o conteúdo for relevante para a pergunta do usuário. Use esta opção para informações mais específicas ou detalhadas.
   • Tipo de Conteúdo: Selecione o tipo de arquivo que você está adicionando:

     • • Texto: Use esta opção para adicionar informações diretamente no editor de texto da plataforma. Você pode formatar o texto, adicionar links e usar Markdown.
     • • PDF: Faça upload de um arquivo PDF. O agente extrairá o texto do PDF e o utilizará como conhecimento.
     • • Planilha: Faça upload de um arquivo de planilha (Excel, CSV). O agente extrairá os dados da planilha.
     • • Website: Insira a URL de um website. O agente extrairá o conteúdo da página e o utilizará como conhecimento.
   • Conteúdo:

     • • Texto: Digite ou cole o texto diretamente no editor. Você pode usar as ferramentas de formatação para criar títulos, listas, negrito, itálico, etc.
     • • PDF/Planilha: Clique no campo de upload e selecione o arquivo no seu computador. Após o upload, uma prévia do conteúdo extraído será exibida.
     • • Website: Cole a URL completa (incluindo https://) do website no campo correspondente.
4. 4 Clique no botão "Salvar" para adicionar o arquivo à base de conhecimento do agente.

Editor de Texto (Quill)

Quando você seleciona o tipo de conteúdo "Texto", um editor de texto (Quill) é exibido. Este editor permite que você:

• Escreva e formate texto diretamente na plataforma.
• Crie títulos e subtítulos.
• Formate texto em negrito, itálico e sublinhado.
• Crie listas numeradas e com marcadores.
• Adicione links e imagens.
• Insira blocos de código.

Prévia do Conteúdo

Após adicionar um arquivo PDF, planilha ou URL de website, uma prévia do conteúdo extraído será exibida abaixo do campo de upload. Isso permite que você verifique se o conteúdo foi extraído corretamente e se está de acordo com o esperado.

Como usar templates existentes (modal de templates)

1. 1 Clique no botão "Usar existente".
2. 2 Uma janela modal (pop-up) será exibida, listando os templates de conhecimento que você já salvou.
3. 3 Selecione o template desejado.
4. 4
   Você pode:

   • Visualizar: Ver o conteúdo do template antes de usá-lo.
   • Duplicar: Criar uma cópia do template para usar como base para um novo arquivo de conhecimento. Isso é útil se você quiser fazer pequenas modificações em um template existente sem alterar o original.
5. 5 Ao duplicar, o conteúdo do template será copiado para um novo arquivo de conhecimento, que você poderá editar e salvar.

Como editar/excluir "Knowledge Files" existentes

Na lista de "Knowledge Files" (abaixo do botão "Adicionar Knowledge File"):

• Cada arquivo é exibido em um bloco com as seguintes informações:

  • • Ícone: Representa o tipo de arquivo (PDF, planilha, website, texto).
  • • Nome: O nome que você deu ao arquivo.
  • • Tipo: Indica se o arquivo é "Ativado Sempre" (system) ou "Ativado Dinamicamente" (data).
  • •
    Botões de ação:

    • - Editar (ícone de lápis): Abre o arquivo para edição.
    • - Excluir (ícone de lixeira): Remove o arquivo da base de conhecimento do agente (requer confirmação).
• Para editar um arquivo, clique no ícone de lápis. O arquivo será aberto na janela modal, e você poderá fazer as modificações necessárias.
• Para excluir um arquivo, clique no ícone de lixeira. Uma caixa de diálogo de confirmação será exibida. A exclusão é irreversível.

O que são Skills e para que servem?

• Skills são recursos adicionais que você pode habilitar no seu agente para que ele possa realizar tarefas específicas.
• Exemplos de skills incluem a capacidade de buscar informações na web em tempo real e gerar imagens a partir de descrições textuais.

Skills pré-definidas

A Merlin AI oferece algumas skills pré-definidas que você pode habilitar facilmente:

Fluxos Automáticos

Permite criar e gerenciar mensagens automáticas que o chatbot envia em situações específicas.

Criando Skills personalizadas (Tool Skills)

Se as skills pré-definidas não atenderem às suas necessidades, você pode criar suas próprias skills personalizadas, chamadas "Tool Skills".

1. 1 Clique no botão "Criar Skill (Avançado)".
2. 2 Será solicitado um nome para a nova Skill.
3. 3
   Após a criação, um Asset ID será gerado. Você será redirecionado para o Toolbuilder, uma ferramenta externa onde poderá definir o comportamento da sua skill personalizada.

   • Asset ID: Um identificador único da sua *tool skill*
   • User ID: Seu identificador único de usuário.
   • Project ID: O identificador único do agente ao qual a *tool skill* está associada.
   • E-mail: Seu endereço de e-mail.
4. 4 No Toolbuilder, você usará uma interface visual e prompts (instruções em linguagem natural) para configurar a sua Skill.
5. 5 Consulte o tutorial externo sobre o Sistema de Agentes para obter instruções detalhadas sobre como criar "Tool Skills".

Gerenciando Skills personalizadas

• As "Tool Skills" que você criar serão listadas na aba "Skills".
• Para cada "Tool Skill", você pode:

  • • Editar (ícone de lápis): Abre o Toolbuilder para editar a skill.
  • • Apagar (ícone de lixeira): Remove a skill do seu agente (requer confirmação).

Configurações Disponíveis

• Objetivo do seu Chatbot

  Defina o objetivo principal do seu chatbot. O que você espera que ele realize? Descreva o momento em que o chatbot deve considerar que um objetivo foi alcançado com sucesso.

  Exemplo: "O objetivo do chatbot é agendar demonstrações do produto. O objetivo é considerado alcançado quando o usuário fornece seu nome, e-mail e telefone e concorda com um horário para a demonstração."

• Público-alvo

  Descreva o público-alvo do seu chatbot. Quem são as pessoas que você espera que interajam com ele? Isso ajuda a refinar as respostas e o tom de voz do agente.

  Exemplo: "O público-alvo são profissionais de marketing e vendas de pequenas e médias empresas interessados em soluções de automação de marketing."

• Critérios de avaliação (Goal Prompt)

  Defina critérios detalhados para avaliar se o chatbot atingiu o objetivo definido. Esses critérios serão usados para analisar as transcrições das conversas e determinar se o objetivo foi alcançado (sucesso, falha ou indefinido).

  Exemplo: "Para que o objetivo seja considerado 'sucesso', a transcrição da conversa deve conter: 1) Nome completo do usuário. 2) Endereço de e-mail válido. 3) Número de telefone válido. 4) Confirmação explícita de um horário para a demonstração."

• Coleta de Dados

  Especifique quais dados o chatbot deve coletar durante as interações. Isso pode incluir informações de contato, preferências do usuário, respostas a perguntas específicas, etc.

  Exemplo: "Coletar o nome completo, endereço de e-mail, número de telefone, empresa e cargo do usuário."

• Abrir Relatórios

  Clique no botão "Abrir Relatórios" para acessar a ferramenta de relatórios (link externo). Os relatórios fornecem insights sobre o desempenho do seu agente, incluindo métricas como:

  • Número de conversas
  • Taxa de sucesso (objetivos alcançados)
  • Tempo médio de conversa
  • Dados coletados
  • E muito mais!

Configurações Disponíveis

• Habilitar Autenticação

  Observação: Este recurso está atualmente desabilitado. No futuro, permitirá que você exija que os usuários façam login antes de interagir com o agente.

• Habilitar MultiMensagens (beta)

  Ative este recurso experimental para permitir que o agente envie várias mensagens em sequência, em vez de apenas uma resposta por vez.

  • a2 - Sim
  • false - não

• Link do Instagram

  Insira o nome de usuário do Instagram (sem o "@") para adicionar um link para o perfil do Instagram do seu agente ou empresa.

• Número do WhatsApp

  Insira o número do WhatsApp (apenas números, incluindo o DDD) para adicionar um link direto para o WhatsApp.

• Link Externo

  Adicione um link para qualquer outro website relevante.

• Permitir Compartilhamento

  Escolha se deseja permitir que outras pessoas compartilhem seu agente. Se ativado, outras pessoas poderão usar e editar seu agente. Opções: Sim/Não.

• Exibir Logo

  Escolha se deseja exibir um logo personalizado em vez do nome do agente na interface de chat. Opções: Sim/Não. Se ativado, você precisará fornecer a URL do logo no campo "Link da logo".

• Link da logo

  Se você optou por exibir um logo, insira a URL completa (incluindo https://) da imagem do logo neste campo.

• IDs (Projeto e Chatbot)

  Estes campos exibem os IDs únicos do seu projeto e do seu chatbot. Esses IDs são usados para identificar seu agente em outras ferramentas e integrações. Você pode copiar esses IDs para a área de transferência clicando no ícone de cópia ao lado de cada campo.

Configurações Disponíveis

• Consultar Instância:

  Este botão verifica se a sua instância do WhatsApp Business está ativa e conectada. Clique neste botão para verificar o status da sua conexão.

• Envio de Mensagens:

  Este botão leva a uma interface onde você pode enviar mensagens diretamente do seu agente para números de WhatsApp. Use esta função para testes ou para enviar mensagens manualmente.