Skip to content

OTOBO / Znuny - Inteligência Artificial

KI Ai Classificação de Tickets

Em Desenvolvimento

ATC está no momento em uma fase inicial e está sendo constantemente aprimorado. As funcionalidades descritas a seguir ainda não estão totalmente implementadas e podem mudar.

Licença

Copyright (c) 2024 - 2025 por Softoft, Tobias Bueck Einzelunternehmen Este código faz parte do "OTOBO - Classificação de Tickets de IA - Básico" e é regido pelo seu acordo 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 4 GB de RAM (8 GB recomendado) - para ATC, 4GB de RAM devem estar disponíveis
  • Mínimo 10 GB de espaço de armazenamento livre
  • OTOBO deve estar instalado

Instalação

Passo 1: Configurar o Banco de Dados

ATC requer acesso ao banco de dados do OTOBO para coletar dados de treinamento. Para isso, é necessário um nome de usuário e uma senha. Para isso, pode-se usar o usuário root, mas é recomendável criar um novo usuário com direitos limitados. ATC requer apenas acesso de leitura ao banco de dados.

Passo 2: Criar Usuário OTOBO

ATC requer um usuário no OTOBO que classifique os tickets. Para isso, é necessário um nome de usuário e uma senha. Ele requer permissões para ler 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

ATC é treinado com dados de fila e prioridade. Para obter um modelo de previsão o mais preciso possível, as prioridades não utilizadas devem ser definidas como inválidas.

Passo 4: Filas OTOBO

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

Passo 5: Configurar Web Services

Passo 6: Criar Novo Arquivo de Sobrescrita do Docker-Compose

No diretório /opt/otobo-docker/docker-compose, crie o arquivo otobo-atc.yml

Em seguida, insira o seguinte conteúdo

Passo 7: Ajustar Arquivos de Configuração

No arquivo .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 dados de tickets para treinamento, execute o seguinte comando:

bash
docker exec -it atc collect-data

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

Treinamento do Modelo

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

bash
docker exec -it atc train

Ativar Previsão

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

bash
docker exec -it atc activate

Desativar Previsão

bash
docker exec -it atc deactivate

KI Ai Classificação de Tickets