atendentepro 0.6.0__tar.gz → 0.6.1__tar.gz

{atendentepro-0.6.0 → atendentepro-0.6.1}/CHANGELOG.md

@@ -5,6 +5,11 @@ 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.6.1] - 2025-01-08
+
+### Fixed
+- Documentação PyPI atualizada com AgentStyle e changelog completo
+
 ## [0.6.0] - 2025-01-08
 
 ### Added

{atendentepro-0.6.0 → atendentepro-0.6.1}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: atendentepro
-Version: 0.6.0
-Summary: Framework de orquestração de agentes IA para resolver interações complexas integrando múltiplas fontes de dados (documentos, APIs, bancos) em uma única plataforma inteligente.
+Version: 0.6.1
+Summary: Framework de orquestração de agentes IA com tom e estilo customizáveis. Integra documentos (RAG), APIs e bancos de dados em uma plataforma inteligente multi-agente.
 Author-email: BeMonkAI <contato@monkai.com.br>
 Maintainer-email: BeMonkAI <contato@monkai.com.br>
 License: Proprietary
@@ -73,6 +73,7 @@ Plataforma que unifica múltiplos agentes especializados para resolver demandas
 | **Classificação Inteligente** | Identifica a intenção e direciona para o agente especializado |
 | **Integração de Dados** | Conecta documentos (RAG), CSVs, bancos de dados SQL e APIs externas |
 | **Orquestração de Fluxos** | Handoffs automáticos entre agentes conforme a complexidade da demanda |
+| **Tom e Estilo Customizáveis** | AgentStyle para personalizar linguagem, tom e formato de respostas |
 | **Escalonamento Controlado** | Transferência para atendimento humano com contexto preservado |
 | **Gestão de Feedbacks** | Sistema de tickets para reclamações, sugestões e acompanhamento |
 | **Configuração Declarativa** | Personalização completa via arquivos YAML |
@@ -92,6 +93,7 @@ Plataforma que unifica múltiplos agentes especializados para resolver demandas
 - [Escalation Agent](#-escalation-agent)
 - [Feedback Agent](#-feedback-agent)
 - [Fluxo de Handoffs](#-fluxo-de-handoffs)
+- [Estilo de Comunicação](#-estilo-de-comunicação-agentstyle)
 - [Tracing e Monitoramento](#-tracing-e-monitoramento)
 - [Suporte](#-suporte)
 
@@ -278,6 +280,7 @@ meu_cliente/
 ├── escalation_config.yaml   # Recomendado
 ├── feedback_config.yaml     # Recomendado
 ├── guardrails_config.yaml   # Recomendado
+├── style_config.yaml        # Opcional - Tom e estilo
 └── data/                    # Dados estruturados (CSV, etc.)
 ```
 
@@ -596,6 +599,87 @@ network = create_standard_network(
 
 ---
 
+## 🎨 Estilo de Comunicação (AgentStyle)
+
+Personalize o tom e estilo de resposta dos agentes:
+
+### Via Código
+
+```python
+from pathlib import Path
+from atendentepro import create_standard_network, AgentStyle
+
+# Estilo global (aplicado a todos os agentes)
+global_style = AgentStyle(
+    tone="profissional e consultivo",
+    language_style="formal",      # formal, informal, neutro
+    response_length="moderado",   # conciso, moderado, detalhado
+    custom_rules="Sempre cumprimente o usuário pelo nome.",
+)
+
+# Estilos específicos por agente
+network = create_standard_network(
+    templates_root=Path("./meu_cliente"),
+    client="config",
+    global_style=global_style,
+    agent_styles={
+        "escalation": AgentStyle(
+            tone="empático e acolhedor",
+            custom_rules="Demonstre compreensão pela situação.",
+        ),
+        "knowledge": AgentStyle(
+            tone="didático e paciente",
+            response_length="detalhado",
+        ),
+    },
+)
+```
+
+### Via YAML (style_config.yaml)
+
+```yaml
+# Estilo Global
+global:
+  tone: "profissional e cordial"
+  language_style: "formal"
+  response_length: "moderado"
+  custom_rules: |
+    - Seja objetivo e claro nas respostas
+    - Use linguagem inclusiva
+
+# Estilos por Agente
+agents:
+  escalation:
+    tone: "empático e tranquilizador"
+    custom_rules: |
+      - Demonstre compreensão pela situação
+      - Assegure que o problema será resolvido
+
+  knowledge:
+    tone: "didático e paciente"
+    response_length: "detalhado"
+    custom_rules: |
+      - Explique conceitos de forma acessível
+      - Cite as fontes das informações
+
+  feedback:
+    tone: "solícito e atencioso"
+    custom_rules: |
+      - Agradeça o feedback recebido
+      - Confirme o registro da solicitação
+```
+
+### Opções Disponíveis
+
+| Parâmetro | Valores | Descrição |
+|-----------|---------|-----------|
+| `tone` | Texto livre | Tom da conversa (ex: "profissional", "empático") |
+| `language_style` | `formal`, `informal`, `neutro` | Nível de formalidade |
+| `response_length` | `conciso`, `moderado`, `detalhado` | Tamanho das respostas |
+| `custom_rules` | Texto livre | Regras personalizadas |
+
+---
+
 ## 🔧 Dependências
 
 - Python 3.9+
@@ -709,7 +793,17 @@ configure_application_insights(
 
 ## 📝 Changelog
 
-### v0.5.9 (Atual)
+### v0.6.1 (Atual)
+- Documentação PyPI atualizada com AgentStyle e changelog completo
+
+### v0.6.0
+- **AgentStyle**: Nova classe para personalizar tom e estilo de comunicação
+  - `tone`, `language_style`, `response_length`, `custom_rules`
+- `style_config.yaml`: Configuração de estilos via YAML
+- Parâmetros `global_style` e `agent_styles` em `create_standard_network()`
+- Todos os agentes aceitam `style_instructions`
+
+### v0.5.9
 - Descrição PyPI formal: "Framework de orquestração de agentes IA"
 - README profissional com foco em capacidades corporativas
 

{atendentepro-0.6.0 → atendentepro-0.6.1}/README.md

@@ -15,6 +15,7 @@ Plataforma que unifica múltiplos agentes especializados para resolver demandas
 | **Classificação Inteligente** | Identifica a intenção e direciona para o agente especializado |
 | **Integração de Dados** | Conecta documentos (RAG), CSVs, bancos de dados SQL e APIs externas |
 | **Orquestração de Fluxos** | Handoffs automáticos entre agentes conforme a complexidade da demanda |
+| **Tom e Estilo Customizáveis** | AgentStyle para personalizar linguagem, tom e formato de respostas |
 | **Escalonamento Controlado** | Transferência para atendimento humano com contexto preservado |
 | **Gestão de Feedbacks** | Sistema de tickets para reclamações, sugestões e acompanhamento |
 | **Configuração Declarativa** | Personalização completa via arquivos YAML |
@@ -34,6 +35,7 @@ Plataforma que unifica múltiplos agentes especializados para resolver demandas
 - [Escalation Agent](#-escalation-agent)
 - [Feedback Agent](#-feedback-agent)
 - [Fluxo de Handoffs](#-fluxo-de-handoffs)
+- [Estilo de Comunicação](#-estilo-de-comunicação-agentstyle)
 - [Tracing e Monitoramento](#-tracing-e-monitoramento)
 - [Suporte](#-suporte)
 
@@ -220,6 +222,7 @@ meu_cliente/
 ├── escalation_config.yaml   # Recomendado
 ├── feedback_config.yaml     # Recomendado
 ├── guardrails_config.yaml   # Recomendado
+├── style_config.yaml        # Opcional - Tom e estilo
 └── data/                    # Dados estruturados (CSV, etc.)
 ```
 
@@ -538,6 +541,87 @@ network = create_standard_network(
 
 ---
 
+## 🎨 Estilo de Comunicação (AgentStyle)
+
+Personalize o tom e estilo de resposta dos agentes:
+
+### Via Código
+
+```python
+from pathlib import Path
+from atendentepro import create_standard_network, AgentStyle
+
+# Estilo global (aplicado a todos os agentes)
+global_style = AgentStyle(
+    tone="profissional e consultivo",
+    language_style="formal",      # formal, informal, neutro
+    response_length="moderado",   # conciso, moderado, detalhado
+    custom_rules="Sempre cumprimente o usuário pelo nome.",
+)
+
+# Estilos específicos por agente
+network = create_standard_network(
+    templates_root=Path("./meu_cliente"),
+    client="config",
+    global_style=global_style,
+    agent_styles={
+        "escalation": AgentStyle(
+            tone="empático e acolhedor",
+            custom_rules="Demonstre compreensão pela situação.",
+        ),
+        "knowledge": AgentStyle(
+            tone="didático e paciente",
+            response_length="detalhado",
+        ),
+    },
+)
+```
+
+### Via YAML (style_config.yaml)
+
+```yaml
+# Estilo Global
+global:
+  tone: "profissional e cordial"
+  language_style: "formal"
+  response_length: "moderado"
+  custom_rules: |
+    - Seja objetivo e claro nas respostas
+    - Use linguagem inclusiva
+
+# Estilos por Agente
+agents:
+  escalation:
+    tone: "empático e tranquilizador"
+    custom_rules: |
+      - Demonstre compreensão pela situação
+      - Assegure que o problema será resolvido
+
+  knowledge:
+    tone: "didático e paciente"
+    response_length: "detalhado"
+    custom_rules: |
+      - Explique conceitos de forma acessível
+      - Cite as fontes das informações
+
+  feedback:
+    tone: "solícito e atencioso"
+    custom_rules: |
+      - Agradeça o feedback recebido
+      - Confirme o registro da solicitação
+```
+
+### Opções Disponíveis
+
+| Parâmetro | Valores | Descrição |
+|-----------|---------|-----------|
+| `tone` | Texto livre | Tom da conversa (ex: "profissional", "empático") |
+| `language_style` | `formal`, `informal`, `neutro` | Nível de formalidade |
+| `response_length` | `conciso`, `moderado`, `detalhado` | Tamanho das respostas |
+| `custom_rules` | Texto livre | Regras personalizadas |
+
+---
+
 ## 🔧 Dependências
 
 - Python 3.9+
@@ -651,7 +735,17 @@ configure_application_insights(
 
 ## 📝 Changelog
 
-### v0.5.9 (Atual)
+### v0.6.1 (Atual)
+- Documentação PyPI atualizada com AgentStyle e changelog completo
+
+### v0.6.0
+- **AgentStyle**: Nova classe para personalizar tom e estilo de comunicação
+  - `tone`, `language_style`, `response_length`, `custom_rules`
+- `style_config.yaml`: Configuração de estilos via YAML
+- Parâmetros `global_style` e `agent_styles` em `create_standard_network()`
+- Todos os agentes aceitam `style_instructions`
+
+### v0.5.9
 - Descrição PyPI formal: "Framework de orquestração de agentes IA"
 - README profissional com foco em capacidades corporativas
 

{atendentepro-0.6.0 → atendentepro-0.6.1}/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "atendentepro"
-version = "0.6.0"
-description = "Framework de orquestração de agentes IA para resolver interações complexas integrando múltiplas fontes de dados (documentos, APIs, bancos) em uma única plataforma inteligente."
+version = "0.6.1"
+description = "Framework de orquestração de agentes IA com tom e estilo customizáveis. Integra documentos (RAG), APIs e bancos de dados em uma plataforma inteligente multi-agente."
 authors = [
     { name = "BeMonkAI", email = "contato@monkai.com.br" }
 ]