@axiom-lattice/examples-deep_research 1.0.94 → 1.0.96

package/src/agents/sap_b1/tools.ts

@@ -2,7 +2,7 @@ import z from "zod";
 import { registerToolLattice } from "@axiom-lattice/core";
 
 const BASE_URL =
-  process.env.SAP_SERVICE_LAYER_URL || "https://b1s.alphafina.cn/b1s/v1";
+  process.env.ERP_SERVICE_LAYER_URL || "https://b1s.alphafina.cn/b1s/v1";
 
 // ============================================================
 // API 元数据
@@ -45,7 +45,7 @@ const API_LIST: ApiEntry[] = [
   {
     name: "BusinessPartners",
     kind: "EntitySet",
-    entityType: "SAPB1.BusinessPartner",
+    entityType: "ERP.BusinessPartner",
     primaryKey: "CardCode",
     domain: "BusinessPartner",
     description: "客户/供应商主数据",
@@ -62,7 +62,7 @@ const API_LIST: ApiEntry[] = [
   {
     name: "BusinessPartnerGroups",
     kind: "EntitySet",
-    entityType: "SAPB1.BusinessPartnerGroup",
+    entityType: "ERP.BusinessPartnerGroup",
     primaryKey: "Code",
     domain: "BusinessPartner",
     description: "BP 分组",
@@ -71,7 +71,7 @@ const API_LIST: ApiEntry[] = [
   {
     name: "SalesPersons",
     kind: "EntitySet",
-    entityType: "SAPB1.SalesPerson",
+    entityType: "ERP.SalesPerson",
     primaryKey: "SalesEmployeeCode",
     domain: "BusinessPartner",
     description: "销售雇员",
@@ -82,7 +82,7 @@ const API_LIST: ApiEntry[] = [
   {
     name: "Items",
     kind: "EntitySet",
-    entityType: "SAPB1.Item",
+    entityType: "ERP.Item",
     primaryKey: "ItemCode",
     domain: "Item / Product",
     description: "物料主数据",
@@ -100,7 +100,7 @@ const API_LIST: ApiEntry[] = [
   {
     name: "ItemGroups",
     kind: "EntitySet",
-    entityType: "SAPB1.ItemGroups",
+    entityType: "ERP.ItemGroups",
     primaryKey: "Number",
     domain: "Item / Product",
     description: "物料组",
@@ -109,7 +109,7 @@ const API_LIST: ApiEntry[] = [
   {
     name: "PriceLists",
     kind: "EntitySet",
-    entityType: "SAPB1.PriceList",
+    entityType: "ERP.PriceList",
     primaryKey: "PriceListNo",
     domain: "Item / Product",
     description: "价格清单",
@@ -123,7 +123,7 @@ const API_LIST: ApiEntry[] = [
   {
     name: "BarCodes",
     kind: "EntitySet",
-    entityType: "SAPB1.BarCode",
+    entityType: "ERP.BarCode",
     primaryKey: "AbsEntry",
     domain: "Item / Product",
     description: "条码",
@@ -134,7 +134,7 @@ const API_LIST: ApiEntry[] = [
   {
     name: "Orders",
     kind: "EntitySet",
-    entityType: "SAPB1.Document",
+    entityType: "ERP.Document",
     primaryKey: "DocEntry",
     domain: "Document",
     description: "销售订单",
@@ -151,7 +151,7 @@ const API_LIST: ApiEntry[] = [
   {
     name: "DeliveryNotes",
     kind: "EntitySet",
-    entityType: "SAPB1.Document",
+    entityType: "ERP.Document",
     primaryKey: "DocEntry",
     domain: "Document",
     description: "交货单",
@@ -166,7 +166,7 @@ const API_LIST: ApiEntry[] = [
   {
     name: "Invoices",
     kind: "EntitySet",
-    entityType: "SAPB1.Document",
+    entityType: "ERP.Document",
     primaryKey: "DocEntry",
     domain: "Document",
     description: "销售发票 (应收)",
@@ -181,7 +181,7 @@ const API_LIST: ApiEntry[] = [
   {
     name: "Quotations",
     kind: "EntitySet",
-    entityType: "SAPB1.Document",
+    entityType: "ERP.Document",
     primaryKey: "DocEntry",
     domain: "Document",
     description: "销售报价单",
@@ -195,7 +195,7 @@ const API_LIST: ApiEntry[] = [
   {
     name: "CreditNotes",
     kind: "EntitySet",
-    entityType: "SAPB1.Document",
+    entityType: "ERP.Document",
     primaryKey: "DocEntry",
     domain: "Document",
     description: "销售贷项凭证",
@@ -209,7 +209,7 @@ const API_LIST: ApiEntry[] = [
   {
     name: "Returns",
     kind: "EntitySet",
-    entityType: "SAPB1.Document",
+    entityType: "ERP.Document",
     primaryKey: "DocEntry",
     domain: "Document",
     description: "销售退货",
@@ -223,7 +223,7 @@ const API_LIST: ApiEntry[] = [
   {
     name: "DownPayments",
     kind: "EntitySet",
-    entityType: "SAPB1.Document",
+    entityType: "ERP.Document",
     primaryKey: "DocEntry",
     domain: "Document",
     description: "预收款",
@@ -237,7 +237,7 @@ const API_LIST: ApiEntry[] = [
   {
     name: "Drafts",
     kind: "EntitySet",
-    entityType: "SAPB1.Document",
+    entityType: "ERP.Document",
     primaryKey: "DocEntry",
     domain: "Document",
     description: "销售草稿/采购草稿（支持创建、查询、更新、删除）",
@@ -254,7 +254,7 @@ const API_LIST: ApiEntry[] = [
   {
     name: "PurchaseOrders",
     kind: "EntitySet",
-    entityType: "SAPB1.Document",
+    entityType: "ERP.Document",
     primaryKey: "DocEntry",
     domain: "Document",
     description: "采购订单",
@@ -269,7 +269,7 @@ const API_LIST: ApiEntry[] = [
   {
     name: "PurchaseDeliveryNotes",
     kind: "EntitySet",
-    entityType: "SAPB1.Document",
+    entityType: "ERP.Document",
     primaryKey: "DocEntry",
     domain: "Document",
     description: "采购收货单",
@@ -282,7 +282,7 @@ const API_LIST: ApiEntry[] = [
   {
     name: "PurchaseInvoices",
     kind: "EntitySet",
-    entityType: "SAPB1.Document",
+    entityType: "ERP.Document",
     primaryKey: "DocEntry",
     domain: "Document",
     description: "采购发票 (应付)",
@@ -296,7 +296,7 @@ const API_LIST: ApiEntry[] = [
   {
     name: "PurchaseReturns",
     kind: "EntitySet",
-    entityType: "SAPB1.Document",
+    entityType: "ERP.Document",
     primaryKey: "DocEntry",
     domain: "Document",
     description: "采购退货",
@@ -309,7 +309,7 @@ const API_LIST: ApiEntry[] = [
   {
     name: "PurchaseQuotations",
     kind: "EntitySet",
-    entityType: "SAPB1.Document",
+    entityType: "ERP.Document",
     primaryKey: "DocEntry",
     domain: "Document",
     description: "采购报价",
@@ -324,7 +324,7 @@ const API_LIST: ApiEntry[] = [
   {
     name: "InventoryGenEntries",
     kind: "EntitySet",
-    entityType: "SAPB1.Document",
+    entityType: "ERP.Document",
     primaryKey: "DocEntry",
     domain: "Inventory / Warehouse",
     description: "库存收货",
@@ -338,7 +338,7 @@ const API_LIST: ApiEntry[] = [
   {
     name: "InventoryGenExits",
     kind: "EntitySet",
-    entityType: "SAPB1.Document",
+    entityType: "ERP.Document",
     primaryKey: "DocEntry",
     domain: "Inventory / Warehouse",
     description: "库存发货",
@@ -351,7 +351,7 @@ const API_LIST: ApiEntry[] = [
   {
     name: "StockTransfers",
     kind: "EntitySet",
-    entityType: "SAPB1.StockTransfer",
+    entityType: "ERP.StockTransfer",
     primaryKey: "DocEntry",
     domain: "Inventory / Warehouse",
     description: "库存转储",
@@ -364,7 +364,7 @@ const API_LIST: ApiEntry[] = [
   {
     name: "InventoryPostings",
     kind: "EntitySet",
-    entityType: "SAPB1.InventoryPosting",
+    entityType: "ERP.InventoryPosting",
     primaryKey: "DocumentEntry",
     domain: "Inventory / Warehouse",
     description: "库存过账",
@@ -376,7 +376,7 @@ const API_LIST: ApiEntry[] = [
   {
     name: "InventoryCountings",
     kind: "EntitySet",
-    entityType: "SAPB1.InventoryCounting",
+    entityType: "ERP.InventoryCounting",
     primaryKey: "DocumentEntry",
     domain: "Inventory / Warehouse",
     description: "库存盘点",
@@ -388,7 +388,7 @@ const API_LIST: ApiEntry[] = [
   {
     name: "Warehouses",
     kind: "EntitySet",
-    entityType: "SAPB1.Warehouse",
+    entityType: "ERP.Warehouse",
     primaryKey: "WarehouseCode",
     domain: "Inventory / Warehouse",
     description: "仓库定义",
@@ -402,7 +402,7 @@ const API_LIST: ApiEntry[] = [
   {
     name: "BinLocations",
     kind: "EntitySet",
-    entityType: "SAPB1.BinLocation",
+    entityType: "ERP.BinLocation",
     primaryKey: "AbsEntry",
     domain: "Inventory / Warehouse",
     description: "库位",
@@ -415,7 +415,7 @@ const API_LIST: ApiEntry[] = [
   {
     name: "BatchNumberDetails",
     kind: "EntitySet",
-    entityType: "SAPB1.BatchNumberDetail",
+    entityType: "ERP.BatchNumberDetail",
     primaryKey: "DocEntry",
     domain: "Inventory / Warehouse",
     description: "批次号明细",
@@ -428,7 +428,7 @@ const API_LIST: ApiEntry[] = [
   {
     name: "SerialNumberDetails",
     kind: "EntitySet",
-    entityType: "SAPB1.SerialNumberDetail",
+    entityType: "ERP.SerialNumberDetail",
     primaryKey: "DocEntry",
     domain: "Inventory / Warehouse",
     description: "序列号明细",
@@ -443,7 +443,7 @@ const API_LIST: ApiEntry[] = [
   {
     name: "ItemsService_InitData",
     kind: "FunctionImport",
-    entityType: "SAPB1.Item",
+    entityType: "ERP.Item",
     domain: "Item / Product",
     description: "初始化物料数据",
     fields: [],
@@ -451,7 +451,7 @@ const API_LIST: ApiEntry[] = [
   {
     name: "BusinessPartnersService_InitData",
     kind: "FunctionImport",
-    entityType: "SAPB1.BusinessPartner",
+    entityType: "ERP.BusinessPartner",
     domain: "BusinessPartner",
     description: "初始化 BP 数据",
     fields: [],
@@ -459,7 +459,7 @@ const API_LIST: ApiEntry[] = [
   {
     name: "OrdersService_InitData",
     kind: "FunctionImport",
-    entityType: "SAPB1.Document",
+    entityType: "ERP.Document",
     domain: "Document",
     description: "初始化订单数据",
     fields: [],
@@ -467,7 +467,7 @@ const API_LIST: ApiEntry[] = [
   {
     name: "InvoicesService_InitData",
     kind: "FunctionImport",
-    entityType: "SAPB1.Document",
+    entityType: "ERP.Document",
     domain: "Document",
     description: "初始化发票数据",
     fields: [],
@@ -477,7 +477,7 @@ const API_LIST: ApiEntry[] = [
   {
     name: "SpecialPrices",
     kind: "EntitySet",
-    entityType: "SAPB1.SpecialPrice",
+    entityType: "ERP.SpecialPrice",
     primaryKey: "ItemCode+CardCode",
     domain: "Item / Product",
     description: "特殊价格（BP/客户特定价格）",
@@ -489,7 +489,7 @@ const API_LIST: ApiEntry[] = [
   {
     name: "LandedCosts",
     kind: "EntitySet",
-    entityType: "SAPB1.LandedCost",
+    entityType: "ERP.LandedCost",
     primaryKey: "DocEntry",
     domain: "Document",
     description: "到岸成本/附加成本凭证",
@@ -498,7 +498,7 @@ const API_LIST: ApiEntry[] = [
   {
     name: "LandedCostsCodes",
     kind: "EntitySet",
-    entityType: "SAPB1.LandedCostsCode",
+    entityType: "ERP.LandedCostsCode",
     primaryKey: "Code",
     domain: "Document",
     description: "到岸成本代码定义",
@@ -507,7 +507,7 @@ const API_LIST: ApiEntry[] = [
   {
     name: "CompanyService_GetItemPrice",
     kind: "FunctionImport",
-    entityType: "SAPB1.ItemPriceReturnParams",
+    entityType: "ERP.ItemPriceReturnParams",
     domain: "Item / Product",
     description: "根据参数查询物料价格（含历史明细）",
     fields: ["ItemPrices", "ItemUnitOfMeasurementCollection"],
@@ -536,7 +536,7 @@ const API_LIST: ApiEntry[] = [
   {
     name: "Z20_COST",
     kind: "EntitySet",
-    entityType: "SAPB1.Z20_COST",
+    entityType: "ERP.Z20_COST",
     primaryKey: "DocEntry",
     domain: "Item / Product",
     description: "自定义: 成本记录表（含周期/实例维度的成本历史）",
@@ -549,7 +549,7 @@ const API_LIST: ApiEntry[] = [
   {
     name: "Z20_CPAT",
     kind: "EntitySet",
-    entityType: "SAPB1.Z20_CPAT",
+    entityType: "ERP.Z20_CPAT",
     primaryKey: "DocEntry",
     domain: "Item / Product",
     description: "自定义: 成本/价格分摊记录",
@@ -561,7 +561,7 @@ const API_LIST: ApiEntry[] = [
   {
     name: "Z20_OINP",
     kind: "EntitySet",
-    entityType: "SAPB1.Z20_OINP",
+    entityType: "ERP.Z20_OINP",
     primaryKey: "DocEntry",
     domain: "Document",
     description: "自定义: 采购订单输入价格记录",
@@ -573,7 +573,7 @@ const API_LIST: ApiEntry[] = [
   {
     name: "Z20_PWAG",
     kind: "EntitySet",
-    entityType: "SAPB1.Z20_PWAG",
+    entityType: "ERP.Z20_PWAG",
     primaryKey: "DocEntry",
     domain: "Item / Product",
     description: "自定义: 工价/工序价格记录",
@@ -585,7 +585,7 @@ const API_LIST: ApiEntry[] = [
   {
     name: "Z20_HOLD",
     kind: "EntitySet",
-    entityType: "SAPB1.Z20_HOLD",
+    entityType: "ERP.Z20_HOLD",
     primaryKey: "DocEntry",
     domain: "Inventory / Warehouse",
     description: "自定义: 暂存/冻结库存记录",
@@ -597,7 +597,7 @@ const API_LIST: ApiEntry[] = [
   {
     name: "Z20_IMIT",
     kind: "EntitySet",
-    entityType: "SAPB1.Z20_IMIT",
+    entityType: "ERP.Z20_IMIT",
     primaryKey: "DocEntry",
     domain: "Inventory / Warehouse",
     description: "自定义: 库存初始化记录",
@@ -609,7 +609,7 @@ const API_LIST: ApiEntry[] = [
 ];
 
 // ============================================================
-// Tool 1: sap_api_search
+// Tool 1: erp_api_search
 // ============================================================
 
 function mapResult(e: ApiEntry): Record<string, unknown> {
@@ -623,8 +623,8 @@ function mapResult(e: ApiEntry): Record<string, unknown> {
     readySelect: e.fields.length > 0 ? `$select=${e.fields.join(",")}` : undefined,
     hint:
       e.kind === "EntitySet"
-        ? `${e.name} — ${e.description}。主键: ${e.primaryKey}。调用 sap_api_call 进行 CRUD 操作。`
-        : `${e.name} — ${e.description}。调用 sap_api_call 执行此方法。`,
+        ? `${e.name} — ${e.description}。主键: ${e.primaryKey}。调用 erp_api_call 进行 CRUD 操作。`
+        : `${e.name} — ${e.description}。调用 erp_api_call 执行此方法。`,
   };
   if (ENTITIES_WITH_LINES.has(e.name)) {
     r.expand = ["DocumentLines", "DocumentAdditionalExpenses"];
@@ -640,11 +640,11 @@ function mapResult(e: ApiEntry): Record<string, unknown> {
 }
 
 registerToolLattice(
-  "sap_api_search",
+  "erp_api_search",
   {
-    name: "sap_api_search",
+    name: "erp_api_search",
     description:
-      "搜索 SAP B1 Service Layer API 接口元数据，覆盖 BP/物料/订单/库存四大领域。" +
+      "搜索 ERP Service Layer API 接口元数据，覆盖 BP/物料/订单/库存四大领域。" +
       "返回接口名、主键、字段列表、可选 expand 导航。" +
       "可用 discover 模式发现关联接口（如搜 SalesPerson 也能找到 SalesPersons API）。" +
       "搜索结果中的 readySelect 可直接复制到 $select。",
@@ -771,36 +771,36 @@ registerToolLattice(
 );
 
 // ============================================================
-// Tool 2: sap_api_call
+// Tool 2: erp_api_call
 // ============================================================
 
-const SAP_COOKIE = process.env.SAP_B1SESSION
-  ? `B1SESSION=${process.env.SAP_B1SESSION}; ROUTEID=.node0`
+const ERP_COOKIE = process.env.ERP_SESSION
+  ? `B1SESSION=${process.env.ERP_SESSION}; ROUTEID=.node0`
   : "";
 
 registerToolLattice(
-  "sap_api_call",
+  "erp_api_call",
   {
-    name: "sap_api_call",
+    name: "erp_api_call",
     description:
-      "执行 SAP B1 Service Layer 的 OData API 查询/创建/更新/删除。" +
+      "执行 ERP Service Layer 的 OData API 查询/创建/更新/删除。" +
       `Base: ${BASE_URL}。` +
-      "⚠️ 先确认是否已通过 sap_api_search 查过字段列表，勿凭记忆编字段名。\n" +
+      "⚠️ 先确认是否已通过 erp_api_search 查过字段列表，勿凭记忆编字段名。\n" +
       "⚠️ 草稿/draft/暂存 → 用 Drafts 接口，不是 Orders/Invoices 等正式单据。" +
       "Drafts 通过 DocObjectCode 区分单据类型(17=订单,13=发票,16=交货单,23=采购订单)。\n" +
       "$filter 操作符: eq/ne/gt/lt/ge/le/contains(f,'v')/startswith(f,'v')/endswith(f,'v')，多条件用 and/or。" +
       "字符串值必须单引号包裹。$orderby=Field desc 排序。\n\n" +
-      "⚠️ SAP B1 实战经验:\n" +
+      "⚠️ ERP 实战经验:\n" +
       "1. 不要用 $expand！$expand 极易触发 400/500。改用 $select 包含嵌套字段，如 $select=DocEntry,DocNum,DocumentLines，\n" +
       "   DocumentLines 会自动作为嵌套 JSON 返回。ItemPrices、BPAddresses 等同理。\n" +
       "2. 不要用主键路径 /Orders('1173')，易 500。用 $filter=DocEntry eq 1173 代替。\n" +
       "3. 查单条记录时优先 $filter，而非传 id 参数。\n" +
       "400 多为特殊字符未编码(引号用 %27)；500 多为字段不存在或用错了 $expand；无结果则放宽 filter。\n" +
-      "POST 创建: sap_api_search 返回的 lineFields 是 DocumentLines 子字段。" +
+      "POST 创建: erp_api_search 返回的 lineFields 是 DocumentLines 子字段。" +
       "body 必含 DocObjectCode(DocType)、CardCode、DocDate；DocumentLines 为数组，每项必含 ItemCode、Quantity。" +
       "PATCH 只传变更字段；DELETE 需传 id。\n" +
       "GET 自动注入 $select+$top=20，手动传入可覆盖。嵌套集合(DocumentLines等)自动裁剪只保留常用字段，防 token 爆炸。" +
-      "认证需 SAP_B1SESSION 环境变量。",
+      "认证需 ERP_SESSION 环境变量。",
     needUserApprove: false,
     schema: z.object({
       entitySet: z
@@ -819,7 +819,7 @@ registerToolLattice(
             "常用: $top=10, $select=CardCode,CardName, " +
             "$filter=CardName eq 'xxx' or contains(CardName,'xxx'), " +
             "$orderby=DocDate desc, $expand=DocumentLines。字符串值用单引号。" +
-            "sap_api_search 返回的 readySelect 可直接复制到 $select。"
+            "erp_api_search 返回的 readySelect 可直接复制到 $select。"
         ),
       body: z.record(z.unknown()).optional().describe("POST/PATCH 时的 JSON 请求体"),
     }),
@@ -833,7 +833,7 @@ registerToolLattice(
       "Content-Type": "application/json",
       Accept: "application/json",
     };
-    if (SAP_COOKIE) headers.Cookie = SAP_COOKIE;
+    if (ERP_COOKIE) headers.Cookie = ERP_COOKIE;
 
     const fetchOptions: RequestInit = { method, headers };
     if ((method === "POST" || method === "PATCH") && input.body) {
@@ -865,7 +865,7 @@ registerToolLattice(
         result.error = `HTTP ${res.status} ${res.statusText}`;
         result.hint =
           res.status === 401
-            ? "需要有效的 B1SESSION Cookie。请先通过 Login 端点获取，或设置 SAP_B1SESSION 环境变量。"
+            ? "需要有效的 B1SESSION Cookie。请先通过 Login 端点获取，或设置 ERP_SESSION 环境变量。"
             : res.status === 404
               ? "接口或实体不存在，请检查 entitySet 名称和 id。"
               : undefined;
@@ -878,7 +878,7 @@ registerToolLattice(
         ok: false,
         error: `请求失败: ${message}`,
         url,
-        hint: "网络连接失败，请检查 SAP_SERVICE_LAYER_URL 是否正确。",
+        hint: "网络连接失败，请检查 ERP_SERVICE_LAYER_URL 是否正确。",
       };
     }
   }