Agentes de base de conhecimento (BIA Studio)

Módulo: Sankhya ERP

Versão mínima: 4.28

Caminho de acesso: Configuração > Avançado >  Bia Studio

Sumário

• Descrição e usabilidade
  • 1. Descrição da funcionalidade
  • 2. Pré-requisitos
  • 3. Diagrama de fluxo
  • 4. Jornada de uso
  • 5.Pontos de atenção
  • 6.Dicas de usabilidade
  • 7.Casos de uso
• FAQ – Dúvidas Frequentes

Descrição e usabilidade

1. Descrição da funcionalidade

O BIA Studio centraliza tarefas e informações referentes à gestão da BIA  em uma única interface visual e colaborativa. Você pode criar agentes de base de conhecimento com arquivos personalizados, organizar espaços de trabalho e acessar informações para agilizar suas rotinas e uso de funcionalidades.

2. Pré-requisitos

Para acessar a funcionalidade BIA Studio, é necessária a aquisição do produto Bia Base De Conhecimento 51219.

O BIA Studio não é compatível com o Navegador Sankhya.

Para utilizar a ferramenta, é essencial que você acesse o Sankhya Om utilizando navegadores modernos e homologados (como Google Chrome, Mozilla Firefox ou Microsoft Edge).

Informação Importante: O Navegador Sankhya será descontinuado em breve. Para mais detalhes e planejamento, consulte o comunicado oficial: Fim do Ciclo de Vida do Navegador Sankhya.

3. Diagrama de fluxo

4. Jornada de uso

Este guia detalha os passos que você deve seguir para criar um novo Agente de Base de Conhecimento, desde a liberação do acesso até o uso final.

Garantindo o Acesso à Ferramenta

Para começar, confirme que seu usuário possui a permissão necessária para criar e gerenciar agentes:

1. Acesse a tela Acessos (utilizando o usuário SUP).
2. Busque o caminho: Configurações > Avançado > Bia Studio.
3. Libere o acesso para o seu usuário.
4. Com a permissão liberada, acesse a tela BIA Studio 

Preparando o Ambiente (Espaço de Trabalho)

O Espaço de Trabalho é o local de armazenamento onde seus arquivos são guardados antes de serem processados para a Base de Conhecimento. Você deve criar este ambiente primeiro:

1. Dentro do BIA Studio, navegue até a seção Espaço de Trabalho.
2. Crie um novo espaço de trabalho.

Regra Importante: Use apenas letras minúsculas e hífens. Não use espaços, letras maiúsculas ou o símbolo sublinhado (_). Exemplo aceito: meu-espaco-de-trabalho

Construindo o Agente de Base de Conhecimento

Após o ambiente estar pronto, você pode criar o Agente que fará as consultas aos documentos:

Para criar um agente

1. Clique em Criar Agente no menu principal
2. Selecione o modelo (template) de Base de conhecimento.
3. Preencha os detalhes do Agente, como o nome e a qual espaço de trabalho pertence.
4. Preencha o campo Descrição com o papel a ser desempenhado pelo agente. Este campo é usado pela BIA para selecionar o agente mais adequado para cada pergunta que recebe. 
5. Complete o campo Instruções com as diretrizes que definem o comportamento do agente como papel, escopo, contexto, tom e estilo.
6. Clique no botão Adicionar para carregar os arquivos na seção Fontes.
7. Selecione os documentos em seu diretório local na janela de upload.
8. Confira se os arquivos aparecem listados na seção Fontes.Caso não apareçam, faça o upload novamente.
9. Clique no botão Avançar.
10. Uma tela informará que a base está sendo criada e, ao finalizar, exibirá uma mensagem de sucesso.

Após a confirmação, escolha entre as opções:

• Clicar no botão Ver meus agentes criados para ir à tela de consulta.
• Iniciar o processo novamente para criar outro Agente.

Neste ponto, o BIA Studio faz automaticamente duas ações importantes:

• Ele carrega e processa os documentos que você selecionou no Espaço de Trabalho, criando a Base de Conhecimento.
• Ele gera um Agente que está diretamente ligado a essa nova Base de Conhecimento.

Publicando o Agente e Liberando o Uso

Para que o Agente criado apareça e possa ser usado pelo seu time (no Copiloto BIA), você precisa ativá-lo:

1. Acesse a seção Explorar agentes.
2. Marque o seu novo Agente como Ativo.
3. Libere o acesso do Agente para os usuários que poderão consultá-lo.

Requisito do Usuário: Para acessar o Agente no Copiloto, o usuário precisa ter o campo “Sankhya ID” preenchido com um e-mail válido em seu cadastro.

Utilizando o Novo Agente de Conhecimento

Com o Agente ativo e o acesso liberado, a jornada está completa.

Agora você pode selecionar o Agente no Copiloto da BIA e começar a fazer perguntas que serão respondidas com base exclusiva nos documentos que você preparou.

5. Pontos de Atenção

• Qualidade dos arquivos: a precisão das respostas da BIA depende da qualidade dos arquivos enviados. Documentos mal formatados ou com texto em imagem podem gerar respostas imprecisas.
• Preenchimento dos campos: os campos descrição e instruções interferem diretamente na qualidade das respostas da BIA.

6. Dicas de Usabilidade

• Nomes e descrições claras: use nomes fáceis de entender para seus espaços de trabalho e agentes.
• Comece com poucos arquivos: ao criar uma base, comece com poucos documentos bem estruturados para testar a qualidade das respostas.
• Use as descrições dos espaços: preencha o campo descrição ao criar um espaço de trabalho para comunicar seu propósito.

7. Casos de Uso

✅ Exemplo real (consultar conhecimento): Você cria um Agente de conhecimento chamado "Assistente de RH" e envia o PDF com as Políticas de Férias. Em seguida, digita na barra de comando "Qual o procedimento para agendar férias?", seleciona o Agente "Assistente RH" e obtém a resposta, extraída do documento.

✅ Exemplo real (colaborar em equipe): Você cria uma base de conhecimento chamado "Manuais de Logística" e adiciona sua equipe usando a opção definir acessos. Vinculado a esta base de conhecimento, você cria um Agente com os manuais de procedimento do armazém. Agora, toda a equipe de logística pode atualizar os documentos contidos nesta base de conhecimento.

❌ Erro comum (permissão de acesso): Você não encontra na sua lista um Agente que um colega criou. Isso geralmente ocorre porque o criador do Agente ainda não adicionou seu e-mail na tela Definir acessos daquele Agente específico.

❌ Erro comum (qualidade do arquivo): Você cria um Agente de conhecimento enviando um arquivo .pdf que é uma imagem escaneada (onde não é possível selecionar o texto). Ao tentar fazer uma pergunta, o sistema não retorna a resposta correta, pois não conseguiu ler o conteúdo do arquivo.

FAQ - Dúvidas Frequentes 

1. O que é Espaço de Trabalho?

O Espaço de Trabalho é o local onde o sistema guarda os seus arquivos (como PDFs ou TXTs) logo que você os carrega. É o lugar de armazenamento antes de eles serem processados.

2. O que é Base de Conhecimento?

A Base de Conhecimento é o conjunto de informações prontas e processadas que foram tiradas dos seus arquivos. É o "cérebro" do Agente, com as respostas que ele pode usar.

3. O que é um Agente de Base de Conhecimento?

É o assistente de inteligência artificial que foi "alimentado" com uma Base de Conhecimento. Ele só responde às suas perguntas usando as informações que estão nos documentos que você forneceu.

4. Quais tipos de arquivo posso usar para criar uma Base de Conhecimento?

Atualmente, o sistema suporta arquivos nos formatos .txt, .pdf e .docx. É obrigatório que o texto dentro desses arquivos seja selecionável, ou seja, o sistema não consegue ler arquivos que são apenas imagens (como fotos escaneadas).

5. Um colega criou um Agente, mas eu não consigo encontrá-lo. O que pode ser?

Na maioria das vezes, é uma questão de permissão. Para você encontrar e usar o Agente, o colega que o criou precisa ter liberado o seu acesso. Peça para que ele verifique se o seu usuário foi adicionado à lista de usuários permitidos para aquele Agente específico.