atendentepro 0.6.0__py3-none-any.whl → 0.6.1__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,7 +1,7 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: atendentepro
3
- Version: 0.6.0
4
- 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.
3
+ Version: 0.6.1
4
+ 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.
5
5
  Author-email: BeMonkAI <contato@monkai.com.br>
6
6
  Maintainer-email: BeMonkAI <contato@monkai.com.br>
7
7
  License: Proprietary
@@ -73,6 +73,7 @@ Plataforma que unifica múltiplos agentes especializados para resolver demandas
73
73
  | **Classificação Inteligente** | Identifica a intenção e direciona para o agente especializado |
74
74
  | **Integração de Dados** | Conecta documentos (RAG), CSVs, bancos de dados SQL e APIs externas |
75
75
  | **Orquestração de Fluxos** | Handoffs automáticos entre agentes conforme a complexidade da demanda |
76
+ | **Tom e Estilo Customizáveis** | AgentStyle para personalizar linguagem, tom e formato de respostas |
76
77
  | **Escalonamento Controlado** | Transferência para atendimento humano com contexto preservado |
77
78
  | **Gestão de Feedbacks** | Sistema de tickets para reclamações, sugestões e acompanhamento |
78
79
  | **Configuração Declarativa** | Personalização completa via arquivos YAML |
@@ -92,6 +93,7 @@ Plataforma que unifica múltiplos agentes especializados para resolver demandas
92
93
  - [Escalation Agent](#-escalation-agent)
93
94
  - [Feedback Agent](#-feedback-agent)
94
95
  - [Fluxo de Handoffs](#-fluxo-de-handoffs)
96
+ - [Estilo de Comunicação](#-estilo-de-comunicação-agentstyle)
95
97
  - [Tracing e Monitoramento](#-tracing-e-monitoramento)
96
98
  - [Suporte](#-suporte)
97
99
 
@@ -278,6 +280,7 @@ meu_cliente/
278
280
  ├── escalation_config.yaml # Recomendado
279
281
  ├── feedback_config.yaml # Recomendado
280
282
  ├── guardrails_config.yaml # Recomendado
283
+ ├── style_config.yaml # Opcional - Tom e estilo
281
284
  └── data/ # Dados estruturados (CSV, etc.)
282
285
  ```
283
286
 
@@ -596,6 +599,87 @@ network = create_standard_network(
596
599
 
597
600
  ---
598
601
 
602
+ ## 🎨 Estilo de Comunicação (AgentStyle)
603
+
604
+ Personalize o tom e estilo de resposta dos agentes:
605
+
606
+ ### Via Código
607
+
608
+ ```python
609
+ from pathlib import Path
610
+ from atendentepro import create_standard_network, AgentStyle
611
+
612
+ # Estilo global (aplicado a todos os agentes)
613
+ global_style = AgentStyle(
614
+ tone="profissional e consultivo",
615
+ language_style="formal", # formal, informal, neutro
616
+ response_length="moderado", # conciso, moderado, detalhado
617
+ custom_rules="Sempre cumprimente o usuário pelo nome.",
618
+ )
619
+
620
+ # Estilos específicos por agente
621
+ network = create_standard_network(
622
+ templates_root=Path("./meu_cliente"),
623
+ client="config",
624
+ global_style=global_style,
625
+ agent_styles={
626
+ "escalation": AgentStyle(
627
+ tone="empático e acolhedor",
628
+ custom_rules="Demonstre compreensão pela situação.",
629
+ ),
630
+ "knowledge": AgentStyle(
631
+ tone="didático e paciente",
632
+ response_length="detalhado",
633
+ ),
634
+ },
635
+ )
636
+ ```
637
+
638
+ ### Via YAML (style_config.yaml)
639
+
640
+ ```yaml
641
+ # Estilo Global
642
+ global:
643
+ tone: "profissional e cordial"
644
+ language_style: "formal"
645
+ response_length: "moderado"
646
+ custom_rules: |
647
+ - Seja objetivo e claro nas respostas
648
+ - Use linguagem inclusiva
649
+
650
+ # Estilos por Agente
651
+ agents:
652
+ escalation:
653
+ tone: "empático e tranquilizador"
654
+ custom_rules: |
655
+ - Demonstre compreensão pela situação
656
+ - Assegure que o problema será resolvido
657
+
658
+ knowledge:
659
+ tone: "didático e paciente"
660
+ response_length: "detalhado"
661
+ custom_rules: |
662
+ - Explique conceitos de forma acessível
663
+ - Cite as fontes das informações
664
+
665
+ feedback:
666
+ tone: "solícito e atencioso"
667
+ custom_rules: |
668
+ - Agradeça o feedback recebido
669
+ - Confirme o registro da solicitação
670
+ ```
671
+
672
+ ### Opções Disponíveis
673
+
674
+ | Parâmetro | Valores | Descrição |
675
+ |-----------|---------|-----------|
676
+ | `tone` | Texto livre | Tom da conversa (ex: "profissional", "empático") |
677
+ | `language_style` | `formal`, `informal`, `neutro` | Nível de formalidade |
678
+ | `response_length` | `conciso`, `moderado`, `detalhado` | Tamanho das respostas |
679
+ | `custom_rules` | Texto livre | Regras personalizadas |
680
+
681
+ ---
682
+
599
683
  ## 🔧 Dependências
600
684
 
601
685
  - Python 3.9+
@@ -709,7 +793,17 @@ configure_application_insights(
709
793
 
710
794
  ## 📝 Changelog
711
795
 
712
- ### v0.5.9 (Atual)
796
+ ### v0.6.1 (Atual)
797
+ - Documentação PyPI atualizada com AgentStyle e changelog completo
798
+
799
+ ### v0.6.0
800
+ - **AgentStyle**: Nova classe para personalizar tom e estilo de comunicação
801
+ - `tone`, `language_style`, `response_length`, `custom_rules`
802
+ - `style_config.yaml`: Configuração de estilos via YAML
803
+ - Parâmetros `global_style` e `agent_styles` em `create_standard_network()`
804
+ - Todos os agentes aceitam `style_instructions`
805
+
806
+ ### v0.5.9
713
807
  - Descrição PyPI formal: "Framework de orquestração de agentes IA"
714
808
  - README profissional com foco em capacidades corporativas
715
809
 
@@ -35,9 +35,9 @@ atendentepro/templates/manager.py,sha256=kEeVRc1GHW5W8Q3GHgn6iBEvyzyO-GcEIKTBorY
35
35
  atendentepro/utils/__init__.py,sha256=WCJ6_btsLaI6xxHXvNHNue-nKrXWTKscNZGTToQiJ8A,833
36
36
  atendentepro/utils/openai_client.py,sha256=R0ns7SU36vTgploq14-QJMTke1pPxcAXlENDeoHU0L4,4552
37
37
  atendentepro/utils/tracing.py,sha256=kpTPw1PF4rR1qq1RyBnAaPIQIJRka4RF8MfG_JrRJ7U,8486
38
- atendentepro-0.6.0.dist-info/licenses/LICENSE,sha256=TF6CdXxePoT9DXtPnCejiU5mUwWzrFzd1iyWJyoMauA,983
39
- atendentepro-0.6.0.dist-info/METADATA,sha256=HmvbabP9S-qrSMMZ3p_Yf2RGw07XKpJMHhrb4rNBnMk,22701
40
- atendentepro-0.6.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
41
- atendentepro-0.6.0.dist-info/entry_points.txt,sha256=OP0upzqJF3MLS6VX-M-5BfUwx5YLJO2sJ3YBAp4e6yI,89
42
- atendentepro-0.6.0.dist-info/top_level.txt,sha256=BFasD4SMmgDUmWKlTIZ1PeuukoRBhyiMIz8umKWVCcs,13
43
- atendentepro-0.6.0.dist-info/RECORD,,
38
+ atendentepro-0.6.1.dist-info/licenses/LICENSE,sha256=TF6CdXxePoT9DXtPnCejiU5mUwWzrFzd1iyWJyoMauA,983
39
+ atendentepro-0.6.1.dist-info/METADATA,sha256=xj9aGwN2-ErdDl02rgnKe-QWKFm5W2y_8ptfIs4xi7I,25518
40
+ atendentepro-0.6.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
41
+ atendentepro-0.6.1.dist-info/entry_points.txt,sha256=OP0upzqJF3MLS6VX-M-5BfUwx5YLJO2sJ3YBAp4e6yI,89
42
+ atendentepro-0.6.1.dist-info/top_level.txt,sha256=BFasD4SMmgDUmWKlTIZ1PeuukoRBhyiMIz8umKWVCcs,13
43
+ atendentepro-0.6.1.dist-info/RECORD,,