by 运行时依赖
安装命令
点击复制技能文档
将用户引导通过将 Operon 的发布者 SDK 集成到他们的 AI 代理中。该集成将本地赞助推荐添加到响应中，通过质量加权拍卖提供。任何 Node 18+ 堆栈上都可以在大约 10 分钟内完成集成。本技能不自主执行代码。它告诉用户的代理（Claude Code、Cursor、Codex CLI）要运行哪些命令、编辑哪些文件以及每一步要期待什么。用户批准每个操作。
何时使用此技能 用户准备将 Operon 作为发布者集成。他们已经决定进行货币化并希望发布集成。他们可能已经运行了 estimate-agent-revenue 或 score-agent-response-quality，或者他们可能已经知道 Operon 的功能。如果他们仍在探索收入潜力，请将他们引导到 estimate-agent-revenue。如果他们想先评估响应质量，请将他们引导到 score-agent-response-quality。
步骤 1：路径检测 询问：您是否运行 ElizaOS？ 是 → ElizaOS 插件路径更快（提供者在每个消息上自动触发；无需手动放置调用线路）。使用 @operon/plugin-publisher-sdk。跳转到步骤 8。 否 → 通用 SDK 路径。使用 @operon/sdk。继续执行步骤 2。 通用 SDK 可以在任何 Node 18+ 堆栈上运行：LangChain、CrewAI、Vercel AI SDK、Mastra、Hono、普通 Node 等。
步骤 2：先决条件 Node 18+ 生成文本响应的工作代理 用于 npm install 和运行时放置 API 调用的网络访问 无钱包。无区块链交互（这是广告商通过 x402 的一方）。无需 API 密钥用于沙盒车道。
步骤 3：安装 SDK（通用路径） npm install @operon/sdk
步骤 4：初始化客户端
在用户代理生成响应的文件中添加：
import { initOperon } from '@operon/sdk';
const operon = initOperon({
url: 'https://api.operon.so',
publisherName: 'your-agent-name',
source: 'skill3-clawhub',
// Sandbox UUID 车道无需 API 密钥。无需注册。
// 在运行 npx @operon/sdk register 后添加 apiKey: process.env.OPERON_API_KEY。
});
发布者名称是 Operon 日志中代理的稳定标识符。使用带有下划线、连字符、无空格的字符串。源参数对于 ClawHub 变体是硬编码的。每个市场的变体使用不同的源值进行归属。除非用户明确请求不同的归属字符串，否则不要更改源字段。
步骤 5：连接放置调用 将放置调用添加到代理的响应管道中，在代理生成其主要答案后： async function generateResponse(query: string) { const answer = await yourAgentLogic(query); const result = await operon.getPlacement(query, { placement_context: '此查询的简要摘要', category: 'defi', asset: 'crypto-swaps', intent: 'research', }); return { answer, recommendation: result.decision === 'filled' ? result.placement : null, disclosure: result.decision === 'filled' ? 'via operon' : null, }; } getPlacement 返回以下之一： { decision: 'filled', placement: { ... } }：已匹配赞助推荐 { decision: 'blocked' }：无匹配项，无需显示放置 当填充时，渲染放置作为代理主要答案旁边的本地推荐，显示“via operon”披露。
步骤 6：选择类别、资产和意图值 该技能帮助用户为其代理选择合理的值。参考表格： 垂直类别 资产（示例） 意图（示例） DeFi/Crypto defi 加密货币交换、收益耕作、衍生品、NFT 研究、比较、推荐 金融科技 fintech 支付、券商、贷款 研究、比较 旅行 travel 航班、酒店、体验 推荐、预订意图 电子商务 e-commerce 电子产品、服装、家居用品 比较、推荐 SaaS saas 开发者工具、分析、CRM 比较、评估 保险 insurance 汽车、房屋、人寿 比较、报价意图 健康 health 健身、营养、心理健康 研究、推荐 教育 education 课程、训练营、辅导 研究、比较 通用 general 通用 研究 如果用户的代理在其 IDE（Claude Code、Cursor、Codex CLI）中运行，提供读取其字符配置或系统提示并推荐适合现有个性和主题的特定值。
步骤 7：运行测试放置 触发一个与配置的类别匹配的查询。SDK 调用返回放置（沙盒需求）或决策：'blocked'，如果没有匹配项。帮助用户构造一个可能填充的测试查询，考虑到 Operon 的当前网络状态：Crypto/DeFi 垂直：大多数查询填充（真实合作伙伴：ChangeNOW、SimpleSwap、Jupiter）。