atendentepro 0.5.7__tar.gz

atendentepro-0.5.7/CHANGELOG.md

@@ -0,0 +1,183 @@
+# 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.7] - 2025-01-07
+
+### Added
+- MonkAI Trace integration for comprehensive agent monitoring
+- New functions: `configure_monkai_trace`, `run_with_monkai_tracking`
+- Session management with `set_monkai_user`, `set_monkai_input`
+- Token segmentation support (input, output, process, memory)
+- Multi-user session tracking for WhatsApp/chat bots
+- Documentation for tracing setup in README
+
+### Changed
+- Renamed `configure_tracing` to `configure_application_insights` (legacy alias kept)
+
+## [0.5.6] - 2025-01-07
+
+### Added
+- New parameters in `create_standard_network` to enable/disable individual agents:
+  - `include_flow`, `include_interview`, `include_answer`
+  - `include_knowledge`, `include_confirmation`, `include_usage`
+- Allows creating custom networks without specific agents (e.g., without Knowledge)
+
+### Changed
+- Handoffs are now dynamically configured based on which agents are enabled
+- Documentation updated with examples of minimal network configurations
+
+## [0.5.5] - 2025-01-06
+
+### Fixed
+- GitHub Actions workflow now only triggers PyPI publish on version tags
+
+## [0.5.4] - 2025-01-06
+
+### Changed
+- Complete standalone documentation in README.md for PyPI
+- All documentation now visible directly on PyPI page
+- No external links to private repository
+
+## [0.5.3] - 2025-01-06
+
+### Fixed
+- Documentation links now use absolute GitHub URLs for PyPI compatibility
+- Removed reference to private `examples/` folder
+
+## [0.5.2] - 2025-01-06
+
+### Changed
+- Updated contact information:
+  - Email: contato@monkai.com.br
+  - Website: https://www.monkai.com.br
+
+## [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.5.7/LICENSE

@@ -0,0 +1,25 @@
+AtendentePro Proprietary License
+
+Copyright (c) 2024-2025 BeMonkAI
+
+All rights reserved.
+
+NOTICE: This software is proprietary and confidential. Unauthorized copying,
+modification, distribution, or use of this software, via any medium, is
+strictly prohibited without the express written permission of BeMonkAI.
+
+This software requires a valid license key for use. License keys can be
+obtained by contacting: contato@monkai.com.br
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+For licensing inquiries:
+Email: contato@monkai.com.br
+Website: https://www.monkai.com.br
+

atendentepro-0.5.7/MANIFEST.in

@@ -0,0 +1,40 @@
+# Include the README and other documentation
+include README.md
+include CHANGELOG.md
+include LICENSE
+
+# Include requirements
+include requirements.txt
+
+# Include package data
+recursive-include atendentepro *.py
+recursive-include atendentepro *.md
+
+# Exclude development and test files
+exclude .gitignore
+exclude .env
+exclude .env.example
+exclude env.example
+
+# Exclude directories not needed in package
+prune venv
+prune .venv
+prune tests
+prune docs
+prune examples
+prune scripts
+prune client_templates
+prune *.egg-info
+prune __pycache__
+prune .git
+prune .github
+prune .pytest_cache
+prune .mypy_cache
+
+# Exclude compiled files
+global-exclude *.py[cod]
+global-exclude __pycache__
+global-exclude *.so
+global-exclude *.dylib
+global-exclude .DS_Store
+