@things-factory/integration-openai 10.1.236 → 10.1.241

package/helps/integration/connector/openai-admin-connector.md

@@ -0,0 +1,7 @@
+# OpenAI Admin 커넥터
+
+OpenAI 조직의 Admin API 에 연결합니다(비용 읽기).
+
+- **Admin 키** — platform.openai.com › Organization settings › Admin keys 에서 만든 `sk-admin-...` 키. 프로젝트 키는 거절됩니다. 조직 소유자만 만들 수 있습니다.
+- **조직 ID** — Organization settings › General 의 `org-...`. 구독 계정의 「계정 식별자」에 같은 값을 적습니다.
+- **엔드포인트** — 비워 두면 `https://api.openai.com`.

package/helps/integration/task/openai-cost-report.md

@@ -0,0 +1,15 @@
+# OpenAI 월 비용
+
+커넥션의 조직이 API 사용에 쓴 비용을 이번 달 전까지 닫힌 달마다, 항목(line item — 모델과 쓰임)별로 읽습니다(Costs API). 다음 단계에서 `local-graphql-mutate` 로 `syncSaasCosts(costs: $costs)` 를 부르면 계정 식별자가 그 조직 ID 인 구독 계정에 청구 기록이 쓰입니다.
+
+## 파라미터
+
+- `months` — 읽을 달 수(1~12, 비우면 3)
+
+## 결과
+
+`vendorAccount`(조직 ID) · `currency`(`USD`) · `months`(달마다 `lines` — `label` 항목 · `amount` 달러).
+
+## 다음 단계
+
+`local-graphql-mutate` — mutation `mutation ($costs: [SaasCostsInput!]!) { syncSaasCosts(costs: $costs) { results { accountName written kept } unmatched } }`, 변수 `costs` → 이 단계 이름. 계정 식별자가 맞는 구독 계정이 없으면 `unmatched` 에 그 id 가 나온다 — 그 값을 계정 식별자에 적는다.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@things-factory/integration-openai",
-  "version": "10.1.236",
+  "version": "10.1.241",
   "main": "dist-server/index.js",
   "browser": "client/index.js",
   "things-factory": true,
@@ -20,11 +20,12 @@
     "build": "tsc --p tsconfig.json",
     "build:server": "npm run clean:server && tsc",
     "clean:server": "rm -rf dist-server",
-    "clean": "npm run clean:server"
+    "clean": "npm run clean:server",
+    "test": "node --test test/*.test.mjs"
   },
   "dependencies": {
-    "@things-factory/ai-client-base": "^10.1.234",
-    "@things-factory/integration-base": "^10.1.236"
+    "@things-factory/ai-client-base": "^10.1.241",
+    "@things-factory/integration-base": "^10.1.241"
   },
-  "gitHead": "1560112ae8ae5a5d296b4fce1d5a1be05e30e8c2"
+  "gitHead": "d7fe2e1a1eb7c02cb21b897da26d385df014f908"
 }

package/translations/en.json

@@ -1,3 +1,6 @@
 {
+  "label.admin-key": "Admin key",
+  "label.months": "months",
+  "label.organization-id": "Organization ID",
   "label.prompt": "prompt"
 }

package/translations/es.json

@@ -1,3 +1,6 @@
 {
+  "label.admin-key": "Admin key",
+  "label.months": "months",
+  "label.organization-id": "Organization ID",
   "label.prompt": "prompt"
 }

package/translations/ja.json

@@ -1,3 +1,6 @@
 {
+  "label.admin-key": "Admin key",
+  "label.months": "months",
+  "label.organization-id": "Organization ID",
   "label.prompt": "プロンプト"
 }

package/translations/ko.json

@@ -1,3 +1,6 @@
 {
+  "label.admin-key": "Admin 키",
+  "label.months": "개월 수",
+  "label.organization-id": "조직 ID",
   "label.prompt": "프롬프트"
 }

package/translations/ms.json

@@ -1,3 +1,6 @@
 {
+  "label.admin-key": "Admin key",
+  "label.months": "months",
+  "label.organization-id": "Organization ID",
   "label.prompt": "prompt"
 }

package/translations/zh.json

@@ -1,3 +1,6 @@
 {
+  "label.admin-key": "Admin key",
+  "label.months": "months",
+  "label.organization-id": "Organization ID",
   "label.prompt": "提示"
 }