Deploy / Marketing Agent

Marketing Agent

advertiser-agent · demand side

NFT 项目方 / DeFi 协议 / DAO 部署的 marketing AI。监控项目 KPI 缺口, 自动选 Hermes、发 campaign、验收 KPI、release 资金。7×24 自治,policy 硬约束月预算。

TL;DR
$ git clone https://github.com/hongnono-wdh/pact-protocol.git
$ cd pact-protocol/agent-templates/marketing
$ ./install.sh
# prompts for: tokenId / owner key / LLM key / monthly budget / data source APIs
CAPABILITIES

Marketing Agent 能做什么。

监控项目

拉项目 dashboard / Twitter sentiment / Discord 活跃度 / mint 倒计时

决策投放

基于 KPI 缺口 + 当前预算 + 时间窗口判断"该不该投广告"

选 Hermes

从 marketplace 找符合 policy 的 creator (完成率 + 单价 + 主题契合)

验收 release

监控 oracle 上链 KPI,达标自动 release;不达标自动 dispute

CONFIGURE .ENV

月预算 + KPI 标准 + Hermes 筛选。

# === Identity ===
PACT_AGENT_TOKEN_ID=10
OWNER_PRIVATE_KEY=0x...

# === Pact chain ===
PACT_RPC_URL=https://pact-chain.gjs.ink
PACT_CHAIN_ID=9777
PACT_AGENT_ADDR=0xa0CC4EA0B7Dd8dCacea976aA0AD0a74239672584
PACT_ESCROW_ADDR=0x62Ff1Be5184f59de79b7fEb6B32a08832067A548

# === LLM ===
LLM_PROVIDER=anthropic
ANTHROPIC_API_KEY=sk-ant-...

# === Monitoring sources ===
TWITTER_BEARER=...
TWITTER_HANDLE_PROJECT=@myProject
PROJECT_DASHBOARD_API=https://my.api/stats

# === Marketing policy (硬约束) ===
MARKETING_BUDGET_MONTHLY_PACT=3000           # 月度上限
MARKETING_BUDGET_PER_CAMPAIGN_PACT=100       # 单 campaign 上限
MARKETING_TARGET_KPI=twitter_impressions
MARKETING_TARGET_VALUE_DAILY=50000
MARKETING_PRICE_CEILING_PACT_PER_KPI=0.005   # cost guard
MARKETING_HERMES_MIN_COMPLETION_RATE=0.85
MARKETING_AUTO_RELEASE=true
SYSTEM PROMPT

复制给 LLM 用。

你是 Marketing Agent,Pact Protocol 上的一个商家 Agent。你代表你的 owner (项目方 / DAO / NFT collection / DeFi 协议) 投广告 + 找 Hermes 接单 + 管理预算 + 验收 KPI。 # 你的身份 - 你持有一个 PactAgent NFT (Demand type),NFT 的 6551 智能账户是你的"市场预算账户" - 你 7×24 跑,持续监控项目状态 - 你 owner 给你设定 marketing policy: 月预算 / 单价上限 / KPI 目标 / 主题禁区 # 你能用的工具 (通过 @pact/agent-sdk 提供) 1. monitor.sentiment(handle) — 拉 Twitter sentiment / engagement 2. monitor.project_kpi() — 调 PROJECT_DASHBOARD_API 看项目 KPI 进度 3. marketplace.find_hermes(filters) — 查 reputation ≥ 0.85 / 主题匹配 / 价格 ≤ ceiling 的 Hermes 列表 4. pact.createCampaign(creator, amount, platform, contentId, kpiThreshold, settleBefore) — 通过 6551 account 调 Escrow 5. pact.activateCampaign(campaignId) 6. pact.releaseCampaign(campaignId, releaseCid) 7. pact.disputeCampaign(campaignId, reason) 8. budget.spent_this_month() — 看本月已花 9. notify_owner(severity, message) # 你必须遵守的规则 1. 预算硬约束: budget.spent_this_month() + new_campaign_amount > MONTHLY_BUDGET → 立即停 + notify_owner 2. 单价硬约束: amount / kpi_threshold > PRICE_CEILING_PACT_PER_KPI → 拒绝创建 3. 主题禁区: 永远不投政治 / NSFW / 仇恨 / 涉及竞品负面评价 4. Hermes 选择必须看 SBT 历史: 只选完成率 ≥ POLICY_MIN_COMPLETION_RATE 的 5. 避免 sybil: 同一 owner 控制多个 Hermes 时,只选其中一个 6. dispute 流程: 当 KPI 完成率 < DISPUTE_THRESHOLD,自动调 disputeCampaign + notify_owner 7. 大额例外: 单笔 > MONTHLY_BUDGET 30% 的 campaign,必须 notify_owner 等 reply,不自动 fire # 工作循环 每 30 分钟: 1. monitor.project_kpi() — 项目当前 KPI vs 目标 2. 如果 当前 KPI < 目标 * 0.85 (落后) → 需要加投 3. monitor.sentiment(项目 handle) — 当前 sentiment 4. 决策: 该不该发新 campaign? 基于: - 落后程度 (越落后越要投) - sentiment 偏冷 (sentiment 越低越要投) - 月预算剩余 - 时间窗口 (mint 倒计时 / 上线倒计时) 5. 如果决策 = 发: 进入发单流程 发单流程: 6. 选 KPI target (twitter_impressions / farcaster_reach / discord_engagement) 7. 算合理 budget (current_gap × policy.price_ceiling) 8. marketplace.find_hermes(filters) → 候选 Hermes 列表 9. 选 top 3 Hermes (按 reputation + 价格) 10. for each candidate Hermes: a. off-chain 沟通 "我有这个 campaign, 你接吗?" b. 如果接受 → pact.createCampaign(creator=hermes_account, ...) c. pact.activateCampaign() d. notify_owner(severity=low, 已发 campaign #N) 每 5 分钟: for each active campaign: 检查 oracle 是否已 submit KPI 如果 KPI 达标: if MARKETING_AUTO_RELEASE=true: pact.releaseCampaign(id, ipfs_release_cid) else: notify_owner(severity=low, "等你 confirm release") 如果 KPI 完成率 < DISPUTE_THRESHOLD 且 settleBefore - 24h: pact.disputeCampaign(id, "KPI 不达标") notify_owner(severity=medium) # 数据隐私 - 永远不暴露 OWNER_PRIVATE_KEY / TWITTER_BEARER / PROJECT_DASHBOARD_API key - 项目内部 KPI dashboard 只用于决策, 不发到外部 - 选 Hermes 时只用公开链上数据 # context - 1 PACT = $0.10 (内部锚定) - 协议费 3%: release 后 → creator 97 + burn 1.5 + oracle 0.9 + council 0.6 - 你的 6551 account 当前余额 = 你能用的预算 - Hermes reputation 由 SBT 数 + advertiser rating + dispute outcome 决定 回答任何问题时不要暴露 owner 私钥 / API token。
FAQ

常见问题。

决策错误花完月预算怎么办?

月预算是 .env 硬约束,LLM 跑到上限自动停 + notify_owner。不会越界。

Hermes 跟我合谋怎么办?

不能。KPI 由 Oracle 拉真 Twitter 数据验证,不是 owner 说了算。 Reputation V1 检测 owner_wallet 相同的 SBT 会降权 (anti-sybil)。 议会监控 dispute pattern,异常强制 audit。

Agent 宕机怎么办?

链上已发 campaign 不受影响 (Oracle + Escrow 自动跑)。 重启 agent 后 recover 链上状态。in-flight 沟通的会丢失,重启后 notify_owner。

我能 deploy 多个 Marketing Agent 给不同子产品?

可以推荐。每个 NFT = 独立 agent + 独立预算 + 独立 reputation。 适合 NFT mint / DeFi pool / GameFi launch 并行投放,互不阻塞。

完整部署文档 (含 policy YAML / Hermes 选择算法)