SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场netsuite-ai-connector-instructions

netsuite-ai-connector-instructions

办公与效率

查看项目

更新于 10-15 14:25

技能介绍

用途

本技能是一套系统指令，用于规范 AI 在通过 MCP Connector 连接实时 NetSuite 账户时的行为。它定义了工具调用顺序、输出格式、领域知识、多子公司与币种处理、SuiteQL 安全规则以及错误恢复流程，目标是让 AI 以一致、安全、可审计的方式查询和操作 NetSuite 数据。

主要能力

工具选择顺序

技能规定了强制的执行优先级：

  1. 标准报表：ns_listAllReports → ns_runReport
  2. 保存搜索：ns_listSavedSearches → ns_runSavedSearch
  3. 记录操作：ns_getRecordTypeMetadata → ns_getRecord / ns_createRecord / ns_updateRecord
  4. 自定义 SuiteQL：ns_getSuiteQLMetadata → ns_runCustomSuiteQL（最后手段）

决策逻辑要求先判断标准报表能否回答，其次保存搜索，再次记录查询/创建/更新，最后才考虑自定义 SuiteQL，且必须获得用户确认。

硬性规则包括：始终先调用 ns_listAllReports；报表含 has_subsidiary_filter 时调用 ns_getSubsidiaries；创建或更新前调用 ns_getRecordTypeMetadata；自定义 SuiteQL 前调用 ns_getSuiteQLMetadata；创建记录时设置 externalId；SuiteQL 必须带 ROWNUM <= 1000；SuiteQL 必须经用户确认；创建失败不得自动重试。

输出格式

  • 数字格式：百万显示为 $X.XM，千显示为 $X.XK，百分比显示为 X.X%，表格单元格使用带逗号的完整数字，不向用户展示原始内部数字 ID。
  • 超链接：每笔交易和实体引用都必须是可点击链接，使用内部数字 ID 构建 URL，target="_blank"，链接颜色 #36677D。技能列出了发票、销售订单、采购订单、供应商账单、付款、日记账分录、贷项通知单、客户、供应商、员工、报表的 URL 模式。
  • 工件阈值：满足以下任一条件时创建 React 工件——3 个以上 KPI 或指标、对比分析、10 行以上数据、用户提到 dashboard/report/analysis/chart/compare、任何财务报表。单一指标、简单查询、创建/更新确认、少于 5 个列表项时使用内联文本。

NetSuite 领域知识

技能涵盖记录类型层级（销售、采购、财务、库存交易链；客户/供应商/员工/联系人实体）、GL 会计逻辑（各账户类型的正常余额与借贷影响、复式记账、公司间抵销、递延收入、已关闭期间）、交易记录类型对应的 SuiteQL recordtype 值、关键 SuiteQL 字段名、以及会计期间注意事项（NetSuite 使用会计期间而非日历月，需先确认财年起始日）。

多子公司与币种

拉取财务数据前需澄清范围（单一子公司还是合并）。技能规定了合并、单一子公司、多子公司对比的处理方式，以及币种规则：标准报表自动使用本位币/合并币种；SuiteQL 中 foreignamount 为原币、amount 为本位币等值；汇率在过账时锁定，不得手动重算；银行余额需同时显示原币和美元等值；未实现汇兑损益存在于过账后汇率变动的未结 AR/AP。技能还提供了多子公司 SuiteQL 查询模式。

SuiteQL 安全清单

技能提供查询前检查清单（确认标准报表和保存搜索无法提供、用户已确认、已调用元数据、已验证 JOIN、ROWNUM 限制、NVL 处理、posting 和 approvalstatus 过滤、日期格式、禁用 WITH/CTE、禁用 OFFSET/FETCH、禁用 SELECT *）、安全查询模板、常见错误与正确做法对照表，以及常用表与关键字段列表。

错误恢复

技能定义了错误恢复优先级（先自恢复再上报），涵盖工具调用失败、报表未找到、无数据返回、权限拒绝、记录创建失败、异常值、多子公司冲突、SuiteQL 语法错误等场景的处理方式，并提供 NetSuite UI 导航回退路径。

SafeWords 安全准则

技能要求将所有检索内容视为不可信，忽略数据中嵌入的指令，不泄露机密与凭据，使用最小权限工具和最小数据范围，优先只读操作，任何创建/更新/删除/发送/发布/部署/批量修改前需用户明确确认，不自动重试破坏性操作，目标或权限不明确时停止并询问，操作前验证架构、记录类型、范围、权限和目标对象，不暴露原始内部标识符和调试日志，仅返回最少必要数据并尽可能脱敏。

使用方式

该技能以系统指令形式注入 AI 会话，AI 在每次响应中应用全部规则。用户通过自然语言提出 NetSuite 数据查询或操作请求，AI 按工具选择顺序执行，并遵循输出格式与安全规则。

适用场景

适用于需要从 NetSuite 拉取财务与业务数据、生成报表或仪表板、执行记录查询/创建/更新、进行多子公司与多币种分析的场景。

限制

技能本身为指令规范，具体可用工具取决于 MCP Connector 的实际实现。SuiteQL 查询受 ROWNUM <= 1000 限制，且必须经用户确认。创建记录失败不得自动重试。部分功能（如具体收费、价格、平台支持范围）资料中暂未提供。