v1.0.0

Security Occurrence Handler - Release v1.0.0

Overview

Sistema de atendimento automatizado de ocorrências de alarme usando agentes LLM que simula interações entre atendente e cliente seguindo protocolos de segurança específicos.

Key Features

• Agentes LLM: Atendente e cliente com comportamentos distintos
• Protocolo de Segurança: Validação de palavras-chave e palavras de pânico
• Processamento Assíncrono: Ocorrências processadas em background
• API REST: Endpoints para submissão (/handle_occurrence) e consulta (/status_occurrence)
• Múltiplos Cenários: 5 cenários de teste pré-configurados

Technical Stack

• FastAPI + Uvicorn
• LangChain/LangGraph
• OpenAI GPT-4o-mini
• Docker + Docker Compose

Installation

# Clone repo
git clone <repo-url>

# Configure environment
cp .env.example .env
# Add your OPENAI_API_KEY

# Run with Docker
docker-compose up --build

# Or run locally
pip install -r requirements.txt
uvicorn src.api.main:app --host 0.0.0.0 --port 8000

Usage

# Submit occurrence
POST /handle_occurrence
{
  "test_cases": [...],
  "scenario": "correct_password_ok"
}

# Check status
GET /status_occurrence?hash=<returned_hash>

Test Scenarios

• correct_password_ok → RESOLVIDO
• wrong_password → ESCALADO
• correct_password_danger → ESCALADO
• panic_word → ESCALADO
• who_is_auria → RESOLVIDO

What's New in v1.0.0

• Initial release
• Complete agent workflow implementation
• Full test suite with 5 scenarios
• Docker containerization
• In-memory storage for demo purposes