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

atendentepro/README.md

@@ -1191,7 +1191,81 @@ flowchart LR
     FEED --> |Protocolo TKT| EMAIL[Email + Ticket]
 ```
 
-### Passo 11: Criar Rede Específica (Opcional)
+### Passo 11: Configurar Estilo de Comunicação (Opcional - style_config.yaml)
+
+O **AgentStyle** permite personalizar o tom e estilo de comunicação dos agentes.
+
+#### Configuração YAML
+
+```yaml
+# style_config.yaml
+
+# Estilo Global (aplicado a todos os agentes por padrão)
+global:
+  tone: "profissional e cordial"
+  language_style: "formal"  # formal, informal, neutro
+  response_length: "moderado"  # conciso, moderado, detalhado
+  custom_rules: |
+    - Seja objetivo e claro nas respostas
+    - Use linguagem inclusiva
+
+# Estilos específicos por agente (sobrescrevem o global)
+agents:
+  escalation:
+    tone: "empático e tranquilizador"
+    custom_rules: |
+      - Demonstre compreensão pela situação do usuário
+      - 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
+```
+
+#### Uso Programático com AgentStyle
+
+```python
+from pathlib import Path
+from atendentepro import create_standard_network, AgentStyle
+
+# Estilo global formal
+global_style = AgentStyle(
+    tone="profissional e consultivo",
+    language_style="formal",
+    response_length="moderado",
+    custom_rules="Sempre se apresente como assistente da empresa.",
+)
+
+# Estilo específico para escalation (mais empático)
+escalation_style = AgentStyle(
+    tone="empático e acolhedor",
+    custom_rules="Demonstre compreensão e assegure resolução.",
+)
+
+network = create_standard_network(
+    templates_root=Path("./client_templates"),
+    client="meu_cliente",
+    global_style=global_style,
+    agent_styles={
+        "escalation": escalation_style,
+        "feedback": AgentStyle(tone="solícito", custom_rules="Agradeça o feedback."),
+    },
+)
+```
+
+#### 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 adicionais personalizadas |
+
+### Passo 12: Criar Rede Específica (Opcional)
 
 Se precisar de lógica customizada:
 
@@ -1285,6 +1359,7 @@ client_templates/meu_cliente/
 ├── escalation_config.yaml     # ✅ Recomendado - Transferência humana
 ├── feedback_config.yaml       # ✅ Recomendado - Tickets/SAC
 ├── guardrails_config.yaml     # ✅ Recomendado - Políticas de segurança
+├── style_config.yaml          # Opcional - Tom e estilo de comunicação
 │
 │   # Dados (opcionais)
 ├── data/                      # Dados estruturados
@@ -1310,6 +1385,7 @@ client_templates/meu_cliente/
 | `escalation_config.yaml` | Escalation | Recomendado | Canais e triggers |
 | `feedback_config.yaml` | Feedback | Recomendado | Tipos ticket e email |
 | `guardrails_config.yaml` | Todos | Recomendado | Escopo e restrições |
+| `style_config.yaml` | Todos | Opcional | Tom e estilo de comunicação |
 
 ---
 

atendentepro/__init__.py

@@ -113,6 +113,7 @@ from atendentepro.agents import (
 # Network
 from atendentepro.network import (
     AgentNetwork,
+    AgentStyle,
     create_standard_network,
     create_custom_network,
 )
@@ -211,6 +212,7 @@ __all__ = [
     "configure_feedback_storage",
     # Network
     "AgentNetwork",
+    "AgentStyle",
     "create_standard_network",
     "create_custom_network",
     # Templates

atendentepro/agents/answer.py

@@ -25,6 +25,7 @@ def create_answer_agent(
     guardrails: Optional[List["GuardrailCallable"]] = None,
     name: str = "Answer Agent",
     custom_instructions: Optional[str] = None,
+    style_instructions: str = "",
 ) -> AnswerAgent:
     """
     Create an Answer Agent instance.
@@ -38,6 +39,7 @@ def create_answer_agent(
         guardrails: List of input guardrails.
         name: Agent name.
         custom_instructions: Optional custom instructions to override default.
+        style_instructions: Optional style/tone instructions to append.
         
     Returns:
         Configured Answer Agent instance.
@@ -48,6 +50,10 @@ def create_answer_agent(
         prompt = get_answer_prompt(answer_template=answer_template)
         instructions = f"{RECOMMENDED_PROMPT_PREFIX} {prompt}"
     
+    # Append style instructions if provided
+    if style_instructions:
+        instructions += style_instructions
+    
     return Agent[ContextNote](
         name=name,
         handoff_description=(

atendentepro/agents/confirmation.py

@@ -27,6 +27,7 @@ def create_confirmation_agent(
     guardrails: Optional[List["GuardrailCallable"]] = None,
     name: str = "Confirmation Agent",
     custom_instructions: Optional[str] = None,
+    style_instructions: str = "",
 ) -> ConfirmationAgent:
     """
     Create a Confirmation Agent instance.
@@ -42,6 +43,7 @@ def create_confirmation_agent(
         guardrails: List of input guardrails.
         name: Agent name.
         custom_instructions: Optional custom instructions to override default.
+        style_instructions: Optional style/tone instructions to append.
         
     Returns:
         Configured Confirmation Agent instance.
@@ -56,6 +58,10 @@ def create_confirmation_agent(
         )
         instructions = f"{RECOMMENDED_PROMPT_PREFIX} {prompt}"
     
+    # Append style instructions if provided
+    if style_instructions:
+        instructions += style_instructions
+    
     return Agent[ContextNote](
         name=name,
         handoff_description=(

atendentepro/agents/escalation.py

@@ -454,6 +454,7 @@ def create_escalation_agent(
     guardrails: Optional[List["GuardrailCallable"]] = None,
     name: str = "Escalation Agent",
     custom_instructions: Optional[str] = None,
+    style_instructions: str = "",
 ) -> EscalationAgent:
     """
     Create an Escalation Agent instance.
@@ -475,6 +476,7 @@ def create_escalation_agent(
         guardrails: List of input guardrails.
         name: Agent name.
         custom_instructions: Optional custom instructions to override default.
+        style_instructions: Optional style/tone instructions to append.
         
     Returns:
         Configured Escalation Agent instance.
@@ -494,6 +496,10 @@ def create_escalation_agent(
         # Usar o prompt builder do módulo prompts
         instructions = f"{RECOMMENDED_PROMPT_PREFIX}\n{get_escalation_prompt(escalation_triggers=escalation_triggers, escalation_channels=escalation_channels)}"
     
+    # Append style instructions if provided
+    if style_instructions:
+        instructions += style_instructions
+    
     # Combinar tools padrão com customizadas
     agent_tools = list(ESCALATION_TOOLS)
     if tools:

atendentepro/agents/feedback.py

@@ -894,6 +894,7 @@ def create_feedback_agent(
     guardrails: Optional[List["GuardrailCallable"]] = None,
     name: str = "Feedback Agent",
     custom_instructions: Optional[str] = None,
+    style_instructions: str = "",
 ) -> FeedbackAgent:
     """
     Create a Feedback Agent for collecting user feedback, questions, and complaints.
@@ -919,6 +920,7 @@ def create_feedback_agent(
         guardrails: List of input guardrails.
         name: Agent name.
         custom_instructions: Override default instructions.
+        style_instructions: Optional style/tone instructions to append.
         
     Returns:
         Configured Feedback Agent instance.
@@ -945,6 +947,10 @@ def create_feedback_agent(
         # Usar o prompt builder do módulo prompts
         instructions = f"{RECOMMENDED_PROMPT_PREFIX}\n{get_feedback_prompt(ticket_types=ticket_types, protocol_prefix=protocol_prefix, brand_name=email_brand_name, sla_message=email_sla_message)}"
     
+    # Append style instructions if provided
+    if style_instructions:
+        instructions += style_instructions
+    
     # Combine tools
     agent_tools = list(FEEDBACK_TOOLS)
     if tools:

atendentepro/agents/flow.py

@@ -26,6 +26,7 @@ def create_flow_agent(
     guardrails: Optional[List["GuardrailCallable"]] = None,
     name: str = "Flow Agent",
     custom_instructions: Optional[str] = None,
+    style_instructions: str = "",
 ) -> FlowAgent:
     """
     Create a Flow Agent instance.
@@ -39,6 +40,7 @@ def create_flow_agent(
         guardrails: List of input guardrails.
         name: Agent name.
         custom_instructions: Optional custom instructions to override default.
+        style_instructions: Optional style/tone instructions to append.
         
     Returns:
         Configured Flow Agent instance.
@@ -49,6 +51,10 @@ def create_flow_agent(
         prompt = get_flow_prompt(flow_template=flow_template, flow_keywords=flow_keywords)
         instructions = f"{RECOMMENDED_PROMPT_PREFIX} {prompt}"
     
+    # Append style instructions if provided
+    if style_instructions:
+        instructions += style_instructions
+    
     return Agent[ContextNote](
         name=name,
         handoff_description="""

atendentepro/agents/interview.py

@@ -27,6 +27,7 @@ def create_interview_agent(
     guardrails: Optional[List["GuardrailCallable"]] = None,
     name: str = "Interview Agent",
     custom_instructions: Optional[str] = None,
+    style_instructions: str = "",
 ) -> InterviewAgent:
     """
     Create an Interview Agent instance.
@@ -42,6 +43,7 @@ def create_interview_agent(
         guardrails: List of input guardrails.
         name: Agent name.
         custom_instructions: Optional custom instructions to override default.
+        style_instructions: Optional style/tone instructions to append.
         
     Returns:
         Configured Interview Agent instance.
@@ -55,6 +57,10 @@ def create_interview_agent(
         )
         instructions = f"{RECOMMENDED_PROMPT_PREFIX} {prompt}"
     
+    # Append style instructions if provided
+    if style_instructions:
+        instructions += style_instructions
+    
     return Agent[ContextNote](
         name=name,
         handoff_description="""

atendentepro/agents/knowledge.py

@@ -217,6 +217,7 @@ def create_knowledge_agent(
     guardrails: Optional[List["GuardrailCallable"]] = None,
     name: str = "Knowledge Agent",
     custom_instructions: Optional[str] = None,
+    style_instructions: str = "",
 ) -> KnowledgeAgent:
     """
     Create a Knowledge Agent instance.
@@ -239,6 +240,7 @@ def create_knowledge_agent(
         guardrails: List of input guardrails.
         name: Agent name.
         custom_instructions: Optional custom instructions to override default.
+        style_instructions: Optional style/tone instructions to append.
         
     Returns:
         Configured Knowledge Agent instance.
@@ -262,6 +264,10 @@ def create_knowledge_agent(
         )
         instructions = f"{RECOMMENDED_PROMPT_PREFIX} {prompt}"
     
+    # Append style instructions if provided
+    if style_instructions:
+        instructions += style_instructions
+    
     # Build tools list
     agent_tools: List = []
     

atendentepro/agents/onboarding.py

@@ -27,6 +27,7 @@ def create_onboarding_agent(
     guardrails: Optional[List["GuardrailCallable"]] = None,
     name: str = "Onboarding Agent",
     custom_instructions: Optional[str] = None,
+    style_instructions: str = "",
 ) -> OnboardingAgent:
     """
     Create an Onboarding Agent instance.
@@ -41,6 +42,7 @@ def create_onboarding_agent(
         guardrails: List of input guardrails.
         name: Agent name.
         custom_instructions: Optional custom instructions to override default.
+        style_instructions: Optional style/tone instructions to append.
         
     Returns:
         Configured Onboarding Agent instance.
@@ -51,6 +53,10 @@ def create_onboarding_agent(
         prompt = get_onboarding_prompt(required_fields=required_fields)
         instructions = f"{RECOMMENDED_PROMPT_PREFIX} {prompt}"
     
+    # Append style instructions if provided
+    if style_instructions:
+        instructions += style_instructions
+    
     return Agent[ContextNote](
         name=name,
         handoff_description=(

atendentepro/agents/triage.py

@@ -25,6 +25,7 @@ def create_triage_agent(
     guardrails: Optional[List["GuardrailCallable"]] = None,
     name: str = "Triage Agent",
     custom_instructions: Optional[str] = None,
+    style_instructions: str = "",
 ) -> TriageAgent:
     """
     Create a Triage Agent instance.
@@ -38,6 +39,7 @@ def create_triage_agent(
         guardrails: List of input guardrails.
         name: Agent name.
         custom_instructions: Optional custom instructions to override default.
+        style_instructions: Optional style/tone instructions to append.
         
     Returns:
         Configured Triage Agent instance.
@@ -47,6 +49,10 @@ def create_triage_agent(
     else:
         instructions = f"{RECOMMENDED_PROMPT_PREFIX} {get_triage_prompt(keywords_text)}"
     
+    # Append style instructions if provided
+    if style_instructions:
+        instructions += style_instructions
+    
     return Agent[ContextNote](
         name=name,
         handoff_description="A triage agent that can delegate a customer's request to the appropriate agent.",

atendentepro/agents/usage.py

@@ -29,6 +29,7 @@ def create_usage_agent(
     guardrails: Optional[List["GuardrailCallable"]] = None,
     name: str = "Usage Agent",
     custom_instructions: Optional[str] = None,
+    style_instructions: str = "",
 ) -> UsageAgent:
     """
     Create a Usage Agent instance.
@@ -40,12 +41,17 @@ def create_usage_agent(
         guardrails: List of input guardrails.
         name: Agent name.
         custom_instructions: Optional custom instructions to override default.
+        style_instructions: Optional style/tone instructions to append.
         
     Returns:
         Configured Usage Agent instance.
     """
     instructions = custom_instructions or DEFAULT_USAGE_INSTRUCTIONS
     
+    # Append style instructions if provided
+    if style_instructions:
+        instructions += style_instructions
+    
     return Agent[ContextNote](
         name=name,
         handoff_description="A usage agent that can answer questions about the usage of the system.",

atendentepro/network.py

@@ -11,6 +11,84 @@ from dataclasses import dataclass, field
 from pathlib import Path
 from typing import Any, Callable, Dict, List, Literal, Optional
 
+
+# =============================================================================
+# Agent Style Configuration
+# =============================================================================
+
+@dataclass
+class AgentStyle:
+    """
+    Configuration for agent conversation style and tone.
+    
+    Allows customizing how agents communicate with users,
+    including tone, language style, response length, and custom rules.
+    
+    Attributes:
+        tone: Conversation tone (e.g., "profissional", "empático", "consultivo")
+        language_style: Language formality ("formal", "informal", "neutro")
+        response_length: Response verbosity ("conciso", "moderado", "detalhado")
+        custom_rules: Additional custom rules as text
+        
+    Example:
+        >>> style = AgentStyle(
+        ...     tone="empático e acolhedor",
+        ...     language_style="formal",
+        ...     response_length="moderado",
+        ...     custom_rules="Sempre se apresente como assistente da empresa."
+        ... )
+        >>> print(style.build_style_prompt())
+    """
+    
+    tone: str = ""
+    language_style: str = ""  # formal, informal, neutro
+    response_length: str = ""  # conciso, moderado, detalhado
+    custom_rules: str = ""
+    
+    def build_style_prompt(self) -> str:
+        """
+        Build style instructions to append to agent prompts.
+        
+        Returns:
+            Formatted style instructions as a string.
+        """
+        parts = []
+        
+        if self.tone:
+            parts.append(f"**Tom de conversa:** {self.tone}.")
+        
+        if self.language_style:
+            style_map = {
+                "formal": "Use linguagem formal e respeitosa, evitando gírias e expressões coloquiais.",
+                "informal": "Use linguagem informal e descontraída, aproximando-se do usuário.",
+                "neutro": "Use linguagem neutra e objetiva, focando na clareza.",
+            }
+            instruction = style_map.get(
+                self.language_style.lower(), 
+                f"Estilo de linguagem: {self.language_style}"
+            )
+            parts.append(f"**Linguagem:** {instruction}")
+        
+        if self.response_length:
+            length_map = {
+                "conciso": "Seja conciso e direto nas respostas, evitando informações desnecessárias.",
+                "moderado": "Forneça respostas com nível médio de detalhe, equilibrando clareza e completude.",
+                "detalhado": "Forneça respostas detalhadas e completas, explicando cada ponto relevante.",
+            }
+            instruction = length_map.get(
+                self.response_length.lower(),
+                f"Tamanho das respostas: {self.response_length}"
+            )
+            parts.append(f"**Respostas:** {instruction}")
+        
+        if self.custom_rules:
+            parts.append(f"**Regras adicionais:**\n{self.custom_rules}")
+        
+        if not parts:
+            return ""
+        
+        return "\n\n## Estilo de Comunicação\n" + "\n\n".join(parts)
+
 from atendentepro.agents import (
     create_triage_agent,
     create_flow_agent,
@@ -118,6 +196,9 @@ def create_standard_network(
     feedback_brand_color: str = "#4A90D9",
     feedback_brand_name: str = "Atendimento",
     custom_tools: Optional[Dict[str, List]] = None,
+    # Style configuration
+    global_style: Optional[AgentStyle] = None,
+    agent_styles: Optional[Dict[str, AgentStyle]] = None,
 ) -> AgentNetwork:
     """
     Create a standard agent network with proper handoff configuration.
@@ -153,6 +234,8 @@ def create_standard_network(
         feedback_brand_color: Brand color for feedback emails.
         feedback_brand_name: Brand name for feedback emails.
         custom_tools: Optional dict of custom tools by agent name.
+        global_style: Style configuration applied to all agents (tone, language, etc.).
+        agent_styles: Dict mapping agent names to specific styles (overrides global).
         
     Returns:
         Configured AgentNetwork instance.
@@ -178,6 +261,23 @@ def create_standard_network(
             include_escalation=False,
             include_feedback=False,
         )
+        
+        # Create network with custom communication style
+        network = create_standard_network(
+            templates_root=Path("templates"),
+            client="my_client",
+            global_style=AgentStyle(
+                tone="profissional e consultivo",
+                language_style="formal",
+                response_length="moderado",
+            ),
+            agent_styles={
+                "escalation": AgentStyle(
+                    tone="empático e acolhedor",
+                    custom_rules="Demonstre compreensão pela situação.",
+                ),
+            },
+        )
     """
     # Verificar licença
     require_activation()
@@ -245,11 +345,23 @@ def create_standard_network(
     # Get custom tools
     tools = custom_tools or {}
     
+    # Style helper function
+    def get_style_for_agent(agent_name: str) -> str:
+        """Get style instructions for a specific agent."""
+        # Agent-specific style takes precedence
+        if agent_styles and agent_name in agent_styles:
+            return agent_styles[agent_name].build_style_prompt()
+        # Fall back to global style
+        if global_style:
+            return global_style.build_style_prompt()
+        return ""
+    
     # Create agents without handoffs first
     # Triage is always created (entry point)
     triage = create_triage_agent(
         keywords_text=triage_keywords,
         guardrails=get_guardrails_for_agent("Triage Agent", templates_root),
+        style_instructions=get_style_for_agent("triage"),
     )
     
     # Create optional agents based on include flags
@@ -259,6 +371,7 @@ def create_standard_network(
             flow_template=flow_template,
             flow_keywords=flow_keywords,
             guardrails=get_guardrails_for_agent("Flow Agent", templates_root),
+            style_instructions=get_style_for_agent("flow"),
         )
     
     interview = None
@@ -268,6 +381,7 @@ def create_standard_network(
             interview_questions=interview_questions,
             tools=tools.get("interview", []),
             guardrails=get_guardrails_for_agent("Interview Agent", templates_root),
+            style_instructions=get_style_for_agent("interview"),
         )
     
     answer = None
@@ -275,6 +389,7 @@ def create_standard_network(
         answer = create_answer_agent(
             answer_template="",
             guardrails=get_guardrails_for_agent("Answer Agent", templates_root),
+            style_instructions=get_style_for_agent("answer"),
         )
     
     knowledge = None
@@ -288,6 +403,7 @@ def create_standard_network(
             include_rag_tool=has_embeddings,
             tools=tools.get("knowledge", []),
             guardrails=get_guardrails_for_agent("Knowledge Agent", templates_root),
+            style_instructions=get_style_for_agent("knowledge"),
         )
     
     confirmation = None
@@ -297,12 +413,14 @@ def create_standard_network(
             confirmation_template=confirmation_template,
             confirmation_format=confirmation_format,
             guardrails=get_guardrails_for_agent("Confirmation Agent", templates_root),
+            style_instructions=get_style_for_agent("confirmation"),
         )
     
     usage = None
     if include_usage:
         usage = create_usage_agent(
             guardrails=get_guardrails_for_agent("Usage Agent", templates_root),
+            style_instructions=get_style_for_agent("usage"),
         )
     
     # Create escalation agent if requested
@@ -312,6 +430,7 @@ def create_standard_network(
             escalation_channels=escalation_channels,
             tools=tools.get("escalation", []),
             guardrails=get_guardrails_for_agent("Escalation Agent", templates_root),
+            style_instructions=get_style_for_agent("escalation"),
         )
     
     # Create feedback agent if requested
@@ -323,6 +442,7 @@ def create_standard_network(
             email_brand_name=feedback_brand_name,
             tools=tools.get("feedback", []),
             guardrails=get_guardrails_for_agent("Feedback Agent", templates_root),
+            style_instructions=get_style_for_agent("feedback"),
         )
     
     # Configure handoffs dynamically based on which agents are included
@@ -433,6 +553,7 @@ def create_standard_network(
             required_fields=fields,
             tools=tools.get("onboarding", []),
             guardrails=get_guardrails_for_agent("Onboarding Agent", templates_root),
+            style_instructions=get_style_for_agent("onboarding"),
         )
         
         network.onboarding = onboarding

atendentepro/templates/__init__.py

@@ -14,12 +14,15 @@ from .manager import (
     load_knowledge_config,
     load_confirmation_config,
     load_onboarding_config,
+    load_style_config,
     FlowConfig,
     InterviewConfig,
     TriageConfig,
     KnowledgeConfig,
     ConfirmationConfig,
     OnboardingConfig,
+    StyleConfig,
+    AgentStyleConfig,
     DataSourceConfig,
     DataSourceColumn,
     DocumentConfig,
@@ -38,12 +41,15 @@ __all__ = [
     "load_knowledge_config",
     "load_confirmation_config",
     "load_onboarding_config",
+    "load_style_config",
     "FlowConfig",
     "InterviewConfig",
     "TriageConfig",
     "KnowledgeConfig",
     "ConfirmationConfig",
     "OnboardingConfig",
+    "StyleConfig",
+    "AgentStyleConfig",
     "DataSourceConfig",
     "DataSourceColumn",
     "DocumentConfig",

atendentepro/templates/manager.py

@@ -314,6 +314,83 @@ class OnboardingField(BaseModel):
     priority: int = 0
 
 
+class AgentStyleConfig(BaseModel):
+    """Configuration for individual agent style."""
+    
+    tone: str = ""
+    language_style: str = ""  # formal, informal, neutro
+    response_length: str = ""  # conciso, moderado, detalhado
+    custom_rules: str = ""
+
+
+class StyleConfig(BaseModel):
+    """Configuration model for agent communication styles.
+    
+    Allows customizing tone, language, and response style globally
+    or per-agent through YAML configuration.
+    
+    Example YAML:
+        global:
+          tone: "profissional e cordial"
+          language_style: "formal"
+          response_length: "moderado"
+          
+        agents:
+          escalation:
+            tone: "empático e acolhedor"
+            custom_rules: "Demonstre compreensão"
+    """
+    
+    global_style: AgentStyleConfig = Field(default_factory=AgentStyleConfig)
+    agents: Dict[str, AgentStyleConfig] = Field(default_factory=dict)
+    
+    @classmethod
+    @lru_cache(maxsize=4)
+    def load(cls, path: Path) -> "StyleConfig":
+        """Load style configuration from YAML file."""
+        if not path.exists():
+            raise FileNotFoundError(f"Style config not found at {path}")
+        
+        with open(path, "r", encoding="utf-8") as f:
+            data = yaml.safe_load(f) or {}
+        
+        # Parse global style
+        global_data = data.get("global", {})
+        global_style = AgentStyleConfig(
+            tone=global_data.get("tone", ""),
+            language_style=global_data.get("language_style", ""),
+            response_length=global_data.get("response_length", ""),
+            custom_rules=global_data.get("custom_rules", ""),
+        )
+        
+        # Parse agent-specific styles
+        agents = {}
+        for agent_name, agent_data in data.get("agents", {}).items():
+            agents[agent_name] = AgentStyleConfig(
+                tone=agent_data.get("tone", ""),
+                language_style=agent_data.get("language_style", ""),
+                response_length=agent_data.get("response_length", ""),
+                custom_rules=agent_data.get("custom_rules", ""),
+            )
+        
+        return cls(global_style=global_style, agents=agents)
+    
+    def get_style_for_agent(self, agent_name: str) -> AgentStyleConfig:
+        """Get style configuration for a specific agent."""
+        # Agent-specific style takes precedence
+        if agent_name in self.agents:
+            agent_style = self.agents[agent_name]
+            # Merge with global (agent-specific overrides global)
+            return AgentStyleConfig(
+                tone=agent_style.tone or self.global_style.tone,
+                language_style=agent_style.language_style or self.global_style.language_style,
+                response_length=agent_style.response_length or self.global_style.response_length,
+                custom_rules=agent_style.custom_rules or self.global_style.custom_rules,
+            )
+        # Fall back to global
+        return self.global_style
+
+
 class OnboardingConfig(BaseModel):
     """Configuration model for Onboarding Agent."""
     
@@ -432,6 +509,11 @@ class TemplateManager:
         folder = self.get_template_folder(client)
         return OnboardingConfig.load(folder / "onboarding_config.yaml")
     
+    def load_style_config(self, client: Optional[str] = None) -> StyleConfig:
+        """Load style configuration for the specified client."""
+        folder = self.get_template_folder(client)
+        return StyleConfig.load(folder / "style_config.yaml")
+    
     def clear_caches(self) -> None:
         """Clear all configuration caches."""
         FlowConfig.load.cache_clear()
@@ -440,6 +522,7 @@ class TemplateManager:
         KnowledgeConfig.load.cache_clear()
         ConfirmationConfig.load.cache_clear()
         OnboardingConfig.load.cache_clear()
+        StyleConfig.load.cache_clear()
 
 
 def get_template_manager() -> TemplateManager:
@@ -528,3 +611,8 @@ def load_onboarding_config(client: Optional[str] = None) -> OnboardingConfig:
     """Load onboarding configuration for the specified client."""
     return get_template_manager().load_onboarding_config(client)
 
+
+def load_style_config(client: Optional[str] = None) -> StyleConfig:
+    """Load style configuration for the specified client."""
+    return get_template_manager().load_style_config(client)
+

{atendentepro-0.5.9.dist-info → atendentepro-0.6.1.dist-info}/METADATA

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: atendentepro
-Version: 0.5.9
-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.5.9.dist-info → atendentepro-0.6.1.dist-info}/RECORD

@@ -1,18 +1,18 @@
-atendentepro/README.md,sha256=AMVMJlVOlXcwU_kRGBiIoSn8hASLHrhZwxV1jr1LJsU,43012
-atendentepro/__init__.py,sha256=A7ANs1G18HZEhl-C_OVVdOzM0KCRDo-sX1Veq4IYwDo,5572
+atendentepro/README.md,sha256=TAXl5GRjhSwz_I-Dx_eN5JOIcUxuE_dz31iMZ_-OnRY,45390
+atendentepro/__init__.py,sha256=CDK61bxE18NYvLeswIoQWLarw2_xJAOEb2yONsQ2CqQ,5606
 atendentepro/license.py,sha256=rlPtysXNqAzEQkP2VjUAVu_nMndhPgfKv1yN2ruUYVI,17570
-atendentepro/network.py,sha256=s7h9if2oS_15BL8VoONjMlihEFCkJqdHxR5WFL81gl4,17310
+atendentepro/network.py,sha256=1grEjYDZQ7K6r-eQ1tMV3g1vBAdkiNn0v1EeraqTK18,22341
 atendentepro/agents/__init__.py,sha256=OcPhG1Dp6xe49B5YIti4HVmaZDoDIrFLfRa8GmI4jpQ,1638
-atendentepro/agents/answer.py,sha256=dIZzGL_ddjC96JIiWSwDg33phwca8NpWFxO16FFYVoA,1905
-atendentepro/agents/confirmation.py,sha256=5Zg4z9A90CydYiEk8CEAKnnza71algFKF-N1WLwGDQI,2311
-atendentepro/agents/escalation.py,sha256=YNA2e1Si30FJoIJkpos3B9imaR_Q6uv9K2o-F-Ht8rQ,17190
-atendentepro/agents/feedback.py,sha256=xTFANEkFQaYIYQxlD6_hxTGAxfGUVwTM-rnfN0gT78Y,32996
-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/agents/answer.py,sha256=Bwxhpeqp7bbiqHN3hfLwuF7wCekd0H2CI4H0UKMTDAY,2130
+atendentepro/agents/confirmation.py,sha256=EB1vb_qBeZu9r0WKTe98kBHfdiuBzVaRUZmDpUIc7sc,2536
+atendentepro/agents/escalation.py,sha256=ukFRNs0ISUug29IN2_wzIKUF_YKw5CCyGzkITtfdLx0,17415
+atendentepro/agents/feedback.py,sha256=7afcdXmW6NfVKJcmZPWbRwD5yPOVOWbvVdqh0LaYfyE,33221
+atendentepro/agents/flow.py,sha256=MLcumyoFFXqhkwu9lIURLJx_sSz-MZvwUdXRGW_PyXo,2281
+atendentepro/agents/interview.py,sha256=vFYCEvtCoCwX7vMVaN5acXO6xKzuBA12jxrqA1SE6n8,2358
+atendentepro/agents/knowledge.py,sha256=Lui1ZVC4AYOvzfm4G4vJZtaRNsXBTVlgfOSchBXryVE,10305
+atendentepro/agents/onboarding.py,sha256=f7ezfZdL3o0o4mLoTpDLFoxUNeEcCKl80qQsxL7t7JI,2323
+atendentepro/agents/triage.py,sha256=pdYCA5AqbGMY0WoJXvdceAz_gnQ7D_fJp7dxxsD-GDg,1958
+atendentepro/agents/usage.py,sha256=wdxX7ZJVO6RGkuAY7JIgTfUQHid-q9U5ohLmvIg399c,1819
 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
@@ -30,14 +30,14 @@ atendentepro/prompts/interview.py,sha256=9zVGA8zSmm6pBx2i1LPGNJIPuLlz7PZKRJE_PC6
 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/templates/__init__.py,sha256=GbtNnhf2Zz-JiNReq-bBLzTdMZ-JFItmPU0OjnlU640,1267
+atendentepro/templates/manager.py,sha256=kEeVRc1GHW5W8Q3GHgn6iBEvyzyO-GcEIKTBorYaHXw,21405
 atendentepro/utils/__init__.py,sha256=WCJ6_btsLaI6xxHXvNHNue-nKrXWTKscNZGTToQiJ8A,833
 atendentepro/utils/openai_client.py,sha256=R0ns7SU36vTgploq14-QJMTke1pPxcAXlENDeoHU0L4,4552
 atendentepro/utils/tracing.py,sha256=kpTPw1PF4rR1qq1RyBnAaPIQIJRka4RF8MfG_JrRJ7U,8486
-atendentepro-0.5.9.dist-info/licenses/LICENSE,sha256=TF6CdXxePoT9DXtPnCejiU5mUwWzrFzd1iyWJyoMauA,983
-atendentepro-0.5.9.dist-info/METADATA,sha256=bLx0WiUGtJ7p8rb095fRgp5N5txnwucdGsoQmHBxicY,22701
-atendentepro-0.5.9.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-atendentepro-0.5.9.dist-info/entry_points.txt,sha256=OP0upzqJF3MLS6VX-M-5BfUwx5YLJO2sJ3YBAp4e6yI,89
-atendentepro-0.5.9.dist-info/top_level.txt,sha256=BFasD4SMmgDUmWKlTIZ1PeuukoRBhyiMIz8umKWVCcs,13
-atendentepro-0.5.9.dist-info/RECORD,,
+atendentepro-0.6.1.dist-info/licenses/LICENSE,sha256=TF6CdXxePoT9DXtPnCejiU5mUwWzrFzd1iyWJyoMauA,983
+atendentepro-0.6.1.dist-info/METADATA,sha256=xj9aGwN2-ErdDl02rgnKe-QWKFm5W2y_8ptfIs4xi7I,25518
+atendentepro-0.6.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+atendentepro-0.6.1.dist-info/entry_points.txt,sha256=OP0upzqJF3MLS6VX-M-5BfUwx5YLJO2sJ3YBAp4e6yI,89
+atendentepro-0.6.1.dist-info/top_level.txt,sha256=BFasD4SMmgDUmWKlTIZ1PeuukoRBhyiMIz8umKWVCcs,13
+atendentepro-0.6.1.dist-info/RECORD,,