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

atendentepro/agents/answer.py

@@ -26,6 +26,7 @@ def create_answer_agent(
     name: str = "Answer Agent",
     custom_instructions: Optional[str] = None,
     style_instructions: str = "",
+    single_reply: bool = False,
 ) -> AnswerAgent:
     """
     Create an Answer Agent instance.
@@ -40,6 +41,7 @@ def create_answer_agent(
         name: Agent name.
         custom_instructions: Optional custom instructions to override default.
         style_instructions: Optional style/tone instructions to append.
+        single_reply: If True, agent responds once then transfers to triage.
         
     Returns:
         Configured Answer Agent instance.
@@ -54,6 +56,10 @@ def create_answer_agent(
     if style_instructions:
         instructions += style_instructions
     
+    # Single reply mode: respond once then return to triage
+    if single_reply:
+        instructions += "\n\nIMPORTANTE: Após fornecer sua resposta, transfira IMEDIATAMENTE para o triage_agent. Você só pode dar UMA resposta antes de transferir."
+    
     return Agent[ContextNote](
         name=name,
         handoff_description=(

atendentepro/agents/confirmation.py

@@ -28,6 +28,7 @@ def create_confirmation_agent(
     name: str = "Confirmation Agent",
     custom_instructions: Optional[str] = None,
     style_instructions: str = "",
+    single_reply: bool = False,
 ) -> ConfirmationAgent:
     """
     Create a Confirmation Agent instance.
@@ -44,6 +45,7 @@ def create_confirmation_agent(
         name: Agent name.
         custom_instructions: Optional custom instructions to override default.
         style_instructions: Optional style/tone instructions to append.
+        single_reply: If True, agent responds once then transfers to triage.
         
     Returns:
         Configured Confirmation Agent instance.
@@ -62,6 +64,10 @@ def create_confirmation_agent(
     if style_instructions:
         instructions += style_instructions
     
+    # Single reply mode: respond once then return to triage
+    if single_reply:
+        instructions += "\n\nIMPORTANTE: Após fornecer sua resposta, transfira IMEDIATAMENTE para o triage_agent. Você só pode dar UMA resposta antes de transferir."
+    
     return Agent[ContextNote](
         name=name,
         handoff_description=(

atendentepro/agents/escalation.py

@@ -455,6 +455,7 @@ def create_escalation_agent(
     name: str = "Escalation Agent",
     custom_instructions: Optional[str] = None,
     style_instructions: str = "",
+    single_reply: bool = False,
 ) -> EscalationAgent:
     """
     Create an Escalation Agent instance.
@@ -477,6 +478,7 @@ def create_escalation_agent(
         name: Agent name.
         custom_instructions: Optional custom instructions to override default.
         style_instructions: Optional style/tone instructions to append.
+        single_reply: If True, agent responds once then transfers to triage.
         
     Returns:
         Configured Escalation Agent instance.
@@ -500,6 +502,10 @@ def create_escalation_agent(
     if style_instructions:
         instructions += style_instructions
     
+    # Single reply mode: respond once then return to triage
+    if single_reply:
+        instructions += "\n\nIMPORTANTE: Após fornecer sua resposta, transfira IMEDIATAMENTE para o triage_agent. Você só pode dar UMA resposta antes de transferir."
+    
     # Combinar tools padrão com customizadas
     agent_tools = list(ESCALATION_TOOLS)
     if tools:

atendentepro/agents/feedback.py

@@ -895,6 +895,7 @@ def create_feedback_agent(
     name: str = "Feedback Agent",
     custom_instructions: Optional[str] = None,
     style_instructions: str = "",
+    single_reply: bool = False,
 ) -> FeedbackAgent:
     """
     Create a Feedback Agent for collecting user feedback, questions, and complaints.
@@ -921,6 +922,7 @@ def create_feedback_agent(
         name: Agent name.
         custom_instructions: Override default instructions.
         style_instructions: Optional style/tone instructions to append.
+        single_reply: If True, agent responds once then transfers to triage.
         
     Returns:
         Configured Feedback Agent instance.
@@ -951,6 +953,10 @@ def create_feedback_agent(
     if style_instructions:
         instructions += style_instructions
     
+    # Single reply mode: respond once then return to triage
+    if single_reply:
+        instructions += "\n\nIMPORTANTE: Após fornecer sua resposta, transfira IMEDIATAMENTE para o triage_agent. Você só pode dar UMA resposta antes de transferir."
+    
     # Combine tools
     agent_tools = list(FEEDBACK_TOOLS)
     if tools:

atendentepro/agents/flow.py

@@ -27,6 +27,7 @@ def create_flow_agent(
     name: str = "Flow Agent",
     custom_instructions: Optional[str] = None,
     style_instructions: str = "",
+    single_reply: bool = False,
 ) -> FlowAgent:
     """
     Create a Flow Agent instance.
@@ -41,6 +42,7 @@ def create_flow_agent(
         name: Agent name.
         custom_instructions: Optional custom instructions to override default.
         style_instructions: Optional style/tone instructions to append.
+        single_reply: If True, agent responds once then transfers to triage.
         
     Returns:
         Configured Flow Agent instance.
@@ -55,6 +57,10 @@ def create_flow_agent(
     if style_instructions:
         instructions += style_instructions
     
+    # Single reply mode: respond once then return to triage
+    if single_reply:
+        instructions += "\n\nIMPORTANTE: Após fornecer sua resposta, transfira IMEDIATAMENTE para o triage_agent. Você só pode dar UMA resposta antes de transferir."
+    
     return Agent[ContextNote](
         name=name,
         handoff_description="""

atendentepro/agents/interview.py

@@ -28,6 +28,7 @@ def create_interview_agent(
     name: str = "Interview Agent",
     custom_instructions: Optional[str] = None,
     style_instructions: str = "",
+    single_reply: bool = False,
 ) -> InterviewAgent:
     """
     Create an Interview Agent instance.
@@ -44,6 +45,7 @@ def create_interview_agent(
         name: Agent name.
         custom_instructions: Optional custom instructions to override default.
         style_instructions: Optional style/tone instructions to append.
+        single_reply: If True, agent responds once then transfers to triage.
         
     Returns:
         Configured Interview Agent instance.
@@ -61,6 +63,10 @@ def create_interview_agent(
     if style_instructions:
         instructions += style_instructions
     
+    # Single reply mode: respond once then return to triage
+    if single_reply:
+        instructions += "\n\nIMPORTANTE: Após fornecer sua resposta, transfira IMEDIATAMENTE para o triage_agent. Você só pode dar UMA resposta antes de transferir."
+    
     return Agent[ContextNote](
         name=name,
         handoff_description="""

atendentepro/agents/knowledge.py

@@ -58,9 +58,22 @@ def load_embeddings() -> List[dict]:
         return []
 
 
+def _check_rag_dependencies() -> None:
+    """Check if RAG dependencies are installed."""
+    try:
+        import numpy  # noqa: F401
+        import sklearn  # noqa: F401
+    except ImportError as e:
+        raise ImportError(
+            "RAG dependencies not installed. "
+            "Install with: pip install atendentepro[rag]"
+        ) from e
+
+
 async def _find_relevant_chunks(query: str, top_k: int = 3) -> List[dict]:
     """Find most relevant chunks for a given query."""
     try:
+        _check_rag_dependencies()
         from sklearn.metrics.pairwise import cosine_similarity
         import numpy as np
         
@@ -218,6 +231,7 @@ def create_knowledge_agent(
     name: str = "Knowledge Agent",
     custom_instructions: Optional[str] = None,
     style_instructions: str = "",
+    single_reply: bool = False,
 ) -> KnowledgeAgent:
     """
     Create a Knowledge Agent instance.
@@ -241,6 +255,7 @@ def create_knowledge_agent(
         name: Agent name.
         custom_instructions: Optional custom instructions to override default.
         style_instructions: Optional style/tone instructions to append.
+        single_reply: If True, agent responds once then transfers to triage.
         
     Returns:
         Configured Knowledge Agent instance.
@@ -268,6 +283,10 @@ def create_knowledge_agent(
     if style_instructions:
         instructions += style_instructions
     
+    # Single reply mode: respond once then return to triage
+    if single_reply:
+        instructions += "\n\nIMPORTANTE: Após fornecer sua resposta, transfira IMEDIATAMENTE para o triage_agent. Você só pode dar UMA resposta antes de transferir."
+    
     # Build tools list
     agent_tools: List = []
     

atendentepro/agents/onboarding.py

@@ -28,6 +28,7 @@ def create_onboarding_agent(
     name: str = "Onboarding Agent",
     custom_instructions: Optional[str] = None,
     style_instructions: str = "",
+    single_reply: bool = False,
 ) -> OnboardingAgent:
     """
     Create an Onboarding Agent instance.
@@ -43,6 +44,7 @@ def create_onboarding_agent(
         name: Agent name.
         custom_instructions: Optional custom instructions to override default.
         style_instructions: Optional style/tone instructions to append.
+        single_reply: If True, agent responds once then transfers to triage.
         
     Returns:
         Configured Onboarding Agent instance.
@@ -57,6 +59,10 @@ def create_onboarding_agent(
     if style_instructions:
         instructions += style_instructions
     
+    # Single reply mode: respond once then return to triage
+    if single_reply:
+        instructions += "\n\nIMPORTANTE: Após fornecer sua resposta, transfira IMEDIATAMENTE para o triage_agent. Você só pode dar UMA resposta antes de transferir."
+    
     return Agent[ContextNote](
         name=name,
         handoff_description=(

atendentepro/agents/usage.py

@@ -30,6 +30,7 @@ def create_usage_agent(
     name: str = "Usage Agent",
     custom_instructions: Optional[str] = None,
     style_instructions: str = "",
+    single_reply: bool = False,
 ) -> UsageAgent:
     """
     Create a Usage Agent instance.
@@ -42,6 +43,7 @@ def create_usage_agent(
         name: Agent name.
         custom_instructions: Optional custom instructions to override default.
         style_instructions: Optional style/tone instructions to append.
+        single_reply: If True, agent responds once then transfers to triage.
         
     Returns:
         Configured Usage Agent instance.
@@ -52,6 +54,10 @@ def create_usage_agent(
     if style_instructions:
         instructions += style_instructions
     
+    # Single reply mode: respond once then return to triage
+    if single_reply:
+        instructions += "\n\nIMPORTANTE: Após fornecer sua resposta, transfira IMEDIATAMENTE para o triage_agent. Você só pode dar UMA resposta antes de transferir."
+    
     return Agent[ContextNote](
         name=name,
         handoff_description="A usage agent that can answer questions about the usage of the system.",

atendentepro/network.py

@@ -199,6 +199,9 @@ def create_standard_network(
     # Style configuration
     global_style: Optional[AgentStyle] = None,
     agent_styles: Optional[Dict[str, AgentStyle]] = None,
+    # Single reply mode (auto-return to triage after one response)
+    global_single_reply: bool = False,
+    single_reply_agents: Optional[Dict[str, bool]] = None,
 ) -> AgentNetwork:
     """
     Create a standard agent network with proper handoff configuration.
@@ -236,6 +239,8 @@ def create_standard_network(
         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).
+        global_single_reply: If True, all agents respond once then transfer to triage.
+        single_reply_agents: Dict mapping agent names to single_reply mode (overrides global).
         
     Returns:
         Configured AgentNetwork instance.
@@ -278,6 +283,17 @@ def create_standard_network(
                 ),
             },
         )
+        
+        # Create network with single reply mode for specific agents
+        network = create_standard_network(
+            templates_root=Path("templates"),
+            client="my_client",
+            global_single_reply=False,  # Not all agents
+            single_reply_agents={
+                "knowledge": True,   # Knowledge responds once
+                "confirmation": True, # Confirmation responds once
+            },
+        )
     """
     # Verificar licença
     require_activation()
@@ -356,6 +372,15 @@ def create_standard_network(
             return global_style.build_style_prompt()
         return ""
     
+    # Single reply helper function
+    def get_single_reply_for_agent(agent_name: str) -> bool:
+        """Get single_reply setting for a specific agent."""
+        # Agent-specific setting takes precedence
+        if single_reply_agents and agent_name in single_reply_agents:
+            return single_reply_agents[agent_name]
+        # Fall back to global setting
+        return global_single_reply
+    
     # Create agents without handoffs first
     # Triage is always created (entry point)
     triage = create_triage_agent(
@@ -372,6 +397,7 @@ def create_standard_network(
             flow_keywords=flow_keywords,
             guardrails=get_guardrails_for_agent("Flow Agent", templates_root),
             style_instructions=get_style_for_agent("flow"),
+            single_reply=get_single_reply_for_agent("flow"),
         )
     
     interview = None
@@ -382,6 +408,7 @@ def create_standard_network(
             tools=tools.get("interview", []),
             guardrails=get_guardrails_for_agent("Interview Agent", templates_root),
             style_instructions=get_style_for_agent("interview"),
+            single_reply=get_single_reply_for_agent("interview"),
         )
     
     answer = None
@@ -390,6 +417,7 @@ def create_standard_network(
             answer_template="",
             guardrails=get_guardrails_for_agent("Answer Agent", templates_root),
             style_instructions=get_style_for_agent("answer"),
+            single_reply=get_single_reply_for_agent("answer"),
         )
     
     knowledge = None
@@ -404,6 +432,7 @@ def create_standard_network(
             tools=tools.get("knowledge", []),
             guardrails=get_guardrails_for_agent("Knowledge Agent", templates_root),
             style_instructions=get_style_for_agent("knowledge"),
+            single_reply=get_single_reply_for_agent("knowledge"),
         )
     
     confirmation = None
@@ -414,6 +443,7 @@ def create_standard_network(
             confirmation_format=confirmation_format,
             guardrails=get_guardrails_for_agent("Confirmation Agent", templates_root),
             style_instructions=get_style_for_agent("confirmation"),
+            single_reply=get_single_reply_for_agent("confirmation"),
         )
     
     usage = None
@@ -421,6 +451,7 @@ def create_standard_network(
         usage = create_usage_agent(
             guardrails=get_guardrails_for_agent("Usage Agent", templates_root),
             style_instructions=get_style_for_agent("usage"),
+            single_reply=get_single_reply_for_agent("usage"),
         )
     
     # Create escalation agent if requested
@@ -431,6 +462,7 @@ def create_standard_network(
             tools=tools.get("escalation", []),
             guardrails=get_guardrails_for_agent("Escalation Agent", templates_root),
             style_instructions=get_style_for_agent("escalation"),
+            single_reply=get_single_reply_for_agent("escalation"),
         )
     
     # Create feedback agent if requested
@@ -443,6 +475,7 @@ def create_standard_network(
             tools=tools.get("feedback", []),
             guardrails=get_guardrails_for_agent("Feedback Agent", templates_root),
             style_instructions=get_style_for_agent("feedback"),
+            single_reply=get_single_reply_for_agent("feedback"),
         )
     
     # Configure handoffs dynamically based on which agents are included
@@ -554,6 +587,7 @@ def create_standard_network(
             tools=tools.get("onboarding", []),
             guardrails=get_guardrails_for_agent("Onboarding Agent", templates_root),
             style_instructions=get_style_for_agent("onboarding"),
+            single_reply=get_single_reply_for_agent("onboarding"),
         )
         
         network.onboarding = onboarding

atendentepro/templates/__init__.py

@@ -15,6 +15,7 @@ from .manager import (
     load_confirmation_config,
     load_onboarding_config,
     load_style_config,
+    load_single_reply_config,
     FlowConfig,
     InterviewConfig,
     TriageConfig,
@@ -23,6 +24,7 @@ from .manager import (
     OnboardingConfig,
     StyleConfig,
     AgentStyleConfig,
+    SingleReplyConfig,
     DataSourceConfig,
     DataSourceColumn,
     DocumentConfig,
@@ -42,6 +44,7 @@ __all__ = [
     "load_confirmation_config",
     "load_onboarding_config",
     "load_style_config",
+    "load_single_reply_config",
     "FlowConfig",
     "InterviewConfig",
     "TriageConfig",
@@ -50,6 +53,7 @@ __all__ = [
     "OnboardingConfig",
     "StyleConfig",
     "AgentStyleConfig",
+    "SingleReplyConfig",
     "DataSourceConfig",
     "DataSourceColumn",
     "DocumentConfig",

atendentepro/templates/manager.py

@@ -391,6 +391,49 @@ class StyleConfig(BaseModel):
         return self.global_style
 
 
+class SingleReplyConfig(BaseModel):
+    """Configuration model for single reply mode.
+    
+    When single_reply is enabled for an agent, it will respond once
+    and automatically transfer back to the Triage agent. This prevents
+    conversations from getting stuck in a specific agent.
+    
+    Example YAML:
+        global: false
+        
+        agents:
+          knowledge: true
+          confirmation: true
+          answer: true
+    """
+    
+    global_enabled: bool = False
+    agents: Dict[str, bool] = Field(default_factory=dict)
+    
+    @classmethod
+    @lru_cache(maxsize=4)
+    def load(cls, path: Path) -> "SingleReplyConfig":
+        """Load single reply configuration from YAML file."""
+        if not path.exists():
+            raise FileNotFoundError(f"Single reply config not found at {path}")
+        
+        with open(path, "r", encoding="utf-8") as f:
+            data = yaml.safe_load(f) or {}
+        
+        return cls(
+            global_enabled=data.get("global", False),
+            agents=data.get("agents", {}),
+        )
+    
+    def get_single_reply_for_agent(self, agent_name: str) -> bool:
+        """Get single_reply setting for a specific agent."""
+        # Agent-specific setting takes precedence
+        if agent_name in self.agents:
+            return self.agents[agent_name]
+        # Fall back to global
+        return self.global_enabled
+
+
 class OnboardingConfig(BaseModel):
     """Configuration model for Onboarding Agent."""
     
@@ -514,6 +557,11 @@ class TemplateManager:
         folder = self.get_template_folder(client)
         return StyleConfig.load(folder / "style_config.yaml")
     
+    def load_single_reply_config(self, client: Optional[str] = None) -> SingleReplyConfig:
+        """Load single reply configuration for the specified client."""
+        folder = self.get_template_folder(client)
+        return SingleReplyConfig.load(folder / "single_reply_config.yaml")
+    
     def clear_caches(self) -> None:
         """Clear all configuration caches."""
         FlowConfig.load.cache_clear()
@@ -523,6 +571,7 @@ class TemplateManager:
         ConfirmationConfig.load.cache_clear()
         OnboardingConfig.load.cache_clear()
         StyleConfig.load.cache_clear()
+        SingleReplyConfig.load.cache_clear()
 
 
 def get_template_manager() -> TemplateManager:
@@ -616,3 +665,8 @@ def load_style_config(client: Optional[str] = None) -> StyleConfig:
     """Load style configuration for the specified client."""
     return get_template_manager().load_style_config(client)
 
+
+def load_single_reply_config(client: Optional[str] = None) -> SingleReplyConfig:
+    """Load single reply configuration for the specified client."""
+    return get_template_manager().load_single_reply_config(client)
+

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: atendentepro
-Version: 0.6.1
+Version: 0.6.3
 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>
@@ -25,33 +25,33 @@ 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
+Requires-Dist: openai-agents<1.0.0,>=0.3.3
+Requires-Dist: openai<2.0.0,>=1.107.1
+Requires-Dist: pydantic<3.0.0,>=2.0.0
+Requires-Dist: PyYAML<7.0,>=6.0
+Requires-Dist: python-dotenv<2.0.0,>=1.0.0
+Requires-Dist: httpx<1.0.0,>=0.27.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"
+Requires-Dist: pytest<9.0.0,>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio<1.0.0,>=0.21.0; extra == "dev"
+Requires-Dist: black<25.0.0,>=23.0.0; extra == "dev"
+Requires-Dist: isort<6.0.0,>=5.12.0; extra == "dev"
+Requires-Dist: mypy<2.0.0,>=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"
+Requires-Dist: mkdocs<2.0.0,>=1.5.0; extra == "docs"
+Requires-Dist: mkdocs-material<10.0.0,>=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"
+Requires-Dist: numpy<2.0.0,>=1.24.0; extra == "rag"
+Requires-Dist: scikit-learn<2.0.0,>=1.3.0; extra == "rag"
+Requires-Dist: PyPDF2<4.0.0,>=3.0.0; extra == "rag"
+Requires-Dist: python-docx<2.0.0,>=0.8.11; extra == "rag"
+Requires-Dist: python-pptx<1.0.0,>=0.6.21; extra == "rag"
+Requires-Dist: PyMuPDF<2.0.0,>=1.23.0; extra == "rag"
 Provides-Extra: tracing
-Requires-Dist: monkai-trace>=0.2.9; extra == "tracing"
+Requires-Dist: monkai-trace<1.0.0,>=0.2.9; extra == "tracing"
 Provides-Extra: azure
-Requires-Dist: opentelemetry-sdk>=1.20.0; extra == "azure"
-Requires-Dist: azure-monitor-opentelemetry-exporter>=1.0.0; extra == "azure"
+Requires-Dist: opentelemetry-sdk<2.0.0,>=1.20.0; extra == "azure"
+Requires-Dist: azure-monitor-opentelemetry-exporter<2.0.0,>=1.0.0; extra == "azure"
 Provides-Extra: all
 Requires-Dist: atendentepro[azure,dev,docs,rag,tracing]; extra == "all"
 Dynamic: license-file
@@ -94,6 +94,7 @@ Plataforma que unifica múltiplos agentes especializados para resolver demandas
 - [Feedback Agent](#-feedback-agent)
 - [Fluxo de Handoffs](#-fluxo-de-handoffs)
 - [Estilo de Comunicação](#-estilo-de-comunicação-agentstyle)
+- [Single Reply Mode](#-single-reply-mode)
 - [Tracing e Monitoramento](#-tracing-e-monitoramento)
 - [Suporte](#-suporte)
 
@@ -707,6 +708,88 @@ agents:
 
 ---
 
+## 🔁 Single Reply Mode
+
+O **Single Reply Mode** permite configurar agentes para responderem apenas uma vez e automaticamente transferirem de volta para o Triage. Isso evita que a conversa fique "presa" em um agente específico.
+
+### Quando Usar
+
+- **Chatbots de alto volume**: Respostas rápidas e independentes
+- **Consultas simples**: Uma pergunta = uma resposta
+- **Evitar loops**: Impedir que usuários fiquem presos em um agente
+
+### Via Código
+
+```python
+from pathlib import Path
+from atendentepro import create_standard_network
+
+# Ativar para TODOS os agentes
+network = create_standard_network(
+    templates_root=Path("./meu_cliente"),
+    client="config",
+    global_single_reply=True,  # Todos respondem uma vez
+)
+
+# Ativar apenas para agentes específicos
+network = create_standard_network(
+    templates_root=Path("./meu_cliente"),
+    client="config",
+    global_single_reply=False,
+    single_reply_agents={
+        "knowledge": True,      # Knowledge responde uma vez
+        "confirmation": True,   # Confirmation responde uma vez
+        "answer": True,         # Answer responde uma vez
+        # interview: False      # Interview pode ter múltiplas interações
+    },
+)
+```
+
+### Via YAML (single_reply_config.yaml)
+
+Crie o arquivo `single_reply_config.yaml` na pasta do cliente:
+
+```yaml
+# Global: aplica a todos os agentes
+global: false
+
+# Configuração por agente
+agents:
+  # Agentes que respondem uma vez
+  knowledge: true
+  confirmation: true
+  answer: true
+  
+  # Agentes que precisam de múltiplas interações
+  interview: false
+  flow: false
+  onboarding: false
+```
+
+### Comportamento
+
+Quando `single_reply=True`:
+
+```
+[Usuário] → [Triage] → [Knowledge]
+                            ↓
+                    (responde uma vez)
+                            ↓
+                       [Triage] ← (retorno automático)
+```
+
+Quando `single_reply=False` (padrão):
+
+```
+[Usuário] → [Triage] → [Knowledge]
+                            ↓
+                    (pode continuar)
+                            ↕
+                       [Usuário]
+```
+
+---
+
 ## 📊 Tracing e Monitoramento
 
 ### MonkAI Trace (Recomendado)

{atendentepro-0.6.1.dist-info → atendentepro-0.6.3.dist-info}/RECORD

@@ -1,18 +1,18 @@
 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=1grEjYDZQ7K6r-eQ1tMV3g1vBAdkiNn0v1EeraqTK18,22341
+atendentepro/network.py,sha256=QEWgvNEWNkr1-xHd54dIdfFIgGJsRLBgQpuaDnQXknM,24124
 atendentepro/agents/__init__.py,sha256=OcPhG1Dp6xe49B5YIti4HVmaZDoDIrFLfRa8GmI4jpQ,1638
-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/answer.py,sha256=S6wTchNSTMc0h6d89A4jAzoqecFPVqHUrr55-rCM-p4,2494
+atendentepro/agents/confirmation.py,sha256=bQmIiDaxaCDIWJ3Fxz8h3AHW4kHhwbWSmyLX4y3dtls,2900
+atendentepro/agents/escalation.py,sha256=tnFhHaV8VnrMMh_p8Xt9JTMe4bkWcGb6mChECm8aAvI,17779
+atendentepro/agents/feedback.py,sha256=0cU6LVcIp_2ZBB-Cdprnwgw1C5IKYC_ydQ8HJnlheqo,33585
+atendentepro/agents/flow.py,sha256=8SsAQ_f-daOM25EVBTMKGSUI9ywG3y4B0bFcCnrUfo0,2645
+atendentepro/agents/interview.py,sha256=3eWHUw63OJuVpHH-QYtdL8SadRgevNLv2N8Esa4Za2c,2722
+atendentepro/agents/knowledge.py,sha256=Xew_qhAdBrm3oVRvHhKh2oi6aURyeIKU5CtgfAHBYEI,11054
+atendentepro/agents/onboarding.py,sha256=IId7N9VeTvHggjK_piDOAmwzBztj6oHqbZq7YOpVJIg,2687
 atendentepro/agents/triage.py,sha256=pdYCA5AqbGMY0WoJXvdceAz_gnQ7D_fJp7dxxsD-GDg,1958
-atendentepro/agents/usage.py,sha256=wdxX7ZJVO6RGkuAY7JIgTfUQHid-q9U5ohLmvIg399c,1819
+atendentepro/agents/usage.py,sha256=tTfbqh3vRIDu0cnB65tv-Z3neEj90COp85nlIVpRLJ8,2183
 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=GbtNnhf2Zz-JiNReq-bBLzTdMZ-JFItmPU0OjnlU640,1267
-atendentepro/templates/manager.py,sha256=kEeVRc1GHW5W8Q3GHgn6iBEvyzyO-GcEIKTBorYaHXw,21405
+atendentepro/templates/__init__.py,sha256=Xc3yTQcdUbzKphbOYEAefhV1v9FzLas_WzuphYVpk_0,1377
+atendentepro/templates/manager.py,sha256=VHnu2dxWA6TR07QjJtsDZIRkwIjq-zGoIDysul7WMkE,23347
 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.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,,
+atendentepro-0.6.3.dist-info/licenses/LICENSE,sha256=TF6CdXxePoT9DXtPnCejiU5mUwWzrFzd1iyWJyoMauA,983
+atendentepro-0.6.3.dist-info/METADATA,sha256=ijYMZnbksuX5O7ao9bA0deK6gI5eYM3jtE2S_hd2WOE,27835
+atendentepro-0.6.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+atendentepro-0.6.3.dist-info/entry_points.txt,sha256=OP0upzqJF3MLS6VX-M-5BfUwx5YLJO2sJ3YBAp4e6yI,89
+atendentepro-0.6.3.dist-info/top_level.txt,sha256=BFasD4SMmgDUmWKlTIZ1PeuukoRBhyiMIz8umKWVCcs,13
+atendentepro-0.6.3.dist-info/RECORD,,