用途：帮助用户通过 AI 智能体安全地使用 Bento，构建符合框架习惯的集成，而非仅语法正确的 SDK 调用。优先使用宿主框架的配置、依赖注入、队列、任务、工作流、cron 与凭据系统。当前客户引导以 https://bentonow.com/agent_onboarding.md 为准。
主要能力：按需求选择入口——Bento MCP 用于受支持 AI 助手的实时账户操作（托管远程 MCP https://mcp.bentonow.com/mcp 或本地 @bentonow/bento-mcp）；CLI 用于终端自动化、CSV 导入与安全批量操作；n8n 用于工作流；SDK 参考用于应用代码。支持 Node、Laravel、PHP、Drupal、Go、.NET、Elixir、Python、Ruby、n8n。
使用方式：先判断用户需要实时账户操作、终端自动化、无代码工作流还是应用代码。从请求或项目文件识别目标 SDK，不明确时运行 node skills/bento/scripts/bento-sdk.mjs detect .；缺失时打印安装说明，除非用户明确要求否则不自动安装，如 node skills/bento/scripts/bento-sdk.mjs install node。仅加载相关参考文件，迁移或跨入口时才加载多个。用所选产品的原生抽象实现，仅在 SDK 未暴露端点时才用原始 HTTP。用本地检查验证，并针对载荷结构、批处理、认证配置与失败处理补充测试。辅助脚本为只读，仅打印指引，可用 list、detect、install、doctor 等子命令，改动陌生项目前先运行 doctor。
集成规则：受众同步/导入优先用批量订阅者 API，不要循环单条创建；订阅者导入按 upsert 处理，设计为幂等可重试；行为与自动化触发用事件追踪，资料状态变更用字段/标签/订阅命令；三类凭据（site UUID、publishable key、secret key）存入环境变量、加密配置、CLI 配置、n8n 凭据或 MCP 凭据配置，禁止硬编码；通过容器或模块系统复用客户端；批量同步、事务邮件与可重试调用放入队列/任务/worker/cron 或 n8n 批处理；按 SDK 文档限制分块，仅重试失败分块；secret key 操作仅限服务端；破坏性或大批量操作尽量加 dry-run 或预览；对实时客户账户先只读检查或出计划，破坏性、高流量或发信前需明确确认。
API 限制：命令为异步，POST /fetch/commands 返回 { results } 与排队数量，不同步返回更新后订阅者；受众同步用 POST /batch/subscribers（最多 1000 条，不触发自动化），单条创建且可能触发自动化用 POST /fetch/subscribers；批量上限：事件 1000、订阅者 1000、事务邮件 60；/stats/* 约每小时每 IP 30 次，需缓存；/fetch/* 与 /batch/* 约每分钟每 IP 60 次；删除标签用 DELETE /fetch/tags/:id 并带 JSON 体 { "tag": { "name": "..." } }，先列出标签取 id；序列 ID 用 GET /fetch/sequences 返回的 id，不要臆造；黑名单检查用 GET /experimental/blacklist，参数为 domain 和/或 ip；GET /experimental/geolocation 返回 {}，不推荐用于丰富数据；GET /fetch/broadcasts 省略 status 时默认 sent，API 创建的广播为草稿，发送前需审核；写入前先列出标签、字段、序列、广播与订阅者。
适用场景：受众同步、订阅者查询、CSV 导入、CI 自动化、事件追踪、标签/字段变更、事务邮件、广播管理、邮箱验证与风险检查。
限制：资料未提供具体收费、价格与平台支持范围；部分端点行为以当前 Rails /api/v1 为准，可能变化。