atendentepro 0.6.4__py3-none-any.whl → 0.6.5__py3-none-any.whl

{atendentepro-0.6.4.dist-info → atendentepro-0.6.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: atendentepro
-Version: 0.6.4
+Version: 0.6.5
 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>
@@ -96,6 +96,7 @@ Plataforma que unifica múltiplos agentes especializados para resolver demandas
 - [Estilo de Comunicação](#-estilo-de-comunicação-agentstyle)
 - [Single Reply Mode](#-single-reply-mode)
 - [Filtros de Acesso](#-filtros-de-acesso-roleuser)
+- [Múltiplos Agentes](#-múltiplos-agentes-multi-interview--knowledge)
 - [Tracing e Monitoramento](#-tracing-e-monitoramento)
 - [Suporte](#-suporte)
 
@@ -1039,6 +1040,142 @@ tool_access:
 
 ---
 
+## 🔀 Múltiplos Agentes (Multi Interview + Knowledge)
+
+O AtendentePro suporta criar **múltiplas instâncias** de Interview e Knowledge agents, cada um especializado em um domínio diferente.
+
+📂 **Exemplo completo**: [docs/examples/multi_agents/](docs/examples/multi_agents/)
+
+### Caso de Uso
+
+Empresa que atende diferentes tipos de clientes:
+- **Pessoa Física (PF)**: Produtos de consumo
+- **Pessoa Jurídica (PJ)**: Soluções empresariais
+
+### Arquitetura
+
+```
+                    ┌─────────────────┐
+                    │     Triage      │
+                    │  (entry point)  │
+                    └────────┬────────┘
+                             │
+              ┌──────────────┼──────────────┐
+              │              │              │
+              ▼              ▼              ▼
+    ┌─────────────┐  ┌─────────────┐  ┌─────────────┐
+    │  Interview  │  │  Interview  │  │    Flow     │
+    │     PF      │  │     PJ      │  │   (comum)   │
+    └──────┬──────┘  └──────┬──────┘  └─────────────┘
+           │                │
+           ▼                ▼
+    ┌─────────────┐  ┌─────────────┐
+    │  Knowledge  │  │  Knowledge  │
+    │     PF      │  │     PJ      │
+    └─────────────┘  └─────────────┘
+```
+
+### Implementação
+
+```python
+from atendentepro import (
+    create_custom_network,
+    create_triage_agent,
+    create_interview_agent,
+    create_knowledge_agent,
+)
+
+# 1. Criar agentes especializados
+interview_pf = create_interview_agent(
+    interview_questions="CPF, data de nascimento, renda mensal",
+    name="interview_pf",  # Nome único!
+)
+
+interview_pj = create_interview_agent(
+    interview_questions="CNPJ, razão social, faturamento",
+    name="interview_pj",  # Nome único!
+)
+
+knowledge_pf = create_knowledge_agent(
+    knowledge_about="Produtos para consumidor final",
+    name="knowledge_pf",
+    single_reply=True,
+)
+
+knowledge_pj = create_knowledge_agent(
+    knowledge_about="Soluções empresariais B2B",
+    name="knowledge_pj",
+    single_reply=True,
+)
+
+# 2. Criar Triage
+triage = create_triage_agent(
+    keywords_text="PF: CPF, pessoal, minha conta | PJ: CNPJ, empresa, MEI",
+    name="triage_agent",
+)
+
+# 3. Configurar handoffs
+triage.handoffs = [interview_pf, interview_pj, knowledge_pf, knowledge_pj]
+interview_pf.handoffs = [knowledge_pf, triage]
+interview_pj.handoffs = [knowledge_pj, triage]
+knowledge_pf.handoffs = [triage]
+knowledge_pj.handoffs = [triage]
+
+# 4. Criar network customizada
+network = create_custom_network(
+    triage=triage,
+    custom_agents={
+        "interview_pf": interview_pf,
+        "interview_pj": interview_pj,
+        "knowledge_pf": knowledge_pf,
+        "knowledge_pj": knowledge_pj,
+    },
+)
+```
+
+### Cenários de Roteamento
+
+| Mensagem do Usuário | Rota |
+|---------------------|------|
+| "Quero abrir conta para mim" | Triage → Interview PF → Knowledge PF |
+| "Preciso de maquininha para minha loja" | Triage → Interview PJ → Knowledge PJ |
+| "Quanto custa o cartão gold?" | Triage → Knowledge PF (direto) |
+| "Capital de giro para empresa" | Triage → Knowledge PJ (direto) |
+
+### Padrão: 1 Interview → 2 Knowledge
+
+Outro padrão comum é ter um único Interview que pode direcionar para múltiplos Knowledge:
+
+```
+        ┌───────────────┐
+        │   Interview   │
+        │ (coleta dados)│
+        └───────┬───────┘
+                │
+        ┌───────┴───────┐
+        ▼               ▼
+┌───────────────┐ ┌───────────────┐
+│   Knowledge   │ │   Knowledge   │
+│   Produtos    │ │Troubleshooting│
+└───────────────┘ └───────────────┘
+```
+
+```python
+# Um interview que direciona para múltiplos knowledge
+interview.handoffs = [knowledge_produtos, knowledge_troubleshooting, triage]
+```
+
+📂 **Exemplo completo**: [example_one_interview_two_knowledge.py](docs/examples/multi_agents/example_one_interview_two_knowledge.py)
+
+### Dicas
+
+1. **Nomes únicos**: Cada agente precisa de um `name` distinto
+2. **Handoffs claros**: Configure quais agentes cada um pode chamar
+3. **Keywords no Triage**: Inclua palavras-chave para direcionar corretamente
+4. **single_reply**: Use em Knowledge para evitar loops
+
+---
+
 ## 📊 Tracing e Monitoramento
 
 ### MonkAI Trace (Recomendado)

{atendentepro-0.6.4.dist-info → atendentepro-0.6.5.dist-info}/RECORD

@@ -35,9 +35,9 @@ atendentepro/templates/manager.py,sha256=s2ezeyEboeMxdcb6oOADQRAm0ikB8Ru4fYC87gf
 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.4.dist-info/licenses/LICENSE,sha256=TF6CdXxePoT9DXtPnCejiU5mUwWzrFzd1iyWJyoMauA,983
-atendentepro-0.6.4.dist-info/METADATA,sha256=hjjY6FTN3Ht4v_05KO-raxRQkZEuWAxV4ACLtWTnCEs,35702
-atendentepro-0.6.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-atendentepro-0.6.4.dist-info/entry_points.txt,sha256=OP0upzqJF3MLS6VX-M-5BfUwx5YLJO2sJ3YBAp4e6yI,89
-atendentepro-0.6.4.dist-info/top_level.txt,sha256=BFasD4SMmgDUmWKlTIZ1PeuukoRBhyiMIz8umKWVCcs,13
-atendentepro-0.6.4.dist-info/RECORD,,
+atendentepro-0.6.5.dist-info/licenses/LICENSE,sha256=TF6CdXxePoT9DXtPnCejiU5mUwWzrFzd1iyWJyoMauA,983
+atendentepro-0.6.5.dist-info/METADATA,sha256=kLTh75smJ0t4HHAGVY7Bcj4XoOzKtrLWL_gcu1OvLEA,40666
+atendentepro-0.6.5.dist-info/WHEEL,sha256=qELbo2s1Yzl39ZmrAibXA2jjPLUYfnVhUNTlyF1rq0Y,92
+atendentepro-0.6.5.dist-info/entry_points.txt,sha256=OP0upzqJF3MLS6VX-M-5BfUwx5YLJO2sJ3YBAp4e6yI,89
+atendentepro-0.6.5.dist-info/top_level.txt,sha256=BFasD4SMmgDUmWKlTIZ1PeuukoRBhyiMIz8umKWVCcs,13
+atendentepro-0.6.5.dist-info/RECORD,,

{atendentepro-0.6.4.dist-info → atendentepro-0.6.5.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.9.0)
+Generator: setuptools (80.10.1)
 Root-Is-Purelib: true
 Tag: py3-none-any