Skip to content

OTOBO / Znuny - Inteligência Artificial

Classificação de Tickets de IA

Em Desenvolvimento

O ATC está atualmente em um estágio inicial e em constante desenvolvimento. As funcionalidades descritas a seguir ainda não estão totalmente implementadas e podem sofrer alterações.

Requisitos do Sistema

Copyright (c) 2024 - 2025 por Softoft, Tobias Bueck Einzelunternehmen Este código faz parte do "OTOBO - AI Ticket Classification - Basic" e é regido pelo seu contrato de licença. Licença completa em LICENSE_DE.md / LICENSE_EN.md. Este código não pode ser copiado e/ou distribuído sem a permissão expressa da Softoft, Tobias Bueck Einzelunternehmen.

Requisitos do Sistema

  • Mínimo de 4 GB de RAM (8 GB recomendado) - 4 GB de RAM devem estar disponíveis para o ATC
  • Mínimo de 10 GB de espaço livre em disco
  • OTOBO deve estar instalado

Instalação

Passo 1: Configurar o Banco de Dados

O ATC precisa de acesso ao banco de dados OTOBO para coletar os dados de treinamento. Para isso, é necessário um nome de usuário e uma senha. Para isso, o usuário root pode ser usado, por exemplo. No entanto, seria melhor definir um novo usuário com direitos restritos. O ATC só precisa de acesso de leitura ao banco de dados.

Passo 2: Criar Usuário OTOBO

O ATC precisa de um usuário no OTOBO que classifique os tickets. Para isso, é necessário um nome de usuário e uma senha. Ele precisa das permissões para ler os tickets da "Fila de Entrada de E-mail" e o direito de movê-los para outra fila e definir uma prioridade.

Passo 3: Prioridades OTOBO

O ATC é treinado com os dados de fila e prioridade. Para obter o melhor modelo de previsão possível. Prioridades não utilizadas devem ser definidas como inválidas.

Passo 4: Filas OTOBO

O ATC pega os tickets da fila de entrada de e-mail. Se ainda não houver uma fila de e-mail, crie uma. Além disso, se ainda não houver uma fila não classificada, crie uma nova. O ATC move tickets sobre os quais não tem certeza para a fila não classificada.

Passo 5: Configurar Web Services

Passo 6: Criar novo arquivo de override do Docker-Compose

Criar otobo-atc.yml no arquivo docker-compose /opt/otobo-docker/

Em seguida, cole o seguinte conteúdo

Passo 7: Ajustar arquivos de configuração

Na variável .env do OTOBO, defina as seguintes variáveis:

dotenv
DATABASE_HOST="db"
DATABASE_PORT="3306"
DATABASE_USER="root"
DATABASE_PASSWORD="1234"
MIN_PREDICTION_CONFIDENCE=0.7
UNCLASSIFIED_QUEUE_NAME=unclassified
OTOBO_USER_NAME=atc
OTOBO_USER_PASSWORD=1234

Além disso, ajuste a variável COMPOSE_FILE e adicione otobo-atc.yml

Passo 8: Instalar ATC

bash
docker-compose down
docker-compose up -d --build

Uso

Coleta de Dados

Para coletar os dados de ticket para treinamento, execute o seguinte comando:

bash
docker exec -it atc collect-data

Os dados coletados serão salvos em um arquivo específico. Este arquivo será então usado para treinar o modelo.

Treinamento do Modelo

Para treinar o modelo, execute o seguinte comando. No entanto, os dados já devem ter sido coletados antes.

bash
docker exec -it atc train

Ativar Previsão

Para ativar o ATC, de modo que o ATC classifique permanentemente os tickets. Ou seja, todos os e-mails recebidos serão classificados.

bash
docker exec -it atc activate

Desativar Previsão

bash
docker exec -it atc deactivate

Classificação de Tickets de IA