广告活动管理器（Ad Campaign Manager）部署

部署 4 个智能体（agent），实现从策略制定、出价管理到效果分析的广告活动全流程自动化。

角色说明

部署流程

步骤 1： 向用户询问该智能体应承担的角色以及所用前缀（prefix）。

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

# strategist：
clawhub install pilot-task-router pilot-dataset pilot-cron
# creative：
clawhub install pilot-share pilot-task-parallel pilot-receipt
# bidder：
clawhub install pilot-metrics pilot-stream-data pilot-escrow
# analyst：
clawhub install pilot-event-filter pilot-slack-bridge pilot-webhook-bridge

步骤 3： 设置主机名：

pilotctl --json set-hostname -

步骤 4： 编写部署清单文件（setup manifest）：

mkdir -p ~/.pilot/setups
cat > ~/.pilot/setups/ad-campaign-manager.json << 'MANIFEST'

MANIFEST

步骤 5： 提示用户与直连通信对等体（direct communication peers）发起握手（handshake）。

各角色对应的清单模板

strategist

{"setup":"ad-campaign-manager","setup_name":"Ad Campaign Manager","role":"strategist","role_name":"Campaign Strategist","hostname":"-strategist","description":"Defines target audiences, budgets, channel mix, and KPIs for ad campaigns.","skills":{"pilot-task-router":"Route campaign briefs to creative based on channel and format.","pilot-dataset":"Store audience segments, budget allocations, and historical KPIs.","pilot-cron":"Schedule campaign launches and budget review cycles."},"peers":[{"role":"creative","hostname":"-creative","description":"Receives campaign briefs and produces ad variations"},{"role":"analyst","hostname":"-analyst","description":"Sends performance insights and optimization recommendations"}],"data_flows":[{"direction":"send","peer":"-creative","port":1002,"topic":"campaign-brief","description":"Campaign briefs with audiences, budgets, and KPIs"},{"direction":"receive","peer":"-analyst","port":1002,"topic":"performance-insight","description":"Performance insights and optimization recommendations"}],"handshakes_needed":["-creative","-analyst"]}

creative

{"setup":"ad-campaign-manager","setup_name":"Ad Campaign Manager","role":"creative","role_name":"Creative Producer","hostname":"-creative","description":"Generates ad copy, headlines, and creative briefs. A/B tests variations across formats.","skills":{"pilot-share":"Send creative assets downstream to the bid manager.","pilot-task-parallel":"Run A/B test variations in parallel across formats.","pilot-receipt":"Acknowledge receipt of campaign briefs from strategist."},"peers":[{"role":"strategist","hostname":"-strategist","description":"Sends campaign briefs"},{"role":"bidder","hostname":"-bidder","description":"Receives creative assets for bidding"}],"data_flows":[{"direction":"receive","peer":"-strategist","port":1002,"topic":"campaign-brief","description":"Campaign briefs with audiences, budgets, and KPIs"},{"direction":"send","peer":"-bidder","port":1002,"topic":"creative-asset","description":"Creative assets with A/B variants and targeting params"}],"handshakes_needed":["-strategist","-bidder"]}

bidder

{"setup":"ad-campaign-manager","setup_name":"Ad Campaign Manager","role":"bidder","role_name":"Bid Manager","hostname":"-bidder","description":"Manages real-time bidding, adjusts bids based on performance, optimizes spend across channels.","skills":{"pilot-metrics":"Track bid performance — CPM, CPC, conversion rates per channel.","pilot-stream-data":"Stream real-time auction data and bid adjustments.","pilot-escrow":"Manage budget holds and spend reconciliation across channels."},"peers":[{"role":"creative","hostname":"-creative","description":"Sends creative assets"},{"role":"analyst","hostname":"-analyst","description":"Receives bid results for analysis"}],"data_flows":[{"direction":"receive","peer":"-creative","port":1002,"topic":"creative-asset","description":"Creative assets with A/B variants and targeting params"},{"direction":"send","peer":"-analyst","port":1002,"topic":"bid-result","description":"Bid results with spend, impressions, and click data"}],"handshakes_needed":["-creative","-analyst"]}

analyst

{"setup":"ad-campaign-manager","setup_name":"Ad Campaign Manager","role":"analyst","role_name":"Performance Analyst","hostname":"-analyst","description":"Tracks conversions, ROAS, CTR. Generates reports and optimization recommendations.","skills":{"pilot-event-filter":"Filter bid events by channel, campaign, and performance threshold.","pilot-slack-bridge":"Post campaign performance summaries and alerts to Slack.","pilot-webhook-bridge":"Push campaign reports to external dashboards and stakeholders."},"peers":[{"role":"bidder","hostname":"-bidder","description":"Sends bid results"},{"role":"strategist","hostname":"-strategist","description":"Receives performance insights for campaign refinement"}],"data_flows":[{"direction":"receive","peer":"-bidder","port":1002,"topic":"bid-result","description":"Bid results with spend, impressions, and click data"},{"direction":"send","peer":"-strategist","port":1002,"topic":"performance-insight","description":"Performance insights and optimization recommendations"},{"direction":"send","peer":"external","port":443,"topic":"campaign-report","description":"Campaign reports to dashboards and stakeholders"}],"handshakes_needed":["-bidder","-strategist"]}

数据流向

• strategist → creative：campaign-brief（端口 1002）
• creative → bidder：creative-asset（端口 1002）
• bidder → analyst：bid-result（端口 1002）
• analyst → strategist：performance-insight（端口 1002）
• analyst → external：campaign-report（通过 webhook，端口 443）

握手命令

# strategist ↔ creative：
pilotctl --json handshake -creative "setup: ad-campaign-manager"
pilotctl --json handshake -strategist "setup: ad-campaign-manager"
# creative ↔ bidder：
pilotctl --json handshake -bidder "setup: ad-campaign-manager"
pilotctl --json handshake -creative "setup: ad-campaign-manager"
# bidder ↔ analyst：
pilotctl --json handshake -analyst "setup: ad-campaign-manager"
pilotctl --json handshake -bidder "setup: ad-campaign-manager"
# analyst ↔ strategist（反馈闭环）：
pilotctl --json handshake -strategist "setup: ad-campaign-manager"
pilotctl --json handshake -analyst "setup: ad-campaign-manager"

工作流示例

# 在 creative 上 — 订阅 campaign briefs：
pilotctl --json subscribe -strategist campaign-brief
# 在 bidder 上 — 订阅 creative assets：
pilotctl --json subscribe -creative creative-asset
# 在 analyst 上 — 订阅 bid results：
pilotctl --json subscribe -bidder bid-result
# 在 strategist 上 — 订阅 performance insights：
pilotctl --json subscribe -analyst performance-insight
# 在 strategist 上 — 发布一条 campaign brief：
pilotctl --json publish -creative campaign-brief '{"campaign":"Summer Sale 2026","audience":{"age":"25-45"},"budget":15000,"channels":["google","meta"]}'

依赖项

需安装 pilot-protocol 技能、pilotctl 可执行文件、clawhub 可执行文件，并确保后台守护进程（daemon）正在运行。