atendentepro 0.3.0__tar.gz → 0.5.1__tar.gz

atendentepro-0.5.1/CHANGELOG.md

@@ -0,0 +1,133 @@
+# Changelog
+
+All notable changes to AtendentePro will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.5.1] - 2025-01-06
+
+### Changed
+- **Documentation**: Updated all diagrams and READMEs
+  - Added prompts files for Escalation and Feedback agents (`prompts/escalation.py`, `prompts/feedback.py`)
+  - Moved `templates/standard/` out of `client_templates/` (now included in repository)
+  - Removed unnecessary Answer → Interview handoff
+  - Fixed inconsistencies in handoff diagrams
+  - Improved YAML configuration documentation
+
+### Fixed
+- Removed circular handoff from Answer Agent to Interview Agent
+- Fixed docstrings and diagrams referencing old handoff structure
+
+## [0.5.0] - 2025-01-06
+
+### Added
+- **Feedback Agent**: New module for ticket-based user feedback
+  - `create_feedback_agent()` factory function
+  - `FEEDBACK_TOOLS` with ticket creation and management tools:
+    - `criar_ticket` - Create feedback tickets (dúvida, feedback, reclamação, sugestão, elogio, problema)
+    - `enviar_email_confirmacao` - Send confirmation email to user
+    - `consultar_ticket` - Query ticket status by protocol
+    - `listar_meus_tickets` - List user's tickets by email
+    - `atualizar_ticket` - Update ticket status or add response
+  - Protocol generation with customizable prefix (TKT, SAC, SUP)
+  - Email templates with brand customization
+  - Priority auto-classification (reclamações = alta)
+  - Team notification support
+- **Network Integration**: Feedback Agent added to standard network
+  - `include_feedback` parameter in `create_standard_network()`
+  - `feedback_protocol_prefix`, `feedback_brand_color`, `feedback_brand_name` parameters
+  - `add_feedback_to_all()` method in AgentNetwork
+  - Feedback added as handoff to ALL agents by default
+- **Template Configuration**: New `feedback_config.yaml` template
+  - Ticket types configuration
+  - Priority levels and SLA
+  - Email branding options
+  - Auto-priority rules
+- **Configuration Function**: `configure_feedback_storage()` for runtime config
+
+### Changed
+- `AgentNetwork` now includes `feedback` attribute
+- Network handoffs updated to include feedback option
+- README updated with Feedback Agent documentation
+- Version bump to 0.5.0
+
+## [0.4.0] - 2025-01-06
+
+### Added
+- **Escalation Agent**: New module for human support transfer
+  - `create_escalation_agent()` factory function
+  - `ESCALATION_TOOLS` with registration and consultation tools
+  - Automatic activation triggers (explicit request, frustration, out-of-scope topics)
+  - Business hours verification
+  - Protocol generation and tracking
+  - Priority auto-classification (urgent, high, normal, low)
+  - Webhook notification support
+- **Network Integration**: Escalation Agent added to standard network
+  - `include_escalation` parameter in `create_standard_network()`
+  - `escalation_channels` parameter for channel description
+  - `add_escalation_to_all()` method in AgentNetwork
+  - Escalation added as handoff to ALL agents by default
+- **Template Configuration**: New `escalation_config.yaml` template
+  - Customizable triggers, channels, and business hours
+  - Priority classification rules
+  - Custom messages
+- **Client Updates**: Vivo and EasyDr networks support Escalation Agent
+- **Examples**: New `main_escalation()` demo in `run_vivo.py`
+
+### Changed
+- `AgentNetwork` now includes `escalation` attribute
+- Network handoffs updated to include escalation option
+- README updated with Escalation Agent documentation
+- Version bump to 0.4.0
+
+## [0.3.0] - 2025-01-04
+
+### Added
+- **License System**: New token-based licensing system
+  - `activate()` function to activate the library
+  - Auto-activation via `ATENDENTEPRO_LICENSE_KEY` environment variable
+  - `atendentepro-generate-token` CLI command for administrators
+  - License expiration support
+  - Feature-based licensing
+- **CLI Tools**: Command-line interface for token generation
+- **Improved Documentation**: Enhanced README with activation instructions
+
+### Changed
+- Library now requires activation before use
+- Version bump to 0.3.0
+- Updated pyproject.toml with new metadata
+
+### Security
+- Added HMAC-SHA256 token validation
+- Proprietary license enforcement
+
+## [0.2.0] - 2025-01-03
+
+### Added
+- **Modular Architecture**: Complete refactoring into independent library
+- **Agent Network**: Configurable multi-agent system
+  - Triage Agent - Intent classification
+  - Flow Agent - Options presentation
+  - Interview Agent - Information collection
+  - Answer Agent - Response synthesis
+  - Knowledge Agent - RAG and structured data queries
+  - Confirmation Agent - Yes/no validation
+  - Usage Agent - System help
+  - Onboarding Agent - User registration
+- **Template System**: YAML-based client configuration
+- **Guardrails**: Scope validation and forbidden topics
+- **Custom Tools**: Support for function_tool integrations
+- **Multiple Data Sources**: CSV, database, API support
+
+### Changed
+- Extracted from monkai monorepo into standalone package
+- Standardized configuration format
+
+## [0.1.0] - 2024-12-01
+
+### Added
+- Initial release
+- Basic multi-agent functionality
+- OpenAI Agents SDK integration
+

{atendentepro-0.3.0 → atendentepro-0.5.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: atendentepro
-Version: 0.3.0
+Version: 0.5.1
 Summary: Sistema de Atendimento Inteligente com Múltiplos Agentes IA - Biblioteca independente e modular baseada no OpenAI Agents SDK
 Author-email: BeMonkAI <contato@bemonkai.com>
 Maintainer-email: BeMonkAI <contato@bemonkai.com>
@@ -58,7 +58,7 @@ Dynamic: license-file
 
 [![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
 [![License: Proprietary](https://img.shields.io/badge/License-Proprietary-red.svg)](LICENSE)
-[![Version](https://img.shields.io/badge/version-0.3.0-green.svg)](CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-0.5.0-green.svg)](CHANGELOG.md)
 
 **Sistema de Atendimento Inteligente com Múltiplos Agentes IA**
 
@@ -157,9 +157,9 @@ from agents import Runner
 activate("ATP_seu-token")
 
 async def main():
-    # 2. Criar rede de agentes
+    # 2. Criar rede de agentes usando template standard
     network = create_standard_network(
-        templates_root=Path("./client_templates"),
+        templates_root=Path("./templates"),  # Template genérico de exemplo
         client="standard"
     )
     
@@ -179,34 +179,40 @@ asyncio.run(main())
 ## 🏗️ Arquitetura
 
 ```
-┌─────────────────────────────────────────────────────────────────┐
-│                         ATENDENTEPRO                            │
-├─────────────────────────────────────────────────────────────────┤
-│                                                                 │
-│   👤 Usuário                                                    │
-│       │                                                         │
-│       ▼                                                         │
-│   ┌─────────────┐                                              │
-│   │   Triage    │──► Classifica intenção                       │
-│   └─────────────┘                                              │
-│         │                                                       │
-│         ├──────────┬──────────┬──────────┬──────────┐          │
-│         ▼          ▼          ▼          ▼          ▼          │
-│   ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐  │
-│   │  Flow   │ │Knowledge│ │Confirm  │ │  Usage  │ │Onboard  │  │
-│   └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘  │
-│         │                                                       │
-│         ▼                                                       │
-│   ┌─────────────┐                                              │
-│   │  Interview  │──► Coleta informações                        │
-│   └─────────────┘                                              │
-│         │                                                       │
-│         ▼                                                       │
-│   ┌─────────────┐                                              │
-│   │   Answer    │──► Resposta final                            │
-│   └─────────────┘                                              │
-│                                                                 │
-└─────────────────────────────────────────────────────────────────┘
+┌────────────────────────────────────────────────────────────────────────────┐
+│                              ATENDENTEPRO                                  │
+├────────────────────────────────────────────────────────────────────────────┤
+│                                                                            │
+│   👤 Usuário                                                               │
+│       │                                                                    │
+│       ▼                                                                    │
+│   ┌─────────────┐                                                         │
+│   │   Triage    │──► Classifica intenção                                  │
+│   └─────────────┘                                                         │
+│         │                                                                  │
+│    ┌────┴────┬─────────┬─────────┬─────────┬─────────┬─────────┬────────┐ │
+│    ▼         ▼         ▼         ▼         ▼         ▼         ▼        ▼ │
+│ ┌──────┐ ┌───────┐ ┌───────┐ ┌───────┐ ┌───────┐ ┌───────┐ ┌───────┐    │
+│ │ Flow │ │Knowl. │ │Confirm│ │ Usage │ │Onboard│ │Escala.│ │Feedbk.│    │
+│ └──────┘ └───────┘ └───────┘ └───────┘ └───────┘ └───────┘ └───────┘    │
+│    │                                                  │         │        │
+│    │         Todos os agentes podem escalar ─────────►│         │        │
+│    │         ou registrar feedback ──────────────────────────────►       │
+│    ▼                                                                      │
+│ ┌─────────────┐                                                          │
+│ │  Interview  │──► Coleta informações                                    │
+│ └─────────────┘                                                          │
+│       │                                                                   │
+│       ▼                                                                   │
+│ ┌─────────────┐                                                          │
+│ │   Answer    │──► Resposta final                                        │
+│ └─────────────┘                                                          │
+│                                                                            │
+│ ═══════════════════════════════════════════════════════════════════════  │
+│  📞 Escalation ──► Transfere para atendimento humano IMEDIATO            │
+│  📝 Feedback   ──► Registra tickets para resposta POSTERIOR              │
+│                                                                            │
+└────────────────────────────────────────────────────────────────────────────┘
 ```
 
 ---
@@ -223,6 +229,8 @@ asyncio.run(main())
 | **Confirmation** | Valida com respostas sim/não |
 | **Usage** | Responde dúvidas sobre o sistema |
 | **Onboarding** | Cadastro de novos usuários |
+| **Escalation** | Transfere para atendimento humano quando necessário |
+| **Feedback** | Registra dúvidas, feedbacks, reclamações e sugestões |
 
 ---
 
@@ -231,18 +239,24 @@ asyncio.run(main())
 Templates são configurações YAML que personalizam o comportamento dos agentes:
 
 ```
-client_templates/
-├── standard/              # Template base
-│   ├── triage_config.yaml
-│   ├── flow_config.yaml
-│   ├── interview_config.yaml
-│   └── ...
+templates/                 # ✅ Templates genéricos (incluídos no repositório)
+└── standard/              # Template de exemplo
+    ├── triage_config.yaml
+    ├── flow_config.yaml
+    ├── escalation_config.yaml
+    ├── feedback_config.yaml
+    └── ...
+
+client_templates/          # 🔒 Templates de clientes (não incluídos no repositório)
 └── meu_cliente/           # Template customizado
     ├── triage_config.yaml
     ├── tools.py           # Tools customizadas
     └── network.py         # Rede específica
 ```
 
+> **Nota:** A pasta `templates/` contém exemplos genéricos e é incluída no repositório.
+> A pasta `client_templates/` contém configurações de clientes e está no `.gitignore`.
+
 Veja a [documentação completa](atendentepro/README.md) para criar templates.
 
 ---

{atendentepro-0.3.0 → atendentepro-0.5.1}/README.md

@@ -2,7 +2,7 @@
 
 [![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
 [![License: Proprietary](https://img.shields.io/badge/License-Proprietary-red.svg)](LICENSE)
-[![Version](https://img.shields.io/badge/version-0.3.0-green.svg)](CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-0.5.0-green.svg)](CHANGELOG.md)
 
 **Sistema de Atendimento Inteligente com Múltiplos Agentes IA**
 
@@ -101,9 +101,9 @@ from agents import Runner
 activate("ATP_seu-token")
 
 async def main():
-    # 2. Criar rede de agentes
+    # 2. Criar rede de agentes usando template standard
     network = create_standard_network(
-        templates_root=Path("./client_templates"),
+        templates_root=Path("./templates"),  # Template genérico de exemplo
         client="standard"
     )
     
@@ -123,34 +123,40 @@ asyncio.run(main())
 ## 🏗️ Arquitetura
 
 ```
-┌─────────────────────────────────────────────────────────────────┐
-│                         ATENDENTEPRO                            │
-├─────────────────────────────────────────────────────────────────┤
-│                                                                 │
-│   👤 Usuário                                                    │
-│       │                                                         │
-│       ▼                                                         │
-│   ┌─────────────┐                                              │
-│   │   Triage    │──► Classifica intenção                       │
-│   └─────────────┘                                              │
-│         │                                                       │
-│         ├──────────┬──────────┬──────────┬──────────┐          │
-│         ▼          ▼          ▼          ▼          ▼          │
-│   ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐  │
-│   │  Flow   │ │Knowledge│ │Confirm  │ │  Usage  │ │Onboard  │  │
-│   └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘  │
-│         │                                                       │
-│         ▼                                                       │
-│   ┌─────────────┐                                              │
-│   │  Interview  │──► Coleta informações                        │
-│   └─────────────┘                                              │
-│         │                                                       │
-│         ▼                                                       │
-│   ┌─────────────┐                                              │
-│   │   Answer    │──► Resposta final                            │
-│   └─────────────┘                                              │
-│                                                                 │
-└─────────────────────────────────────────────────────────────────┘
+┌────────────────────────────────────────────────────────────────────────────┐
+│                              ATENDENTEPRO                                  │
+├────────────────────────────────────────────────────────────────────────────┤
+│                                                                            │
+│   👤 Usuário                                                               │
+│       │                                                                    │
+│       ▼                                                                    │
+│   ┌─────────────┐                                                         │
+│   │   Triage    │──► Classifica intenção                                  │
+│   └─────────────┘                                                         │
+│         │                                                                  │
+│    ┌────┴────┬─────────┬─────────┬─────────┬─────────┬─────────┬────────┐ │
+│    ▼         ▼         ▼         ▼         ▼         ▼         ▼        ▼ │
+│ ┌──────┐ ┌───────┐ ┌───────┐ ┌───────┐ ┌───────┐ ┌───────┐ ┌───────┐    │
+│ │ Flow │ │Knowl. │ │Confirm│ │ Usage │ │Onboard│ │Escala.│ │Feedbk.│    │
+│ └──────┘ └───────┘ └───────┘ └───────┘ └───────┘ └───────┘ └───────┘    │
+│    │                                                  │         │        │
+│    │         Todos os agentes podem escalar ─────────►│         │        │
+│    │         ou registrar feedback ──────────────────────────────►       │
+│    ▼                                                                      │
+│ ┌─────────────┐                                                          │
+│ │  Interview  │──► Coleta informações                                    │
+│ └─────────────┘                                                          │
+│       │                                                                   │
+│       ▼                                                                   │
+│ ┌─────────────┐                                                          │
+│ │   Answer    │──► Resposta final                                        │
+│ └─────────────┘                                                          │
+│                                                                            │
+│ ═══════════════════════════════════════════════════════════════════════  │
+│  📞 Escalation ──► Transfere para atendimento humano IMEDIATO            │
+│  📝 Feedback   ──► Registra tickets para resposta POSTERIOR              │
+│                                                                            │
+└────────────────────────────────────────────────────────────────────────────┘
 ```
 
 ---
@@ -167,6 +173,8 @@ asyncio.run(main())
 | **Confirmation** | Valida com respostas sim/não |
 | **Usage** | Responde dúvidas sobre o sistema |
 | **Onboarding** | Cadastro de novos usuários |
+| **Escalation** | Transfere para atendimento humano quando necessário |
+| **Feedback** | Registra dúvidas, feedbacks, reclamações e sugestões |
 
 ---
 
@@ -175,18 +183,24 @@ asyncio.run(main())
 Templates são configurações YAML que personalizam o comportamento dos agentes:
 
 ```
-client_templates/
-├── standard/              # Template base
-│   ├── triage_config.yaml
-│   ├── flow_config.yaml
-│   ├── interview_config.yaml
-│   └── ...
+templates/                 # ✅ Templates genéricos (incluídos no repositório)
+└── standard/              # Template de exemplo
+    ├── triage_config.yaml
+    ├── flow_config.yaml
+    ├── escalation_config.yaml
+    ├── feedback_config.yaml
+    └── ...
+
+client_templates/          # 🔒 Templates de clientes (não incluídos no repositório)
 └── meu_cliente/           # Template customizado
     ├── triage_config.yaml
     ├── tools.py           # Tools customizadas
     └── network.py         # Rede específica
 ```
 
+> **Nota:** A pasta `templates/` contém exemplos genéricos e é incluída no repositório.
+> A pasta `client_templates/` contém configurações de clientes e está no `.gitignore`.
+
 Veja a [documentação completa](atendentepro/README.md) para criar templates.
 
 ---