PA 状态技能

最低模型要求

任意模型。状态检查为数据驱动、基于规则的判断。

执行时机

• 每日 09:00：向管理员发送全网状态报告。
• 发生账单错误时立即执行：仅针对受影响的 PA 发送部分报告。
• 按需执行：若管理员询问“当前状态如何？”，则立即生成报告。

状态检查项

对 data/pa-directory.json 中的每个 PA，检查以下字段：

自动化报告脚本

#!/usr/bin/env python3
import json
import datetime

# 加载 PA 目录
try:
    with open('data/pa-directory.json') as f:
        d = json.load(f)
except FileNotFoundError:
    print("ERROR: data/pa-directory.json not found")
    exit(1)

today = datetime.date.today().isoformat()
online = []
issues = []
offline = []

for pa in d.get('pas', []):
    name = pa['name']
    owner = pa['owner']
    status = pa.get('status', 'unknown')
    model = pa.get('model', 'unknown')

    # 格式化日历与账单状态标识符
    calendar = "✅" if pa.get('calendar_connected') else "❌"
    billing_ok = not pa.get('billing_error', False)
    billing = "✅" if billing_ok else "⚠️ billing error"

    # 将每个 PA 归类至 online / issues / offline
    if status == 'active' and billing_ok:
        online.append(f"• {name} ({owner}) — {model}, cal {calendar}")
    elif status == 'inactive':
        offline.append(f"• {name} ({owner})")
    else:
        issues.append(f"• {name} ({owner}) — {billing}")

# 打印报告
total = len(d.get('pas', []))
print(f"📊 PA Network Status — {today}\n")
print(f"✅ ONLINE ({len(online)}/{total})")
for line in online:
    print(line)

if issues:
    print("\n⚠️ ISSUES")
    for line in issues:
        print(line)

if offline:
    print("\n❌ OFFLINE")
    for line in offline:
        print(line)

if not issues and not offline:
    print("\nAll PAs are healthy 🎉")

目录结构（含状态字段）

在 pa-directory.json 的每个 PA 条目中添加以下字段：

{
  "name": "Aria",
  "phone": "+1XXXXXXXXXX",
  "owner": "Owner Name",
  "owner_email": "owner@company.com",
  "status": "active",
  "model": "your-llm-model",
  "last_seen": "2026-04-01T10:00:00Z",
  "calendar_connected": true,
  "billing_error": false,
  "billing_error_since": null
}

请将 "your-llm-model" 替换为实际模型 ID（例如："claude-haiku-20240307"、"gpt-4o-mini"、"gemini-1.5-flash"）。

快速 Ping（WhatsApp 可达性检测）

用于实时验证（在运行上述脚本之后）：

对 issues 列表中的每个 PA：
  发送消息："ping 🏓"
  最多等待 5 分钟
  若收到响应：标记为 ONLINE
  若无响应：标记为 NO_RESPONSE → 检查 whatsapp-diagnostics 和 billing-monitor 技能

规则：仅对已标记异常的 PA 执行 Ping；切勿对健康状态的 PA 执行 Ping —— 否则会产生干扰噪声。

调度策略

成本优化建议

• 成本极低：读取 JSON 文件并格式化报告所消耗的 token 极少。
• 小模型即可满足：任意模型均可生成该报告。
• 应避免：切勿一次性向所有 PA 发送 Ping —— 请逐个发送，以防触发速率限制（rate limits）。
• 推荐批处理：每日统一执行一次全量报告，而非单独轮询每个 PA。