@kanyun-ai-infra/agenthub 1.8.0 → 1.9.0

package/README.md

@@ -50,12 +50,10 @@ const agenthub = new PilotPlatformClient({
   // controlPlaneUrl 可省略——默认打线上地址；打 test 等环境再显式传（或设 PILOT_CONTROL_PLANE_URL）。
 });
 
-// 1. Project：租户 / 根分组。默认 runtime template 让发布 Version 时不必每次手选模板。
-const project = await agenthub.projects.create({
-  slug: "acme",
-  displayName: "Acme",
-  defaultRuntimeTemplateRefName: "pilot-v2-pod-agent",
-});
+// 1. Project：租户 / 根分组。模型服务按 Project 归属、目前只能在门户「凭证与集成」→「模型服务」
+//    里配，所以这里用一个已经配好模型服务的 Project。新建用 agenthub.projects.create({ slug,
+//    displayName, defaultRuntimeTemplateRefName })，建完先去门户给它配一套模型服务。
+const project = await agenthub.projects.get("<已配好模型服务的 Project id>");
 
 // 2. Agent：Project 下一个可运行的 agent。
 await agenthub.agents.create({
@@ -64,7 +62,6 @@ await agenthub.agents.create({
   displayName: "Support Bot",
   kind: "managed_agent",
   defaults: {
-    model: "claude-opus-4-7",
     systemPrompt: "You are the Acme support agent.",
     agentPackage: {
       format: "claude_code",
@@ -87,7 +84,10 @@ const version = await agenthub.agents.publishVersion({
   workerContract: { kind: "managed_agent" },
   setDefault: true,
   managedAgentProfileSnapshot: {
-    model: "claude-opus-4-7",
+    // 模型服务必填：没声明模型服务的 Agent 建不出会话（SESSION_LLM_PROVIDER_REQUIRED）。
+    // 填这个 Project 那套模型服务的 publicId（llmp_ 开头，门户列表里复制）。
+    // model 省略 = 用该模型服务声明的默认档位。
+    llmProviderRef: "llmp_xxxxxxxxxxxxxxxx",
     systemPrompt: "You are the Acme support agent.",
   },
 });
@@ -192,7 +192,7 @@ App 里点的"对"；`purge(projectId, { subjectKind, subjectId })` 按主体清
 | --- | --- |
 | `usage` | 模型用量（`inputTokens` / `outputTokens` / `totalTokens` 等）。其中 `costUsd` 是 Claude Code CLI **自报的列表价估算**（`costSource === "claude_code_cli"`），不是账单实付；`failed` / `aborted` 轮次没有 `usage`（T-INV-13）。`completed` 轮次也可能缺省——用量数据没通过校验时字段不落，并在该轮 `anomalies` 里记 `usage_parse_failed`。 |
 | `traceId` | 这一轮的分布式 trace id（`string \| null`），可拼 Octopus trace-explorer 深链定位整条链路（agenthub → control-worker → agent-worker）。 |
-| `memoryRecall.state` | **只在会话首轮出现**——设计如此，不是版本或故障问题：读服务只给首轮投影这个字段（`session-turns-read-service.ts` 的 `core.turnId === enrichment.firstTurnId` 判据），第 2 轮起 `memoryRecall` 恒为 `undefined`，即便服务端是最新版。值是这一轮的**记忆召回状态**枚举，不是召回内容：`selected`（召回并注入了条目）/ `empty`（功能开着、也查了，本轮无可注入记忆）/ `recall_failed`（召回过程失败）/ `unavailable`（回读时没能解出召回快照）/ `legacy`（会话早于记忆机制，无快照）。目前只对外暴露状态，召回内容展示挂在另一条线（#1837）。 |
+| `memoryRecall.state` | **只在会话首轮出现**——设计如此，不是版本或故障问题：读服务只给首轮投影这个字段（`session-turns-read-service.ts` 的 `core.turnId === enrichment.firstTurnId` 判据），第 2 轮起 `memoryRecall` 恒为 `undefined`，即便服务端是最新版。值是这一轮的**记忆召回状态**枚举，不是召回内容：`selected`（召回并注入了条目）/ `empty`（功能开着、也查了，本轮无可注入记忆）/ `recall_failed`（召回过程失败）/ `unavailable`（回读时没能解出召回快照）/ `legacy`（会话早于记忆机制，无快照）。目前只对外暴露状态，不含召回内容。 |
 
 三个字段都是可选/可空的：`usage` 与 `memoryRecall` 是可选字段，`traceId` 可空、没有
 链路时为 `null`。写消费代码时一律按「缺失」处理，不要假定它们一定存在。