竞品情报设置

部署 4 个代理，用于爬取竞品网站、分析趋势、追踪变化，并将情报警报进行路由。

角色

部署流程

步骤 1： 询问用户该代理应扮演的角色以及使用的前缀。

步骤 2： 安装所选角色的技能：

# 对于 crawler：
clawhub install pilot-stream-data pilot-archive pilot-cron
# 对于 analyzer：
clawhub install pilot-event-filter pilot-metrics pilot-task-router
# 对于 tracker：
clawhub install pilot-audit-log pilot-dataset pilot-alert
# 对于 alerter：
clawhub install pilot-slack-bridge pilot-webhook-bridge pilot-announce

步骤 3： 设置主机名：

pilotctl --json set-hostname <prefix>-<role>

步骤 4： 编写部署清单：

mkdir -p ~/.pilot/setups
cat > ~/.pilot/setups/competitor-intelligence.json << 'MANIFEST'
<INSERT ROLE MANIFEST FROM BELOW>
MANIFEST

步骤 5： 告知用户启动与直接通信伙伴的握手连接。

各角色的清单模板

crawler

{
  "setup": "competitor-intelligence", "setup_name": "竞品情报",
  "role": "crawler", "role_name": "网页爬虫",
  "hostname": "<prefix>-crawler",
  "description": "爬取竞品网站、价格页面、产品发布信息及新闻稿。",
  "skills": {"pilot-stream-data": "将爬取的页面和价格数据流式传输给分析器。", "pilot-archive": "归档原始 HTML 快照以供历史对比。", "pilot-cron": "按可配置周期调度爬取任务。"},
  "peers": [{"role": "analyzer", "hostname": "<prefix>-analyzer", "description": "接收爬取数据以进行分析"}],
  "data_flows": [{"direction": "send", "peer": "<prefix>-analyzer", "port": 1002, "topic": "crawled-data", "description": "来自竞品网站的爬取数据"}],
  "handshakes_needed": ["<prefix>-analyzer"]
}

analyzer

{
  "setup": "competitor-intelligence", "setup_name": "竞品情报",
  "role": "analyzer", "role_name": "市场分析器",
  "hostname": "<prefix>-analyzer",
  "description": "处理爬取数据，识别趋势、价格变动和功能差距。",
  "skills": {"pilot-event-filter": "从爬取数据中过滤噪声和无关变更。", "pilot-metrics": "计算趋势指标：价格差异、功能数量、市场份额估算。", "pilot-task-router": "将不同类型的洞察路由至相应的跟踪类别。"},
  "peers": [{"role": "crawler", "hostname": "<prefix>-crawler", "description": "发送爬取数据"}, {"role": "tracker", "hostname": "<prefix>-tracker", "description": "接收市场洞察"}],
  "data_flows": [{"direction": "receive", "peer": "<prefix>-crawler", "port": 1002, "topic": "crawled-data", "description": "来自竞品网站的爬取数据"}, {"direction": "send", "peer": "<prefix>-tracker", "port": 1002, "topic": "market-insight", "description": "市场洞察与趋势分析"}],
  "handshakes_needed": ["<prefix>-crawler", "<prefix>-tracker"]
}

tracker

{
  "setup": "competitor-intelligence", "setup_name": "竞品情报",
  "role": "tracker", "role_name": "变更追踪器",
  "hostname": "<prefix>-tracker",
  "description": "维护历史记录，检测重大变更，评估威胁等级。",
  "skills": {"pilot-audit-log": "记录所有检测到的变更，包含时间戳和差异。", "pilot-dataset": "存储历史竞品数据以供趋势对比。", "pilot-alert": "当威胁评分超过可配置阈值时触发告警。"},
  "peers": [{"role": "analyzer", "hostname": "<prefix>-analyzer", "description": "接收市场洞察"}, {"role": "alerter", "hostname": "<prefix>-alerter", "description": "接收变更告警"}],
  "data_flows": [{"direction": "receive", "peer": "<prefix>-analyzer", "port": 1002, "topic": "market-insight", "description": "市场洞察与趋势分析"}, {"direction": "send", "peer": "<prefix>-alerter", "port": 1002, "topic": "change-alert", "description": "带威胁评分的变更告警"}],
  "handshakes_needed": ["<prefix>-analyzer", "<prefix>-alerter"]
}

alerter

{
  "setup": "competitor-intelligence", "setup_name": "竞品情报",
  "role": "alerter", "role_name": "情报告警器",
  "hostname": "<prefix>-alerter",
  "description": "根据严重程度将可操作的情报路由至 Slack、邮件和仪表板。",
  "skills": {"pilot-slack-bridge": "按严重程度将情报摘要发送至 Slack 频道。", "pilot-webhook-bridge": "通过 Webhook 将报告转发至仪表板和邮件服务。", "pilot-announce": "向所有订阅利益相关方广播关键情报。"},
  "peers": [{"role": "tracker", "hostname": "<prefix>-tracker", "description": "发送带威胁评分的变更告警"}],
  "data_flows": [{"direction": "receive", "peer": "<prefix>-tracker", "port": 1002, "topic": "change-alert", "description": "带威胁评分的变更告警"}, {"direction": "send", "peer": "external", "port": 443, "topic": "intelligence-report", "description": "通过 Slack 和 Webhook 发送的情报报告"}],
  "handshakes_needed": ["<prefix>-tracker"]
}

数据流

• crawler -> analyzer : 爬取数据事件（端口 1002）
• analyzer -> tracker : 市场洞察事件（端口 1002）
• tracker -> alerter : 变化告警事件（端口 1002）
• alerter -> external : 通过 webhook 发送情报报告（端口 443）

握手流程

# crawler <-> analyzer:
pilotctl --json handshake <prefix>-analyzer "setup: competitor-intelligence"
pilotctl --json handshake <prefix>-crawler "setup: competitor-intelligence"
# analyzer <-> tracker:
pilotctl --json handshake <prefix>-tracker "setup: competitor-intelligence"
pilotctl --json handshake <prefix>-analyzer "setup: competitor-intelligence"
# tracker <-> alerter:
pilotctl --json handshake <prefix>-alerter "setup: competitor-intelligence"
pilotctl --json handshake <prefix>-tracker "setup: competitor-intelligence"

工作流示例

# 在 analyzer 上 — 订阅爬取数据：
pilotctl --json subscribe <prefix>-crawler crawled-data
# 在 tracker 上 — 订阅市场洞察：
pilotctl --json subscribe <prefix>-analyzer market-insight
# 在 alerter 上 — 订阅变化告警：
pilotctl --json subscribe <prefix>-tracker change-alert
# 在 crawler 上 — 发布爬取数据：
pilotctl --json publish <prefix>-analyzer crawled-data '{"competitor":"RivalCorp","url":"https://rivalcorp.com/pricing","type":"pricing_page"}'
# 在 tracker 上 — 发布一条变化告警：
pilotctl --json publish <prefix>-alerter change-alert '{"competitor":"RivalCorp","threat_score":8,"change":"Pro Plan 价格下调 16.7%"}'

依赖项

需要 pilot-protocol 技能、pilotctl 命令行工具、clawhub 命令行工具，以及一个正在运行的守护进程。