HaaS — Deploy Guide

1 Criar o YAML de configuração

Monte um YAML com as informações do agente. Não inclua porta — o haas_deploy.py da Mirna CC decide automaticamente a próxima porta disponível.

# config.yaml — Configuração do Agente HaaS
name: eva
team: collection
area: Collection
jira_project: CAIX
persona: >-
  Cobrança empática. Foco na recuperação
  de inadimplência com tom profissional e humano.
usuario: Solange
canais:
  - slack
  - telegram
skills:
  - collection-queries
  - eva-cartilha-collection
profiles:
  - EVA
model: deepseek/deepseek-v4-pro
crons:
  - schedule: "0 8 * * *"
    prompt: Gere o report diário de acordos e envie no Slack #collection
    deliver: slack:C028TDGD77V
    model: google/gemini-2.5-flash
    enabled: true
  - schedule: "*/30 8-21 * * 1-5"
    prompt: Sincronize cache de acordos e massivos
    deliver: local
    no_agent: true
    enabled: true

Campos do YAML:

• name — nome do agente (lowercase, sem espaços) ✓ obrigatório
• team — time/área slugificado (ex: collection, finance) ✓ obrigatório
• area — nome da área por extenso (ex: "Collection", "Customer Success") ✓ obrigatório
• jira_project — key do projeto Jira (ex: CAIX, OB2, FINC) ✓ obrigatório
• persona — descrição da personalidade e tom do agente ✓ obrigatório
• usuario — nome da pessoa responsável pelo agente ✓ obrigatório
• canais — canais de comunicação: "slack", "telegram" ou ambos opcional
• skills — lista de skills para o agente opcional
• profiles — lista de sub-agentes/profiles opcional
• crons — tarefas agendadas opcional
  • schedule — expressão cron (ex: "0 8 * * *")
  • prompt — instrução que o agente executa
  • deliver — destino: "slack:CHANNEL_ID", "telegram:CHAT_ID" ou "local"
  • model — modelo LLM (default: mesmo do agente). Para tarefas mecânicas, use "google/gemma-4-26b-a4b-it"
  • no_agent — true para tarefas mecânicas (zero tokens, só roda script)
  • enabled — true (default) ou false

2 Chamar a Mirna CC

Envie o YAML para a Mirna CC com a instrução de deploy. Exemplo de mensagem:

Mirna CC, faz o deploy de um novo agente com essa config:

name: eva
team: collection
area: Collection
jira_project: CAIX
persona: >-
  Cobrança empática. Foco na recuperação.
usuario: Solange
canais:
  - slack
  - telegram
skills:
  - collection-queries
  - eva-cartilha-collection
profiles:
  - EVA
crons:
  - schedule: "0 8 * * *"
    prompt: Report diário de acordos → Slack #collection
    deliver: slack:C028TDGD77V
    enabled: true

Fluxo automático que a Mirna CC executa:

flowchart LR
    A["📋 YAML do Usuário"] --> B["🔍 Valida Config"]
    B --> C["🔢 Aloca Porta"]
    C --> D["🐳 Gera Compose"]
    D --> E["📝 Cria .env"]
    E --> F["📦 Build + Up"]
    F --> G["❤️ Health Check"]
    G --> H["✅ Agente Online!"]
        

• ✅ Aloca a próxima porta disponível
• ✅ Gera o docker-compose.yml com project name correto
• ✅ Cria o .env com todas as variáveis (Jira, Slack, Telegram)
• ✅ Cria os volumes externos nomeados
• ✅ Builda a imagem e sobe o container
• ✅ Verifica health check
• ✅ Atualiza o Architecture Diagram no portal
• ✅ Configura os bots Slack/Telegram se solicitado

3 Verificar

Após o deploy, confirme com a Mirna CC que o agente está saudável:

Mirna CC, verifica se o agente Eva está online

Se precisar checar manualmente:

# Health check (porta alocada pela Mirna CC)
curl http://localhost:{porta}/health

# Logs
docker logs {name}-{team}-1

# Status geral
docker ps --format "table {{.Names}}\t{{.Status}}\t{{.Ports}}"

Exemplo completo — Agente de Finance

name: finc
team: finance
area: Finance
jira_project: FINC
persona: >-
  Analista financeiro preciso e organizado.
  Foco em conciliação, relatórios e compliance.
usuario: Ricardo
canais:
  - slack
skills:
  - databricks-query
  - hubspot-query
profiles:
  - FINC
crons:
  - schedule: "0 9 * * 1-5"
    prompt: Conciliação diária — alerte discrepâncias no Slack #finance
    deliver: slack:C_FINANCE_ID
    enabled: true

🔀 Escolha o método

📋 Canais e Comportamento

Criando canais

1. + Add Channel na sidebar
2. Nome descritivo (ex: #collection-eva)
3. Adicione o time
4. Adicione o bot: digite @nomedobot → "Invite to Channel"

Padrão de resposta

⚠️ Troubleshooting

✅ Checklist

1 Criar bot via BotFather

No Telegram, converse com @BotFather:

• Envie /newbot
• Dê um nome (ex: "Eva — Collection CondoConta")
• Dê um username (ex: eva_condoconta_bot)
• Copie o API Token retornado (formato: 123456:ABC-DEF...)

2 Personalizar o bot

Envie comandos ao BotFather para refinar:

• /setdescription — descrição do agente
• /setabouttext — texto "Sobre"
• /setuserpic — avatar do agente
• /setcommands — comandos disponíveis (ex: status — Verificar status do agente)

3 Pedir ao agente para configurar

Envie o token para o seu agente:

Eva, configura o Telegram com esse token:

Token: 123456:ABC-DEF1234...

O agente configura automaticamente:

• ✅ Adiciona o token ao .env
• ✅ Ativa o gateway Telegram no config
• ✅ Redeploya o container

4 Testar

Abra o bot no Telegram e envie uma mensagem. O agente deve responder com sua persona configurada.

Como funciona

Todos os agentes Mirna HaaS compartilham a mesma credencial Jira (email + API token do Atlassian). Cada agente trabalha no projeto da sua área:

Área          Jira Project
─────────────────────────
Collection    CAIX
Tesouraria    OB2
Finance       FINC
Sales/Comerc  RAIX
CX            CX
CS            CS
Atendimento   ATD
People        PPL
Produto       PROD
AI Expert     COM
        

Adicionar Jira ao seu agente

Se o agente já está rodando e precisa de acesso Jira (ou trocar de projeto), peça direto a ele:

Eva, configura o Jira com o projeto CAIX

O agente configura automaticamente:

• ✅ Adiciona a credencial Jira ao .env
• ✅ Configura o projeto no profile
• ✅ Redeploya o container

Trocar projeto Jira

Se o agente mudou de área ou precisa acessar outro projeto:

Eva, troca o projeto Jira de CAIX para OB2

Skills

Skills são arquivos SKILL.md que ensinam o agente a executar tarefas específicas. Peça ao seu agente para adicionar:

Eva, adiciona essas skills:

- collection-queries
- eva-cartilha-collection
- databricks-query

O agente instala as skills no profile e redespliega se necessário.

👥 Profiles (Sub-agentes)

Profiles são sub-personalidades especializadas — cada uma com persona, skills e histórico isolados.

Por que usar?

Exemplos na CondoConta

Criar um profile

Eva, cria um profile "rod" para o Rodrigo:

Persona: Product Manager técnico, foco em clareza e execução.
Skills: prd-creation, jira-issue-manager, confluence-search

O agente cria o diretório, adiciona SOUL.md, linka skills e redespliega.

Listar skills disponíveis

Eva, lista as skills disponíveis

O agente mostra todas as skills instaladas e as que podem ser adicionadas.