atendentepro 0.5.4__tar.gz → 0.5.6__tar.gz

{atendentepro-0.5.4 → atendentepro-0.5.6}/CHANGELOG.md

@@ -5,6 +5,23 @@ 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.5.6] - 2025-01-07
+
+### Added
+- New parameters in `create_standard_network` to enable/disable individual agents:
+  - `include_flow`, `include_interview`, `include_answer`
+  - `include_knowledge`, `include_confirmation`, `include_usage`
+- Allows creating custom networks without specific agents (e.g., without Knowledge)
+
+### Changed
+- Handoffs are now dynamically configured based on which agents are enabled
+- Documentation updated with examples of minimal network configurations
+
+## [0.5.5] - 2025-01-06
+
+### Fixed
+- GitHub Actions workflow now only triggers PyPI publish on version tags
+
 ## [0.5.4] - 2025-01-06
 
 ### Changed

{atendentepro-0.5.4 → atendentepro-0.5.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: atendentepro
-Version: 0.5.4
+Version: 0.5.6
 Summary: Sistema de Atendimento Inteligente com Múltiplos Agentes IA - Biblioteca independente e modular baseada no OpenAI Agents SDK
 Author-email: BeMonkAI <contato@monkai.com.br>
 Maintainer-email: BeMonkAI <contato@monkai.com.br>
@@ -525,26 +525,61 @@ Escalation► Triage, Feedback
 Feedback ► Triage, Escalation
 ```
 
-### Configuração de Handoffs
+### Configuração de Agentes
+
+Você pode escolher exatamente quais agentes incluir na sua rede:
 
 ```python
-# Todos os handoffs habilitados (padrão)
+from pathlib import Path
+from atendentepro import create_standard_network
+
+# Todos os agentes habilitados (padrão)
 network = create_standard_network(
     templates_root=Path("./meu_cliente"),
     client="config",
-    include_escalation=True,  # Padrão: True
-    include_feedback=True,    # Padrão: True
 )
 
-# Sem Escalation ou Feedback
+# Sem Knowledge Agent (para clientes sem base de conhecimento)
 network = create_standard_network(
     templates_root=Path("./meu_cliente"),
     client="config",
+    include_knowledge=False,
+)
+
+# Rede mínima (apenas fluxo principal)
+network = create_standard_network(
+    templates_root=Path("./meu_cliente"),
+    client="config",
+    include_knowledge=False,
+    include_confirmation=False,
+    include_usage=False,
     include_escalation=False,
     include_feedback=False,
 )
+
+# Apenas captura de leads (sem Knowledge nem Usage)
+network = create_standard_network(
+    templates_root=Path("./meu_cliente"),
+    client="config",
+    include_knowledge=False,
+    include_usage=False,
+)
 ```
 
+### Parâmetros Disponíveis
+
+| Parâmetro | Padrão | Descrição |
+|-----------|--------|-----------|
+| `include_flow` | `True` | Agente de fluxo conversacional |
+| `include_interview` | `True` | Agente de entrevista/coleta |
+| `include_answer` | `True` | Agente de resposta final |
+| `include_knowledge` | `True` | Agente de base de conhecimento |
+| `include_confirmation` | `True` | Agente de confirmação |
+| `include_usage` | `True` | Agente de instruções de uso |
+| `include_onboarding` | `False` | Agente de boas-vindas |
+| `include_escalation` | `True` | Agente de escalonamento humano |
+| `include_feedback` | `True` | Agente de tickets/feedback |
+
 ---
 
 ## 🔧 Dependências

{atendentepro-0.5.4 → atendentepro-0.5.6}/README.md

@@ -469,26 +469,61 @@ Escalation► Triage, Feedback
 Feedback ► Triage, Escalation
 ```
 
-### Configuração de Handoffs
+### Configuração de Agentes
+
+Você pode escolher exatamente quais agentes incluir na sua rede:
 
 ```python
-# Todos os handoffs habilitados (padrão)
+from pathlib import Path
+from atendentepro import create_standard_network
+
+# Todos os agentes habilitados (padrão)
 network = create_standard_network(
     templates_root=Path("./meu_cliente"),
     client="config",
-    include_escalation=True,  # Padrão: True
-    include_feedback=True,    # Padrão: True
 )
 
-# Sem Escalation ou Feedback
+# Sem Knowledge Agent (para clientes sem base de conhecimento)
 network = create_standard_network(
     templates_root=Path("./meu_cliente"),
     client="config",
+    include_knowledge=False,
+)
+
+# Rede mínima (apenas fluxo principal)
+network = create_standard_network(
+    templates_root=Path("./meu_cliente"),
+    client="config",
+    include_knowledge=False,
+    include_confirmation=False,
+    include_usage=False,
     include_escalation=False,
     include_feedback=False,
 )
+
+# Apenas captura de leads (sem Knowledge nem Usage)
+network = create_standard_network(
+    templates_root=Path("./meu_cliente"),
+    client="config",
+    include_knowledge=False,
+    include_usage=False,
+)
 ```
 
+### Parâmetros Disponíveis
+
+| Parâmetro | Padrão | Descrição |
+|-----------|--------|-----------|
+| `include_flow` | `True` | Agente de fluxo conversacional |
+| `include_interview` | `True` | Agente de entrevista/coleta |
+| `include_answer` | `True` | Agente de resposta final |
+| `include_knowledge` | `True` | Agente de base de conhecimento |
+| `include_confirmation` | `True` | Agente de confirmação |
+| `include_usage` | `True` | Agente de instruções de uso |
+| `include_onboarding` | `False` | Agente de boas-vindas |
+| `include_escalation` | `True` | Agente de escalonamento humano |
+| `include_feedback` | `True` | Agente de tickets/feedback |
+
 ---
 
 ## 🔧 Dependências

{atendentepro-0.5.4 → atendentepro-0.5.6}/atendentepro/network.py

@@ -102,9 +102,17 @@ class AgentNetwork:
 def create_standard_network(
     templates_root: Path,
     client: str = "standard",
+    # Agents to include
+    include_flow: bool = True,
+    include_interview: bool = True,
+    include_answer: bool = True,
+    include_knowledge: bool = True,
+    include_confirmation: bool = True,
+    include_usage: bool = True,
     include_onboarding: bool = False,
     include_escalation: bool = True,
     include_feedback: bool = True,
+    # Agent-specific configurations
     escalation_channels: str = "",
     feedback_protocol_prefix: str = "TKT",
     feedback_brand_color: str = "#4A90D9",
@@ -114,7 +122,10 @@ def create_standard_network(
     """
     Create a standard agent network with proper handoff configuration.
     
-    This creates the default network configuration with:
+    This creates a configurable network where you can enable/disable specific agents.
+    The Triage agent is always included as it's the entry point.
+    
+    Default handoff configuration (when all agents are enabled):
     - Triage -> Flow, Confirmation, Knowledge, Usage, Escalation, Feedback
     - Flow -> Interview, Triage, Escalation, Feedback
     - Interview -> Answer, Escalation, Feedback
@@ -122,13 +133,19 @@ def create_standard_network(
     - Confirmation -> Triage, Escalation, Feedback
     - Knowledge -> Triage, Escalation, Feedback
     - Usage -> Triage, Escalation, Feedback
-    - Escalation -> Triage
+    - Escalation -> Triage, Feedback
     - Feedback -> Triage, Escalation
     
     Args:
         templates_root: Root directory for template configurations.
         client: Client key to load configurations for.
-        include_onboarding: Whether to include the onboarding agent.
+        include_flow: Whether to include the flow agent (default True).
+        include_interview: Whether to include the interview agent (default True).
+        include_answer: Whether to include the answer agent (default True).
+        include_knowledge: Whether to include the knowledge agent (default True).
+        include_confirmation: Whether to include the confirmation agent (default True).
+        include_usage: Whether to include the usage agent (default True).
+        include_onboarding: Whether to include the onboarding agent (default False).
         include_escalation: Whether to include the escalation agent (default True).
         include_feedback: Whether to include the feedback agent (default True).
         escalation_channels: Description of available escalation channels.
@@ -142,6 +159,25 @@ def create_standard_network(
         
     Raises:
         LicenseNotActivatedError: If the library is not activated.
+        
+    Example:
+        # Create network without Knowledge agent
+        network = create_standard_network(
+            templates_root=Path("templates"),
+            client="my_client",
+            include_knowledge=False,
+        )
+        
+        # Create minimal network (only Triage, Flow, Interview, Answer)
+        network = create_standard_network(
+            templates_root=Path("templates"),
+            client="my_client",
+            include_knowledge=False,
+            include_confirmation=False,
+            include_usage=False,
+            include_escalation=False,
+            include_feedback=False,
+        )
     """
     # Verificar licença
     require_activation()
@@ -210,50 +246,64 @@ def create_standard_network(
     tools = custom_tools or {}
     
     # 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),
     )
     
-    flow = create_flow_agent(
-        flow_template=flow_template,
-        flow_keywords=flow_keywords,
-        guardrails=get_guardrails_for_agent("Flow Agent", templates_root),
-    )
+    # Create optional agents based on include flags
+    flow = None
+    if include_flow:
+        flow = create_flow_agent(
+            flow_template=flow_template,
+            flow_keywords=flow_keywords,
+            guardrails=get_guardrails_for_agent("Flow Agent", templates_root),
+        )
     
-    interview = create_interview_agent(
-        interview_template=flow_template,
-        interview_questions=interview_questions,
-        tools=tools.get("interview", []),
-        guardrails=get_guardrails_for_agent("Interview Agent", templates_root),
-    )
+    interview = None
+    if include_interview:
+        interview = create_interview_agent(
+            interview_template=flow_template,
+            interview_questions=interview_questions,
+            tools=tools.get("interview", []),
+            guardrails=get_guardrails_for_agent("Interview Agent", templates_root),
+        )
     
-    answer = create_answer_agent(
-        answer_template="",
-        guardrails=get_guardrails_for_agent("Answer Agent", templates_root),
-    )
+    answer = None
+    if include_answer:
+        answer = create_answer_agent(
+            answer_template="",
+            guardrails=get_guardrails_for_agent("Answer Agent", templates_root),
+        )
     
-    knowledge = create_knowledge_agent(
-        knowledge_about=knowledge_about,
-        knowledge_template=knowledge_template,
-        knowledge_format=knowledge_format,
-        embeddings_path=embeddings_path,
-        data_sources_description=data_sources_description,
-        include_rag_tool=has_embeddings,
-        tools=tools.get("knowledge", []),
-        guardrails=get_guardrails_for_agent("Knowledge Agent", templates_root),
-    )
+    knowledge = None
+    if include_knowledge:
+        knowledge = create_knowledge_agent(
+            knowledge_about=knowledge_about,
+            knowledge_template=knowledge_template,
+            knowledge_format=knowledge_format,
+            embeddings_path=embeddings_path,
+            data_sources_description=data_sources_description,
+            include_rag_tool=has_embeddings,
+            tools=tools.get("knowledge", []),
+            guardrails=get_guardrails_for_agent("Knowledge Agent", templates_root),
+        )
     
-    confirmation = create_confirmation_agent(
-        confirmation_about=confirmation_about,
-        confirmation_template=confirmation_template,
-        confirmation_format=confirmation_format,
-        guardrails=get_guardrails_for_agent("Confirmation Agent", templates_root),
-    )
+    confirmation = None
+    if include_confirmation:
+        confirmation = create_confirmation_agent(
+            confirmation_about=confirmation_about,
+            confirmation_template=confirmation_template,
+            confirmation_format=confirmation_format,
+            guardrails=get_guardrails_for_agent("Confirmation Agent", templates_root),
+        )
     
-    usage = create_usage_agent(
-        guardrails=get_guardrails_for_agent("Usage Agent", templates_root),
-    )
+    usage = None
+    if include_usage:
+        usage = create_usage_agent(
+            guardrails=get_guardrails_for_agent("Usage Agent", templates_root),
+        )
     
     # Create escalation agent if requested
     escalation = None
@@ -275,48 +325,74 @@ def create_standard_network(
             guardrails=get_guardrails_for_agent("Feedback Agent", templates_root),
         )
     
-    # Configure handoffs
-    triage_handoffs = [flow, confirmation, knowledge, usage]
-    flow_handoffs = [interview, triage]
-    confirmation_handoffs = [triage]
-    knowledge_handoffs = [triage]
-    usage_handoffs = [triage]
-    interview_handoffs = [answer]
-    answer_handoffs = [triage]  # Answer só volta para Triage (não faz sentido voltar para Interview)
-    escalation_handoffs = [triage]
-    feedback_handoffs = [triage]
+    # Configure handoffs dynamically based on which agents are included
+    # Helper function to filter None values
+    def filter_agents(*agents):
+        return [a for a in agents if a is not None]
+    
+    # Build triage handoffs (main routing)
+    triage_handoffs = filter_agents(flow, confirmation, knowledge, usage)
+    
+    # Other agent handoffs
+    flow_handoffs = filter_agents(interview, triage) if flow else []
+    confirmation_handoffs = [triage] if confirmation else []
+    knowledge_handoffs = [triage] if knowledge else []
+    usage_handoffs = [triage] if usage else []
+    interview_handoffs = filter_agents(answer) if interview else []
+    answer_handoffs = [triage] if answer else []
+    escalation_handoffs = [triage] if escalation else []
+    feedback_handoffs = [triage] if feedback else []
     
     # Add escalation to all agents if enabled
     if escalation:
         triage_handoffs.append(escalation)
-        flow_handoffs.append(escalation)
-        confirmation_handoffs.append(escalation)
-        knowledge_handoffs.append(escalation)
-        usage_handoffs.append(escalation)
-        interview_handoffs.append(escalation)
-        answer_handoffs.append(escalation)
+        if flow:
+            flow_handoffs.append(escalation)
+        if confirmation:
+            confirmation_handoffs.append(escalation)
+        if knowledge:
+            knowledge_handoffs.append(escalation)
+        if usage:
+            usage_handoffs.append(escalation)
+        if interview:
+            interview_handoffs.append(escalation)
+        if answer:
+            answer_handoffs.append(escalation)
         if feedback:
             feedback_handoffs.append(escalation)
     
     # Add feedback to all agents if enabled
     if feedback:
         triage_handoffs.append(feedback)
-        flow_handoffs.append(feedback)
-        confirmation_handoffs.append(feedback)
-        knowledge_handoffs.append(feedback)
-        usage_handoffs.append(feedback)
-        interview_handoffs.append(feedback)
-        answer_handoffs.append(feedback)
+        if flow:
+            flow_handoffs.append(feedback)
+        if confirmation:
+            confirmation_handoffs.append(feedback)
+        if knowledge:
+            knowledge_handoffs.append(feedback)
+        if usage:
+            usage_handoffs.append(feedback)
+        if interview:
+            interview_handoffs.append(feedback)
+        if answer:
+            answer_handoffs.append(feedback)
         if escalation:
             escalation_handoffs.append(feedback)
     
+    # Apply handoffs to agents
     triage.handoffs = triage_handoffs
-    flow.handoffs = flow_handoffs
-    confirmation.handoffs = confirmation_handoffs
-    knowledge.handoffs = knowledge_handoffs
-    usage.handoffs = usage_handoffs
-    interview.handoffs = interview_handoffs
-    answer.handoffs = answer_handoffs
+    if flow:
+        flow.handoffs = flow_handoffs
+    if confirmation:
+        confirmation.handoffs = confirmation_handoffs
+    if knowledge:
+        knowledge.handoffs = knowledge_handoffs
+    if usage:
+        usage.handoffs = usage_handoffs
+    if interview:
+        interview.handoffs = interview_handoffs
+    if answer:
+        answer.handoffs = answer_handoffs
     if escalation:
         escalation.handoffs = escalation_handoffs
     if feedback:

{atendentepro-0.5.4 → atendentepro-0.5.6}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "atendentepro"
-version = "0.5.4"
+version = "0.5.6"
 description = "Sistema de Atendimento Inteligente com Múltiplos Agentes IA - Biblioteca independente e modular baseada no OpenAI Agents SDK"
 authors = [
     { name = "BeMonkAI", email = "contato@monkai.com.br" }