Skills — Automações por Agentes

/workspace/skills/
  scripts/
    weekly-health-report.yaml    # Metadados e configuração
    weekly-health-report.py      # Script Python

name: weekly-health-report
description: "Gera relatório semanal de health score da carteira de clientes e envia para o canal #cs-alerts no Slack"
version: "1.0.0"
runtime: python3.12

# Parâmetros que o agente pode passar ao invocar a skill
parameters:
  - name: min_health_score
    type: integer
    default: 60
    description: "Score mínimo para incluir uma conta no relatório de risco"
  - name: slack_channel
    type: string
    default: "#cs-alerts"
    description: "Canal Slack para envio do relatório"

# Segredos necessários (nunca em plaintext — referenciados pelo nome)
secrets:
  - SLACK_BOT_TOKEN
  - MEMORY_API_KEY

# Timeout máximo de execução
timeout_seconds: 120

import os
import requests
from slack_sdk import WebClient

def run(params: dict, secrets: dict) -> dict:
    """
    Consulta a Memory API para obter perfis de clientes,
    filtra por health score e envia relatório ao Slack.
    """
    memory_api = os.environ.get("MEMORY_API_URL", "http://strattum-memory-api:8002")
    
    # Consultar entidades com health score abaixo do threshold
    response = requests.get(
        f"{memory_api}/v1/memory/entities",
        headers={"Authorization": f"Bearer {secrets['MEMORY_API_KEY']}"},
        params={"type": "cliente", "max_health_score": params["min_health_score"]}
    )
    
    clientes_risco = response.json()["entities"]
    
    if not clientes_risco:
        return {"status": "ok", "message": "Nenhuma conta em risco encontrada."}
    
    # Montar relatório
    linhas = [f"*Relatório de Risco — {len(clientes_risco)} contas abaixo de {params['min_health_score']}*\n"]
    for cliente in clientes_risco[:10]:  # máximo 10 por relatório
        linhas.append(f"• {cliente['name']} — score: {cliente['health_score']} | CS: {cliente['owner']}")
    
    # Enviar ao Slack
    slack = WebClient(token=secrets["SLACK_BOT_TOKEN"])
    slack.chat_postMessage(
        channel=params["slack_channel"],
        text="\n".join(linhas)
    )
    
    return {"status": "ok", "accounts_reported": len(clientes_risco)}

Usuário: Execute o relatório semanal de saúde da carteira para o canal #cs-alerts.

Agente: [chama run_skill com nome="weekly-health-report" e parâmetros]
        Relatório enviado para #cs-alerts. 8 contas estão abaixo do score 70. 
        Top 3 riscos: TechCorp (score 52), FinServ (score 58), DataCo (score 61).

POST /v1/skills/run
{
  "skill": "weekly-health-report",
  "parameters": {
    "min_health_score": 65,
    "slack_channel": "#cs-critico"
  }
}

{
  "SLACK_BOT_TOKEN": {
    "description": "Bot token do Slack para envio de notificações",
    "created_at": "2026-03-15"
  },
  "MEMORY_API_KEY": {
    "description": "Chave de acesso à Memory API",
    "created_at": "2026-03-15"
  }
}