atendentepro 0.3.0__py3-none-any.whl → 0.5.1__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: atendentepro
3
- Version: 0.3.0
3
+ Version: 0.5.1
4
4
  Summary: Sistema de Atendimento Inteligente com Múltiplos Agentes IA - Biblioteca independente e modular baseada no OpenAI Agents SDK
5
5
  Author-email: BeMonkAI <contato@bemonkai.com>
6
6
  Maintainer-email: BeMonkAI <contato@bemonkai.com>
@@ -58,7 +58,7 @@ Dynamic: license-file
58
58
 
59
59
  [![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
60
60
  [![License: Proprietary](https://img.shields.io/badge/License-Proprietary-red.svg)](LICENSE)
61
- [![Version](https://img.shields.io/badge/version-0.3.0-green.svg)](CHANGELOG.md)
61
+ [![Version](https://img.shields.io/badge/version-0.5.0-green.svg)](CHANGELOG.md)
62
62
 
63
63
  **Sistema de Atendimento Inteligente com Múltiplos Agentes IA**
64
64
 
@@ -157,9 +157,9 @@ from agents import Runner
157
157
  activate("ATP_seu-token")
158
158
 
159
159
  async def main():
160
- # 2. Criar rede de agentes
160
+ # 2. Criar rede de agentes usando template standard
161
161
  network = create_standard_network(
162
- templates_root=Path("./client_templates"),
162
+ templates_root=Path("./templates"), # Template genérico de exemplo
163
163
  client="standard"
164
164
  )
165
165
 
@@ -179,34 +179,40 @@ asyncio.run(main())
179
179
  ## 🏗️ Arquitetura
180
180
 
181
181
  ```
182
- ┌─────────────────────────────────────────────────────────────────┐
183
- ATENDENTEPRO
184
- ├─────────────────────────────────────────────────────────────────┤
185
-
186
- │ 👤 Usuário
187
- │ │
188
- │ ▼
189
- │ ┌─────────────┐
190
- │ │ Triage │──► Classifica intenção
191
- │ └─────────────┘
192
- │ │
193
- ├──────────┬──────────┬──────────┬──────────┐
194
- │ ▼
195
- ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐
196
- Flow │ │Knowledge│ │Confirm │ │ Usage │ │Onboard
197
- └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘
198
- │ │
199
-
200
- ┌─────────────┐
201
- Interview │──► Coleta informações │
202
- └─────────────┘
203
-
204
-
205
- ┌─────────────┐
206
- Answer │──► Resposta final │
207
- └─────────────┘
208
-
209
- └─────────────────────────────────────────────────────────────────┘
182
+ ┌────────────────────────────────────────────────────────────────────────────┐
183
+ ATENDENTEPRO
184
+ ├────────────────────────────────────────────────────────────────────────────┤
185
+
186
+ │ 👤 Usuário
187
+ │ │
188
+ │ ▼
189
+ │ ┌─────────────┐
190
+ │ │ Triage │──► Classifica intenção
191
+ │ └─────────────┘
192
+ │ │
193
+ ┌────┴────┬─────────┬─────────┬─────────┬─────────┬─────────┬────────┐
194
+ ▼ ▼
195
+ ┌──────┐ ┌───────┐ ┌───────┐ ┌───────┐ ┌───────┐ ┌───────┐ ┌───────┐
196
+ Flow │ │Knowl. │ │Confirm│ │ Usage │ │Onboard│ Escala.│ │Feedbk.│ │
197
+ └──────┘ └───────┘ └───────┘ └───────┘ └───────┘ └───────┘ └───────┘
198
+ │ │
199
+ Todos os agentes podem escalar ─────────►│
200
+ ou registrar feedback ──────────────────────────────► │
201
+
202
+ ┌─────────────┐
203
+ Interview │──► Coleta informações
204
+ └─────────────┘
205
+
206
+
207
+ ┌─────────────┐
208
+ Answer │──► Resposta final │
209
+ │ └─────────────┘ │
210
+ │ │
211
+ │ ═══════════════════════════════════════════════════════════════════════ │
212
+ │ 📞 Escalation ──► Transfere para atendimento humano IMEDIATO │
213
+ │ 📝 Feedback ──► Registra tickets para resposta POSTERIOR │
214
+ │ │
215
+ └────────────────────────────────────────────────────────────────────────────┘
210
216
  ```
211
217
 
212
218
  ---
@@ -223,6 +229,8 @@ asyncio.run(main())
223
229
  | **Confirmation** | Valida com respostas sim/não |
224
230
  | **Usage** | Responde dúvidas sobre o sistema |
225
231
  | **Onboarding** | Cadastro de novos usuários |
232
+ | **Escalation** | Transfere para atendimento humano quando necessário |
233
+ | **Feedback** | Registra dúvidas, feedbacks, reclamações e sugestões |
226
234
 
227
235
  ---
228
236
 
@@ -231,18 +239,24 @@ asyncio.run(main())
231
239
  Templates são configurações YAML que personalizam o comportamento dos agentes:
232
240
 
233
241
  ```
234
- client_templates/
235
- ├── standard/ # Template base
236
- ├── triage_config.yaml
237
- ├── flow_config.yaml
238
- ├── interview_config.yaml
239
- │ └── ...
242
+ templates/ # ✅ Templates genéricos (incluídos no repositório)
243
+ └── standard/ # Template de exemplo
244
+ ├── triage_config.yaml
245
+ ├── flow_config.yaml
246
+ ├── escalation_config.yaml
247
+ ├── feedback_config.yaml
248
+ └── ...
249
+
250
+ client_templates/ # 🔒 Templates de clientes (não incluídos no repositório)
240
251
  └── meu_cliente/ # Template customizado
241
252
  ├── triage_config.yaml
242
253
  ├── tools.py # Tools customizadas
243
254
  └── network.py # Rede específica
244
255
  ```
245
256
 
257
+ > **Nota:** A pasta `templates/` contém exemplos genéricos e é incluída no repositório.
258
+ > A pasta `client_templates/` contém configurações de clientes e está no `.gitignore`.
259
+
246
260
  Veja a [documentação completa](atendentepro/README.md) para criar templates.
247
261
 
248
262
  ---
@@ -1,10 +1,12 @@
1
- atendentepro/README.md,sha256=2JWtLfG01zu8IO7Zo0AZOLSJoxNcWlrzgv4CYQML4I8,24619
2
- atendentepro/__init__.py,sha256=m8djGtMGG-EAm43h6J0NxGC7xqObG4_90RyT5vCDMks,4794
1
+ atendentepro/README.md,sha256=fMkuZTbPbsW30u8ICidR2eGxEpi0u6COsyTjy3CHtHo,43006
2
+ atendentepro/__init__.py,sha256=AKiIp9o6ktPE-UU1HfcBQaAZgXbMThe7FF2SDBHBF5c,5148
3
3
  atendentepro/license.py,sha256=AGi2ePm28kUak0ekzZ-0Fulg2Q2IOrmVEOS69zDLT58,17567
4
- atendentepro/network.py,sha256=YgSw6LYvSmFUPztHOK7MR5LrMlyBtBCWobizTNOhCr0,10266
5
- atendentepro/agents/__init__.py,sha256=_05UyG04mTlwgZ56ymGI6lavIFQq_qyKWSsK4H1v4uY,1236
6
- atendentepro/agents/answer.py,sha256=4uiuih8cSBUNqPWwN4TfCilnBOfAYhOtpj8bCZQ0Lpk,2023
4
+ atendentepro/network.py,sha256=CHJVoggOE--LzVvR1XROtjeFqnwJctP2L4dHgCVCXXE,14419
5
+ atendentepro/agents/__init__.py,sha256=OcPhG1Dp6xe49B5YIti4HVmaZDoDIrFLfRa8GmI4jpQ,1638
6
+ atendentepro/agents/answer.py,sha256=dIZzGL_ddjC96JIiWSwDg33phwca8NpWFxO16FFYVoA,1905
7
7
  atendentepro/agents/confirmation.py,sha256=5Zg4z9A90CydYiEk8CEAKnnza71algFKF-N1WLwGDQI,2311
8
+ atendentepro/agents/escalation.py,sha256=YNA2e1Si30FJoIJkpos3B9imaR_Q6uv9K2o-F-Ht8rQ,17190
9
+ atendentepro/agents/feedback.py,sha256=xTFANEkFQaYIYQxlD6_hxTGAxfGUVwTM-rnfN0gT78Y,32996
8
10
  atendentepro/agents/flow.py,sha256=qWuPcjfm2peWjpHFUiq0P1blRk500LUUucb2Z9kT95Q,2056
9
11
  atendentepro/agents/interview.py,sha256=Tegfh3ZTr7__b_a0elyfn57u56yuS2pN_RB-8vOt-Os,2133
10
12
  atendentepro/agents/knowledge.py,sha256=M8XOJ_yxYRyuCaBxn-xFCCWE-MTx5bjyUi4-E2tSPL8,10080
@@ -18,9 +20,11 @@ atendentepro/guardrails/manager.py,sha256=KeyQkIfyPYuHIbuCPP-N4y2R3AJ6n2thkEO_av
18
20
  atendentepro/models/__init__.py,sha256=eUMq0Lw21PGItGliKHxFDeETIqOVqEwkXVOjgJPM5I0,390
19
21
  atendentepro/models/context.py,sha256=1WsoHEtXodgfd5JyZDZctV_2uabNq_XAKv0HKmWb-G8,543
20
22
  atendentepro/models/outputs.py,sha256=B573co699DhK0TSpqOHUykUOnBVa2Ool4rnNEO-xmUA,3270
21
- atendentepro/prompts/__init__.py,sha256=hoO_mqZ6XwdfnUUOUSYJ8LaHR6pQArh7IhNtHZRq5UQ,1026
22
- atendentepro/prompts/answer.py,sha256=nFaSDXWKLchk2kxN3ID6OfhOZBh7qLYD7y6bFlDYer8,4099
23
+ atendentepro/prompts/__init__.py,sha256=pks7i00GXGM9J3UnZyCn4dDVLb4C8xSJ_yWAvpK3OM4,1390
24
+ atendentepro/prompts/answer.py,sha256=0VBKRzOXXlxg0IfIq1Et0XlDpX3akKASNb9NY_pesuM,3916
23
25
  atendentepro/prompts/confirmation.py,sha256=zt1Ekl8ZVrAAKZ9xZHa3R343JG9VzuZVJYt1jZCg2jg,4141
26
+ atendentepro/prompts/escalation.py,sha256=KAG1saHTnXEcZO44WNcdn8JdvSHS46otreYWk7kMTmg,5600
27
+ atendentepro/prompts/feedback.py,sha256=PGDYz56_iOqvsttc_ZdRipUO_14DXLdmmzMHUldYPno,7111
24
28
  atendentepro/prompts/flow.py,sha256=BCuaiaZLZBrS3X4Lxo80JS8a94w-mmxlXwqE1259R_c,4078
25
29
  atendentepro/prompts/interview.py,sha256=9zVGA8zSmm6pBx2i1LPGNJIPuLlz7PZKRJE_PC6J7UI,3988
26
30
  atendentepro/prompts/knowledge.py,sha256=B3BOyAvzQlwAkR51gc-B6XbQLtwIZlwGP1ofhZ4cFbk,4644
@@ -31,9 +35,9 @@ atendentepro/templates/manager.py,sha256=KdE4khWDMD2S607TDTMkvJ8lZzQ9D_TD_lBaXYS
31
35
  atendentepro/utils/__init__.py,sha256=6EgS4DrW4fG17JdaHNKWMpzicigfFLVJO2VxPV73k9c,334
32
36
  atendentepro/utils/openai_client.py,sha256=R0ns7SU36vTgploq14-QJMTke1pPxcAXlENDeoHU0L4,4552
33
37
  atendentepro/utils/tracing.py,sha256=HQ3l4IiNcesCJ6l5qcERWyeBQav0G1ea-H8Rei6eQpE,2319
34
- atendentepro-0.3.0.dist-info/licenses/LICENSE,sha256=flIcFQ143WYRO80xQ0AaAlRdBbAJ6Y8zeLTdfYU5XsQ,976
35
- atendentepro-0.3.0.dist-info/METADATA,sha256=GUfKlkhORpcpDbgQT9J3ejsfvN59xkArOf2FiEnLccA,10258
36
- atendentepro-0.3.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
37
- atendentepro-0.3.0.dist-info/entry_points.txt,sha256=OP0upzqJF3MLS6VX-M-5BfUwx5YLJO2sJ3YBAp4e6yI,89
38
- atendentepro-0.3.0.dist-info/top_level.txt,sha256=BFasD4SMmgDUmWKlTIZ1PeuukoRBhyiMIz8umKWVCcs,13
39
- atendentepro-0.3.0.dist-info/RECORD,,
38
+ atendentepro-0.5.1.dist-info/licenses/LICENSE,sha256=flIcFQ143WYRO80xQ0AaAlRdBbAJ6Y8zeLTdfYU5XsQ,976
39
+ atendentepro-0.5.1.dist-info/METADATA,sha256=UYXIwSrk_BEWpKvRH7VxHsGlMc1W-AeUG4WLyZwvLBs,12023
40
+ atendentepro-0.5.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
41
+ atendentepro-0.5.1.dist-info/entry_points.txt,sha256=OP0upzqJF3MLS6VX-M-5BfUwx5YLJO2sJ3YBAp4e6yI,89
42
+ atendentepro-0.5.1.dist-info/top_level.txt,sha256=BFasD4SMmgDUmWKlTIZ1PeuukoRBhyiMIz8umKWVCcs,13
43
+ atendentepro-0.5.1.dist-info/RECORD,,