atendentepro 0.3.0__py3-none-any.whl

atendentepro/utils/tracing.py

@@ -0,0 +1,71 @@
+# -*- coding: utf-8 -*-
+"""
+Tracing configuration for AtendentePro.
+
+Provides optional Application Insights integration for telemetry.
+"""
+
+from __future__ import annotations
+
+import logging
+from typing import Optional
+
+from atendentepro.config import get_config
+
+logger = logging.getLogger(__name__)
+
+
+def configure_tracing(connection_string: Optional[str] = None) -> bool:
+    """
+    Configure Application Insights tracing if connection string is available.
+    
+    Args:
+        connection_string: Optional connection string. If not provided,
+                          uses the value from configuration.
+                          
+    Returns:
+        True if tracing was configured, False otherwise.
+    """
+    config = get_config()
+    conn_str = connection_string or config.application_insights_connection_string
+    
+    if not conn_str:
+        logger.debug("No Application Insights connection string provided. Tracing disabled.")
+        return False
+    
+    try:
+        # Try to configure Application Insights
+        from opentelemetry import trace
+        from opentelemetry.sdk.trace import TracerProvider
+        from opentelemetry.sdk.trace.export import BatchSpanProcessor
+        
+        # Check if azure monitor is available
+        try:
+            from azure.monitor.opentelemetry.exporter import AzureMonitorTraceExporter
+            
+            exporter = AzureMonitorTraceExporter(connection_string=conn_str)
+            provider = TracerProvider()
+            processor = BatchSpanProcessor(exporter)
+            provider.add_span_processor(processor)
+            trace.set_tracer_provider(provider)
+            
+            logger.info("Application Insights tracing configured successfully.")
+            return True
+            
+        except ImportError:
+            logger.warning(
+                "Azure Monitor exporter not available. "
+                "Install 'azure-monitor-opentelemetry-exporter' for Application Insights support."
+            )
+            return False
+            
+    except ImportError:
+        logger.warning(
+            "OpenTelemetry not available. "
+            "Install 'opentelemetry-sdk' for tracing support."
+        )
+        return False
+    except Exception as e:
+        logger.error(f"Failed to configure tracing: {e}")
+        return False
+

atendentepro-0.3.0.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,39 @@
+atendentepro/README.md,sha256=2JWtLfG01zu8IO7Zo0AZOLSJoxNcWlrzgv4CYQML4I8,24619
+atendentepro/__init__.py,sha256=m8djGtMGG-EAm43h6J0NxGC7xqObG4_90RyT5vCDMks,4794
+atendentepro/license.py,sha256=AGi2ePm28kUak0ekzZ-0Fulg2Q2IOrmVEOS69zDLT58,17567
+atendentepro/network.py,sha256=YgSw6LYvSmFUPztHOK7MR5LrMlyBtBCWobizTNOhCr0,10266
+atendentepro/agents/__init__.py,sha256=_05UyG04mTlwgZ56ymGI6lavIFQq_qyKWSsK4H1v4uY,1236
+atendentepro/agents/answer.py,sha256=4uiuih8cSBUNqPWwN4TfCilnBOfAYhOtpj8bCZQ0Lpk,2023
+atendentepro/agents/confirmation.py,sha256=5Zg4z9A90CydYiEk8CEAKnnza71algFKF-N1WLwGDQI,2311
+atendentepro/agents/flow.py,sha256=qWuPcjfm2peWjpHFUiq0P1blRk500LUUucb2Z9kT95Q,2056
+atendentepro/agents/interview.py,sha256=Tegfh3ZTr7__b_a0elyfn57u56yuS2pN_RB-8vOt-Os,2133
+atendentepro/agents/knowledge.py,sha256=M8XOJ_yxYRyuCaBxn-xFCCWE-MTx5bjyUi4-E2tSPL8,10080
+atendentepro/agents/onboarding.py,sha256=bDdwEE33Hcnv8UW3qsHhLcloaEL5xfh3BBeoWTgb8s0,2098
+atendentepro/agents/triage.py,sha256=VUHOwbQq0jt8pDfNy0FWznicqXDgMfXW0JwAsuGcAzg,1733
+atendentepro/agents/usage.py,sha256=hmckYQ4kOfYqu15xsxg_r2VoRozCwtw-RxxteUtbsI0,1594
+atendentepro/config/__init__.py,sha256=LQZbEz9AVGnO8xCG_rI9GmyFQun5HQqo8hJkkm-d_e4,338
+atendentepro/config/settings.py,sha256=Z1texEtO76Rrt-wPyEXM3FyujDE75r8HbEEJClzFOvk,4762
+atendentepro/guardrails/__init__.py,sha256=lCSI4RbQeIOya8k1wIADoxz9gYySDtUtOv-JiXisvyQ,454
+atendentepro/guardrails/manager.py,sha256=KeyQkIfyPYuHIbuCPP-N4y2R3AJ6n2thkEO_avDgY7M,14053
+atendentepro/models/__init__.py,sha256=eUMq0Lw21PGItGliKHxFDeETIqOVqEwkXVOjgJPM5I0,390
+atendentepro/models/context.py,sha256=1WsoHEtXodgfd5JyZDZctV_2uabNq_XAKv0HKmWb-G8,543
+atendentepro/models/outputs.py,sha256=B573co699DhK0TSpqOHUykUOnBVa2Ool4rnNEO-xmUA,3270
+atendentepro/prompts/__init__.py,sha256=hoO_mqZ6XwdfnUUOUSYJ8LaHR6pQArh7IhNtHZRq5UQ,1026
+atendentepro/prompts/answer.py,sha256=nFaSDXWKLchk2kxN3ID6OfhOZBh7qLYD7y6bFlDYer8,4099
+atendentepro/prompts/confirmation.py,sha256=zt1Ekl8ZVrAAKZ9xZHa3R343JG9VzuZVJYt1jZCg2jg,4141
+atendentepro/prompts/flow.py,sha256=BCuaiaZLZBrS3X4Lxo80JS8a94w-mmxlXwqE1259R_c,4078
+atendentepro/prompts/interview.py,sha256=9zVGA8zSmm6pBx2i1LPGNJIPuLlz7PZKRJE_PC6J7UI,3988
+atendentepro/prompts/knowledge.py,sha256=B3BOyAvzQlwAkR51gc-B6XbQLtwIZlwGP1ofhZ4cFbk,4644
+atendentepro/prompts/onboarding.py,sha256=78fSIh2ifsGeoav8DV41_jnyU157c0dtggJujcDvW4U,6093
+atendentepro/prompts/triage.py,sha256=bSdEVheGy03r5P6MQuv7NwhN2_wrt0mK80F9f_LskRU,1283
+atendentepro/templates/__init__.py,sha256=kSXiDXVIZKKsSn2GuHBcHsnXqVRcNWyBzRlKl9HYoCI,1137
+atendentepro/templates/manager.py,sha256=KdE4khWDMD2S607TDTMkvJ8lZzQ9D_TD_lBaXYSTBzI,17932
+atendentepro/utils/__init__.py,sha256=6EgS4DrW4fG17JdaHNKWMpzicigfFLVJO2VxPV73k9c,334
+atendentepro/utils/openai_client.py,sha256=R0ns7SU36vTgploq14-QJMTke1pPxcAXlENDeoHU0L4,4552
+atendentepro/utils/tracing.py,sha256=HQ3l4IiNcesCJ6l5qcERWyeBQav0G1ea-H8Rei6eQpE,2319
+atendentepro-0.3.0.dist-info/licenses/LICENSE,sha256=flIcFQ143WYRO80xQ0AaAlRdBbAJ6Y8zeLTdfYU5XsQ,976
+atendentepro-0.3.0.dist-info/METADATA,sha256=GUfKlkhORpcpDbgQT9J3ejsfvN59xkArOf2FiEnLccA,10258
+atendentepro-0.3.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+atendentepro-0.3.0.dist-info/entry_points.txt,sha256=OP0upzqJF3MLS6VX-M-5BfUwx5YLJO2sJ3YBAp4e6yI,89
+atendentepro-0.3.0.dist-info/top_level.txt,sha256=BFasD4SMmgDUmWKlTIZ1PeuukoRBhyiMIz8umKWVCcs,13
+atendentepro-0.3.0.dist-info/RECORD,,

atendentepro-0.3.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

atendentepro-0.3.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+atendentepro-generate-token = atendentepro.license:_cli_generate_token

atendentepro-0.3.0.dist-info/licenses/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.dist-info/top_level.txt

@@ -0,0 +1 @@
+atendentepro