atendentepro 0.3.0__tar.gz

atendentepro-0.3.0/CHANGELOG.md

@@ -0,0 +1,57 @@
+# 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.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/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@bemonkai.com
+
+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@bemonkai.com
+Website: https://bemonkai.com
+

atendentepro-0.3.0/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
+

atendentepro-0.3.0/PKG-INFO

@@ -0,0 +1,306 @@
+Metadata-Version: 2.4
+Name: atendentepro
+Version: 0.3.0
+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>
+License: Proprietary
+Project-URL: Homepage, https://github.com/BeMonkAI/atendentepro
+Project-URL: Documentation, https://github.com/BeMonkAI/atendentepro#readme
+Project-URL: Repository, https://github.com/BeMonkAI/atendentepro
+Project-URL: Issues, https://github.com/BeMonkAI/atendentepro/issues
+Project-URL: Changelog, https://github.com/BeMonkAI/atendentepro/blob/main/CHANGELOG.md
+Keywords: ai,agents,customer-service,chatbot,openai,multi-agent,atendimento,openai-agents,conversational-ai,rag
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: Other/Proprietary License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Communications :: Chat
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: openai-agents>=0.3.3
+Requires-Dist: openai>=1.107.1
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: PyYAML>=6.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: numpy>=1.24.0
+Requires-Dist: scikit-learn>=1.3.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: isort>=5.12.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: mkdocs>=1.5.0; extra == "docs"
+Requires-Dist: mkdocs-material>=9.0.0; extra == "docs"
+Provides-Extra: rag
+Requires-Dist: PyPDF2>=3.0.0; extra == "rag"
+Requires-Dist: python-docx>=0.8.11; extra == "rag"
+Requires-Dist: python-pptx>=0.6.21; extra == "rag"
+Requires-Dist: PyMuPDF>=1.23.0; extra == "rag"
+Provides-Extra: tracing
+Requires-Dist: opentelemetry-sdk>=1.20.0; extra == "tracing"
+Requires-Dist: azure-monitor-opentelemetry-exporter>=1.0.0; extra == "tracing"
+Provides-Extra: all
+Requires-Dist: atendentepro[dev,docs,rag,tracing]; extra == "all"
+Dynamic: license-file
+
+# AtendentePro 🤖
+
+[![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)
+
+**Sistema de Atendimento Inteligente com Múltiplos Agentes IA**
+
+Uma biblioteca Python modular e independente para criar sistemas de atendimento automatizado usando múltiplos agentes de IA especializados baseados no [OpenAI Agents SDK](https://github.com/openai/openai-agents-python).
+
+---
+
+## 📋 Índice
+
+- [Instalação](#-instalação)
+- [Ativação (Licença)](#-ativação-licença)
+- [Início Rápido](#-início-rápido)
+- [Arquitetura](#-arquitetura)
+- [Agentes](#-agentes)
+- [Templates](#-templates)
+- [Documentação](#-documentação)
+- [Suporte](#-suporte)
+
+---
+
+## 📦 Instalação
+
+### Via pip (Privado)
+
+```bash
+# Instalar do repositório privado
+pip install atendentepro --extra-index-url https://pypi.bemonkai.com/simple/
+
+# Ou via GitHub
+pip install git+https://github.com/BeMonkAI/atendentepro.git
+```
+
+### Desenvolvimento Local
+
+```bash
+# Clonar repositório
+git clone https://github.com/BeMonkAI/atendentepro.git
+cd atendentepro
+
+# Criar ambiente virtual
+python -m venv venv
+source venv/bin/activate  # Linux/Mac
+# ou: venv\Scripts\activate  # Windows
+
+# Instalar em modo editable
+pip install -e .
+
+# Com dependências de desenvolvimento
+pip install -e ".[dev]"
+```
+
+---
+
+## 🔑 Ativação (Licença)
+
+A biblioteca **requer um token de licença** para funcionar.
+
+### Opção 1: Variável de Ambiente (Recomendado)
+
+```bash
+export ATENDENTEPRO_LICENSE_KEY="ATP_seu-token-aqui"
+```
+
+### Opção 2: Via Código
+
+```python
+from atendentepro import activate
+
+activate("ATP_seu-token-aqui")
+```
+
+### Opção 3: Arquivo .env
+
+```env
+ATENDENTEPRO_LICENSE_KEY=ATP_seu-token-aqui
+OPENAI_API_KEY=sk-sua-chave-openai
+```
+
+### Obter um Token
+
+Entre em contato para obter seu token:
+- 📧 **Email:** contato@bemonkai.com
+- 🌐 **Site:** https://bemonkai.com
+
+---
+
+## ⚡ Início Rápido
+
+```python
+import asyncio
+from pathlib import Path
+from atendentepro import activate, create_standard_network
+from agents import Runner
+
+# 1. Ativar (ou use variável de ambiente)
+activate("ATP_seu-token")
+
+async def main():
+    # 2. Criar rede de agentes
+    network = create_standard_network(
+        templates_root=Path("./client_templates"),
+        client="standard"
+    )
+    
+    # 3. Executar conversa
+    result = await Runner.run(
+        network.triage,
+        [{"role": "user", "content": "Olá, preciso de ajuda"}]
+    )
+    
+    print(result.final_output)
+
+asyncio.run(main())
+```
+
+---
+
+## 🏗️ Arquitetura
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                         ATENDENTEPRO                            │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                 │
+│   👤 Usuário                                                    │
+│       │                                                         │
+│       ▼                                                         │
+│   ┌─────────────┐                                              │
+│   │   Triage    │──► Classifica intenção                       │
+│   └─────────────┘                                              │
+│         │                                                       │
+│         ├──────────┬──────────┬──────────┬──────────┐          │
+│         ▼          ▼          ▼          ▼          ▼          │
+│   ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐  │
+│   │  Flow   │ │Knowledge│ │Confirm  │ │  Usage  │ │Onboard  │  │
+│   └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘  │
+│         │                                                       │
+│         ▼                                                       │
+│   ┌─────────────┐                                              │
+│   │  Interview  │──► Coleta informações                        │
+│   └─────────────┘                                              │
+│         │                                                       │
+│         ▼                                                       │
+│   ┌─────────────┐                                              │
+│   │   Answer    │──► Resposta final                            │
+│   └─────────────┘                                              │
+│                                                                 │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 🤖 Agentes
+
+| Agente | Descrição |
+|--------|-----------|
+| **Triage** | Classifica intenção e direciona para agente especializado |
+| **Flow** | Apresenta opções/menu ao usuário |
+| **Interview** | Coleta informações através de perguntas |
+| **Answer** | Sintetiza resposta final |
+| **Knowledge** | Consulta RAG e dados estruturados |
+| **Confirmation** | Valida com respostas sim/não |
+| **Usage** | Responde dúvidas sobre o sistema |
+| **Onboarding** | Cadastro de novos usuários |
+
+---
+
+## 📁 Templates
+
+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
+│   └── ...
+└── meu_cliente/           # Template customizado
+    ├── triage_config.yaml
+    ├── tools.py           # Tools customizadas
+    └── network.py         # Rede específica
+```
+
+Veja a [documentação completa](atendentepro/README.md) para criar templates.
+
+---
+
+## 📚 Documentação
+
+- [📖 Documentação da Biblioteca](atendentepro/README.md)
+- [📊 Fluxogramas](docs/fluxogramas/)
+- [💡 Exemplos](examples/)
+- [📝 Changelog](CHANGELOG.md)
+
+---
+
+## 🔧 Dependências
+
+- Python 3.9+
+- openai-agents >= 0.3.3
+- openai >= 1.107.1
+- pydantic >= 2.0.0
+- PyYAML >= 6.0
+- python-dotenv >= 1.0.0
+
+---
+
+## 🛠️ Desenvolvimento
+
+```bash
+# Instalar dependências de desenvolvimento
+pip install -e ".[dev]"
+
+# Rodar testes
+pytest
+
+# Formatar código
+black atendentepro
+isort atendentepro
+
+# Type checking
+mypy atendentepro
+```
+
+---
+
+## 📄 Licença
+
+Este software é **proprietário** e requer uma licença válida para uso.
+
+Veja o arquivo [LICENSE](LICENSE) para mais detalhes.
+
+---
+
+## 🤝 Suporte
+
+- 📧 **Email:** contato@bemonkai.com
+- 🌐 **Site:** https://bemonkai.com
+- 🐛 **Issues:** https://github.com/BeMonkAI/atendentepro/issues
+
+---
+
+**Made with ❤️ by BeMonkAI**
+

atendentepro-0.3.0/README.md

@@ -0,0 +1,250 @@
+# AtendentePro 🤖
+
+[![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)
+
+**Sistema de Atendimento Inteligente com Múltiplos Agentes IA**
+
+Uma biblioteca Python modular e independente para criar sistemas de atendimento automatizado usando múltiplos agentes de IA especializados baseados no [OpenAI Agents SDK](https://github.com/openai/openai-agents-python).
+
+---
+
+## 📋 Índice
+
+- [Instalação](#-instalação)
+- [Ativação (Licença)](#-ativação-licença)
+- [Início Rápido](#-início-rápido)
+- [Arquitetura](#-arquitetura)
+- [Agentes](#-agentes)
+- [Templates](#-templates)
+- [Documentação](#-documentação)
+- [Suporte](#-suporte)
+
+---
+
+## 📦 Instalação
+
+### Via pip (Privado)
+
+```bash
+# Instalar do repositório privado
+pip install atendentepro --extra-index-url https://pypi.bemonkai.com/simple/
+
+# Ou via GitHub
+pip install git+https://github.com/BeMonkAI/atendentepro.git
+```
+
+### Desenvolvimento Local
+
+```bash
+# Clonar repositório
+git clone https://github.com/BeMonkAI/atendentepro.git
+cd atendentepro
+
+# Criar ambiente virtual
+python -m venv venv
+source venv/bin/activate  # Linux/Mac
+# ou: venv\Scripts\activate  # Windows
+
+# Instalar em modo editable
+pip install -e .
+
+# Com dependências de desenvolvimento
+pip install -e ".[dev]"
+```
+
+---
+
+## 🔑 Ativação (Licença)
+
+A biblioteca **requer um token de licença** para funcionar.
+
+### Opção 1: Variável de Ambiente (Recomendado)
+
+```bash
+export ATENDENTEPRO_LICENSE_KEY="ATP_seu-token-aqui"
+```
+
+### Opção 2: Via Código
+
+```python
+from atendentepro import activate
+
+activate("ATP_seu-token-aqui")
+```
+
+### Opção 3: Arquivo .env
+
+```env
+ATENDENTEPRO_LICENSE_KEY=ATP_seu-token-aqui
+OPENAI_API_KEY=sk-sua-chave-openai
+```
+
+### Obter um Token
+
+Entre em contato para obter seu token:
+- 📧 **Email:** contato@bemonkai.com
+- 🌐 **Site:** https://bemonkai.com
+
+---
+
+## ⚡ Início Rápido
+
+```python
+import asyncio
+from pathlib import Path
+from atendentepro import activate, create_standard_network
+from agents import Runner
+
+# 1. Ativar (ou use variável de ambiente)
+activate("ATP_seu-token")
+
+async def main():
+    # 2. Criar rede de agentes
+    network = create_standard_network(
+        templates_root=Path("./client_templates"),
+        client="standard"
+    )
+    
+    # 3. Executar conversa
+    result = await Runner.run(
+        network.triage,
+        [{"role": "user", "content": "Olá, preciso de ajuda"}]
+    )
+    
+    print(result.final_output)
+
+asyncio.run(main())
+```
+
+---
+
+## 🏗️ Arquitetura
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                         ATENDENTEPRO                            │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                 │
+│   👤 Usuário                                                    │
+│       │                                                         │
+│       ▼                                                         │
+│   ┌─────────────┐                                              │
+│   │   Triage    │──► Classifica intenção                       │
+│   └─────────────┘                                              │
+│         │                                                       │
+│         ├──────────┬──────────┬──────────┬──────────┐          │
+│         ▼          ▼          ▼          ▼          ▼          │
+│   ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐  │
+│   │  Flow   │ │Knowledge│ │Confirm  │ │  Usage  │ │Onboard  │  │
+│   └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘  │
+│         │                                                       │
+│         ▼                                                       │
+│   ┌─────────────┐                                              │
+│   │  Interview  │──► Coleta informações                        │
+│   └─────────────┘                                              │
+│         │                                                       │
+│         ▼                                                       │
+│   ┌─────────────┐                                              │
+│   │   Answer    │──► Resposta final                            │
+│   └─────────────┘                                              │
+│                                                                 │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 🤖 Agentes
+
+| Agente | Descrição |
+|--------|-----------|
+| **Triage** | Classifica intenção e direciona para agente especializado |
+| **Flow** | Apresenta opções/menu ao usuário |
+| **Interview** | Coleta informações através de perguntas |
+| **Answer** | Sintetiza resposta final |
+| **Knowledge** | Consulta RAG e dados estruturados |
+| **Confirmation** | Valida com respostas sim/não |
+| **Usage** | Responde dúvidas sobre o sistema |
+| **Onboarding** | Cadastro de novos usuários |
+
+---
+
+## 📁 Templates
+
+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
+│   └── ...
+└── meu_cliente/           # Template customizado
+    ├── triage_config.yaml
+    ├── tools.py           # Tools customizadas
+    └── network.py         # Rede específica
+```
+
+Veja a [documentação completa](atendentepro/README.md) para criar templates.
+
+---
+
+## 📚 Documentação
+
+- [📖 Documentação da Biblioteca](atendentepro/README.md)
+- [📊 Fluxogramas](docs/fluxogramas/)
+- [💡 Exemplos](examples/)
+- [📝 Changelog](CHANGELOG.md)
+
+---
+
+## 🔧 Dependências
+
+- Python 3.9+
+- openai-agents >= 0.3.3
+- openai >= 1.107.1
+- pydantic >= 2.0.0
+- PyYAML >= 6.0
+- python-dotenv >= 1.0.0
+
+---
+
+## 🛠️ Desenvolvimento
+
+```bash
+# Instalar dependências de desenvolvimento
+pip install -e ".[dev]"
+
+# Rodar testes
+pytest
+
+# Formatar código
+black atendentepro
+isort atendentepro
+
+# Type checking
+mypy atendentepro
+```
+
+---
+
+## 📄 Licença
+
+Este software é **proprietário** e requer uma licença válida para uso.
+
+Veja o arquivo [LICENSE](LICENSE) para mais detalhes.
+
+---
+
+## 🤝 Suporte
+
+- 📧 **Email:** contato@bemonkai.com
+- 🌐 **Site:** https://bemonkai.com
+- 🐛 **Issues:** https://github.com/BeMonkAI/atendentepro/issues
+
+---
+
+**Made with ❤️ by BeMonkAI**
+