Pular para o conteúdo

04-nichos — Variações por Mercado e Setor

Mesmo agente (ex: agent-sdr), em nichos diferentes (saúde vs e-commerce vs B2B), tem comportamentos diferentes. Este diretório documenta as variações por nicho.

Princípio

A diferença entre nichos não justifica produto novo, mas justifica playbook específico:

  • Tom diferente
  • Tools enfatizadas diferentes
  • Fluxos adaptados
  • Knowledge base específica do setor
  • Pricing diferente

Mesmo template, mesmo código. Só muda o playbook.yaml e o prompt_overrides.md.

Como o sistema de playbooks funciona

agent-sdr/
├── src/
│ └── config/
│ └── playbooks/ ← Playbooks por nicho
│ ├── saude.yaml
│ ├── b2b_servicos.yaml
│ ├── ecommerce.yaml
│ ├── infoproduto.yaml
│ └── ...
└── tenants/
└── usa_salus/
├── config.yaml ← Cliente
└── playbook.yaml ← Override do nicho

No config.yaml do tenant:

tenants/usa_salus/config.yaml
playbook: saude # carrega src/config/playbooks/saude.yaml

O loader carrega:

  1. default_config.yaml (defaults do tipo de agente)
  2. playbooks/{playbook}.yaml (specifics do nicho)
  3. tenants/{id}/config.yaml (overrides do cliente)

Em ordem, cada um sobrescreve o anterior.

Catálogo de nichos

NichoDocumentaçãoPlaybook
Saúde (clínicas, terapeutas)saude.mdplaybooks/saude.yaml
Beleza e estéticabeleza-estetica.mdplaybooks/beleza.yaml
Educação (cursos, escolas)educacao.mdplaybooks/educacao.yaml
E-commerceecommerce.mdplaybooks/ecommerce.yaml
B2B serviçosb2b-servicos.mdplaybooks/b2b_servicos.yaml
SaaSsaas.mdplaybooks/saas.yaml
Infoprodutoinfoproduto.mdplaybooks/infoproduto.yaml

Quando criar nicho novo

Crie playbook de nicho novo quando:

  • ✅ 3+ clientes do mesmo setor
  • ✅ Padrões claros de tom/fluxo/tools
  • ✅ Demanda recorrente de personalização similar

Não crie quando:

  • ❌ Cliente único é “diferente”
  • ❌ Pequenas diferenças (resolva no config.yaml do tenant)
  • ❌ Sem demanda real

Estrutura de cada documento de nicho

Cada 04-nichos/{nicho}.md contém:

  1. Características do nicho — o que define este mercado
  2. Padrões de comunicação — como o público fala e espera ser tratado
  3. Padrões de produto/serviço — o que é vendido tipicamente
  4. Tom e linguagem ideal
  5. Fluxo adaptado — variações específicas do nicho
  6. Tools enfatizadas
  7. Compliance específico — saúde tem CFM, financeiro tem BACEN, etc
  8. Casos de sucesso anonimizados — exemplos do portfólio Triadeflow
  9. Pricing típico do nicho
  10. Playbook YAML completo — pronto para usar